Diff for /parser3/operators.ru.txt between versions 1.168 and 1.181

version 1.168, 2004/03/10 10:04:30 version 1.181, 2006/06/09 18:59:42
Line 50  Xне сделано, видимо, не будет сделано Line 50  Xне сделано, видимо, не будет сделано
            %left '-' '+'             %left '-' '+'
            %left '*' '/' '%' '\\'             %left '*' '/' '%' '\\'
            %left NEG     /* negation: unary - */             %left NEG     /* negation: unary - */
           !литералы
              true
              false
   
                         
     !^if(условие){когда да}{когда нет}      !^if(условие){когда да}{когда нет}
     !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}}      !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}}
     !^while(условие){тело}      !^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^use[модуль]      !^use[модуль]
     !^try{      !^try{
Line 86  Xне сделано, видимо, не будет сделано Line 89  Xне сделано, видимо, не будет сделано
         удобно сделать после выставления 401 ошибки          удобно сделать после выставления 401 ошибки
     ^return[результат] + - отваливает из выполнения метода,       ^return[результат] + - отваливает из выполнения метода, 
         выдавая нестандартный результат          выдавая нестандартный результат
     X^break[] + - обрывает цикл      !^break[] + - обрывает цикл
     X^continue[] + - обрывает итерацию цикла      !^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          default as-is
     !^taint[[lang]][код]      !^taint[[lang]][код]
         default "just tainted, language unknown"          default "just tainted, language unknown"
Line 171  odbc    c:\drives\y\parser3project\odbc\ Line 174  odbc    c:\drives\y\parser3project\odbc\
     !^cache[expires date]      !^cache[expires date]
         !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'"          !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'"
         !в пределе: ^cache(0) отменить кэширование          !в пределе: ^cache(0) отменить кэширование
       !^cache[] выдаёт текущую expires date
     X^cache[read]       X^cache[read] 
         сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", <br>          сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", <br>
         выдаёт bool "получилось/нет"          выдаёт bool "получилось/нет"
           !^sleep(seconds)
   
   
     Xесть глобальный флажок в свойствах/командной строке "не оптимизировать"      Xесть глобальный флажок в свойствах/командной строке "не оптимизировать"
Line 252  odbc    c:\drives\y\parser3project\odbc\ Line 257  odbc    c:\drives\y\parser3project\odbc\
         0 или default          0 или default
     !^имя.double[] (default)      !^имя.double[] (default)
         0 или default          0 или default
     !^void:sql{запрос без результата}      !^void:sql{запрос без результата}{$.bind[см. table::sql]}
   
   
 !int,double  !int,double
Line 264  odbc    c:\drives\y\parser3project\odbc\ Line 269  odbc    c:\drives\y\parser3project\odbc\
     !^имя.div(на сколько /)      !^имя.div(на сколько /)
     !^имя.mod(на сколько %)      !^имя.mod(на сколько %)
     !^имя.format[формат]      !^имя.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  !string
Line 276  odbc    c:\drives\y\parser3project\odbc\ Line 281  odbc    c:\drives\y\parser3project\odbc\
         пример:          пример:
         ^if(def $form:name) не пуста?          ^if(def $form:name) не пуста?
         ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?]          ^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) целочисленное значение строки.       !^имя.int[] .int(default) целочисленное значение строки. 
         если ломается преобразование, берётся default          если ломается преобразование, берётся default
Line 317  odbc    c:\drives\y\parser3project\odbc\ Line 322  odbc    c:\drives\y\parser3project\odbc\
         состоит из большого числа фрагментов          состоит из большого числа фрагментов
     !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца      !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца
         default 'chars' -- whitespace chars          default 'chars' -- whitespace chars
       !^string.append[string]
       !^string.base64[] encode
       !^string:base64[encoded] decode
   
 !table  !table
     в выражении       в выражении 
Line 331  odbc    c:\drives\y\parser3project\odbc\ Line 339  odbc    c:\drives\y\parser3project\odbc\
         !пустые строки, и строки в первой колонке содержащие '#', игнорируются                  !пустые строки, и строки в первой колонке содержащие '#', игнорируются        
         !$.separator[^#09]          !$.separator[^#09]
         !$.encloser["] по-умолчанию, нет.          !$.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]]      !^таблица.save[[nameless|append;]путь[;опции, см. load]]
     !$таблица.поле      !$таблица.поле
     !$таблица.fields  из named таблицы выдаёт текущую запись как Hash      !$таблица.fields  из named таблицы выдаёт текущую запись как Hash
Line 408  odbc    c:\drives\y\parser3project\odbc\ Line 420  odbc    c:\drives\y\parser3project\odbc\
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
   
     пример:      пример:
     $uids[^hashfile::open[/db/uids]]      $sessions[^hashfile::open[/db/sessions]]
          
     $random[23847387taduigh345XGHWElxjgdjg]      $sid[^math:uuid[]]
     $uids.$random[$.value[$uid] $.expires(1)]      $sessions.$sid[$.value[$uid] $.expires(1)]
     $uid[$persistent.logins.$random]      $uid[$sessions.$sid]
   
 !form  !form
     [берётся первый элемент из одноимённых из GET, потом первый из POST]      [берётся первый элемент из одноимённых из GET, потом первый из POST]
Line 426  odbc    c:\drives\y\parser3project\odbc\ Line 438  odbc    c:\drives\y\parser3project\odbc\
   
 !env  !env
     !$env:переменная      !$env:переменная
       !$env:PARSER было то же самое, что показывается при запуске parser.cgi
   
 !cookie  !cookie
     !$cookie:имя считать старое или свежезаданное      !$cookie:имя считать старое или свежезаданное
Line 458  odbc    c:\drives\y\parser3project\odbc\ Line 471  odbc    c:\drives\y\parser3project\odbc\
         ! $attribute[zzz] field: abc; {attribute=zzz}<<часть          ! $attribute[zzz] field: abc; {attribute=zzz}<<часть
         !значение поля или атрибута может быть string или date          !значение поля или атрибута может быть string или date
         ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"          ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
       !$response:headers накопленные поля
     !$response:body[DATA]  замещает стандартный ответ      !$response:body[DATA]  замещает стандартный ответ
     !$response:download[DATA]  замещает стандартный ответ,       !$response:download[DATA]  замещает стандартный ответ, 
         выставляет флаг, заставляющий browser предложить download          выставляет флаг, заставляющий browser предложить download
Line 548  odbc    c:\drives\y\parser3project\odbc\ Line 562  odbc    c:\drives\y\parser3project\odbc\
     !это старый формат, поддерживается для обратной совместимости      !это старый формат, поддерживается для обратной совместимости
     !если имя части начинается со слова text, то это текстовый блок.      !если имя части начинается со слова text, то это текстовый блок.
     !если имя части начинается со слова attach, то это вложение, формат задания::      !если имя части начинается со слова attach, то это вложение, формат задания::
         !$attach[$.format[!uue|Xbase64] $.value[DATA] $.file-name[user-file-name]]          !$attach[$.format[!uue|!base64] $.value[DATA] $.file-name[user-file-name]]
     !важно: при multipart не указывать content-type      !важно: при multipart не указывать content-type
         ^mail:send[          ^mail:send[
 #           по-умолчанию, совпадает с source encoding.  #           по-умолчанию, совпадает с source encoding.
Line 653  odbc    c:\drives\y\parser3project\odbc\ Line 667  odbc    c:\drives\y\parser3project\odbc\
     !^file:find[имя файла][{когда не нашли}]      !^file:find[имя файла][{когда не нашли}]
     !^file:list[путь[;шаблон]] = table с колонкой name      !^file:list[путь[;шаблон]] = table с колонкой name
     !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]]      !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]]
       !^file::create[text;имя;^untaint[xml]{data}]
     !$файл_который_был_loaded.size      !$файл_который_был_loaded.size
     !^file::stat[имя файла]      !^file::stat[имя файла]
     !$файл_который_был_stated.size !.adate !.mdate !.cdate      !$файл_который_был_stated.size !.adate !.mdate !.cdate
Line 680  odbc    c:\drives\y\parser3project\odbc\ Line 695  odbc    c:\drives\y\parser3project\odbc\
     !^file:justext[/a/some.tar.gz]=gz      !^file:justext[/a/some.tar.gz]=gz
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif      !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif
     !^file.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать      !^file.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать
     !^file::sql[[имя_файла_для_download]]{}      X^file::sql[[имя_файла_для_download]]{}
       !^file::sql{}[[
           $.name[имя_файла_для_download]
           $.content-type[пользовательский content-type]
       ]]
         результат запроса должен быть "одна строка".          результат запроса должен быть "одна строка".
         колонки:          колонки:
         первая колонка - данные          первая колонка - данные
         если есть вторая - это имя файла          если есть вторая - это имя файла
         если есть третья - это content-type          если есть третья - это content-type
       !^file.base64[] encode
       !^file::base64[encoded string] decode
   
 !math  !math
     !$math:PI      !$math:PI
Line 746  odbc    c:\drives\y\parser3project\odbc\ Line 766  odbc    c:\drives\y\parser3project\odbc\
         столбцы: year, month, day, weekday          столбцы: year, month, day, weekday
           
 xdoc(xnode)  xdoc(xnode)
       !$xdoc.search-namespaces hash, where keys=prefixes, values=urls
       
     DOM1 attributes:      DOM1 attributes:
     !readonly attribute DocumentType doctype      !readonly attribute DocumentType doctype
     Xreadonly attribute DOMImplementation implementation      Xreadonly attribute DOMImplementation implementation
Line 887  xdoc(xnode) Line 909  xdoc(xnode)
     !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName);      !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName);
   
     !XPath:      !XPath:
     !^node.select[xpath/query/expression][[namespaces]] = array of nodes,       !^node.select[xpath/query/expression] = array of nodes, 
         empty array if nothing found          empty array if nothing found
     !^node.selectSingle[xpath/query/expression][[namespaces]] = first node if any      !^node.selectSingle[xpath/query/expression] = first node if any
     !^node.selectBool[xpath/query/expression][[namespaces]] = bool if any or die      !^node.selectBool[xpath/query/expression] = bool if any or die
     !^node.selectNumber[xpath/query/expression][[namespaces]] = double if any or die      !^node.selectNumber[xpath/query/expression] = double if any or die
     !^node.selectString[xpath/query/expression][[namespaces]] = string if any or die      !^node.selectString[xpath/query/expression] = string if any or die
         ![[namespaces]] hash, where keys=prefixes, values=urls  
   
     !error codes(пока придут как текст в случае соответствующих ошибок):      !error codes(пока придут как текст в случае соответствующих ошибок):
         INDEX_SIZE_ERR          INDEX_SIZE_ERR
Line 988  console Line 1009  console
     !$console:line      !$console:line
         read/write строку          read/write строку
   
 !DATA::=string | file  DATA::=string | file | hash
   
   !hash вида
   [
           $.file[имя файла на диске]
           $.name[имя файла для пользователя]
           $.mdate[date]
   ]
   
 !MAIN  !MAIN
     это класс, загружаемый на автомате из parser3.conf,       это класс, загружаемый на автомате из parser3.conf, 
Line 1077  console Line 1105  console
           
 !нужно выключить русский apache: CharsetDisable on  !нужно выключить русский apache: CharsetDisable on
   
 !если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет  Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения      выдан список фрагментов результата с указанием их происхождения
   
   !если описание метода содержит локальную переменную result в явном виде
       (есть и неявная переменная)
       то код вывода строковых литералов не попадает в конечный байт-код,
       а непробельные символы считаются синтаксической ошибкой
       для вывода чего бы то ни было надо пользоваться этой переменной
   

Removed from v.1.168  
changed lines
  Added in v.1.181


E-mail: