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_encodeKoduje 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_namePobierz 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 session_regenerate_id
+
+
+]]>
+
+
+
+
+
&reftitle.seealso;
session_id
+ session_create_idsession_start
+ session_destroy
+ session_resetsession_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_unsetZwalnia 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_decodeDekoduje 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
-
+
+
rawurldecodeDekoduje ł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;
-
-
- rawurldecode przykład
+
+
+ rawurldecode 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_indexPobiera 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_numberPobiera 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_parseRozpoczyna 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_handlerresourceparser
- 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;
+
+
+
+
+