From ed360c0616ea878e2298f5dee8dd6a7fbb1090ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Grzegorz=20Ba=C5=84kowski?= Date: Wed, 22 May 2024 18:25:41 +0200 Subject: [PATCH] Sync reference/xml, var, url, tidy, strings, session, uodbc with EN (#5) * Sync reference/xml, var, url, tidy, strings, session, uodbc with EN * Delete unnecessary char from session-module-name.xml file * Small change in session, tidy, url, var functions files --- reference/session/configure.xml | 16 +- .../session/functions/session-encode.xml | 20 ++- .../session/functions/session-module-name.xml | 55 +++++-- .../functions/session-regenerate-id.xml | 150 +++++++++++++----- .../functions/session-set-cookie-params.xml | 74 ++++++--- reference/session/functions/session-unset.xml | 55 ++++++- reference/strings/setup.xml | 7 +- reference/tidy/book.xml | 11 +- reference/tidy/setup.xml | 9 +- reference/uodbc/configure.xml | 9 +- reference/url/functions/base64-decode.xml | 42 ++--- reference/url/functions/rawurldecode.xml | 30 ++-- reference/url/functions/urldecode.xml | 8 +- reference/var/functions/boolval.xml | 17 +- reference/var/functions/floatval.xml | 37 ++++- reference/var/functions/get-resource-type.xml | 64 +++----- .../functions/xml-get-current-byte-index.xml | 30 +++- .../xml-get-current-column-number.xml | 30 +++- .../functions/xml-get-current-line-number.xml | 30 +++- reference/xml/functions/xml-parse.xml | 67 ++++++-- .../xml/functions/xml-set-element-handler.xml | 131 ++++++++------- 21 files changed, 584 insertions(+), 308 deletions(-) diff --git a/reference/session/configure.xml b/reference/session/configure.xml index 994b59bf..111bc3b3 100755 --- a/reference/session/configure.xml +++ b/reference/session/configure.xml @@ -1,14 +1,16 @@ - + +
&reftitle.install; - Obsługa sesji jest domyślnie włączona. Aby zbudować PHP bez obsługi sesji, - należy podać opcję do - wywołania configure. Aby użyć pamięci współdzielonej do przechowywania - sesji, należy podać opcję . + &installation.enabled.disable; + + + + Aby używać alokacji pamięci współdzielonej (mm) do przechowywania sesji, skonfiguruj PHP + z opcją . &windows.builtin; @@ -22,7 +24,7 @@ możliwe jest, że inny system obsługi sesji (na przykład taki, który używa bazy danych) nie śledzi sesji, które nie zawierają danych. - +
+ - - + + session_encode Koduje dane bieżącej sesji do postaci ciągu tekstowego @@ -11,7 +11,7 @@ &reftitle.description; - stringsession_encode + stringfalsesession_encode @@ -24,10 +24,15 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Zwraca zakodowaną zawartość aktualnej sesji. + Zwraca zakodowaną zawartość aktualnej sesji, &return.falseforfailure;. @@ -38,8 +43,8 @@ Należy wywołać session_start przed użyciem session_encode. - - + + &reftitle.seealso; @@ -51,7 +56,6 @@ - + - + + session_module_name Pobierz i/lub ustaw moduł bieżącej sesji - + &reftitle.description; - stringsession_module_name - stringmoduł + stringfalse + session_module_name + stringnull + module&null; session_module_name pobiera nazwę obecnego - modułu sesji. + modułu sesji, który jest również znany jako + session.save_handler. @@ -24,11 +28,14 @@ - moduł + module - Jeżel moduł jest określony, to zostanie on + Jeżel parametr module jest określony i nie ma wartości &null;, to zostanie on użyty w zamian obecnego. + Przekazanie wartości "user" do tego paramteru jest zabronione. Zamiast tego + należy wywołać funkcję session_set_save_handler w celu ustawienia obsługi + sesji zdefniowanego przez użytkownika. @@ -39,12 +46,40 @@ &reftitle.returnvalues; - Zwraca nazwę obecnego modułu sesji. + Zwraca nazwę obecnego modułu sesji, &return.falseforfailure;. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Parametr module akceptuje teraz wartość null. + + + + 7.2.0 + + Obecnie jest wyraźnie zabronione ustawianie nazwy modułu na + "user". Wcześniej było to po cichu ignorowane. + + + + + + + + + session_regenerate_id @@ -13,7 +14,7 @@ &reftitle.description; boolsession_regenerate_id - boolusunięcie_starej_sesjifalse + booldelete_old_session&false; session_regenerate_id zastępuje bieżący identyfikator @@ -24,6 +25,22 @@ jest włączone, wyjście musi się rozpocząć po wywołaniu session_regenerate_id. W przeciwnym wypadku zostanie użyte stare ID. + + + Obecnie session_regenerate_id nie radzi sobie dobrze z niestabilną siecią, + np. siecią komórkową i WiFi. W związku z tym może dojść do utraty + sesji przez wywołanie session_regenerate_id + + + Nie należy natychmiast niszczyć starych danych sesji, ale należy użyć + niszczącego znacznika czasu i kontrolować dostęp do starego identyfikatora sesji. W przeciwnym razie, + równoczesny dostęp do strony może skutkować niespójnym stanem lub + utratą sesji, lub może spowodować warunek wyścigu po stronie klienta (przeglądarki) + i może niepotrzebnie utworzyć wiele identyfikatorów sesji. Natychmiastowe + usunięcie danych sesji wyłącza również wykrywanie ataków związanych z przejęciem sesji + i zapobieganie im. + + @@ -31,10 +48,13 @@ - usunięcie_starej_sesji + delete_old_session Określa czy stary identyfikator sesji ma zostać usunięty, czy też nie. + Nie powinieneś usuwać starej sesji, jeśli chcesz uniknąć + wyścigów spowodowanych usunięciem lub wykryciem/uniknięciem ataków polegających + na przejęciu sesji. @@ -49,38 +69,6 @@ - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 4.3.3 - - Od tej wersji PHP, jeśli ciasteczka sesji są aktywne, wywołanie - session_regenerate_id utworzy nowe ciasteczko - sesji z nowym identyfikatorem sesji. - - - - 5.1.0 - - Dodano parametr usunięcie_starej_sesji. - - - - - - - - &reftitle.examples; @@ -89,12 +77,31 @@ "; @@ -106,14 +113,85 @@ print_r($_SESSION); - + + + Obecny moduł sesji nie radzi sobie dobrze z niestabilną siecią. Powinieneś + zarządzać identyfikatorem sesji, aby uniknąć utraty sesji za pomocą funkcji session_regenerate_id. + + + + + Unikanie utraconej sesji za pomocą funkcji <function>session_regenerate_id</function> + + +]]> + + + + + &reftitle.seealso; session_id + session_create_id session_start + session_destroy + session_reset session_name diff --git a/reference/session/functions/session-set-cookie-params.xml b/reference/session/functions/session-set-cookie-params.xml index 53d05b9f..cacf87e6 100644 --- a/reference/session/functions/session-set-cookie-params.xml +++ b/reference/session/functions/session-set-cookie-params.xml @@ -1,7 +1,7 @@ - + - + session_set_cookie_params @@ -12,12 +12,17 @@ Opis - voidsession_set_cookie_params - intczas_życia - stringścieżka - stringdomena - boolbezpiecznefalse - boolhttponlyfalse + boolsession_set_cookie_params + intlifetime_or_options + stringnullpath&null; + stringnulldomain&null; + boolnullsecure&null; + boolnullhttponly&null; + + Alternatywna sygnatura dostępna od PHP 7.3.0: + + boolsession_set_cookie_params + arraylifetime_or_options Ustaw parametry ciasteczka pierwotnie zdefiniowane w pliku &php.ini;. Efekt @@ -31,22 +36,35 @@ kluczy, które można otrzymać przy użyciu funkcji ini_get. - + &reftitle.parameters; - czas życia + lifetime_or_options - Czas życia - ciasteczka sesyjnego (w sekundach). + W przypadku użycia pierwszej sygnatury długość życialifetime + ciasteczka sesji określona w sekundach. + + + W przypadku użycia drugiej sygnatury, + tablica asocjacyjna array, która może mieć dowolny z kluczy + lifetime, path, domain, + secure, httponly i samesite. + Wartości mają takie samo znaczenie, jak opisane dla parametrów o tej + samej nazwie. Wartość elementu samesite powinna wynosić + Lax lub Strict. + Jeśli którakolwiek z dozwolonych opcji nie zostanie podana, ich wartości domyślne + są takie same jak wartości domyślne parametrów jawnych. Jeśli element + samesite zostanie pominięty, atrybut cookie SameSite + nie zostanie ustawiony. - ścieżka + path Ścieżka w domenie, @@ -56,7 +74,7 @@ - domena + domain Domena ciasteczka, @@ -66,7 +84,7 @@ - bezpieczne + secure Jeżeli ustawiono &true;, ciasteczko będzie wysyłane tylko za pomocą @@ -91,7 +109,7 @@ &reftitle.returnvalues; - &return.void; + &return.success; @@ -108,9 +126,24 @@ - 5.2.0 + 8.0.0 + + Parametry path, domain, + secure oraz httponly pozwalają teraz na wartość null. + + + + 7.3.0 + + Dodano alternatywną sygnaturę obsługującą parametr &array; lifetime_or_options + Ta sygnatura obsługuje również + ustawienie atrybutu SameSite. + + + + 7.2.0 - Dodano parametr httponly. + &return.success; Wcześniej funkcja zwracała void. @@ -138,11 +171,14 @@ session.cookie_httponly + + session.cookie_samesite + session_get_cookie_params - + + + session_unset Zwalnia wszystkie zmienne sesyjne - + &reftitle.description; - voidsession_unset + boolsession_unset @@ -19,29 +20,71 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - &return.void; + &return.success; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 7.2.0 + + Zwracanym typem tej funkcji jest teraz wartość logiczna bool + Wcześniej był to typ void. + + + + + + + + &reftitle.notes; Jeśli użyta została tablica $_SESSION, to aby wyrejestrować zmienną z sesji należy użyć unset, na - przykład unset ($_SESSION['varname']);.. + przykład unset($_SESSION['varname']);. NIE należy usuwać całej zmiennej $_SESSION poprzez - wywołanie unset($_SESSION), ponieważ uniemożliwi to + wywołanie unset($_SESSION), ponieważ uniemożliwi to rejestrację zmiennych sesyjnych poprzez zmienną superglobalną $_SESSION. + + + Użycie funkcji session_unset jest identyczne z $_SESSION = []. + + + + + Ta funkcja działa tylko wtedy, gdy sesja jest aktywna. Nie wyczyści tablicy + $_SESSION, jeśli sesja nie została jeszcze rozpoczęta lub + została już zniszczona. Użyj $_SESSION = [] aby usunąć + wszystkie zmienne sesji, nawet jeśli sesja nie jest aktywna. + + diff --git a/reference/strings/setup.xml b/reference/strings/setup.xml index b6c47e54..bfdeb1d0 100644 --- a/reference/strings/setup.xml +++ b/reference/strings/setup.xml @@ -1,6 +1,7 @@ - + + &reftitle.setup; @@ -13,6 +14,10 @@
&reftitle.install; &no.install; + + Od PHP 8.1.0, funkcja crypt może być zbudowana w oparciu o systemową bibliotekę kryptograficzną + poprzez określenie opcji konfiguracji . +
diff --git a/reference/tidy/book.xml b/reference/tidy/book.xml index ed7027db..23341e39 100644 --- a/reference/tidy/book.xml +++ b/reference/tidy/book.xml @@ -1,7 +1,7 @@ - + - + Tidy @@ -12,9 +12,10 @@ Tidy jest rozszerzeniem opakowującym bibliotekę libTidy (ang. Tidy HTML clean and repair; w wolnym tłumaczeniu: robienie porządków - - czyść i napraw kod HTML), która pozwala nie tylko porządkować - i manipulować dokumentami HTML, ale również poruszać się po drzewie - węzłów dokumentu. + czyść i napraw kod HTML), która pozwala nie tylko czyścić i w inny + sposób manipulować dokumentami HTML, XHTML i XML, ale także przeglądać + drzewo dokumentów, w tym te z osadzonymi językami skryptowymi, takimi + jak PHP lub ASP, przy użyciu konstrukcji obiektowych. diff --git a/reference/tidy/setup.xml b/reference/tidy/setup.xml index f1b2dec1..a72fbab7 100644 --- a/reference/tidy/setup.xml +++ b/reference/tidy/setup.xml @@ -1,7 +1,7 @@ - + - + &reftitle.setup; @@ -11,7 +11,10 @@ Aby używać rozszerzenia Tidy należy zainstalować bibliotekę libTidy, która jest dostępna na witrynie - &url.tidy;. + tidy homepage. + Od PHP 7.1.0 alternatywnie może być użyta biblioteka + libtidy5, następca obsługujący HTML5. + Od PHP 7.3.0, inną opcją jest użycie biblioteki libtidyp.
diff --git a/reference/uodbc/configure.xml b/reference/uodbc/configure.xml index 3b7d367c..a71a78d6 100644 --- a/reference/uodbc/configure.xml +++ b/reference/uodbc/configure.xml @@ -1,6 +1,6 @@ - - + +
&reftitle.install; @@ -161,7 +161,10 @@ - &windows.builtin; + + Użytkownicy systemu Windows muszą włączyć + php_odbc.dll, aby móc korzystać z tego rozszerzenia. +
+ - + + base64_decode Dekoduje dane zakodowane przez MIME base64 - + &reftitle.description; - stringbase64_decode - stringdane - boolściślefalse + stringfalsebase64_decode + stringstring + boolstrict&false; - Odkodowuje dane zakodowane w base64. + Odkodowuje dane z parametru string zakodowane w base64. @@ -24,7 +25,7 @@ - dane + string Zakodowane dane. @@ -49,33 +50,11 @@ &reftitle.returnvalues; - Zwraca oryginalne dane&return.falseforfailure;. Zwrócone dane mogą mieć postać + Zwraca zdekodowane dane&return.falseforfailure;. Zwrócone dane mogą mieć postać binarną. - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.2.0 - Dodano parametr ściśle - - - - - - - &reftitle.examples; @@ -110,7 +89,6 @@ PHP jest super - + + rawurldecode Dekoduje łańcuchy zakodowane metodą kodowania URL'i - + &reftitle.description; stringrawurldecode - stringstr + stringstring Zwraca łańcuch w którym sekwencje dwóch cyfr szesnastkowych @@ -25,7 +26,7 @@ - str + string URL do zdekodowania. @@ -45,19 +46,19 @@ &reftitle.examples; - - - <function>rawurldecode</function> przykład + + + <function>rawurldecode</function> przykład - -]]> - - +?> +]]> + + @@ -84,7 +85,6 @@ echo rawurldecode('foo%20bar%40baz'); // foo bar@baz - + + urldecode @@ -11,7 +12,7 @@ &reftitle.description; stringurldecode - stringłańcuch + stringstring Odkodowuje każdy kod w postaci %## @@ -25,7 +26,7 @@ - łańcuch + string Ciąg znaków do odkodowania. @@ -92,7 +93,6 @@ foreach (explode('&', $zapytanie) as $fragment) { - + - + boolval @@ -11,11 +11,11 @@ &reftitle.description; - booleanboolval - mixedvar + boolboolval + mixedvalue - Zwraca wartość zmiennej var jako boolean. + Zwraca wartość typu bool zmiennej podanej jako value @@ -23,10 +23,10 @@ &reftitle.parameters; - var + value - Wartość skalarna, która jest konwertowana do typu boolean. + Wartość skalarna, która jest konwertowana do typu bool. @@ -36,7 +36,7 @@ &reftitle.returnvalues; - Typ boolean zmiennej podanej jako var. + Wartość typu bool zmiennej podanej jako value. @@ -96,7 +96,6 @@ stdClass: true - + + floatval @@ -10,10 +11,10 @@ &reftitle.description; floatfloatval - mixedvar + mixedvalue - Pobiera wartość zmiennej var jako typ float. + Pobiera wartość zmiennej value jako typ float. @@ -21,12 +22,12 @@ - var + value Może być dowolnym typem skalarnym. floatval nie powinno - być używane na obiektach - w takim wypadku zostanie wyemitowany komunikat - E_NOTICE, a funkcja zwróci 1. + być używane na obiektach - w takim wypadku zostanie wyemitowany błąd poziomu + E_WARNING, a funkcja zwróci 1. @@ -46,6 +47,29 @@ rzutowania na float. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Poziom błędu podczas konwersji z obiektu został zmieniony z E_NOTICE na E_WARNING. + + + + + + + &reftitle.examples; @@ -90,7 +114,6 @@ echo $float_value_of_var; // 0 - + + get_resource_type @@ -14,7 +15,7 @@ &reftitle.description; stringget_resource_type - resourcehandle + resourceresource Ta funkcja pobiera typ podanego zasobu. @@ -26,7 +27,7 @@ - handle + resource Uchwyt do danego zasobu. @@ -40,40 +41,17 @@ &reftitle.returnvalues; - Jeżeli jako handle został podany zasób, ta funkcja + Jeżeli jako resource został podany zasób, ta funkcja zwróci łańcuch znakow reprezentujący jego typ. Jeżeli typ nie jest rozpoznawany przez tę funkcję, zwróconym wynikiem będzie string Unknown. - Ta funkcja zwróci &null; i wygeneruje błąd jeżeli podany - handle nie jest typu resource. + Ta funkcja zwróci &null; i wygeneruje błąd jeżeli podany + resource nie jest typu resource. - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - PHP 5.3.0 - - Jeśli handle nie ma typu resource ta - funkcja zwraca &null;. Wcześniej zwracane było &false;. - - - - - - - &reftitle.examples; @@ -82,25 +60,35 @@ doc) . "\n"; +// Od PHP 8.0.0 poniższe rozwiązanie już nie działa. Funkcja curl_init zwraca teraz +obiekt CurlHandle. +$c = curl_init(); +echo get_resource_type($c) . "\n"; ?> ]]> + &example.outputs.7; + + + + + &reftitle.seealso; + + + get_resource_id + + + - + - - + + xml_get_current_byte_index Pobiera aktualny indeks bajtu parsera XML @@ -12,7 +12,7 @@ &reftitle.description; intxml_get_current_byte_index - resourceparser + XMLParserparser Pobiera aktualny indeks bajtu podanego parsera XML. @@ -38,13 +38,28 @@ &reftitle.returnvalues; - Ta funkcja zwraca &false; jeżeli parser nie - odnosi się do prawidłowego parsera. W przeciwnym razie zwraca indeks - bajtu, na którym znajduje się aktualnie parser w swoim buforze + Zwraca indeks bajtu na którym znajduje się aktualnie parser w swoim buforze danych (zaczynając od 0). + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &xml.changelog.parser-param; + + + + + &reftitle.notes; @@ -66,7 +81,6 @@ - + - - + + xml_get_current_column_number @@ -14,7 +14,7 @@ &reftitle.description; intxml_get_current_column_number - resourceparser + XMLParserparser Pobiera aktualny numer kolumny dla podanego parsera XML. @@ -40,14 +40,29 @@ &reftitle.returnvalues; - Ta funkcja zwraca &false; jeżeli parser nie - odnosi się do prawidłowego parsera. W innym przypadku zwraca numer kolumny - w aktualnej linii (którą zwraca funkcja + Zwraca kolumnę w aktualnej linii (którą zwraca funkcja xml_get_current_line_number), na której znajduje się aktualnie parser. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &xml.changelog.parser-param; + + + + + &reftitle.seealso; @@ -59,7 +74,6 @@ - + - - + + xml_get_current_line_number Pobiera aktualny numer linii dla parsera XML @@ -12,7 +12,7 @@ &reftitle.description; intxml_get_current_line_number - resourceparser + XMLParserparser Pobiera aktualny numer linii dla podanego parsera XML. @@ -38,12 +38,27 @@ &reftitle.returnvalues; - Ta funkcja zwraca &false; jeśli parser nie - odnosi się do prawidłowego parsera. W przeciwnym razie zwraca numer - linii, na której znajduje się aktualnie parser w buforze danych. + Zwraca linię, w której znajduje się aktualnie parser w buforze danych. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &xml.changelog.parser-param; + + + + + &reftitle.seealso; @@ -55,7 +70,6 @@ - + - - + + xml_parse Rozpoczyna parsowanie dokumentu XML @@ -12,9 +12,9 @@ &reftitle.description; intxml_parse - resourceparser - stringdane - boolostatnifalse + XMLParserparser + stringdata + boolis_final&false; xml_parse parsuje dokument XML. Uchwyty dla @@ -35,21 +35,21 @@ - dane + data Fragment danych do parsowania. Dokument może być prawidłowo parsowany po kawałku za pomocą wielokrotnego wywoływania xml_parse - z nowymi danymi, dopóki podany jest parametr ostatni + z nowymi danymi, dopóki podany jest parametr is_final i posiada on wartość logiczną &true; podczas parsowania ostatniej porcji danych. - ostatni + is_final - Jeśli jest podany i posiada wartość logiczną &true;, dane + Jeśli jest podany i posiada wartość logiczną &true;, data są ostatnim kawałkiem wysłanych danych podczas tego parsowania. @@ -73,14 +73,55 @@ - Błędy encji są raportowane po zakończeniu przetwarzania danych, a więc tylko wtedy - gdy ustawiony jest parametr ostatni i posiada on wartość &true;. + Niektóre błędy (takie jak błędy encji) są zgłaszane na końcu danych, a więc tylko wtedy, + gdy ustawiony jest parametr is_final i posiada on wartość &true;. - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &xml.changelog.parser-param; + + + + + + &reftitle.examples; + + Parsowanie fragmentów dużych dokumentów XML + + Ten przykład pokazuje, jak duże dokumenty XML mogą być odczytywane + i parsowane we fragmentach, dzięki czemu nie jest konieczne przechowywanie całego + dokumentu w pamięci. Obsługa błędów została pominięta dla zwięzłości. + + + + + + + + - + xml_set_element_handler - Ustawia początkową i końcową procedurę obsługi elementu + Ustawia początkową i końcową funkcję obsługi elementu &reftitle.description; - boolxml_set_element_handler - resourceparser - callbablepoczątkowa_procedura_obsługi_elementu - callbablekońcowa_procedura_obsługi_elementu + truexml_set_element_handler + XMLParserparser + callablestart_handler + callableend_handler - Ustawia funkcje procedury obsługi elementu dla parser XML. - początkowa_procedura_obsługi_elementu i - końcowa_procedura_obsługi_elementu są ciągami znaków zawierającymi - nazwy funkcji, które muszą istnieć podczas wywołania xml_parse - dla parser. + Ustawia funkcje obsługi elementu dla parsera XML podanego jako parser. + + + Funkcja start_handler jest wywoływana po otwarciu nowego + elementu XML. Funkcja end_handler jest wywoływana po zamknięciu + elementu XML. @@ -29,63 +30,46 @@ &reftitle.parameters; + &xml.parser.param; - parser + start_handler + &xml.handler.description; - Referencja do parsera XML do ustawiania obsługi funkcji początku i końca elementu. - - - - - początkowa_procedura_obsługi_elementu - - - Funkcja nazwana przez początkowa_procedura_obsługi_elementu - musi przyjmować trzy parametry: + Sygnatura funkcji obsługi musi zawierać: - początkowa_procedura_obsługi_elementu - resourceparser - stringnazwa - arrayatrybuty + voidstart_element_handler + XMLParserparser + stringname + arrayattributes + &xml.handler.parser.param; - parser + name - Pierwszy parametr, parser, - jest referencją do parsera XML wywołującego procedurę obsługi. + Zawiera nazwę elementu, dla którego wywoływana funcja obsługi. + Jeśli opcja case-folding jest włączona + dla tego parsera, nazwa elementu będzie pisana wielkimi literami. - nazwa + attributes - Drugi parametr, nazwa, zawiera nazwę elementu - dla którego procedura obsługi została wywołana. Jeśli dla tego parsera - włączony jest case-folding, - wówczas nazwa elementu będzie zamieniona na duże litery. - - - - - atrybuty - - - Trzeci parametr, atrybuty, zawiera tablicę - asocjacyjną z atrybutami elementów (jeśli jakiekolwiek są). - Kluczami tych tablic są nazwy atrybutów a wartościami wartości artybutów. - Nazwy atrybutów są zamieniane na duże litery za pomocą opcji case-folding na tej samej zasadzie jak - nazwy elementów. Wartości atrybutów opcja case-folded nie - dotyczy. + Tablica asocjacyjna z atrybutami elementu. + Tablica jest pusta, jeśli element nie ma atrybutów. + Kluczami tej tablicy są nazwy atrybutów, + a wartościami są wartości atrybutów. + Wielkość liter w nazwach atrybutów jest traktowana tak samo przez + opcję case-folded jak dla nazw elementów. + Wartości atrybutów opcja case-folded nie dotyczy. - Oryginalna kolejność atrybutów może być odzyskana za pomocą normalnego - przejścia przez atrybuty używając each. - Pierwszy klucz w tablicy był pierwszym atrybutem itd. + Kolejność przeglądania atrybutów attributes + jest identyczna z kolejnością, w jakiej atrybuty zostały zadeklarowane. @@ -95,15 +79,15 @@ - końcowa_procedura_obsługi_elementu + end_handler - Funkcja nazwana przez końcowa_procedura_obsługi_elementu + Funkcja nazwana przez end_handler musi przyjmować dwa parametry: - końcowa_procedura_obsługi_elementu + end_element_handler resourceparser - stringnazwa + stringname @@ -111,27 +95,22 @@ Pierwszy parametr, parser, - jest referencją do parsera XML wywołującego procedurę obsługi. + jest referencją do parsera XML wywołującego funkcję obsługi. - nazwa + name - Drugi parametr, nazwa, zawiera nazwę elementu - dla którego procedura obsługi została wywołana. Jeśli dla tego parsera - włączony jest case-folding, - wówczas nazwa elementu będzie zamieniona na duże litery. + Zawiera nazwę elementu, dla którego wywoływana jest ta funkcja obsługi. + Jeśli opcja case-folding jest włączona + dla tego parsera, nazwa elementu będzie pisana wielkimi literami. - - Jeśli funkcja procedury obsługi jest podana jako pusty ciąg znaków lub &false;, - wówczas procedura obsługi w zapytaniu jest wyłączona. - @@ -141,12 +120,28 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &xml.changelog.parser-param; + + + + +