--- parser3/operators.ru.txt 2004/03/05 10:16:49 1.163 +++ parser3/operators.ru.txt 2005/11/25 11:51:45 1.179 @@ -50,11 +50,14 @@ Xне сделано, видимо, не будет сделано %left '-' '+' %left '*' '/' '%' '\\' %left NEG /* negation: unary - */ + !литералы + true + false !^if(условие){когда да}{когда нет} !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}} - !^while(условие){тело} + !^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] !^use[модуль] !^try{ @@ -88,7 +91,7 @@ Xне сделано, видимо, не будет сделано выдавая нестандартный результат X^break[] + - обрывает цикл X^continue[] + - обрывает итерацию цикла - !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-html]]{код} + !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html]]{код} default as-is !^taint[[lang]][код] default "just tainted, language unknown" @@ -171,9 +174,11 @@ odbc c:\drives\y\parser3project\odbc\ !^cache[expires date] !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" !в пределе: ^cache(0) отменить кэширование + !^cache[] выдаёт текущую expires date X^cache[read] сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires",
выдаёт bool "получилось/нет" + !^sleep(seconds) Xесть глобальный флажок в свойствах/командной строке "не оптимизировать" @@ -252,7 +257,7 @@ odbc c:\drives\y\parser3project\odbc\ 0 или default !^имя.double[] (default) 0 или default - !^void:sql{запрос без результата} + !^void:sql{запрос без результата}{$.bind[см. table::sql]} !int,double @@ -264,7 +269,7 @@ odbc c:\drives\y\parser3project\odbc\ !^имя.div(на сколько /) !^имя.mod(на сколько %) !^имя.format[формат] - !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0}]] + !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] запрос, результат которого должен быть один столбец/одна строка !string @@ -276,7 +281,7 @@ odbc c:\drives\y\parser3project\odbc\ пример: ^if(def $form:name) не пуста? ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?] - !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a}]] + !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]] результат запроса должен быть один столбец/одна строка !^имя.int[] .int(default) целочисленное значение строки. если ломается преобразование, берётся default @@ -317,6 +322,9 @@ odbc c:\drives\y\parser3project\odbc\ состоит из большого числа фрагментов !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца default 'chars' -- whitespace chars + !^string.append[string] + !^string.base64[] encode + !^string:base64[encoded] decode !table в выражении @@ -331,7 +339,11 @@ odbc c:\drives\y\parser3project\odbc\ !пустые строки, и строки в первой колонке содержащие '#', игнорируются !$.separator[^#09] !$.encloser["] по-умолчанию, нет. - !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]] + !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]] + bind привязывает переменные в запросе к их значениям + пока реализован только для oracle + в запросе надо написать ":имя" + в параметре bind передать hash, из которого возьмётся(или куда запишется) значение !^таблица.save[[nameless|append;]путь[;опции, см. load]] !$таблица.поле !$таблица.fields из named таблицы выдаёт текущую запись как Hash @@ -408,11 +420,11 @@ odbc c:\drives\y\parser3project\odbc\ !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] пример: - $uids[^hashfile::open[/db/uids]] - - $random[23847387taduigh345XGHWElxjgdjg] - $uids.$random[$.value[$uid] $.expires(1)] - $uid[$persistent.logins.$random] + $sessions[^hashfile::open[/db/sessions]] + + $sid[^math:uuid[]] + $sessions.$sid[$.value[$uid] $.expires(1)] + $uid[$sessions.$sid] !form [берётся первый элемент из одноимённых из GET, потом первый из POST] @@ -426,6 +438,7 @@ odbc c:\drives\y\parser3project\odbc\ !env !$env:переменная + !$env:PARSER было то же самое, что показывается при запуске parser.cgi !cookie !$cookie:имя считать старое или свежезаданное @@ -458,6 +471,7 @@ odbc c:\drives\y\parser3project\odbc\ ! $attribute[zzz] field: abc; {attribute=zzz}<<часть !значение поля или атрибута может быть string или date ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" + !$response:headers накопленные поля !$response:body[DATA] замещает стандартный ответ !$response:download[DATA] замещает стандартный ответ, выставляет флаг, заставляющий browser предложить download @@ -653,6 +667,7 @@ odbc c:\drives\y\parser3project\odbc\ !^file:find[имя файла][{когда не нашли}] !^file:list[путь[;шаблон]] = table с колонкой name !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]] + !^file::create[text;имя;^untaint[xml]{data}] !$файл_который_был_loaded.size !^file::stat[имя файла] !$файл_который_был_stated.size !.adate !.mdate !.cdate @@ -680,13 +695,18 @@ odbc c:\drives\y\parser3project\odbc\ !^file:justext[/a/some.tar.gz]=gz !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif !^file.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать - !^file::sql[[имя_файла_для_download]]{} + X^file::sql[[имя_файла_для_download]]{} + !^file::sql{}[[ + $.name[имя_файла_для_download] + $.content-type[пользовательский content-type] + ]] результат запроса должен быть "одна строка". колонки: первая колонка - данные если есть вторая - это имя файла если есть третья - это content-type - + !^file.base64[] encode + !^file::base64[encoded string] decode !math !$math:PI @@ -746,6 +766,8 @@ odbc c:\drives\y\parser3project\odbc\ столбцы: year, month, day, weekday xdoc(xnode) + !$xdoc.search-namespaces hash, where keys=prefixes, values=urls + DOM1 attributes: !readonly attribute DocumentType doctype Xreadonly attribute DOMImplementation implementation @@ -987,7 +1009,14 @@ console !$console:line read/write строку -!DATA::=string | file +DATA::=string | file | hash + +!hash вида +[ + $.file[имя файла на диске] + $.name[имя файла для пользователя] + $.mdate[date] +] !MAIN это класс, загружаемый на автомате из parser3.conf, @@ -1019,18 +1048,28 @@ console операторов/методов, приведших к ошибке. !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла: - !http://domain/document?params + !http://domain/document[?params<> создает http.status ошибку, !это можно отключить, передав !$.any-status(1) !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ + !$.user[пользователь] + !$.password[пароль] !file::load в дополнительные поля записывает !ПОЛЕ:значение (имена полей ответа заглавными буквами) !tables << хеш их ПОЛЕ->table с единственным столбцом "value". @@ -1066,5 +1105,12 @@ console !нужно выключить русский apache: CharsetDisable on -!если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет +Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет выдан список фрагментов результата с указанием их происхождения + +!если описание метода содержит локальную переменную result в явном виде + (есть и неявная переменная) + то код вывода строковых литералов не попадает в конечный байт-код, + а непробельные символы считаются синтаксической ошибкой + для вывода чего бы то ни было надо пользоваться этой переменной +