--- parser3/operators.ru.txt	2004/03/02 16:56:57	1.160
+++ parser3/operators.ru.txt	2004/04/06 13:14:22	1.173
@@ -101,6 +101,7 @@ Xне сделано, видимо, не будет сделано
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?
+            ClientCharset=parser-charset << charset in which parser thinks client works
             charset=cp1251_koi8&
             timeout=3&
             compress=1&
@@ -109,8 +110,9 @@ Xне сделано, видимо, не будет сделано
             autocommit если выставить в 0, будет делать commit/rollback
 
         !pgsql://user:pass@{host[:port]|[local]}/database?
-            client_encoding=win,[to-find-out]&
-            datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO
+            client_encoding=win,[to-find-out]
+            &datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO
+            &ClientCharset=parser-charset << charset in which parser thinks client works
         
         !oracle://user:pass@service?
             NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251&
@@ -125,7 +127,8 @@ Xне сделано, видимо, не будет сделано
             ORA_ENCRYPT_LOGIN=TRUE
             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)
         была определена таблица
@@ -314,6 +317,7 @@ odbc    c:\drives\y\parser3project\odbc\
         состоит из большого числа фрагментов
     !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца
         default 'chars' -- whitespace chars
+    !^string.append[string]
 
 !table
     в выражении 
@@ -405,11 +409,11 @@ odbc    c:\drives\y\parser3project\odbc\
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
 
     пример:
-    $uids[^hashfile::open[/db/uids]]
-    
-    $random[23847387taduigh345XGHWElxjgdjg]
-    $uids.$random[$.value[$uid] $.expires(1)]
-    $uid[$persistent.logins.$random]
+    $sessions[^hashfile::open[/db/sessions]]
+   
+    $sid[^math:uuid[]]
+    $sessions.$sid[$.value[$uid] $.expires(1)]
+    $uid[$sessions.$sid]
 
 !form
     [берётся первый элемент из одноимённых из GET, потом первый из POST]
@@ -743,6 +747,8 @@ odbc    c:\drives\y\parser3project\odbc\
         столбцы: year, month, day, weekday
     
 xdoc(xnode)
+    !$xdoc.search-namespaces hash, where keys=prefixes, values=urls
+    
     DOM1 attributes:
     !readonly attribute DocumentType doctype
     Xreadonly attribute DOMImplementation implementation
@@ -1016,18 +1022,28 @@ console
         операторов/методов, приведших к ошибке.
 
 !при загрузке файла (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
         !$.headers[
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]
+        $.enctype[multipart/form-data]
+        $.form[
+            !$.field1[string]
+            !$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]
+            $.field3[file]
+        ]
+        !$.body[string]
+        	|file
         !по-умолчанию, user-agent=parser3
         !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
         !это можно отключить, передав
         !$.any-status(1)
         !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ
+        !$.user[пользователь]
+        !$.password[пароль]
     !file::load в дополнительные поля записывает
         !ПОЛЕ:значение (имена полей ответа заглавными буквами)
         !tables << хеш их ПОЛЕ->table с единственным столбцом "value". 
@@ -1063,5 +1079,12 @@ console
     
 !нужно выключить русский apache: CharsetDisable on
 
-!если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
+Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения
+
+!если описание метода содержит локальную переменную result в явном виде
+    (есть и неявная переменная)
+    то код вывода строковых литералов не попадает в конечный байт-код,
+    а непробельные символы считаются синтаксической ошибкой
+    для вывода чего бы то ни было надо пользоваться этой переменной
+