Для анализа данных в Galaxy Communicator реализован анализатор и выполнитель выражений и макросов. Он используется для фильтрования, выполнения запросов над таблицами, а так же для написания макро- функций, которые можно выполнять над таблицами, которые доступны макроязыку.

На данный момент доступны 3 таблицы:

• Список рас (Race)
• Список кораблей (ShipGroup)
• Список планет (Planet)

Обращение к таблицам возможно с помощью префикса – имени таблицы. Например: Race.Wpn или ShipGroup.Weight.

Для запросов и фильтров нужно указывать выражение. Выражение может состоять из операндов и операций.

Операнды могут быть, как стоковые или числовые константы, так и названием поля обрабатываемой таблицы.

Кроме этого операндом может быть вызов функции реализованной в макроязыке.

Операции делятся на унарные и бинарные.

Унарных операций две: унарный минус, и отрицание(not). Все остальные операции бинарные(+,-,*,/, and, or, >, <, >=, <=, <>, =, ==, &, |). Операция == применяется для сравнения строк без учета регистра.

Стоит отдельно рассмотреть операцию разыменовывания '^' - это операция позволяет формировать обращение к нужной планете. Имя планеты является левым операндом, правым может быть произвольное выражение, которое может обращаться к полям данной планеты. Например, для определения размера нужной планеты можно написать '#1'^.size или var1^.size, если значение переменной var1 во время выполнения будет равно названию или номеру планеты, то результат выражения будет равен размеру этой планеты. В списке кораблей так же можно обращаться к полям dest и from с помощью операции разыменовывания. Например, что бы отфильтровать корабли, которые находятся вместе с кораблями нужной вам расы на одной планете нужно достаточно установить фильтр dest^.fleet('RaceName')>0.

Кроме операции разыменования есть альтернативная возможность обращения не только к планете, но и к расе и к кораблю. Для этого в макроязык встроены операторы выборки одной записи из таблицы WinRace, WinPlanet, WithGroup, имеющие следующий синтаксис:

WithRace <expression> [ as 'name'] do {<operator>;} EndWith;

При выполнении оператора, происходит поиск значения выражения в соответствующей таблице и формирование таблицы состоящей из одной записи. К расе нужно обращаться по имени, к кораблю по номеру. Список операторов выполняется уже в контексте новой таблицы, и все обращения к полям будут выполнены как обращения к полям этой таблицы. Name - необязательный параметр в этой конструкции, но его использование дает возможность в последствие обращаться к данной таблице по этому имени, уже без апострофов.

Например, макрос:

macro GetDrive;
begin 
  WithRace me  as 'mytable' do
     result:=mytable.drv;
  EndWith;
end;

Будет возвращать значение технологии двигателей главной расы.

Если нужно сформировать таблицу из нескольких записей, удовлетворяющих определенному условию, то нужно воспользоваться операторами WithRaces, WithPlanets, WithGroups. Синтаксис аналогичный оператору выборки одной записи. Различие в том, что выражение является фильтром, который будет применен к данной таблице. Т.е. более медленный аналог макроса GetDrive можно написать в таком виде:

macro GetDrive;
begin 
  WithRaces 'name="'+me+'"' do do
     result:=drv;
  EndWith;
end;

Стоковые константы указываются в кавычках (одинарных или двойных), возможно вложение одних кавычек в другие. Стоит учитывать, что все операции сравнения над стоками производится с учетом регистра. Т.е. 'World'<>'WorLD'. Это обусловлено тем, что все без исключения сервера Galaxy, так же различают регистры, и вполне возможно некорректная работа выполнителя в случаях, когда у Вас в галактике, кто-то этим пользуется.

Пример: “Normal 'string' constant”

Для числовых констант возможно написание, как с фиксированной точкой, так и в экспоненциальной форме.

Пример: 1e-3, 0.001

Поле таблицы совпадает с его названием при отображении.

Поле может быть написано без учета регистра.

Кроме этого есть константы:

#NL – константа перевода на новую строку

Но для 3 таблиц (Расы, Планеты, Список Групп) есть дополнительные вычислимые поля.

Все поля этих таблиц перечислены ниже.

Кроме этих полей каждая таблица имеет поле Count  и функцию Current(NewPos). Count - возвращает количество записей в таблице, нумерация идет от 0 до count. Функция Current позволяет менять текущую запись в таблице в значение NewPos. Например, sum(#*Weight) может быть переписана на макроязыке следующим образом:

macro mysum;
var
  summa, i;
begin
  summa:=0;
  for i:=0 to shipgroup.count do
     shipgroup.current(i);
     summa:=summa+shipgroup.#*shipgroup.Weight;
  endfor;
  result:=summa;
end;

Причем, этот макрос может быть выполнен в любом окне запроса, так как содержит обращение к shipgroup и не зависит от текущей активной таблицы.

Для написания полноценных макросов разработан макроязык. Для этого нужно создать файл gcomm.mac в каталоге расположения gcomm.exe и в этот файл вставляются все описания макросов.

Синтаксис описан ниже:

Макрос объявляется следующим образом:

Macro <ident>[(<ident>{,<ident>})];

Var <ident>{,<ident>};

{<operator>;}

End;

,где в части VAR указывается список переменных, тип переменных определяется во время выполнения и может динамически меняться.

Кроме этого всегда есть зарезервированная переменная result, значение которой определяет результат функции.

Ниже приведен синтаксис операторов языка

<operator> ::=

Стоит отметить что, возможно, использовать рекурсию.

обратно