--- parser3/operators.ru.txt	2003/11/10 07:05:39	1.134
+++ parser3/operators.ru.txt	2004/02/26 14:44:46	1.152
@@ -86,13 +86,17 @@ Xне сделано, видимо, не будет сделано
         удобно сделать после выставления 401 ошибки
     ^return[результат] + - отваливает из выполнения метода, 
         выдавая нестандартный результат
-    ^break[] + - обрывает цикл
-    ^continue[] + - обрывает итерацию цикла
+    X^break[] + - обрывает цикл
+    X^continue[] + - обрывает итерацию цикла
     !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-html]]{код}
         default as-is
     !^taint[[lang]][код]
         default "just tainted, language unknown"
-    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[во что переименовать @main]
+    !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[
+        $.main[во что переименовать @main]
+        $.file[имя файла из которого, якобы, данный текст]
+        $.lineno(номер строки в файле, откуда данный текст. можно отрицательный) 
+    ]
     !^process..[путь][во что переименовать @main]
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
@@ -100,7 +104,9 @@ Xне сделано, видимо, не будет сделано
             charset=cp1251_koi8&
             timeout=3&
             compress=1&
-            named_pipe=1
+            named_pipe=1&
+            autocommit=1
+            autocommit если выставить в 0, будет делать commit/rollback
 
         !pgsql://user:pass@{host[:port]|[local]}/database?
             client_encoding=win,[to-find-out]&
@@ -117,6 +123,7 @@ Xне сделано, видимо, не будет сделано
             NLS_ISO_CURRENCY  ISO currency symbol
             NLS_SORT  sort sequence
             ORA_ENCRYPT_LOGIN=TRUE
+            ClientCharset=parser-charset << charset in which parser thinks client works
 
         !odbc://DSN=dsn^;UID=user^;PWD=password
 
@@ -149,10 +156,11 @@ odbc    c:\drives\y\parser3project\odbc\
         ставить такой префикс перед открывающим апострофом, впритык, везде без проблелов
         /**имя_поля**/'literal'
     !^rem{}
-    !^cache[файл](секунд){код}
+    !^cache[файл](секунд){код}[{catch код}]
         !относительное задание времени
         !скэшировать строку, которая получается при выполнении кода на 'секунд' секунд
         !если 0секунд, значит не кэшировать, а старый такой стереть
+        !в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}
     !^cache[файл][expires date]{код}
         !абсолютное задание времени
     X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0)
@@ -378,19 +386,20 @@ odbc    c:\drives\y\parser3project\odbc\
     !.ключ[значение]  положить значение
     !.ключ[$.value[значение] $.expires ЗНАЧЕНИЕ}
       положить значение до expires
-      значение поля expires может быть date, или число дней(0дней=не вечно)
+      значение поля expires может быть date, или число дней(0дней=на вечно)
     !.ключ  достать
     !^delete[ключ]  удалить ключ
     !^delete[]  удалить файлы, содержащие данные
     !^hash[]
         преобразовать в обычный hash
+        попутно стирает устаревшие пары
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
 
     пример:
-    $uids[^hashfile::assign[/db/uids]]
+    $uids[^hashfile::open[/db/uids]]
     
     $random[23847387taduigh345XGHWElxjgdjg]
-    $uids.$random[$.value[$uid] $.expires(60*30)]
+    $uids.$random[$.value[$uid] $.expires(1)]
     $uid[$persistent.logins.$random]
 
 !form
@@ -711,7 +720,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !^date.sql-string[] %Y-%m-%d %H:%M:%S
         where published='$дата.sql-string[]'
     !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу 
-        столбцы: 0..6, week, weekyear
+        столбцы: 0..6, week, year
     !^date:calendar[rus|eng;год;месяц;день] выдаёт именнованную таблицу
         столбцы: year, month, day, weekday
     
@@ -774,10 +783,17 @@ xdoc(xnode)
         выдаёт media-type при подстановке $response:body[сюда]
 
 
+	!если на документ ссылаются так:
+	    parser://method/param/to/that/method
+	    то в качестве документа используется ^MAIN:method[/param/to/that/method]
+	    [примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было]
+
 !xnode
     DOM1 attributes:
     !$node.nodeName
     !$node.nodeValue
+    	!read
+    	!write
     !$node.nodeType = int
       ELEMENT_NODE                   = 1 
       ATTRIBUTE_NODE                 = 2 
@@ -916,11 +932,6 @@ xdoc(xnode)
             file    time
             file    time
             file    time
-    !$status:charset hash
-        !cache table
-            file
-            file
-            file
 
     !$status:rusage hash
         !utime user time used
@@ -947,6 +958,13 @@ xdoc(xnode)
             Return the total number of bytes [EVER(c)PAF] allocated in this process.		
             Never decreases.							
 
+    !$status:pid process id
+    !$status:tid thread id
+
+console
+    $console:timeout
+    !$console:line
+        read/write строку
 
 !DATA::=string | file