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

version 1.178, 2005/02/17 14:54:51 version 1.193, 2007/04/20 10:30:34
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|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]][код]
Line 129  Xне сделано, видимо, не будет сделано Line 132  Xне сделано, видимо, не будет сделано
   
         !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset          !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset
             ClientCharset << charset in which parser thinks client works              ClientCharset << charset in which parser thinks client works
               
           !sqlite://database
   
         для работы connect нужно, чтобы заранее(рекомендуется в системном parser3)          для работы connect нужно, чтобы заранее(рекомендуется в системном parser3)
         была определена таблица          была определена таблица
 #sql drivers  #sql drivers
 $SQL[  $SQL[
     $.drivers[^table::set{protocol    driver    client      $.drivers[^table::create{protocol    driver    client
 mysql    /www/parser3/libparser3mysql.so    /usr/local/lib/mysql/libmysqlclient.so  mysql    /www/parser3/libparser3mysql.so    /usr/local/lib/mysql/libmysqlclient.so
 pgsql    /www/parser3/libparser3pgsql.so    /usr/local/pgsql/lib/libpq.so  pgsql    /www/parser3/libparser3pgsql.so    /usr/local/pgsql/lib/libpq.so
 oracle    /www/parser3/libparser3oracle.so    /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data  oracle    /www/parser3/libparser3oracle.so    /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data
   sqlite    /www/parser3/libparser3sqlite.so    /usr/local/sqlite/lib/sqlite3.so
 odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll  odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll
 }]  }]
 ]  ]
Line 171  odbc    c:\drives\y\parser3project\odbc\ Line 177  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 "получилось/нет"
Line 191  odbc    c:\drives\y\parser3project\odbc\ Line 198  odbc    c:\drives\y\parser3project\odbc\
     !есть глобальная строка/таблица $MAIN:CLASS_PATH с путём/путями к каталогу с классами.      !есть глобальная строка/таблица $MAIN:CLASS_PATH с путём/путями к каталогу с классами.
         !корень путя/путей считается от корня веб пространства.          !корень путя/путей считается от корня веб пространства.
     !2. ...относительно строчки из table $MAIN:CLASS_PATH, снизу вверх      !2. ...относительно строчки из table $MAIN:CLASS_PATH, снизу вверх
        задавайте её в parser3.conf вашего сайта         задавайте её в конфигурационном auto.p вашего сайта
   
     !глобальная табличка $CHARSETS[$.название[имя файла]]      !глобальная табличка $CHARSETS[$.название[имя файла]]
     !задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode      !задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode
Line 212  odbc    c:\drives\y\parser3project\odbc\ Line 219  odbc    c:\drives\y\parser3project\odbc\
     !$имя whitespace или ${имя}неважно  подстановка значения      !$имя whitespace или ${имя}неважно  подстановка значения
     !^имя параметры  вызов      !^имя параметры  вызов
     !$имя.CLASS класс значения      !$имя.CLASS класс значения
       !$имя.CLASS_NAME имя класса
     !$имя[$.key[] () {}]  конструктор элемента переменной-хэша $имя.key      !$имя[$.key[] () {}]  конструктор элемента переменной-хэша $имя.key
     !^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key      !^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key
     $CLASS.имя  обращение к переменной класса      $CLASS.имя  обращение к переменной класса
Line 253  odbc    c:\drives\y\parser3project\odbc\ Line 261  odbc    c:\drives\y\parser3project\odbc\
         0 или default          0 или default
     !^имя.double[] (default)      !^имя.double[] (default)
         0 или default          0 или default
       !^имя.bool[] + .bool(true|false)  bool значение
     !^void:sql{запрос без результата}{$.bind[см. table::sql]}      !^void:sql{запрос без результата}{$.bind[см. table::sql]}
   
   
 !int,double  !int,double
     !^имя.int[]  целочисленное значение       !^имя.int[]  целочисленное значение 
     !^имя.double[]+  double значение       !^имя.double[]+  double значение 
       !^имя.bool[] + .bool(true|false)  bool значение
     !^имя.inc(на сколько +)      !^имя.inc(на сколько +)
     !^имя.dec(на сколько -)      !^имя.dec(на сколько -)
     !^имя.mul(на сколько *)      !^имя.mul(на сколько *)
Line 282  odbc    c:\drives\y\parser3project\odbc\ Line 292  odbc    c:\drives\y\parser3project\odbc\
     !^имя.int[] .int(default) целочисленное значение строки.       !^имя.int[] .int(default) целочисленное значение строки. 
         если ломается преобразование, берётся default          если ломается преобразование, берётся default
     !^имя.double[]+ .double(default)  double значение строки      !^имя.double[]+ .double(default)  double значение строки
       !^имя.bool[] + .bool(default)  bool значение строки
         если ломается преобразование, берётся default          если ломается преобразование, берётся default
     !^имя.format[формат] %d  %.2f %02d...      !^имя.format[формат] %d  %.2f %02d...
     !^строка.match[шаблон][[опции поиска]]  $prematch $match $postmatch $1 $2...      !^строка.match[шаблон][[опции поиска]]  $prematch $match $postmatch $1 $2...
Line 292  odbc    c:\drives\y\parser3project\odbc\ Line 303  odbc    c:\drives\y\parser3project\odbc\
         m multiline = $ считается концом строки[\n], не концом всего текста          m multiline = $ считается концом строки[\n], не концом всего текста
         g найти все вхождения, а не одно          g найти все вхождения, а не одно
         ' создавать столбцы prematch, match, postmatch          ' создавать столбцы prematch, match, postmatch
           n вернуть цисло с количеством найденных совпадений, а не таблицу с резальтатами
     !^строка.match[шаблон][опции поиска]{замена}      !^строка.match[шаблон][опции поиска]{замена}
         опции поиска+=          опции поиска+=
         g заменить все вхождения, а не одно          g заменить все вхождения, а не одно
Line 319  odbc    c:\drives\y\parser3project\odbc\ Line 331  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.append[string]
       !^string.base64[] encode
       !^string:base64[encoded] decode
   
 !table  !table
     в выражении       в выражении 
Line 400  odbc    c:\drives\y\parser3project\odbc\ Line 414  odbc    c:\drives\y\parser3project\odbc\
   
 !hashfile  !hashfile
     !^hashfile::open[filename]      !^hashfile::open[filename]
     !^hashfile.clear[]  забыть всё      !^хешфайл.clear[]  забыть всё
     !.ключ[значение]  положить значение      !$хешфайл.ключ[значение]  положить значение
     !.ключ[$.value[значение] $.expires ЗНАЧЕНИЕ}      !$хешфайл.ключ[$.value[значение] $.expires ЗНАЧЕНИЕ}
       положить значение до expires        положить значение до expires
       значение поля expires может быть date, или число дней(0дней=на вечно)        значение поля expires может быть date, или число дней(0дней=на вечно)
     !.ключ  достать      !$хешфайл.ключ  достать
     !^delete[ключ]  удалить ключ      !^хешфайл.delete[ключ]  удалить ключ
     !^delete[]  удалить файлы, содержащие данные      !^хешфайл.delete[]  удалить файлы, содержащие данные
     !^hash[]      !^хешфайл.hash[]
         преобразовать в обычный hash          преобразовать в обычный hash
         попутно стирает устаревшие пары          попутно стирает устаревшие пары
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
       !^хешфайл.release[]
           записать данные и снять блокировки.
           при повторном обращении к элементам откроется автоматически.
       !^хешфайл.cleanup[]  пробежаться по всем элементам и удалить устаревшие.
   
     пример:      пример:
     $sessions[^hashfile::open[/db/sessions]]      $sessions[^hashfile::open[/db/sessions]]
