--- parser3/operators.txt 2002/02/22 10:13:41 1.13 +++ parser3/operators.txt 2002/03/25 10:27:20 1.22 @@ -49,14 +49,39 @@ Xне сделано, видимо, не будет сделано !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}} !^while(условие){тело} !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] - X^exit[] + - прекращяет обработку запроса. + !^use[модуль] + !^try{ + ... + !^throw[sql.connect;вася;болван] // был ^error[текст] + ... + }{ + ^if($exception.type eq sql){ + $exception.handled(1) ^rem{флаг, что exception обработан} + .... + } + + ^switch($exception.type){ + ^case[sql;mail]{ + $exception.handled(1) + код, обрабатывающий sql ошибку + $exception.type = sql.connect + $exception.file $exception.lineno [если не запрещены при компиляции] + $exception.source = вася + $exception.comment = болван + ^if($exception.type eq connect){^cache[read]} + } + ^case[_default]{ + код, обрабатывающий другую ошибку + ^throw[$exception] << re-throw + } + } + } + ^exit[] + - прекращяет обработку запроса. удобно сделать после выставления 401 ошибки - X^return[результат] + - отваливает из выполнения метода, + ^return[результат] + - отваливает из выполнения метода, выдавая нестандартный результат - X^break[] + - обрывает цикл - X^continue[] + - обрывает итерацию цикла - !^use[модуль] - X^try{код}{...catch...} пока не придумал, как лучше + ^break[] + - обрывает цикл + ^continue[] + - обрывает итерацию цикла !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-html]]{код} default as-is !^taint[[lang]][код] @@ -69,9 +94,11 @@ Xне сделано, видимо, не будет сделано compress=1& named_pipe=1 - !pgsql://user:pass@{host[:port]|[local]}/database + !pgsql://user:pass@{host[:port]|[local]}/database? + client_encoding=win,[to-find-out]& + datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO - oracle://user:pass@service? + !oracle://user:pass@service? NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251& NLS_LANGUAGE language-dependent conventions NLS_TERRITORY territory-dependent conventions @@ -114,10 +141,15 @@ odbc c:\drives\y\parser3project\odbc\ ставить такой префикс перед открывающим апострофом, впритык, везде без проблелов /**имя_поля**/'literal' !^rem{} - !^error[текст] !^cache[файл](секунд){код} !скэшировать строку, которая получается при выполнении кода на 'секунд' секунд !если 0секунд, значит не кэшировать, а старый такой стереть + ^cache[delete] + сигнализирует вышестоящему ^cache "не кэшировать, старое забыть" + ^cache[read] + сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires",
+ выдаёт bool "получилось/нет" + Xесть глобальный флажок в свойствах/командной строке "не оптимизировать" !и есть исключение: ^untaint[html]{код} не оптимизируется безотностительно флажка @@ -213,15 +245,15 @@ odbc c:\drives\y\parser3project\odbc\ если ломается преобразование, берётся default !^имя.format[формат] %d %.2f %02d... !^строка.match[шаблон][[опции поиска]] $prematch $match $postmatch $1 $2... - опции поиска= - i CASELESS - x whitespace in regex ignored - s singleline = $ считается концом всего текста - m multiline = $ считается концом строки[\n], не концом всего текста - g найти все вхождения, а не одно + опции поиска= + i CASELESS + x whitespace in regex ignored + s singleline = $ считается концом всего текста + m multiline = $ считается концом строки[\n], не концом всего текста + g найти все вхождения, а не одно !^строка.match[шаблон][опции поиска]{замена} - опции поиска+= - g заменить все вхождения, а не одно + опции поиска+= + g заменить все вхождения, а не одно !^строка.{l|r}split[разделитель] таблица из столбца $piece !^строка.upper|lower[] X^строка.truncate(предел терпенья) стиль :( @@ -241,7 +273,7 @@ odbc c:\drives\y\parser3project\odbc\ числовое значение равно count[] !^table::create[[nameless]]{данные} старое имя "set" !^table::create[table] - клонирует таблицу + клонирует таблицу !^table::load[[nameless;]путь] !если не nameless, названия колонок берутся из первой строки !пустые строки, и строки в первой колонке содержащие '#', игнорируются @@ -265,7 +297,8 @@ odbc c:\drives\y\parser3project\odbc\ !^таблица.join[таблица] - добавляет записи из таблицы. таблицы должны иметь одинаковую структуру. !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать - !^таблица.locate[поле;значение] выдаёт bool + !^таблица.locate[поле;значение] передвигает текущую строку, если найдёт. выдаёт bool + !^таблица.locate(логическое выражение) передвигает текущую строку, если найдёт. выдаёт bool !^таблица.hash[поле, что будет ключом][[поле значений|table поля значений]]+ значением $hash.ключ будет hash в котором поля значений будут ключами поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой @@ -284,7 +317,9 @@ odbc c:\drives\y\parser3project\odbc\ перезаписывает одноимённые !^hash.sub[вычитаемое] !^a.union[b] = объединение + одноимённые остаются !^a.intersection[b] = пересечение + значения a !^a.intersects[b] = bool !^hash::sql{запрос}[[$.limit(2) $.offset(4)]] получается hash(ключи=значения первая колонка ответа) @@ -306,7 +341,7 @@ odbc c:\drives\y\parser3project\odbc\ !cookie !$cookie:имя считать старое или свежезаданное !$cookie:имя[значение] на 90 дней - !$cookie:имя[$.value[значение] $.expires(дней) или $.expires[session]] + !$cookie:имя[$.value[значение] $.expires(дней, 0дней=session)] !request !$request:query @@ -327,6 +362,7 @@ odbc c:\drives\y\parser3project\odbc\ ! $value[abc] field: {abc}<<часть ! $attribute[zzz] field: abc; {attribute=zzz}<<часть !$response:body[DATA] замещает стандартный ответ + !$response:status !^response:clear[] забыть все заданные response поля !$response:charset кодировка клиента т.е. та, @@ -415,12 +451,15 @@ Xhashfile ] ] ] - !для отправки используется программа с параметрами, задаваемая - $MAIL.sendmail[команда] - если не будет задана, проверяется, доступна ли - /usr/sbin/sendmail или + !для отправки + под unix используется программа с параметрами, задаваемая + $MAIL.sendmail[команда] + если не будет задана, проверяется, доступна ли + /usr/sbin/sendmail или /usr/lib/sendmail - и, если доступна, то запускается с параметром "-t". + и, если доступна, то запускается с параметром "-t". + под win32 используется SMTP протокол, сервер задаётся + $MAIL.SMTP[smtp.domain.ru] !image !$картинка[^image::measure[DATA]] @@ -483,10 +522,10 @@ Xhashfile каталоги для dest создаются с правами 775 каталог старого файла стирается, если после move он остаётся пуст !^file:lock[имя файла]{код} - файл при необходимости создаётся - блокируется - выполняется код - разблокируется + файл при необходимости создаётся + блокируется + выполняется код + разблокируется !math !$math:PI @@ -501,7 +540,7 @@ Xhashfile !date !время типа time можно использовать в выражениях, подставляет - количество дней с epoch [1 января 1970 (UTC)], дробное + количество дней с epoch [1 января 1970 (UTC)], дробное !всё происходит в localtime, !временная зона задаётся вне parser средствами OS !^date::now[] @@ -511,8 +550,10 @@ Xhashfile !^date.roll[year|month|day](+/- 1) сдвигает дату !^date.sql-string[] %Y-%m-%d %H:%M:%S where published='$дата.sql-string[]' - !^date:calendar[rus|eng;год;месяц] выдаёт таблицу - !^date:calendar[rus|eng;год;месяц;день] выдаёт таблицу + !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу + столбцы: 0..6 + !^date:calendar[rus|eng;год;месяц;день] выдаёт именнованную таблицу + столбцы: year, month, day, weekday xdoc(xnode) DOM1 attributes: @@ -566,7 +607,7 @@ xdoc(xnode) !.save[file.xml;output options] с шапкой !.file[output options] = file output options идентичны атрибутам xsl:output - [исключение: игнорируется cdata-section-elements, нужно будет, сделаю] + [исключение: игнорируется cdata-section-elements, нужно будет, сделаю] выдаёт media-type при подстановке $response:body[сюда] @@ -642,7 +683,7 @@ xdoc(xnode) !XPath: !^node.select[xpath/query/expression] = array of nodes, - empty array if nothing found + empty array if nothing found !^node.selectSingle[xpath/query/expression] = first node if any !^node.selectBool[xpath/query/expression] = bool if any !^node.selectNumber[xpath/query/expression] = double if any @@ -714,12 +755,12 @@ xdoc(xnode) file !$status:rusage hash - !utime user time used - !stime system time used - !maxrss max resident set size - !ixrss integral shared text memory size - !idrss integral unshared data size - !isrss integral unshared stack size + !utime user time used + !stime system time used + !maxrss max resident set size + !ixrss integral shared text memory size + !idrss integral unshared data size + !isrss integral unshared stack size !MAIN это класс, загружаемый на автомате из parser3.conf, @@ -741,16 +782,15 @@ xdoc(xnode) !результат которого передаётся в его @post-process[data] if($data is string) ... !результат которого отдаётся пользователю - !если встречается ошибка, её можно красиво сообщить пользователю, + !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, !определив - !@exception[origin;source;comment;type;code;stack] - !origin файл(строка) где случилась проблема - !source строка, из-за которой случилась проблема - !comment комментарий english - !type строка "тип проблемы" (пока пусто) - !code строка "код проблемы" (пока пусто) - !stack табличка из колонок origin name, - там лежат в обратном порядке имена[name] и места вызовов[origin] + !@unhandled_exception[exception;stack] + !$exception.type строка "тип проблемы" + !$exception.file $exception.lineno файл и строка где случилась проблема [если не запрещены при компиляции] + !$exception.source строка, из-за которой случилась проблема + !$exception.comment комментарий english + !stack табличка из колонок file line name, + там лежат в обратном порядке имена[name] и места вызовов[file line] операторов/методов, приведших к ошибке. !нужно выключить русский apache: CharsetDisable on