--- parser3/operators.ru.txt 2009/08/14 10:40:33 1.224 +++ parser3/operators.ru.txt 2013/07/21 15:16:44 1.243 @@ -56,6 +56,7 @@ Xне сделано, видимо, не будет сделано !^if(условие){когда да}{когда нет} + !^if(условие1){да}[(условие2){да}[(условие2){да}[...]]]{нет} -- количество доп. условий не ограничено (в общем elseif это :) !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}} !^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] @@ -140,8 +141,8 @@ Xне сделано, видимо, не будет сделано ClientCharset << charset in which parser thinks client works !sqlite://DBfile? - ClientCharset=parser-charset& << charset in which parser thinks client works - autocommit=1 + ClientCharset=parser-charset& << charset in which parser thinks client works + autocommit=1 для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p) была определена таблица @@ -180,7 +181,7 @@ odbc c:\drives\y\parser3project\odbc\deb !в catch коде $exception.handled[cache] ^rem{флаг, что exception обработан} !^cache[файл][expires date]{код}[{catch код}] !абсолютное задание времени - X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0) + !^cache[файл] удалить файл [не ругает, если его нет] !^cache(секунд) !^cache[expires date] !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" @@ -296,7 +297,7 @@ odbc c:\drives\y\parser3project\odbc\deb пример: ^if(def $form:name) не пуста? ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?] - !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]] + !^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]] результат запроса должен быть один столбец/одна строка !^строка.int[] .int(default) целочисленное значение строки. если ломается преобразование, берётся default @@ -335,7 +336,9 @@ odbc c:\drives\y\parser3project\odbc\deb !^строка.pos[подстрока](позиция, с которой ищем) <0 = не найдено !^строка.replace[$таблица_подстановок_строка_на_строку] + !^строка.replace[$что;$на-что] !^строка.save[[append;]путь] + !^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]] !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены полезно делать перед сложными match операциями, если вы знаете, что входная строка состоит из большого числа фрагментов @@ -343,7 +346,7 @@ odbc c:\drives\y\parser3project\odbc\deb default 'chars' -- whitespace chars !^строка.append[string] !^строка.base64[] encode - !^string:base64[encoded] decode + !^string:base64[encoded[;$.strict(true)]] decode !table в выражении @@ -359,10 +362,10 @@ odbc c:\drives\y\parser3project\odbc\deb !$.separator[^#09] !$.encloser["] по-умолчанию, нет. !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]] - bind привязывает переменные в запросе к их значениям - пока реализован только для oracle - в запросе надо написать ":имя" - в параметре bind передать hash, из которого возьмётся(или куда запишется) значение + bind привязывает переменные в запросе к их значениям + пока реализован только для oracle + в запросе надо написать ":имя" + в параметре bind передать hash, из которого возьмётся(или куда запишется) значение !^таблица.save[[nameless|append;]путь[;опции, см. load]] !$таблица.поле !$таблица.fields из named таблицы выдаёт текущую запись как Hash @@ -371,7 +374,9 @@ odbc c:\drives\y\parser3project\odbc\deb !^таблица.offset[[whence]](5) сдвигает !whence=cur|set !без whence - это cur - !^таблица.count[] + !^таблица.count[], ^таблица.count[rows] - количество строк в таблице + !^таблица.count[columns] - для named таблицы количество столбцов (сокращение от $c[^таблица.columns[]]^c.count[]) + !^таблица.count[cells] - количество ячеек в текущей строке таблицы !^таблица.line[] 1-based offset !^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc !^таблица.append{данные} @@ -424,6 +429,9 @@ odbc c:\drives\y\parser3project\odbc\deb !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] !^хеш.delete[ключ] удалить ключ !^хеш.contain[ключ] - существует ли в хеше ключ (bool) + !^хэш._at[first|last] + !^хэш._at([-]N) + доступ к заданным элементам упорядоченного хеша !hashfile !^hashfile::open[filename] @@ -508,7 +516,7 @@ odbc c:\drives\y\parser3project\odbc\deb !$response:headers накопленные поля !$response:body[DATA] замещает стандартный ответ !$response:download[DATA] замещает стандартный ответ, - выставляет флаг, заставляющий browser предложить download + выставляет флаг, заставляющий browser предложить download !$response:status !^response:clear[] забыть все заданные response поля !$response:charset @@ -538,18 +546,26 @@ odbc c:\drives\y\parser3project\odbc\deb !^reflection:classes[] хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void !^reflection:class[объект] класс переданного объекта !^reflection:class_name[объект] имя класса переданного объекта - !^reflection:base[объект] класс переданного объекта - !^reflection:base_name[объект] имя класса переданного объекта + !^reflection:base[объект] родительский класс переданного объекта + !^reflection:base_name[объект] имя родительского класса переданного объекта !^reflection:methods[класс] хеш со списком методов указанного класса, значения -- строки 'native' или 'parser' + !^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта + !^reflection:fields[класс или объект] хеш со списком статических полей указанного класса или динамических полей указанного объекта + !^reflection:field[класс или объект;имя поля] возвращает значение указанного поля класса или объекта. getter-ы игнорируются. + !^reflection:uid[класс или объект] возвращает идентификатор объекта или класса !^reflection:method_info[класс;метод] хеш с параметрами указанного метода класса $.inherited[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) + $.overridden[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) для native классов возвращается хеш: .min_params(минимально необходимое число параметров) .max_params(максимально возможное число параметров) .call_type[dynamic|static|any] для parser классов возвращается хеш: ключ -- номер параметра (0, 1, ...), значение - имя параметра - !^reflection:dynamical[[object or class, caller if absent]] возвращает true, если метод был вызван динамически + !^reflection:dynamical[[object or class, caller if absent]] возвращает true, если метод был вызван из динамического контекста + при передаче параметра возвращает true, если передан динамический объект, + false если класс + !^reflection:delete[класс или объект;имя переменной] удаляет переменную с указанным именем в указанном классе или объекте !mail @@ -580,10 +596,10 @@ odbc c:\drives\y\parser3project\odbc\deb $.message#[MESSAGE] (message, message2, ...) !^mail:send[ - $.options[-odd] - unix: строка, которая будет добавлена к команде запуска sendmail - -odd означает "быстро поставь в очередь без проверки email" - win32: игнорируется + $.options[-odd] + unix: строка, которая будет добавлена к команде запуска sendmail + -odd означает "быстро поставь в очередь без проверки email" + win32: игнорируется $.charset[кодировка заголовка и текстовых блоков] $.any-header-field $.text[string] @@ -735,12 +751,15 @@ odbc c:\drives\y\parser3project\odbc\deb !$файл_из_post.name !$файл_из_post.size !$файлtиз_post.text - !^файл.save[text|binary;имя файла] + !^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем]]] !^file:delete[имя файла] !^file:find[имя файла][{когда не нашли}] - !^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонкой name + !^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонками name dir + !^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)] = table с колонками name dir size [mca]date !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]] - !^file::create[text;имя;^untaint[xml]{data}] + !^file::create[text|binary;имя;data] + !^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]] + !^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.charset[...]]] !$файл_который_был_loaded.size !$файл_который_был_loaded_или_created.mode = text/binary !^file::stat[имя файла] @@ -764,32 +783,36 @@ odbc c:\drives\y\parser3project\odbc\deb выполняется код разблокируется Xchmod[...] НЕТ И НЕ БУДЕТ, ЧТОБЫ НЕ МОГЛИ СДЕЛАТЬ executable и запустить, даже если ftp запрещает chmod. - !^file:dirname[/a/some.tar.gz]=/a - !^file:dirname[/a/b/]=/a - !^file:basename[/a/some.tar.gz]=some.tar.gz + !^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix) + !^file:dirname[/a/b/]=/a (работает аналогично комманде *nix) + !^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix) + !^file:basename[/a/b/]=b (работает аналогично комманде *nix) !^file:justname[/a/some.tar.gz]=some.tar !^file:justext[/a/some.tar.gz]=gz !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать - X^file::sql[[имя_файла_для_download]]{} - !^file::sql{}[[ - $.name[имя_файла_для_download] - $.content-type[пользовательский content-type] + X^file::sql[[имя_файла_для_download]]{query} + !^file::sql{query}[[ + $.name[имя_файла_для_download] + $.content-type[пользовательский content-type] ]] - результат запроса должен быть "одна строка". - колонки: - первая колонка - данные - если есть вторая - это имя файла - если есть третья - это content-type + результат запроса должен быть "одна строка". + колонки: + первая колонка - данные + если есть вторая - это имя файла + если есть третья - это content-type !^файл.base64[] encode - !^file:base64[имя файла] encode - !^file::base64[encoded string] decode + !^file:base64[имя файла] + encode + !^file::base64[encoded string] + !^file::base64[mode;имя файла;encoded string[;$.content-type[...]]] + decode !^file:crc32[имя файла] - вычисляет crc32 файла с указанным именем + вычисляет crc32 файла с указанным именем !^файл.crc32[] - вычисляет crc32 объекта - !^файл.md5[] - !^file:md5[имя файла] + вычисляет crc32 объекта + !^файл.md5[] + !^file:md5[имя файла] выдает digest файла, длиной 16 байт в виде строки, где байты digest выданы в hex виде, впритык, в нижнем регистре @@ -824,12 +847,47 @@ odbc c:\drives\y\parser3project\odbc\deb !^math:crc32[string] вычисляет crc32 строки !^math:sha1[string] + !^math:convert[number](base-from;base-to) преобразует строку с числом из одной системы исчисления в другую !inet !^inet:ntoa(long) !^inet:aton[IP] +!json + !^json:parse[-json-строка-[; + $.depth(максимальная глубина, default == 19) + $.double(false) отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен) + в этом случае они попадут в результирующий объект как строки + $.distinct[first|last|all] как будет происходить разбор дублирующихся ключей у объектов + first -- будет оставлен первый встретившийся элемент + last -- будет оставлен последний встретившийся элемент + all -- будут оставлены все элементы. при этом элементы, начиная со 2 + получат числовые суффиксы (key_2 итд) + по умолчанию дублирующиеся ключи приведут к exception + $.object[method-junction] пользовательский метод[ключ;объект], которому будут передаваться все разобранные + объекты и ключи объекта, метод возвращает новый объект + $.array[method-junction] пользовательский метод, которому будут передаваться массивы + ]] + парсит json-строку в хэш + !^json:string[system or user object[; + $.skip-unknown(false) отключить exception и выдавать 'null' при сериализации объектов с типами + отличных от void, bool, string, int, double, date, table, hash и file + $.indent(true) форматировать результирующую строку табуляциями по глубине вложенности + $.date[sql-string|gmt-string|unix-timestamp] формат вывода даты, по умолчанию -- sql-string + $.table[object|array|compact] формат вывода таблицы, по умолчанию -- object + object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...] + array: [["c1","c2",...] || null (for nameless),["v11","v12",...],...] + compact: ["v11" || ["v11","v12",...],...] + $.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла + не попадает в output) + $.xdoc[hash] параметры преобразования xdoc в строку (как в ^xdoc.string[]) + $.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который + должен принимать 3 параметра: ключ, объект данного типа и опции + вызова ^json:string[] + ]] + сериализует системный или пользовательский объект в json-строку + !date !время типа time можно использовать в выражениях, подставляет @@ -840,6 +898,7 @@ odbc c:\drives\y\parser3project\odbc\deb $date:TZ наш часовой пояс, дробное, в часах (где-то есть с точностью до получаса) !^date::now[] !^date::now(смещение в днях) выдаёт сейчас+смещение + !^date::today[] дата на 00:00:00 текущего дня !^date::create(дней с epoch) // старое имя set !^date::create(year;month[;day[;hour[;minute[;second]]]]) // старое имя set !^date::create[дата в формате %Y-%m-%d %H:%M:%S] @@ -853,7 +912,10 @@ odbc c:\drives\y\parser3project\odbc\deb TZ="" << локальная зона !^дата.roll[year|month|day](+-смещение) сдвигает дату !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co - !^дата.sql-string[] %Y-%m-%d %H:%M:%S + !^дата.sql-string[[datetime|date|time]] + datetime или без параметра -- %Y-%m-%d %H:%M:%S + date -- %Y-%m-%d + time -- %H:%M:%S where published='^дата.sql-string[]' !^date:calendar[rus|eng](год;месяц) выдаёт неименованную таблицу столбцы: 0..6, week, year @@ -1095,7 +1157,7 @@ xdoc(xnode) !$status:memory hash !used - Includes some pages that were allocated but never written. + Includes some pages that were allocated but never written. !free @@ -1103,8 +1165,8 @@ xdoc(xnode) Return the number of bytes allocated since the last collection. !ever_allocated_since_start - Return the total number of bytes [EVER(c)PAF] allocated in this process. - Never decreases. + Return the total number of bytes [EVER(c)PAF] allocated in this process. + Never decreases. !$status:pid process id !$status:tid thread id