Line 427  odbc    c:\drives\y\parser3project\odbc\ Line 445  odbc    c:\drives\y\parser3project\odbc\
     !$form:qtail = строка со значением текста после второго "?xxxxx", если там не было ',' [imap]      !$form:qtail = строка со значением текста после второго "?xxxxx", если там не было ',' [imap]
     !$form:fields = hash со всеми полями формы      !$form:fields = hash со всеми полями формы
     !$form:tables.поле = table с одним столбцом "field" со значениями "поля"      !$form:tables.поле = table с одним столбцом "field" со значениями "поля"
       !$form:files.поле = hash со значениями полей типа файл, ключи - 0, 1, ..., значение - файл
     !$form:imap = хэш с ключами 'x' и 'y'      !$form:imap = хэш с ключами 'x' и 'y'
         со значением ?1,2 приписки при использовании server-site image map          со значением ?1,2 приписки при использовании server-site image map
   
 !env  !env
     !$env:переменная      !$env:переменная
       !$env:PARSER было то же самое, что показывается при запуске parser.cgi
   
 !cookie  !cookie
     !$cookie:имя считать старое или свежезаданное      !$cookie:имя считать старое или свежезаданное
     !$cookie:имя[значение] на 90 дней      !$cookie:имя[значение] на 90 дней
     !$cookie:имя[$.value[значение]  $.expires ЗНАЧЕНИЕ ]      !$cookie:имя[$.value[значение]  $.expires[ЗНАЧЕНИЕ] $.secure(true)]
     !значение поля expires может быть 'session', date, или число дней(0дней=session)      !значение поля expires может быть 'session', date, или число дней(0дней=session)
     ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"      ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
       ! можно устанавливать bool свойства, например $.secure(true), $.httponly(true)
   
   
 !request  !request
     !$request:query          !$request:query    
Line 464  odbc    c:\drives\y\parser3project\odbc\ Line 486  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 553  odbc    c:\drives\y\parser3project\odbc\ Line 576  odbc    c:\drives\y\parser3project\odbc\
     !если body указан hash, то это части, будут собраны текстовые блоки, затем вложения      !если body указан hash, то это части, будут собраны текстовые блоки, затем вложения
     !это старый формат, поддерживается для обратной совместимости      !это старый формат, поддерживается для обратной совместимости
     !если имя части начинается со слова text, то это текстовый блок.      !если имя части начинается со слова text, то это текстовый блок.
     !если имя части начинается со слова attach, то это вложение, формат задания::      !если имя части начинается со слова file, то это вложение, формат задания::
         !$attach[$.format[!uue|Xbase64] $.value[DATA] $.file-name[user-file-name]]          !$file[$.format[!uue|!base64] $.value[DATA] $.name[user-file-name]]
     !важно: при multipart не указывать content-type      !важно: при multipart не указывать content-type
         ^mail:send[          ^mail:send[
 #           по-умолчанию, совпадает с source encoding.  #           по-умолчанию, совпадает с source encoding.
Line 582  odbc    c:\drives\y\parser3project\odbc\ Line 605  odbc    c:\drives\y\parser3project\odbc\
                     $.body[слова]                      $.body[слова]
                 ]                  ]
 #для удобства скриптования можно указать только одну часть, при этом не будет multipart  #для удобства скриптования можно указать только одну часть, при этом не будет multipart
                 $.attach[                  $.file[
                    $.value[^file::load[my beloved.doc]]                     $.value[^file::load[my beloved.doc]]
                    $.file-name[мой любимый.doc]                     $.name[мой любимый.doc]
                      $.format[base64]
                 ]                  ]
                 $.attach2[                  $.file2[
                    $.value[^file::load[my beloved.doc]]                     $.value[^file::load[my beloved.doc]]
                    $.file-name[мой любимый.doc]                     $.name[мой любимый.doc]
                ]                 ]
             ]              ]
         ]          ]
Line 659  odbc    c:\drives\y\parser3project\odbc\ Line 683  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 673  odbc    c:\drives\y\parser3project\odbc\ Line 698  odbc    c:\drives\y\parser3project\odbc\
         можно переименовывать и двигать каталоги[win32: но не через границу дисков]          можно переименовывать и двигать каталоги[win32: но не через границу дисков]
         каталоги для dest создаются с правами 775          каталоги для dest создаются с правами 775
         каталог старого файла стирается, если после move он остаётся пуст          каталог старого файла стирается, если после move он остаётся пуст
       !^file:copy[имя файла;имя копии файла] 
           можно копировать только файлы
     !^file:lock[имя файла]{код}      !^file:lock[имя файла]{код}
         файл при необходимости создаётся          файл при необходимости создаётся
         блокируется          блокируется
