--- parser3/operators.txt 2010/10/13 11:33:19 1.233 +++ parser3/operators.txt 2015/09/04 23:11:28 1.245 @@ -91,10 +91,6 @@ Xне сделано, видимо, не будет сделано } } } - ^exit[] + - прекращяет обработку запроса. - удобно сделать после выставления 401 ошибки - ^return[результат] + - отваливает из выполнения метода, - выдавая нестандартный результат !^break[] + - обрывает цикл !^continue[] + - обрывает итерацию цикла !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html|regex|parser-code]]{код} @@ -336,6 +332,7 @@ odbc c:\drives\y\parser3project\odbc\deb !^строка.pos[подстрока](позиция, с которой ищем) <0 = не найдено !^строка.replace[$таблица_подстановок_строка_на_строку] + !^строка.replace[$что;$на-что] !^строка.save[[append;]путь] !^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]] !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены @@ -345,7 +342,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 в выражении @@ -373,7 +370,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{данные} @@ -546,9 +545,13 @@ odbc c:\drives\y\parser3project\odbc\deb !^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(максимально возможное число параметров) @@ -558,6 +561,7 @@ odbc c:\drives\y\parser3project\odbc\deb !^reflection:dynamical[[object or class, caller if absent]] возвращает true, если метод был вызван из динамического контекста при передаче параметра возвращает true, если передан динамический объект, false если класс + !^reflection:delete[класс или объект;имя переменной] удаляет переменную с указанным именем в указанном классе или объекте !mail @@ -746,10 +750,12 @@ odbc c:\drives\y\parser3project\odbc\deb !^файл.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;имя;data] - !^file::create[text;имя;data[;$.charset[кодировка букв в создаваемом файле]]] + !^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[имя файла] @@ -773,15 +779,16 @@ 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{}[[ + X^file::sql[[имя_файла_для_download]]{query} + !^file::sql{query}[[ $.name[имя_файла_для_download] $.content-type[пользовательский content-type] ]] @@ -853,22 +860,27 @@ odbc c:\drives\y\parser3project\odbc\deb last -- будет оставлен последний встретившийся элемент all -- будут оставлены все элементы. при этом элементы, начиная со 2 получат числовые суффиксы (key_2 итд) - по умолчанию дублирующиеся ключи приводыт к exception - $.object[method-junction] пользовательский метод, которому будут передаваться все разобранные пары - ключ/значение + по умолчанию дублирующиеся ключи приведут к 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] формат вывода таблицы, по умолчанию -- object + $.table[object|array|compact] формат вывода таблицы, по умолчанию -- object object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...] array: [["c1","c2",...] || null (for nameless),["v11","v12",...],...] - $.file[text|base64] вывести тело файла в указанном виде (по умолчание тело файла + compact: ["v11" || ["v11","v12",...],...] + $.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла не попадает в output) + $.xdoc[hash] параметры преобразования xdoc в строку (как в ^xdoc.string[]) $.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который - должен принимать 2 параметра: значение и параметры + должен принимать 3 параметра: ключ, объект данного типа и опции + вызова ^json:string[] ]] сериализует системный или пользовательский объект в json-строку @@ -876,14 +888,13 @@ odbc c:\drives\y\parser3project\odbc\deb !date !время типа time можно использовать в выражениях, подставляет количество дней с epoch [1 января 1970 (UTC)], дробное - !всё происходит в localtime, - !временная зона задаётся вне parser средствами OS - $date:UTC-offset сколько дней надо прибавить,чтобы попасть в local время - $date:TZ наш часовой пояс, дробное, в часах (где-то есть с точностью до получаса) + !строковое значение в местном времени, численное в UTC + !по умолчанию используется установленная средствами OS временная зона !^date::now[] !^date::now(смещение в днях) выдаёт сейчас+смещение - !^date::create(дней с epoch) // старое имя set - !^date::create(year;month[;day[;hour[;minute[;second]]]]) // старое имя set + !^date::today[] дата на 00:00:00 текущего дня + !^date::create(дней с epoch) + !^date::create(year;month[;day[;hour[;minute[;second]]]]) !^date::create[дата в формате %Y-%m-%d %H:%M:%S] для удобного создания по значению из базы формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] @@ -895,7 +906,11 @@ odbc c:\drives\y\parser3project\odbc\deb TZ="" << локальная зона !^дата.roll[year|month|day](+-смещение) сдвигает дату !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co - !^дата.sql-string[] %Y-%m-%d %H:%M:%S + !^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе + !^дата.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