cls_2: Синтаксис

Пример cls-2 синтаксиса

{test-cfg
  {sort on}
  {rewrite off}
  {cfg-file
    {file-name "name-1" }
    {file-type "txt" }
  }
  {cfg-file
    {file-name "name-2" }
    {file-type "gif" }
  }
  {header-file
    {name "name-4" }
    {type "doc" }
  }
  {header-file
    {name "name-3" }
    {type "jpg" }
  }
}

Базовые элементы

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

cls_2-документ может содержать комментарии, которые полностью игнорируются при разборе. Существуют два вида коментариев:

• однострочный. Начинается с || и завершается в конце строки;
• многострочный. Начинается с |# и завершается #|.

Многострочные комментарии не могут быть вложенными друг в друга.

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

Значениями тега называются все токены, указанные внутри тега без учета дочерных тегов. Различаются три типа токенов:

• space (пробелы). Содержат все пробельные символы между двумя соседними токенами. Пробельными символами являются: пробел (" "), перевод строки ("\n"), возврат каретки ("\r"), горизонтальная табуляция ("\t");
• nonspace (не пробелы). Непрерывная последовательность символов, отличных от пробелов;
• string (строка). Последовательность символов, заключенная в двойные кавычки.

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

Приведенный выше пример можно представить в виде следующей разобранной последовательности токенов:

• tag с именем "test-cfg";
• space со значением "\n\t";
• tag с именем "sort";
• space со значением " ";
• nonspace со значением "on";
• tag с именем "rewrite";
• space со значением " ";
• nonspace со значением "off";
• tag с именем "cfg-file";
• space со значением "\n\t\t";
• tag с именем "file-name";
• space со значением " ";
• string со значением "name-1";
• space со значением " ";
• space со значением "\n\t\t"
• tag с именем "file-type";
• space со значением " ";
• string со значением "txt";
• space со значением " ";
• space со значением "\n\t";
• и т.д.

Примечание. В данной расшифровке не показаны моменты завершения разбора дочерних тегов.

Escape-последовательности

Символы {, }, |, \, " являются управляющими. Поэтому их нельзя использовать непосредственно в токенах nonspace и string. При необходимости использования этих значений необходим префиксовать их с помощью обратного слеша. Например:

• \{;
• \};
• \|;
• \\;
• \".

Для того, чтобы двойная кавычка не открывала токен типа string достаточно записать ее в виде escape-последовательности.

Примечание. Указанные выше управляющие символы обязательно должны быть представлены в виде escape-последовательностей внутри токена типа string.

Для записи любого символа можно использовать целочисленное значение кода символа, представленное в одной из систем счисления:

• двоичной. Представление должно начинаться с префикса \b или \B, за которым должно следовать восемь двоичных разрядов. Например, \b01000001;
• восьмеричной. Представление должно начинаться с префикса \o или \O, за которым должно следовать три восьмеричных разряда. Например, \o017;
• шестнадцатиричной. Представление должно начинаться с префикса \x или \X, за которым должно следовать два шестнадцатиричных разряда. Например, \xfb.

Так же поддерживаются следующие escape-последовательности:

• \n -- перевод строки;
• \r -- возврат каретки;
• \t -- горизонтальная табуляция.

---