Line 696  odbc    c:\drives\y\parser3project\odbc\ Line 723  odbc    c:\drives\y\parser3project\odbc\
         первая колонка - данные          первая колонка - данные
         если есть вторая - это имя файла          если есть вторая - это имя файла
         если есть третья - это content-type          если есть третья - это content-type
       !^file.base64[] encode
       !^file:base64[имя файла] encode
       !^file::base64[encoded string] decode
       !^file:crc32[имя файла]
          вычисляет crc32 файла с указанным именем
       !^file.crc32[]
                   вычисляет crc32 объекта
           !^file.md5[]
           !^file:md5[имя файла]
           выдает digest файла, длиной 16 байт в виде строки, 
           где байты digest выданы в hex виде, впритык, в нижнем регистре
   
 !math  !math
     !$math:PI      !$math:PI
Line 725  odbc    c:\drives\y\parser3project\odbc\ Line 762  odbc    c:\drives\y\parser3project\odbc\
          если нет тела salt, оно создаётся случайным           если нет тела salt, оно создаётся случайным
        $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris].         $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris].
        другие salt читайте документацию по функции OS 'crypt'.         другие salt читайте документацию по функции OS 'crypt'.
       !^math:crc32[string]
          вычисляет crc32 строки
   
 !date  !date
     !время типа time можно использовать в выражениях, подставляет       !время типа time можно использовать в выражениях, подставляет 
Line 743  odbc    c:\drives\y\parser3project\odbc\ Line 782  odbc    c:\drives\y\parser3project\odbc\
         формат2: %H:%M[:%S]          формат2: %H:%M[:%S]
     !^date::unix-timestamp()      !^date::unix-timestamp()
     !^date.unix-timestamp[]      !^date.unix-timestamp[]
     !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ      !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ weekyear
         read-only          read-only
         TZ="" << локальная зона          TZ="" << локальная зона
     !^date.roll[year|month|day](+-смещение) сдвигает дату      !^date.roll[year|month|day](+-смещение) сдвигает дату
Line 787  xdoc(xnode) Line 826  xdoc(xnode)
     ::sql{...}      ::sql{...}
     !::create[[URI]]{<?xml?><string/>} старое имя 'set'      !::create[[URI]]{<?xml?><string/>} старое имя 'set'
     !::create[[URI]][qualifiedName]      !::create[[URI]][qualifiedName]
       !::create[file] can be usable: $f[^file::load[binary;http://;some http options here...]]$x[^xdoc::create[$f]]
       URI default = disk path to requested document        URI default = disk path to requested document
       для каталогов конечный / обязателен        для каталогов конечный / обязателен
     !::load[file.xml[;опции]]      !::load[file.xml[;опции]]
Line 1009  DATA::=string | file | hash Line 1049  DATA::=string | file | hash
 ]  ]
   
 !MAIN  !MAIN
     это класс, загружаемый на автомате из parser3.conf,       это класс, загружаемый на автомате из конфигурационного auto.p, 
     кучи auto.p и запрашиваемого документа:      кучи auto.p и запрашиваемого документа:
         !parser3.conf           !конфигурационный auto.p 
             cgi:               cgi: 
                 1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG                  1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG
                    или рядом с бинарником parser'а                      или рядом с бинарником parser'а 
Line 1023  DATA::=string | file | hash Line 1063  DATA::=string | file | hash
     имя последнего загруженного MAIN, имён у предыдущих нет      имя последнего загруженного MAIN, имён у предыдущих нет
           
     !после загрузки MAIN класса вызывается его @main[]      !после загрузки MAIN класса вызывается его @main[]
     !результат которого передаётся в его @post-process[data] if($data is string) ...      !результат которого передаётся в его @postprocess[data] if($data is string) ...
     !результат которого отдаётся пользователю      !результат которого отдаётся пользователю
   
 !если встречается ошибка и try не задан, её можно красиво сообщить пользователю,   !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, 

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


E-mail: