--- parser3/operators.ru.txt	2002/12/06 17:27:34	1.106
+++ parser3/operators.ru.txt	2003/11/03 13:20:30	1.123
@@ -92,7 +92,8 @@ Xне сделано, видимо, не будет сделано
         default as-is
     !^taint[[lang]][код]
         default "just tainted, language unknown"
-    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}
+    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[во что переименовать @main]
+    !^process..[путь][во что переименовать @main]
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?
@@ -271,6 +272,7 @@ odbc    c:\drives\y\parser3project\odbc\
         s singleline = $ считается концом всего текста
         m multiline = $ считается концом строки[\n], не концом всего текста
         g найти все вхождения, а не одно
+        ' создавать столбцы prematch, match, postmatch
     !^строка.match[шаблон][опции поиска]{замена}
         опции поиска+=
         g заменить все вхождения, а не одно
@@ -301,11 +303,14 @@ odbc    c:\drives\y\parser3project\odbc\
         логическое значение равно "не пуста?"
         числовое значение равно count[]
     !^table::create[[nameless]]{данные} старое имя "set"
-    !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur]]]
+    !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
         клонирует таблицу    
+        reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает)
     !^table::load[[nameless;]путь[;опции]]
         !если не nameless, названия колонок берутся из первой строки
         !пустые строки, и строки в первой колонке содержащие '#', игнорируются        
+        !$.column-separator[^#09]
+        !$.column-encloser["]
     !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]]
     !^таблица.save[[nameless|append;]путь]
     !$таблица.поле
@@ -326,11 +331,15 @@ odbc    c:\drives\y\parser3project\odbc\
     !^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]]     - добавляет записи из таблицы. 
         таблицы должны иметь одинаковую структуру.
     !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать
-    !^таблица.locate[поле;значение] передвигает текущую строку, если найдёт. выдаёт bool
-    !^таблица.locate(логическое выражение) передвигает текущую строку, если найдёт. выдаёт bool
-    !^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1)]]
+    !^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] 
+        передвигает текущую строку, если найдёт. выдаёт bool
+    !^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
+        передвигает текущую строку, если найдёт. выдаёт bool
+    !^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1) $.distinct[tables]]]
         значением $hash.ключ будет hash в котором поля значений будут ключами
         поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой
+        если distinct содержит true, то не будет ошибки при повторяющихся ключах
+        если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом
     !^таблица.columns[]+ таблица из одного столбца $column
     !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало
         $adults[^man.select($man.age>=18)]
@@ -379,12 +388,17 @@ odbc    c:\drives\y\parser3project\odbc\
 !cookie
     !$cookie:имя считать старое или свежезаданное
     !$cookie:имя[значение] на 90 дней
-    !$cookie:имя[$.value[значение]  $.expires(дней, 0дней=session)]
+    !$cookie:имя[$.value[значение]  $.expires ЗНАЧЕНИЕ ]
+    !значение поля expires может быть 'session', date, или число дней(0дней=session)
+    ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
 
 !request
     !$request:query    
     !$request:body unprocessed POST request body
     !$request:uri
+    !$request:document-root
+        каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT
+        можно изменить, если на hosting что-то неудобно настроено
     X!$request:browser  это hash, поля:
         !$type = ie/nn и !$version = номер, скажем 5.5       
     X$request:user
@@ -403,6 +417,8 @@ odbc    c:\drives\y\parser3project\odbc\
         !значение поля или атрибута может быть string или date
         ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
     !$response:body[DATA]  замещает стандартный ответ
+    !$response:download[DATA]  замещает стандартный ответ, 
+    	выставляет флаг, заставляющий browser предложить download
     !$response:status
     !^response:clear[] забыть все заданные response поля
     !$response:charset
@@ -594,7 +610,8 @@ Xhashfile
         если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif
     !^картинка.text(x;y)[текст_надписи] AS_IS
     !^картинка.length[текст_надписи] AS_IS
-    !^картинка.gif[] -- кодирует в FILE с content-type=image/gif
+    !^картинка.gif[возможно, имя файла] -- кодирует в FILE с content-type=image/gif
+        имя файла будет использовано при $response:download
     !^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color)
     !^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color)
     !^картинка.circle(center x;center y;r;color)
@@ -646,7 +663,7 @@ Xhashfile
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif
 
 
-math
+!math
     !$math:PI
     !^math:round floor ceiling 
     !^math:trunc frac
@@ -656,7 +673,18 @@ math
     !^math:degrees radians
     !^math:pow sqrt
     !^math:random(ширина диапазона)
-    ^math:GUID {C2C0983C-E26E-4169-BD07-77ECE9405BA5}
+    !^math:uuid[]
+        22C0983C-E26E-4169-BD07-77ECE9405BA5
+        win32: пользуется cryptapi
+        unix: пользуется /dev/urandom, 
+            если нет, /dev/random, 
+            если нет, rand 
+            [на solaris /dev/random можно добавить]
+    !^math:uid64[]
+       BA39BAB6340BE370
+    !^math:md5[string]
+        выдает digest строки, длиной 16 байт в виде строки, 
+        где байты digest выданы в hex виде, впритык, в нижнем регистре
     !^math:crypt[password;salt]
        salt prefix $apr1$ вызывает встроенный MD5 алгоритм, 
          если нет тела salt, оно создаётся случайным
@@ -678,9 +706,13 @@ math
         для удобного создания по значению из базы
         формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
         формат2: %H:%M[:%S]
-    !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving
+    !^date::unix-timestamp()
+    !^date.unix-timestamp[]
+    !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ
         read-only
+        TZ="" << локальная зона
     !^date.roll[year|month|day](+-смещение) сдвигает дату
+    !^date.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour&co
     !^date.sql-string[] %Y-%m-%d %H:%M:%S
         where published='$дата.sql-string[]'
     !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу 
@@ -866,6 +898,11 @@ xdoc(xnode)
         attribute that is already inuse
         elsewhere
 
+!memory
+    !^memory:compact[] собрать мусор, освободив место под новые данные
+    (предупреждение: память процесса никогда не освобождается)
+    полезно делать перед XSL transform.
+
 !status
     !чтобы класс был доступен, в apache нужно сказать 
     <Location /parser-status.html>
@@ -902,6 +939,19 @@ xdoc(xnode)
            $s[$status:rusage]
            ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]
 
+    !$status:memory hash
+        !used
+            Includes some pages that were allocated but never written.		
+
+        !free
+
+        !ever_allocated_since_compact
+            Return the number of bytes allocated since the last collection.	
+
+        !ever_allocated_since_start
+            Return the total number of bytes [EVER(c)PAF] allocated in this process.		
+            Never decreases.							
+
 
 !DATA::=string | file
 
@@ -943,7 +993,15 @@ xdoc(xnode)
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]
         !по-умолчанию, user-agent=parser3
-    !file::load в дополнительные поля записывает ПОЛЕ:значение (имена полей ответа заглавными буквами)
+        !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
+        !это можно отключить, передав
+        !$.any-status(1)
+        !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ
+    !file::load в дополнительные поля записывает
+        !ПОЛЕ:значение (имена полей ответа заглавными буквами)
+        !tables << хеш их ПОЛЕ->table с единственным столбцом "value". 
+            в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies
+            todo:сделать отдельный cookies
 
 !системные типы ошибок:
     !parser.compile       ^test[}                компиляция (непарная скобка, ...)