Diff for /parser3/operators.ru.txt between versions 1.157 and 1.177

version 1.157, 2004/03/02 14:56:42 version 1.177, 2004/12/23 15:36:12
Line 88  Xне сделано, видимо, не будет сделано Line 88  Xне сделано, видимо, не будет сделано
         выдавая нестандартный результат          выдавая нестандартный результат
     X^break[] + - обрывает цикл      X^break[] + - обрывает цикл
     X^continue[] + - обрывает итерацию цикла      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          default as-is
     !^taint[[lang]][код]      !^taint[[lang]][код]
         default "just tainted, language unknown"          default "just tainted, language unknown"
Line 101  Xне сделано, видимо, не будет сделано Line 101  Xне сделано, видимо, не будет сделано
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]        по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}      !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?          !mysql://user:pass@{host[:port]|[/unix/socket]}/database?
               ClientCharset=parser-charset << charset in which parser thinks client works
             charset=cp1251_koi8&              charset=cp1251_koi8&
             timeout=3&              timeout=3&
             compress=1&              compress=1&
Line 109  Xне сделано, видимо, не будет сделано Line 110  Xне сделано, видимо, не будет сделано
             autocommit если выставить в 0, будет делать commit/rollback              autocommit если выставить в 0, будет делать commit/rollback
   
         !pgsql://user:pass@{host[:port]|[local]}/database?          !pgsql://user:pass@{host[:port]|[local]}/database?
             client_encoding=win,[to-find-out]&              client_encoding=win,[to-find-out]
             datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO              &datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO
               &ClientCharset=parser-charset << charset in which parser thinks client works
                   
         !oracle://user:pass@service?          !oracle://user:pass@service?
             NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251&              NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251&
Line 125  Xне сделано, видимо, не будет сделано Line 127  Xне сделано, видимо, не будет сделано
             ORA_ENCRYPT_LOGIN=TRUE              ORA_ENCRYPT_LOGIN=TRUE
             ClientCharset=parser-charset << charset in which parser thinks client works              ClientCharset=parser-charset << charset in which parser thinks client works
   
         !odbc://DSN=dsn^;UID=user^;PWD=password          !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset
               ClientCharset << charset in which parser thinks client works
   
         для работы connect нужно, чтобы заранее(рекомендуется в системном parser3)          для работы connect нужно, чтобы заранее(рекомендуется в системном parser3)
         была определена таблица          была определена таблица
Line 239  odbc    c:\drives\y\parser3project\odbc\ Line 242  odbc    c:\drives\y\parser3project\odbc\
         0          0
     !^имя.pos[...]      !^имя.pos[...]
         -1          -1
       !^void.left(n)
          ничего не выдаёт
       !^void.right(n)
          ничего не выдаёт
       !^void.mid(p[;n])
          ничего не выдаёт
     !^имя.int[]  (default)       !^имя.int[]  (default) 
         0 или default          0 или default
     !^имя.double[] (default)      !^имя.double[] (default)
         0 или default          0 или default
     !^void:sql{запрос без результата}      !^void:sql{запрос без результата}{$.bind[см. table::sql]}
   
   
 !int,double  !int,double
     !^имя.int[]  целочисленное значение       !^имя.int[]  целочисленное значение 
Line 254  odbc    c:\drives\y\parser3project\odbc\ Line 264  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 266  odbc    c:\drives\y\parser3project\odbc\ Line 276  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 307  odbc    c:\drives\y\parser3project\odbc\ Line 317  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]
   
 !table  !table
     в выражении       в выражении 
Line 321  odbc    c:\drives\y\parser3project\odbc\ Line 332  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 398  odbc    c:\drives\y\parser3project\odbc\ Line 413  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 670  odbc    c:\drives\y\parser3project\odbc\ Line 685  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{}[[options]] результат запроса должен быть "одна строка,одна колонка"      X^file::sql[[имя_файла_для_download]]{}
       !^file::sql{}[[
           $.name[имя_файла_для_download]
           $.content-type[пользовательский content-type]
       ]]
           результат запроса должен быть "одна строка".
           колонки:
           первая колонка - данные
           если есть вторая - это имя файла
           если есть третья - это content-type
   
   
 !math  !math
Line 731  odbc    c:\drives\y\parser3project\odbc\ Line 755  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 972  console Line 998  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 1004  console Line 1037  console
         операторов/методов, приведших к ошибке.          операторов/методов, приведших к ошибке.
   
 !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:  !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:
     !http://domain/document?params      !http://domain/document[?params<<deprecated, use $.form[...]]
     !а также, возможно, указать опции:      !а также, возможно, указать опции:
         !$.method[GET|HEAD]          !$.method[GET|POST|HEAD]
         !$.timeout(3)  << в секундах, по-умолчанию =2          !$.timeout(3)  << в секундах, по-умолчанию =2
         !$.headers[          !$.headers[
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК          !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]          !]
           $.enctype[multipart/form-data]
           $.form[
               !$.field1[string]
               !$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]
               $.field3[file]
           ]
           !$.body[string]
                   |file
         !по-умолчанию, user-agent=parser3          !по-умолчанию, user-agent=parser3
         !по-умолчанию, получение http status != 200 >> создает http.status ошибку,          !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
         !это можно отключить, передав          !это можно отключить, передав
         !$.any-status(1)          !$.any-status(1)
         !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ          !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ
           !$.user[пользователь]
           !$.password[пароль]
     !file::load в дополнительные поля записывает      !file::load в дополнительные поля записывает
         !ПОЛЕ:значение (имена полей ответа заглавными буквами)          !ПОЛЕ:значение (имена полей ответа заглавными буквами)
         !tables << хеш их ПОЛЕ->table с единственным столбцом "value".           !tables << хеш их ПОЛЕ->table с единственным столбцом "value". 
Line 1051  console Line 1094  console
           
 !нужно выключить русский apache: CharsetDisable on  !нужно выключить русский apache: CharsetDisable on
   
 !если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет  Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения      выдан список фрагментов результата с указанием их происхождения
   
   !если описание метода содержит локальную переменную result в явном виде
       (есть и неявная переменная)
       то код вывода строковых литералов не попадает в конечный байт-код,
       а непробельные символы считаются синтаксической ошибкой
       для вывода чего бы то ни было надо пользоваться этой переменной
   

Removed from v.1.157  
changed lines
  Added in v.1.177


E-mail: