--- parser3/operators.ru.txt	2002/11/22 16:18:14	1.97
+++ parser3/operators.ru.txt	2003/09/02 07:43:32	1.115.2.1
@@ -301,15 +301,16 @@ 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)]]
         клонирует таблицу    
-    !^table::load[[nameless;]путь]
+        reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает)
+    !^table::load[[nameless;]путь[;опции]]
         !если не nameless, названия колонок берутся из первой строки
         !пустые строки, и строки в первой колонке содержащие '#', игнорируются        
     !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]]
     !^таблица.save[[nameless|append;]путь]
     !$таблица.поле
-    !$таблица.fields+  из named таблицы выдаёт текущую запись как Hash
+    !$таблица.fields  из named таблицы выдаёт текущую запись как Hash
     !^таблица.menu{тело}[разделитель]
     !^таблица.offset[[whence]](5) сдвигает; без параметра - печатает offset
         !whence=cur|set
@@ -326,11 +327,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)]
@@ -344,6 +349,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !$hash.ключ
         !_default - специальный ключ, если задан, 
         то при обращении по ключу, которому нет соответствия, выдаётся _default значение 
+    !$hash.fields выдает $hash. чтобы класс hash был чуть больше похож на класс table
     !^hash::create[[!copy_from_hash|Xcopy_from_hashfile]]
         создаёт новый hash, копию старого
     !^hash.add[слагаемое]
@@ -402,6 +408,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
@@ -568,10 +576,11 @@ Xhashfile
         смотрит на .ext case insensitive, 
         умеет мерить пока только .gif и .jpg .jpeg
     !$image.exif << hash после measure jpeg с exif информацией 
-		!$image.exif.DateTime & co 
-			[полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html]
-		!числа типа int/double,
-		!перечисления в виде hash с ключами 0..count-1
+        !$image.exif.DateTime & co 
+            [полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html]
+        !числа типа int/double,
+        !даты типа date
+        !перечисления в виде hash с ключами 0..count-1
     !$картинка.src .width .height
     !$картинка.line-width  число=ширина линий
        !$картинка.line-style строка=стиль линий '*** * '='*** * *** * *** * '
@@ -615,7 +624,7 @@ Xhashfile
     !^file:delete[имя файла]
     !^file:find[имя файла][{когда не нашли}]
     !^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][;опции]]
     !$файл_который_был_loaded.size
     !^file::stat[имя файла]
     !$файл_который_был_stated.size !.adate !.mdate !.cdate
@@ -644,7 +653,7 @@ Xhashfile
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif
 
 
-math
+!math
     !$math:PI
     !^math:round floor ceiling 
     !^math:trunc frac
@@ -654,7 +663,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, оно создаётся случайным
@@ -676,9 +696,11 @@ math
         для удобного создания по значению из базы
         формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
         формат2: %H:%M[:%S]
-    !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving
+    !$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;год;месяц] выдаёт неименованную таблицу 
@@ -718,7 +740,7 @@ xdoc(xnode)
     !::create[[URI]][qualifiedName]
       URI default = disk path to requested document
       для каталогов конечный / обязателен
-    !::load[file.xml]
+    !::load[file.xml[;опции]]
     !.transform[rules.xsl|xdoc][[params hash]] выдаёт dom
         шаблон кэшируется, кэш обновляется при изменении даты файла шаблона,
         или изменении даты файла "имя шаблона.stamp"[проверка даты stamp приоритетнее]
@@ -877,11 +899,6 @@ xdoc(xnode)
             url    time    
             url    time    
             url    time    
-    !$status:db hash
-        !cache hash db_home=>tables table
-            name    time    users
-            name    time    users
-            name    time    users
     !$status:stylesheet
         !cache table
             file    time
@@ -937,6 +954,24 @@ xdoc(xnode)
         там лежат в обратном порядке имена[name] и места вызовов[file line] 
         операторов/методов, приведших к ошибке.
 
+!при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:
+    !http://domain/document?params
+    !а также, возможно, указать опции:
+        !$.method[GET|HEAD]
+        !$.timeout(3)  << в секундах, по-умолчанию =2
+        !$.headers[
+        !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
+        !]
+        !по-умолчанию, user-agent=parser3
+        !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
+        !это можно отключить, передав
+        !$.any-status(1)
+    !file::load в дополнительные поля записывает 
+        !ПОЛЕ:значение (имена полей ответа заглавными буквами)
+        !tables << хеш их ПОЛЕ->table с единственным столбцом "value". 
+            в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies
+            todo:сделать отдельный cookies
+
 !системные типы ошибок:
     !parser.compile       ^test[}                компиляция (непарная скобка, ...)
     !parser.runtime       ^if(0).                параметры (больше/меньше, чем нужно, не тех типов, ...)
@@ -958,6 +993,11 @@ xdoc(xnode)
     !smtp.execute                                                     communication error
     !email.format         hren tam@null.ru                            wrong email format(bad chars/empty)
     !email.send           $MAIL.sendmail[/shit]                       sendmail not executable
+    !http.host            ^file::load[http://notfound/there]          host not found
+    !http.connect         ^file::load[http://not_accepting/there]     host found, but do not accept connections
+    !http.timeout         ^file::load[http://host/doc]                whole load operation failed to complete in # seconds
+    !http.response        ^file::load[http://ok/there]                host found, connection accepted, bad answer
+    !http.status          ^file::load[http://ok/there]                host found, connection accepted, status!=200
     
 !нужно выключить русский apache: CharsetDisable on