Diff for /parser3/operators.ru.txt between versions 1.151 and 1.178

version 1.151, 2004/02/26 14:37:30 version 1.178, 2005/02/17 14:54:51
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"
     ^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[      !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[
         $.main[во что переименовать @main]          $.main[во что переименовать @main]
         $.file[имя файла из которого, якобы, данный текст]          $.file[имя файла из которого, якобы, данный текст]
         $.lineno(номер строки в файле, откуда данный текст. можно отрицательный)           $.lineno(номер строки в файле, откуда данный текст. можно отрицательный) 
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 171  odbc    c:\drives\y\parser3project\odbc\ Line 174  odbc    c:\drives\y\parser3project\odbc\
     X^cache[read]       X^cache[read] 
         сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", <br>          сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", <br>
         выдаёт bool "получилось/нет"          выдаёт bool "получилось/нет"
           !^sleep(seconds)
   
   
     Xесть глобальный флажок в свойствах/командной строке "не оптимизировать"      Xесть глобальный флажок в свойствах/командной строке "не оптимизировать"
Line 239  odbc    c:\drives\y\parser3project\odbc\ Line 243  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 265  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 277  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 305  odbc    c:\drives\y\parser3project\odbc\ Line 316  odbc    c:\drives\y\parser3project\odbc\
     !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены      !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены
         полезно делать перед сложными match операциями, если вы знаете, что входная строка          полезно делать перед сложными match операциями, если вы знаете, что входная строка
         состоит из большого числа фрагментов          состоит из большого числа фрагментов
       !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца
           default 'chars' -- whitespace chars
       !^string.append[string]
   
 !table  !table
     в выражении       в выражении 
Line 319  odbc    c:\drives\y\parser3project\odbc\ Line 333  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 375  odbc    c:\drives\y\parser3project\odbc\ Line 393  odbc    c:\drives\y\parser3project\odbc\
     !^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]      !^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]
         получается hash(ключи=значения первая колонка ответа)          получается hash(ключи=значения первая колонка ответа)
         of hash(ключи=названия остальных колонкок ответа)          of hash(ключи=названия остальных колонкок ответа)
     !^hash._keys[]+ таблица из одного столбца $key      !^hash._keys[[название колонки с ключами]]+ таблица из одного столбца $key или как передадут
     !^hash._count[]      !^hash._count[]
     !^foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^delete[ключ]  удалить ключ      !^delete[ключ]  удалить ключ
Line 396  odbc    c:\drives\y\parser3project\odbc\ Line 414  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 629  odbc    c:\drives\y\parser3project\odbc\ Line 647  odbc    c:\drives\y\parser3project\odbc\
         определяющее прожорливость выделялки цветов из палитры [default=150]          определяющее прожорливость выделялки цветов из палитры [default=150]
             меньше - точнее приближает цвета, но они быстро кончаются              меньше - точнее приближает цвета, но они быстро кончаются
             больше - неточно приближает цвет, но бОльшей части хватит              больше - неточно приближает цвет, но бОльшей части хватит
       !^картинка.pixel(x;y)[(color)]
           узнать или задать цвет пиксела
   
 !file  !file
     !$файл_из_post.name       !$файл_из_post.name 
Line 665  odbc    c:\drives\y\parser3project\odbc\ Line 685  odbc    c:\drives\y\parser3project\odbc\
     !^file:justname[/a/some.tar.gz]=some.tar      !^file:justname[/a/some.tar.gz]=some.tar
     !^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 строку, которую можно в запрос отдать
       X^file::sql[[имя_файла_для_download]]{}
       !^file::sql{}[[
           $.name[имя_файла_для_download]
           $.content-type[пользовательский content-type]
       ]]
           результат запроса должен быть "одна строка".
           колонки:
           первая колонка - данные
           если есть вторая - это имя файла
           если есть третья - это content-type
   
   
 !math  !math
Line 725  odbc    c:\drives\y\parser3project\odbc\ Line 756  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 966  console Line 999  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 998  console Line 1038  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 1045  console Line 1095  console
           
 !нужно выключить русский apache: CharsetDisable on  !нужно выключить русский apache: CharsetDisable on
   
 !если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет  Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения      выдан список фрагментов результата с указанием их происхождения
   
   !если описание метода содержит локальную переменную result в явном виде
       (есть и неявная переменная)
       то код вывода строковых литералов не попадает в конечный байт-код,
       а непробельные символы считаются синтаксической ошибкой
       для вывода чего бы то ни было надо пользоваться этой переменной
   

Removed from v.1.151  
changed lines
  Added in v.1.178


E-mail: