From 04098352da74ea8e9147831628b1193441b3170d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Grzegorz=20Ba=C5=84kowski?= Date: Wed, 22 May 2024 18:24:57 +0200 Subject: [PATCH] Sync array functions with EN (#4) --- reference/array/functions/array-chunk.xml | 59 ++++-- reference/array/functions/array-combine.xml | 75 +++---- .../array/functions/array-count-values.xml | 19 +- .../array/functions/array-diff-assoc.xml | 83 ++++---- reference/array/functions/array-diff-key.xml | 51 +++-- .../array/functions/array-diff-uassoc.xml | 56 ++--- reference/array/functions/array-diff.xml | 114 ++++++++--- reference/array/functions/array-fill.xml | 120 +++++++---- reference/array/functions/array-filter.xml | 78 +++---- reference/array/functions/array-flip.xml | 15 +- .../array/functions/array-key-exists.xml | 62 ++++-- reference/array/functions/array-keys.xml | 46 ++--- reference/array/functions/array-map.xml | 193 +++++++++++++----- reference/array/functions/array-pad.xml | 77 ++++--- reference/array/functions/array-shift.xml | 24 +-- reference/array/functions/array-sum.xml | 39 +++- reference/array/functions/array-unique.xml | 83 ++++---- reference/array/functions/array-walk.xml | 105 ++++++---- reference/array/functions/array.xml | 38 ++-- reference/array/sorting.xml | 15 +- 20 files changed, 836 insertions(+), 516 deletions(-) diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml index b053d835..b8cd800f 100644 --- a/reference/array/functions/array-chunk.xml +++ b/reference/array/functions/array-chunk.xml @@ -1,25 +1,25 @@ - + - + array_chunk - Podziel tablicę na kawałki + Dzieli tablicę na kawałki - + &reftitle.description; arrayarray_chunk - arraytablica - introzmiar - boolzachowaj_klucze&false; + arrayarray + intlength + boolpreserve_keys&false; - Dzieli tablicę po ilości elementów określonej jako rozmiar. - Ostatni kawałek może zawierać mniej elementów niż określono w argumencie - rozmiar. + Dzieli tablicę po ilości elementów określonej jako length. + Ostatni kawałek może zawierać mniej elementów niż określono w parametrze + length. @@ -29,7 +29,7 @@ - tablica + array Tablica do podzielenia @@ -38,7 +38,7 @@ - rozmiar + length Rozmiar każdego z fragmentów @@ -47,7 +47,7 @@ - zachowaj_klucze + preserve_keys Kiedy ustawione na &true;, klucze zostaną zachowane. @@ -65,18 +65,44 @@ &reftitle.returnvalues; Zwraca tablicę wielowymiarową, numerowaną od zera, gdzie każdy - wymiar zawiera ilość elementów określoną jako rozmiar. + wymiar zawiera ilość elementów określoną jako parametr length. &reftitle.errors; - Jeżeli rozmiar jest mniejszy niż 1, - zostanie wygenerowany E_WARNING i zwrócony &null;. + Jeżeli parametr length jest mniejszy niż 1, + zostanie zgłoszony błądValueError. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Jeśli length jest mniejszy niż 1, + Jeśli parametr length jest mniejszy niż 1, + zostanie teraz zgłoszony błąd ValueError; + poprzednio zamiast tego zgłaszany był błąd poziomuE_WARNING + i funkcja zwracała &null;. + + + + + + + &reftitle.examples; @@ -150,7 +176,6 @@ Array - + - + array_combine Tworzy tablicę używając wartości jednej tablicy jako kluczy a drugiej jako wartości - + &reftitle.description; arrayarray_combine - arrayklucze - arraywartości + arraykeys + arrayvalues Tworzy tablicę używając wartości z tablicy - klucze jako kluczy i wartości z tablicy - wartości jako ich wartości. + keys jako kluczy i wartości z tablicy + values jako ich wartości. @@ -28,7 +28,7 @@ - klucze + keys Tablica kluczy do użycia. Niepoprawne wartości będą @@ -38,7 +38,7 @@ - wartości + values Tablica wartości do użycia. @@ -53,45 +53,49 @@ &reftitle.returnvalues; - Zwraca wynikową tablicę lub &false; jeżeli liczba elementów z obu tablic - nie pasuje do siebie. + Zwraca połączoną tablicę (array). &reftitle.errors; - Generuje błąd E_WARNING jeżeli liczba elementów w tablicach - klucze i wartości nie jest + Od PHP 8.0.0 zgłaszany jest błąd ValueError, jeśli liczba elementów w + keys i values nie jest jednakowa. + Przed PHP 8.0.0 zamiast tego emitowany był błąd E_WARNING. + Od PHP 8.0.0 zgłaszany jest błąd ValueError, jeśli liczba elementów w + parametrach keys i values + nie jest jednakowa. + Przed PHP 8.0.0 zamiast tego emitowany był błąd E_WARNING. &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.4.0 - - Poprzednie wersje generowały błąd E_WARNING i zwracały - &false; dla pustych tablic. - - - - - - + + + + + &Version; + &Description; + + + + + 8.0.0 + + array_combine zgłasza teraz błąd + ValueError jeśli liczba elementów + dla każdej z tablic nie jest równa; + poprzednio funkcja ta zwracała &false;. + + + + + - + &reftitle.examples; @@ -130,6 +134,7 @@ Array array_merge array_walk array_values + array_map diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml index d88e1dbf..b33bf34e 100644 --- a/reference/array/functions/array-count-values.xml +++ b/reference/array/functions/array-count-values.xml @@ -1,22 +1,23 @@ - + + array_count_values - Zlicza wszystkie wartości w tablicy + Zlicza wystąpienia każdej odrębnej wartości w tablicy - + &reftitle.description; arrayarray_count_values - arraytablica + arrayarray array_count_values zwraca tablicę zawierającą - wartości tablicy jako klucze i częstość - ich występowania w tablicy jako wartości. + wartości tablicy array (które muszą być typu &integer; lub &string;) jako klucze i + ile razy wystąpiły w tablicy array jako wartości. @@ -26,7 +27,7 @@ - tablica + array Tablica wartości do zliczenia @@ -41,7 +42,7 @@ &reftitle.returnvalues; - Zwraca asocjacyjną tablicę wartości z tablica jako + Zwraca asocjacyjną tablicę wartości z array jako kluczami i ich ilością jako wartością. @@ -50,7 +51,7 @@ &reftitle.errors; Emituje błąd E_WARNING dla każdego elementu, który nie jest typu - string lub integer. + string lub int. diff --git a/reference/array/functions/array-diff-assoc.xml b/reference/array/functions/array-diff-assoc.xml index 6ded6c32..91d431b0 100755 --- a/reference/array/functions/array-diff-assoc.xml +++ b/reference/array/functions/array-diff-assoc.xml @@ -1,24 +1,25 @@ - + - + array_diff_assoc Oblicza różnicę między tablicami z dodatkowym sprawdzaniem kluczy - + &reftitle.description; arrayarray_diff_assoc - arraytablica1 - arraytablica2 - array... + arrayarray + arrayarrays - Porównuje tablica1 z tablica2 i + Porównuje tablicę array z tablicami arrays i zwraca różnicę. W przeciwieństwie do array_diff, porównywane + Porównuje tablicę array z tablicami arrays i + zwraca różnicę. W przeciwieństwie do funkcji array_diff, porównywane są także klucze tablic. @@ -29,7 +30,7 @@ - tablica1 + array Tablica do porównania @@ -38,19 +39,10 @@ - tablica2 + arrays - Tablica, z którą porównujemy - - - - - - ... - - - Więcej tablic do porównania + Tablice do porównania @@ -62,8 +54,27 @@ &reftitle.returnvalues; - Zwraca tablicę zawierającą wszystkie wartości z - tablica1, które nie są obecne w żadnej z innych tablic. + Zwraca tablicę zawierającą wszystkie wartości z tablicy + array które nie są obecne w żadnej z pozostałych tablic. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &array.changelog.require-only-one; + + + @@ -80,18 +91,20 @@ Przykład użycia <function>array_diff_assoc</function> - W tym przykładzie możesz zobaczyć, że para "a" => "green" + W tym przykładzie para "a" => "green" jest obecna w obu tablicach i dlatego nie jest wyświetlana przez funkcję W odróżnieniu od 0 => "red", które jest wyświetlane, - ponieważ w drugiej tablicy "red" - ma klucz, którym jest 1. + ponieważ klucz "red" jest + automatycznie przypisywany do 0 w pierwszej tablicy, + podczas gdy jest on przypisany do 1 w drugiej tablicy, + ponieważ klucz 0 jest już zajęty przez yellow. "green", "b" => "brown", "c" => "blue", "red"); -$tablica2 = array("a" => "green", "yellow", "red"); -$wynik = array_diff_assoc($tablica1, $tablica2); +$array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red"); +$array2 = array("a" => "green", "yellow", "red"); +$result = array_diff_assoc($array1, $array2); print_r($tablica); ?> ]]> @@ -121,10 +134,10 @@ Array ]]> @@ -135,7 +148,7 @@ Array ( [0] => 0 [1] => 1 - ) +) ]]> @@ -147,14 +160,14 @@ Array Ta funkcja sprawdza tylko pierwszy wymiar tablicy wielowymiarowej. - Oczywiście można porównać głębsze wymiary używając + Możliwe jest sprawdzenie głębszych wymiarów za pomocą na przykład, array_diff_assoc($array1[0], $array2[0]);. - Upewnij się, że przekazujesz argumenty z odpowiedniej kolejności, gdy porównujesz - podobne tablice z większą ilością kluczy. Nowa tablica powinna być przekazana pierwsza. + Upewnij się, że argumenty są przekazywane we właściwej kolejności podczas porównywania + podobnych tablic z większą liczbą kluczy. Nowa tablica powinna być przekazana pierwsza. diff --git a/reference/array/functions/array-diff-key.xml b/reference/array/functions/array-diff-key.xml index c8bb15d9..b9e84afb 100755 --- a/reference/array/functions/array-diff-key.xml +++ b/reference/array/functions/array-diff-key.xml @@ -1,24 +1,23 @@ - + - + array_diff_key Oblicza różnicę tablic używając kluczy do porównań - + &reftitle.description; arrayarray_diff_key - arrayarray1 - arrayarray2 - array... + arrayarray + arrayarrays - Porównuje klucze z array1 z kluczami z - array2 i zwraca różnicę. + Porównuje klucze z array z kluczami z + arrays i zwraca różnicę. Ta funkcja jest podobna do array_diff, z wyjątkiem faktu że porównywane są klucze zamiast wartości. @@ -30,7 +29,7 @@ - array1 + array Tablica do porównania @@ -39,19 +38,10 @@ - array2 - - - Tablica, z którą funkcja ma porównać - - - - - - ... + arrays - Więcej tablic, z którymi funkcja ma porównać + Tablice do porównania @@ -64,11 +54,30 @@ &reftitle.returnvalues; Zwraca tablicę (array) zawierająca wszystkie wpisy z - array1, których klucze nie są obecne w żadnej + array, których klucze nie są obecne w żadnej z innych tablic. + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &array.changelog.require-only-one; + + + + + + + - + array_diff_uassoc Oblicza różnicę tablic z dodatkowym sprawdzeniem indeksu wykonywanym przez podaną przez użytkownika funkcję - + &reftitle.description; arrayarray_diff_uassoc - arrayarray1 - arrayarray2 - array... + arrayarray + arrayarrays callablekey_compare_func - Porównuje array1 z array2 i + Porównuje tablicę array z tablicami arrays i zwraca różnicę. W przeciwieństwie do array_diff + Porównuje tablicę array z tablicami arrays i + zwraca różnicę. W przeciwieństwie do funkcji array_diff przy porównywaniu używane są klucze tablic. @@ -34,7 +35,7 @@ - array1 + array Tablica do porównania @@ -43,19 +44,10 @@ - array2 + arrays - Tablica, z którą ma porównać funkcja - - - - - - ... - - - Więcej tablic, z którymi ma porównać funkcja + Tablice do porównania @@ -63,10 +55,7 @@ key_compare_func - - &return.callbacksort; - - &callback.cmp; + &sort.callback.description; @@ -78,7 +67,7 @@ &reftitle.returnvalues; Zwraca tablicę (array) zawierającą wszystkie wpisy z tablicy - array1, które nie istnieją w żadnej z innych tablic. + array, które nie istnieją w żadnej z pozostłych tablic. @@ -95,21 +84,20 @@ Przykład użycia <function>array_diff_uassoc</function> - Para "a" => "green" + W tym przykładzie przykładzie "a" => "green" istnieje w obu tablicach i dlatego nie ma jej w wyniku działania funkcji. - Z kolei para 0 => "red" jest w wyniku ponieważ - w drugim parametrze "red" ma klucz który wynosi - 1. + Z kolei para 0 => "red" jest w danych wyjściowych, + ponieważ klucz „red” jest automatycznie przypisany do + 0 w pierwszej tablicy, podczas gdy jest on przypisany do + 1 w drugiej tablicy, ponieważ klucz 0 + jest już zajęty przez yellow. $b)? 1:-1; + return $a <=> $b; } $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red"); @@ -136,14 +124,14 @@ Array - + &reftitle.notes; Ta funkcja sprawdza tylko jeden wymiar tablicy wielowymiarowej. - Można oczywiście porównywać głębsze wymiary używając przykładowo + Możliwe jest sprawdzenie głębszych wymiarów za pomocą na przykład, array_diff_uassoc($array1[0], $array2[0], "key_compare_func");. diff --git a/reference/array/functions/array-diff.xml b/reference/array/functions/array-diff.xml index 27bc216a..9c6de5d3 100644 --- a/reference/array/functions/array-diff.xml +++ b/reference/array/functions/array-diff.xml @@ -1,7 +1,7 @@ - + - + array_diff @@ -12,13 +12,12 @@ &reftitle.description; arrayarray_diff - arraytablica1 - arraytablica2 - array... + arrayarray + arrayarrays - Porównuje tablica1 z jedną lub większą ilością tablic - i zwraca wartości tablica1, które nie są obecne w + Porównuje tablicę array z jedną lub większą ilością tablic + i zwraca wartości w tablicy array, które nie są obecne w żadnej z innych tablic. @@ -28,7 +27,7 @@ - tablica1 + array Tablica którą porównujemy @@ -36,18 +35,10 @@ - tablica2 + arrays - Tablica z którą porównujemy - - - - - ... - - - Więcej tablic z którymi porównujemy + Tablice do porównania @@ -58,8 +49,28 @@ &reftitle.returnvalues; - Zwraca tablicę zawierającą wszystkie elementy z - tablica1, które nie są obecne w żadnej z innych tablic. + Zwraca tablicę zawierającą wszystkie elementy z tablicy + array które nie są obecne w żadnej z pozostałych tablic. + Klucze w tablicy array są zachowywane. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &array.changelog.require-only-one; + + + @@ -71,16 +82,16 @@ "green", "red", "blue", "red"); -$tablica2 = array("b" => "green", "yellow", "red"); -$wynik = array_diff($tablica1, $tablica2); +$array1 = array("a" => "green", "red", "blue", "red"); +$array2 = array("b" => "green", "yellow", "red"); +$result = array_diff($array1, $array2); -print_r($wynik); +print_r($result); ?> ]]> - Wielokrotne wystąpienia w $tablica1 są + Wielokrotne wystąpienia w tablicy $array1 są traktowane w ten sam sposób. Wynikiem będzie: @@ -93,18 +104,54 @@ Array + + + + <function>array_diff</function> z niepasującymi typami + + Dwa elementy są uznawane za równe wtedy i tylko wtedy, gdy + (string) $elem1 === (string) $elem2. To jest, + kiedy reprezentacja jako ciąg znaków jest taka sama. + + + v = $v; + } + + public function __toString() { + return $this->v; + } +} + +$source = [new S('a'), new S('b'), new S('c')]; +$filter = [new S('b'), new S('c'), new S('d')]; + +$result = array_diff($source, $filter); + +// $result zawiera teraz jedną instancję S('a'); +?> +]]> + + + Aby użyć alternatywnej funkcji porównania, zobacz array_udiff. + + + &reftitle.notes; - - - Dwa elementy są uznawane za równe tylko jeżeli - (string) $elem1 === (string) $elem2. Innymi słowy: - gdy reprezentacja jako łańcuch znaków jest jednakowa. - - - Ta funkcja sprawdza tylko pierwszy wymiar tablicy wielowymiarowej. @@ -119,6 +166,7 @@ Array array_diff_assoc + array_udiff array_intersect array_intersect_assoc diff --git a/reference/array/functions/array-fill.xml b/reference/array/functions/array-fill.xml index 3bdf49c9..3b744092 100644 --- a/reference/array/functions/array-fill.xml +++ b/reference/array/functions/array-fill.xml @@ -1,25 +1,25 @@ - - + + array_fill Wypełnia tablicę podanymi wartościami - + &reftitle.description; arrayarray_fill - intindeks_początkowy - intilość - mixedwartość + intstart_index + intcount + mixedvalue Wypełnia tablicę - podaną ilością (num) wpisów określonych przez - wartość zaczynając od indeksu podanego jako - indeks_początkowy. + wpisami o wartości podanej w parametrze value + w ilości podanej w parametrze count zaczynając + od indeksu podanego jako parametr start_index. @@ -29,33 +29,34 @@ - indeks_początkowy + start_index Pierwszy klucz zwracanej tablicy. - Jeżeli indeks_początkowy jest ujemny, - pierwszym indeksem będzie ten podany w parametrze - indeks początkowy a kolejne będą numerowane - od zera - (zobacz przykład). + Jeżeli parametr start_index jest ujemny, + pierwszym indeksem będzie ten podany w parametrze + start_index a kolejne będą numerowane + od zera przed PHP 8.0.0; + od PHP 8.0.0, ujemne klucze są zwiększane normalnie + (see example). - ilość + count Ilość elementów do wstawienia. - Musi być większa lub równa zero. + Musi być większa lub równa zero i mniejsza lub równa 2147483647. - wartość + value Wartość użyta do wypełniania. @@ -77,34 +78,33 @@ &reftitle.errors; - Wyemituje błąd E_WARNING jeżeli ilość jest - mniejsza niż zero. + Zgłosi błąd ValueError jeśli parametr count + jest poza zakresem. &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.6.0 - - ilość może być teraz równa zero. Poprzednio - ilość musiała być większa od zera. - - - - - - + + + + + &Version; + &Description; + + + + + 8.0.0 + + array_fill zgłasza teraz błąd ValueError + jeśli parametr count jest poza zakresem; poprzednio był zgłaszany błąd + E_WARNING i funkcja zwracała &false;. + + + + + @@ -116,9 +116,7 @@ ]]> @@ -134,6 +132,24 @@ Array [9] => banan [10] => banan ) +]]> + + + + + + <function>array_fill</function> z ujemnym indeksem początkowym + + +]]> + + &example.outputs.7; + + gruszka @@ -141,10 +157,25 @@ Array [1] => gruszka [2] => gruszka ) +]]> + + &example.outputs.8; + + gruszka + [-1] => gruszka + [0] => gruszka + [1] => gruszka +) ]]> + + Zauważ, że indeks -1 nie jest obecny przed PHP 8.0.0. + @@ -154,7 +185,7 @@ Array aby zobaczyć dokładne wyjaśnienie na temat ujemnych indeksów. - + &reftitle.seealso; @@ -167,7 +198,6 @@ Array - + - + array_filter Filtruje elementy przy użyciu callbacku - + &reftitle.description; arrayarray_filter - arraytablica - callablecallback - intflaga0 + arrayarray + callablenull + callback&null; + intmode0 + - Iteruje przez każdą wartość w tablicy - przekazując ją do funkcji podanej jako callback. + Iteruje przez każdą wartość w tablicy array + przekazując ją do funkcji podanej jako parametr callback. Jeżeli callback zwraca &true;, obecna wartość - z podanej tablicy jest zwracana w - tablicy wynikowej. Klucze tablic są zachowywane. + z podanej tablicy array jest zwracana w + tablicy wynikowej &array;. + + + Klucze tablicy są zachowywane i mogą powodować luki, jeśli tablica array była indeksowana. + Tablica wynikowa &array; może być reindeksowana przy użyciu funkcji array_values. @@ -31,7 +37,7 @@ - tablica + array Tablica do przefiltrowania @@ -46,16 +52,15 @@ Funkcja zwrotna do użycia - Jeżeli nie został podany callback, to wszystkie wpisy - tablicy odpowiadające &false; (zobacz: - konwersja do - wartości logicznych) zostaną usunięte. + Jeżeli nie został podany parametr callback, to wszystkie puste wpisy + tablicy array zostaną usunięte. Zobacz funkcję empty + aby dowiedzieć się, jak PHP definiuje puste w tym przypadku. - + - flaga + mode Flaga określająca jakie parametry są wysyłane do callbacku: @@ -69,6 +74,8 @@ argumenty do callbacku, zamiast wartości + Domyślnie jest to 0 co spowoduje przekazanie wartości jako jedynego argumentu + do callback. @@ -96,13 +103,12 @@ - 5.6.0 + 8.0.0 - Dodano opcjonalny parametr flagi oraz stałe - ARRAY_FILTER_USE_KEY i - ARRAY_FILTER_USE_BOTH + Parametr callback może mieć teraz wartość null. + &array.changelog.by-ref; @@ -126,7 +132,7 @@ function nieparzysta($var) { // sprawdza czy podana liczba jest nieparzysta - return($var & 1); + return $var & 1; } function parzysta($var) @@ -135,8 +141,8 @@ function parzysta($var) return(!($var & 1)); } -$array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); -$array2 = array(6, 7, 8, 9, 10, 11, 12); +$array1 = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5]; +$array2 = [6, 7, 8, 9, 10, 11, 12]; echo "Nieparzyste:\n"; print_r(array_filter($array1, "nieparzysta")); @@ -172,13 +178,15 @@ Array 'foo', - 1 => false, - 2 => -1, - 3 => null, - 4 => '' - ); +$entry = [ + 0 => 'foo', + 1 => false, + 2 => -1, + 3 => null, + 4 => '', + 5 => '0', + 6 => 0, +]; print_r(array_filter($entry)); ?> @@ -196,8 +204,8 @@ Array - <function>array_filter</function> z - <parameter>flagą</parameter> + <function>array_filter</function> z + <parameter>mode</parameter> - + &reftitle.seealso; + array_intersect array_map array_reduce array_walk @@ -255,7 +264,6 @@ array(2) { - + - + array_flip @@ -15,12 +15,12 @@ array_flip zwraca tablicę (array) w odwróconej - kolejności, np. klucze array stają się wartościami, a wartości - z array stają się kluczami. + kolejności, tzn. klucze tablicy array stają się wartościami, a wartości + z tablicy array stają się kluczami. Zauważ że wartości w tablicy array muszą być poprawnymi - kluczami, np. muszą być typu integer lub + kluczami, np. muszą być typu int lub string. Zostanie wyemitowane ostrzeżenie jeśli wartość ma zły typ, a taka para klucza i wartości nie znajdzie się w wyniku działania funkcji. @@ -50,8 +50,7 @@ &reftitle.returnvalues; - Zwraca odwróconą tablicę w wypadku powodzenia lub &null; w razie - błędu. + Zwraca odwróconą tablicę. @@ -85,7 +84,7 @@ Array - Przykład użycia <function>array_flip</function>: kolizja + <function>array_flip</function>: kolizja - + - - + + array_key_exists Sprawdza czy podany klucz lub indeks istnieje w tablicy - + &reftitle.description; boolarray_key_exists - mixedklucz - arraytablica + stringintfloatbool + resourcenullkey + arrayarray array_key_exists zwraca &true; jeśli - podany klucz jest ustawiony w tablicy. - klucz może być dowolną wartością możliwą + podany klucz key jest ustawiony w tablicy. + Parametr key może być dowolną wartością możliwą dla indeksu tablicy. @@ -28,7 +29,7 @@ - klucz + key Wartość do sprawdzenia. @@ -36,7 +37,7 @@ - tablica + array Tablica z kluczami do sprawdzenia. @@ -60,6 +61,31 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Parametr key akceptuje teraz + bool, float, int, + null, resource, i + string jako argumenty. + + + + + + + &reftitle.examples; @@ -80,7 +106,7 @@ if (array_key_exists('pierwszy', $tablica)) { <function>array_key_exists</function> vs <function>isset</function> - isset nie zwraca &true; dla kluczy + Funkcja isset nie zwraca &true; dla kluczy przypisanych do wartości &null;, podczas gdy array_key_exists tak. @@ -105,15 +131,14 @@ array_key_exists('pierwszy', $tablica); Z powodu kompatybilności wstecznej, array_key_exists - zwróci &true; także wtedy, gdy klucz jest właściwością - zdefiniowaną w ramach obiektu podanego jako parametr - tablica. Nie powinno się polegać na tym zachowaniu - i powinno się zadbać, aby tablica była - rzeczywiście typu array. + zwróci &true; także wtedy, gdy parametr key jest właściwością + zdefiniowaną w ramach obiektu object podanego jako parametr + array. To zachowanie jest przestarzałe od PHP 7.4.0, + i usunięte od PHP 8.0.0. - Aby sprawdzić czy właściwość istnieje w obiekcie, użyj - property_exists. + Aby sprawdzić czy właściwość istnieje w obiekcie, + powinna zostać użyta funkcjaproperty_exists. @@ -130,7 +155,6 @@ array_key_exists('pierwszy', $tablica); - + - + array_keys Zwraca wszystkie klucze lub podzbiór kluczy z tablicy - + &reftitle.description; arrayarray_keys - arraytablica + arrayarray arrayarray_keys - arraytablica - mixedszukana_wartość - boolścisłe_porównanie&false; + arrayarray + mixedfilter_value + boolstrict&false; array_keys zwraca klucze, numeryczne - i tekstowe, z tablicy. + i tekstowe, z tablicy array. - Jeżeli parametr szukana_wartość został podany, + Jeżeli parametr filter_value został podany, to zwracane są klucze tylko dla tej wartości. W przeciwnym wypadku zwrócone - zostaną wszystkie klucze z podanej tablicy. + zostaną wszystkie klucze z podanej tablicy array. @@ -36,7 +36,7 @@ - tablica + array Tablica zawierająca klucze do zwrócenia. @@ -44,15 +44,15 @@ - szukana_wartość + filter_value - Jeżeli podano, to zwracane są klucze tylko dla tej wartości. + Jeżeli podano, to zwracane są klucze zawierające tą wartość. - ścisłe_porównanie + strict Określa czy podczas szukania powinno być użyte ścisłe (===) porównanie. @@ -66,7 +66,7 @@ &reftitle.returnvalues; - Zwraca tablicę wszystkich kluczy z parametru tablica. + Zwraca tablicę wszystkich kluczy z tablicy array. @@ -78,14 +78,14 @@ 100, "kolor" => "czerwony"); +$array = array(0 => 100, "color" => "red"); print_r(array_keys($array)); -$array = array("niebieski", "czerwony", "zielony", "niebieski", "niebieski"); -print_r(array_keys($array, "niebieski")); +$array = array("blue", "red", "green", "blue", "blue"); +print_r(array_keys($array, "blue")); -$array = array("kolor" => array("niebieski", "czerwony", "zielony"), - "rozmiar" => array("mały", "średni", "duży")); +$array = array("color" => array("blue", "red", "green"), + "size" => array("small", "medium", "large")); print_r(array_keys($array)); ?> ]]> @@ -96,7 +96,7 @@ print_r(array_keys($array)); Array ( [0] => 0 - [1] => kolor + [1] => color ) Array ( @@ -106,8 +106,8 @@ Array ) Array ( - [0] => kolor - [1] => rozmiar + [0] => color + [1] => size ) ]]> diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml index 1f6e544f..06e70c08 100644 --- a/reference/array/functions/array-map.xml +++ b/reference/array/functions/array-map.xml @@ -1,27 +1,31 @@ - + - - + + array_map Stosuje podany callback do elementów podanych tablic - + &reftitle.description; arrayarray_map - callablecallback - arrayarray1 - array... + callablenull + callback + arrayarray + arrayarrays - array_map zwraca tablicę zawierającą wszystkie - elementy array1 po wykonaniu funkcji - callback na każdym z nich. - Liczba parametrów przyjmowanych przez callback - powinna wynosić tyle, ile tablic przekazano do array_map + array_map zwraca tablicę &array; zawierającą + wyniki zastosowania callback do odpowiedniej wartości + tablicy array (i tablic arrays, jeśli podano + więcej tablic) użytych jako argumenty dla funkcji zwrotnej callback. Liczba + parametrów, które callback akceptuje, powinna być + zgodna z liczbą tablic przekazanych do funkcji array_map. + Nadmiarowe tablice wejściowe są ignorowane. Błąd ArgumentCountError + jest zgłaszany, jeśli podano niewystarczającą liczbę argumentów. @@ -33,12 +37,18 @@ callback - Funkcja zwrotna do wykonania na każdym elemencie każdej tablicy. + Funkcja zwrotna callable do uruchomienia na każdym elemencie w każdej tablicy. + + + &null; może być przekazana jako wartość do callback + aby wykonać operację zip na wielu tablicach. + Jeśli tylko tablica array została podana, + array_map zwróci tablicę wejściową. - array1 + array Tablica do przepuszczenia przez podany callback. @@ -46,11 +56,11 @@ - ... + arrays - Dalsza lista tablic do przepuszczenia przez funkcję podaną - w argumencie callback. + Dodatkowa zmienna lista argumentów tablicowych, które mają być uruchomione + przez funkcję callback. @@ -61,9 +71,33 @@ &reftitle.returnvalues; - Zwraca tablicę zawierającą wszystkie elementy array1 - po wykonaniu funkcji callback na każdym z nich. + Zwraca tablicę zawierającą wyniki zastosowania funkcji callback + do odpowiedniej wartości tablicy array + (i tablic arrays jeśli podano więcej tablic) + używanych jako argumenty funkcji zwrotnej callback + + Zwrócona tablica zachowa klucze argumentu tablicy wtedy i tylko wtedy, + jeśli przekazano dokładnie jedną tablicę. Jeśli przekazano więcej niż jedną tablicę, + zwrócona tablica będzie miała sekwencyjne klucze liczb całkowitych. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &array.changelog.by-ref; + + + @@ -76,11 +110,11 @@ ]]> @@ -104,15 +138,21 @@ Array - <function>array_map</function> z użyciem funkcji anonimowej (od PHP 5.3.0) + <function>array_map</function> używa funkcji lambda $value * 2, range(1, 5))); + + ?> ]]> @@ -132,27 +172,27 @@ Array - <function>array_map</function> - większa ilość tablic + <function>array_map</function> - użycie większej ilości tablic $m)); + return [$n => $m]; } -$a = array(1, 2, 3, 4, 5); -$b = array("uno", "dos", "tres", "cuatro", "cinco"); +$a = [1, 2, 3, 4, 5]; +$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco']; -$c = array_map("show_Spanish", $a, $b); +$c = array_map('show_Spanish', $a, $b); print_r($c); -$d = array_map("map_Spanish", $a , $b); +$d = array_map('map_Spanish', $a , $b); print_r($d); ?> ]]> @@ -217,13 +257,13 @@ Array - Tworzenie tablicy tablic + Wykonywanie operacji zip na tablicach - Zwracana tablica zachowa klucze tablicy podanej jako argument jeśli i tylko - jeśli przekazany zostanie dokładnie jedna tablica. Jeśli zostanie przekazana - więcej niż jedna tablica, zwrócona tablica otrzyma kolejne klucze numeryczne. + + + &null; <parameter>callback</parameter> tylko z + <parameter>array</parameter> + + + +]]> + + &example.outputs; + + + int(1) + [1]=> + int(2) + [2]=> + int(3) +} +]]> + + @@ -286,15 +350,15 @@ Array "wartość"); +$arr = ['stringkey' => 'value']; function cb1($a) { - return array ($a); + return [$a]; } function cb2($a, $b) { - return array ($a, $b); + return [$a, $b]; } -var_dump(array_map("cb1", $arr)); -var_dump(array_map("cb2", $arr, $arr)); +var_dump(array_map('cb1', $arr)); +var_dump(array_map('cb2', $arr, $arr)); var_dump(array_map(null, $arr)); var_dump(array_map(null, $arr, $arr)); ?> @@ -332,6 +396,44 @@ array(1) { string(5) "wartość" } } +]]> + + + + <function>array_map</function> - tablice asocjacyjne + + Chociaż array_map nie obsługuje bezpośrednio używania klucza tablicy + jako danych wejściowych, można to symulować za pomocą funkcji array_keys. + + + 'First release', + 'v2' => 'Second release', + 'v3' => 'Third release', +]; + +// Notatka: Przed 7.4.0, zamiast tego użyj dłuższej składni dla funkcji anonimowych. +$callback = fn(string $k, string $v): string => "$k was the $v"; + +$result = array_map($callback, array_keys($arr), array_values($arr)); + +var_dump($result); +?> +]]> + + &example.outputs; + + + string(24) "v1 was the First release" + [1]=> + string(25) "v2 was the Second release" + [2]=> + string(24) "v3 was the Third release" +} ]]> @@ -349,7 +451,6 @@ array(1) { - + + array_pad - Dopełnij tablicę do podanej długości podanymi wartościami + Dopełnia tablicę do podanej długości podanymi wartościami &reftitle.description; arrayarray_pad - arraytablica - introzmiar - mixedwartość + arrayarray + intlength + mixedvalue array_pad zwraca kopię tablicy - tablica dopełnioną do rozmiaru określonego przez - rozmiar wartością - wartość. Jeśli rozmiar + array dopełnioną do rozmiaru określonego przez + parametr length wartością podaną przez parmetr + value. Jeśli parametr length jest wartością dodatnią, to tablica jest dopełniana z prawej strony, jeśli ujemna to z lewej. Jeśli wartość bezwzględna parametru - rozmiar jest mniejsza lub równa długości tablicy - tablica, to tablica nie jest dopełniana. - Możliwe jest dodanie co najwyżej 1048576 elementów za jednym wywołaniem - funkcji. + length jest mniejsza lub równa długości tablicy + array, to tablica nie jest dopełniana. @@ -34,7 +33,7 @@ - tablica + array Początkowa tablica, której wartości mają być dopełnione. @@ -42,7 +41,7 @@ - rozmiar + length Nowy rozmiar tablicy. @@ -50,12 +49,12 @@ - wartość + value Wartość, której należy użyć do dopełniania jeśli - tablica jest mniejsza niż - rozmiar. + tablica array jest mniejsza niż + parametr length. @@ -66,13 +65,38 @@ &reftitle.returnvalues; - Zwraca kopię tablicy tablica dopełnioną do rozmiaru - określonego przez rozmiar wartością - wartość. Jeśli rozmiar jest + Zwraca kopię tablicy array dopełnioną do rozmiaru + określonego przez parametr length wartością okeśloną przez + parametr value. Jeśli parametr length jest wartością dodatnią, to tablica jest dopełniana z prawej strony, jeśli ujemna to z lewej. Jeśli wartość bezwzględna parametru - rozmiar jest mniejsza lub równa długości tablicy - tablica, to tablica nie jest dopełniana. + length jest mniejsza lub równa długości tablicy + array, to tablica nie jest dopełniana. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.3.0 + + Przed wersją 8.3 można było dodać jednocześnie tylko 1048576 elementów. + Teraz ograniczeniem jest tylko maksymalny rozmiar tablicy. + + + + + @@ -84,15 +108,15 @@ ]]> @@ -110,7 +134,6 @@ $wynik = array_pad($wejscie, 2, "noop"); - + - + array_shift @@ -11,14 +11,14 @@ &reftitle.description; mixedarray_shift - arraytablica + arrayarray array_shift zwraca pierwszą wartość tablicy (z parametru - tablica), jednocześnie usuwając ten element z tablicy - i cofając wszystkie jej indeksy o jeden. + array), jednocześnie usuwając ten element z tablicy + i cofając wszystkie jej indeksy o jeden. Tablice numeryczne będą tak zmodyfikowane, aby indeksy zaczynały się od zera, - a klucze tablic asocjacyjnych pozostaną nienaruszone. + podczas, gdy klucze tablic asocjacyjnych nie zostaną naruszone. &array.resetspointer; @@ -27,7 +27,7 @@ - tablica + array Tablica wejściowa. @@ -40,7 +40,7 @@ &reftitle.returnvalues; - Zwraca usunięty element lub &null; jeśli tablica jest + Zwraca usunięty element lub &null; jeśli tablica array jest pusta, lub jeśli w rzeczywistości nie jest tablicą. @@ -52,7 +52,7 @@ @@ -64,13 +64,13 @@ print_r($stack); Array ( [0] => banan - [1] => jabłko - [2] => malina + [1] => apple + [2] => raspberry ) ]]> - a pomarańcza zostanie przypisana do + a orange zostanie przypisana do $fruit. diff --git a/reference/array/functions/array-sum.xml b/reference/array/functions/array-sum.xml index cfdd5ddf..c3090caf 100644 --- a/reference/array/functions/array-sum.xml +++ b/reference/array/functions/array-sum.xml @@ -1,6 +1,7 @@ - + + array_sum @@ -9,8 +10,8 @@ &reftitle.description; - numberarray_sum - arraytablica + intfloatarray_sum + arrayarray array_sum zwraca sumę wartości w tablicy. @@ -21,7 +22,7 @@ - tablica + array Tablica wejściowa. @@ -35,9 +36,37 @@ &reftitle.returnvalues; Zwraca sumę wartości jako liczbę całkowitą lub zmiennoprzecinkową; 0 jeśli - tablica jest pusta. + tablica array jest pusta. + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.3.0 + + Teraz emituje błąd E_WARNING kiedy wartości tablicyarray + nie mogą być skonwertowane na typ &integer; lub &float;. Wcześniej tablice &array; i obiekty &object; + były ignorowane, podczas gdy każda inna wartość była rzutowana na typ &integer;. Ponadto obiekty, + definiują rzutowanie numeryczne (n.p. GMP) są teraz rzutowane zamiast ignorowane. + + + + + + + + &reftitle.examples; diff --git a/reference/array/functions/array-unique.xml b/reference/array/functions/array-unique.xml index 8f82c294..3b47701f 100644 --- a/reference/array/functions/array-unique.xml +++ b/reference/array/functions/array-unique.xml @@ -1,7 +1,7 @@ - + - + array_unique @@ -12,25 +12,23 @@ &reftitle.description; arrayarray_unique - arraytablica - intopcje_sortowaniaSORT_STRING + arrayarray + intflagsSORT_STRING - Pobiera parametr tablica i zwraca nową tablicę + Pobiera wejściową tablicę array i zwraca nową tablicę bez duplikatów wartości. - Zauważ, że klucze są zachowywane. array_unique - najpierw sortuje wartości skonwertowane na ciągi a później zachowuje - pierwszy napotkany klucz dla każdej wartości ignorując wszystkie - pozostałe klucze. Nie oznacza to, że klucz pierwszej związanej wartości z - nieposortowanej tablicy będzie zachowany. + Zauważ, że klucze są zachowywane. Jeśli wiele elementów porównywanych jest + równych w ramach danego parmetru flags, wówczas klucz + i wartość pierwszego równego elementu zostaną zachowane. Dwa elementy tablicy są uważane za równe wtedy i tylko wtedy jeśli (string) $elem1 === (string) $elem2, to znaczy gdy - reprezentacje wartości w postaci stringów są takie same, to użyty będzie pierwszy element. + reprezentacje jako ciąg znaków są takie same, to użyty będzie pierwszy element. @@ -40,7 +38,7 @@ - tablica + array Tablica wejściowa. @@ -48,14 +46,14 @@ - opcje_sortowania + flags - Drugi, opcjonalny parametr opcje_sortowania - może być użyty do zmiany zachowania podczas sortowania za pomocą następujących wartości: + Drugi, opcjonalny parametr flags + może być użyty do zmiany zachowania podczas porównywania za pomocą następujących wartości: - Opcje sortowania: + Flagi typu porównywania: SORT_REGULAR - porównuje pozycje normalnie @@ -100,18 +98,13 @@ - 5.2.10 + 7.2.0 - Zmiana domyślnej wartości opcje_sortowania ponowanie na - SORT_STRING. - - - - 5.2.9 - - Dodano nową domyślną opcje_sortowania - SORT_REGULAR. Przed PHP 5.2.9, ta funkcja była używana - wewnętrznie do sortowania tablic z opcją SORT_STRING. + Jeśli parametr flags ma wartość SORT_STRING, + wcześniej tablica array została skopiowana i nieunikalne + elementy zostały usunięte (bez późniejszego pakowania tablicy), ale teraz budowana + jest nowa tablica poprzez dodanie unikalnych elementów. Może to skutkować + różnymi indeksami liczbowymi. @@ -128,9 +121,9 @@ "zielony", "czerwony", "b" => "zielony", "niebieski", "czerwony"); -$wynik = array_unique ($wejscie); -print_r($wynik); +$input = array ("a" => "green", "red", "b" => "green", "blue", "red"); +$result = array_unique ($input); +print_r($result); ?> ]]> @@ -139,9 +132,9 @@ print_r($wynik); zielony - [0] => czerwony - [1] => niebieski + [a] => green + [0] => red + [1] => blue ) ]]> @@ -153,9 +146,9 @@ Array ]]> @@ -172,15 +165,6 @@ array(2) { - - &reftitle.seealso; - - - array_count_values - - - - &reftitle.notes; @@ -191,8 +175,15 @@ array(2) { + + &reftitle.seealso; + + + array_count_values + + + - + - + array_walk - Zastosuj funkcję użytkownika do każdego elementu tablicy + Stosuje funkcję użytkownika do każdego elementu tablicy &reftitle.description; boolarray_walk - arrayobjecttablica - callablenazwa_funkcji - mixeddane&null; + arrayobjectarray + callablecallback + mixedarg&null; - Wykonuje zdefiniowaną przez użytkownika funkcję nazwa_funkcji na każdym - elemencie tablicy tablica. + Wykonuje zdefiniowaną przez użytkownika funkcję callback na każdym + elemencie tablicy array. Na działanie array_walk nie wpływa pozycja wewnętrznego wskaźnika - parametru array. array_walk + tablicy array. array_walk przetworzy wszystkie elementy tablicy niezależnie od pozycji tego wskaźnika. @@ -30,7 +30,7 @@ - tablica + array Tablica wejściowa. @@ -38,17 +38,17 @@ - nazwa_funkcji + callback - Zazwyczaj nazwa_funkcji przyjmuje dwa parametry. - Pierwszym jest element tablicy tablica, + Zazwyczaj callback przyjmuje dwa parametry. + Pierwszym jest element tablicy array, natomiast drugim klucz lub numer indeksu tego elementu. - Jeśli nazwa_funkcji ma zmieniać wartości tablicy, - należy określić pierwszy argument nazwa_funkcji + Jeśli callback ma zmieniać wartości tablicy, + należy określić pierwszy parametr callback jako referencję. W tym przypadku wszystkie zmiany dokonane przez tą funkcję będą dokonywane bezpośrednio na oryginalnej tablicy. @@ -57,13 +57,13 @@ Wiele wewnętrznych funkcji (na przykład strtolower) - wygeneruje ostrzeżenie jeśli przekazanych zostanie więcej argumentów + wygeneruje ostrzeżenie, jeśli przekazanych zostanie więcej argumentów niż oczekiwano i nie nadają się do użycia bezpośrednio jako callback. - Tylko wartości tablicy tablica mogą być + Tylko wartości tablicy array mogą być zmieniane; jej struktura nie może modyfikowana, czyli np. programista nie może dodać, usunąć lub zmieniać kolejności elementów. Jeśli funkcja zwrotna nie respektuje tych wymogów, to jej zachowanie będzie nieokreślone @@ -72,12 +72,12 @@ - dane + arg - Jeśli podany zostanie opcjonalny parametr dane, + Jeśli podany zostanie opcjonalny parametr arg, to zostanie on przekazany jako trzeci parametr do - nazwa_funkcji. + callback. @@ -94,12 +94,12 @@ &reftitle.errors; - Od PHP 7.1.0 wygenerowany zostanie ArgumentCountError jeśli funkcja nazwa_funkcji + Od PHP 7.1.0 wygenerowany zostanie ArgumentCountError jeśli funkcja callback wymaga więcej niż 2 parametry (wartość i klucz tablicy) - lub więcej niż 3 parametry jeśli zostały przekazane również dane. + lub więcej niż 3 parametry jeśli zostały przekazane również arg. Poprzednio w tym wypadku zostałby wygenerowany błąd poziomu E_WARNING za każdym razem kiedy - array_walk wywoływałby nazwa_funkcji. + array_walk wywoływałby callback. @@ -117,8 +117,8 @@ 8.0.0 - Jeśli nazwa_funkcji oczekuje drugiego lub trzeciego parametru przekazanego - przez referencję, wówczas ta funkcja wyemituje E_WARNING. + Jeśli callback oczekuje drugiego lub trzeciego parametru przekazanego + przez referencję, wówczas ta funkcja wyemituje błąd E_WARNING. @@ -134,25 +134,25 @@ "cytryna", "a" => "pomarańcza", "b" => "banan", "c" => "jabłko"); +$fruits = array ("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple"); -function testowa_zmiana(&$element1, $klucz, $prefiks) +function test_alter(&$element1, $key, $prefiks) { $element1 = "$prefiks: $element1"; } -function testowe_wyswietlenie($element2, $klucz) +function test_print($element2, $key) { - echo "$klucz. $element2\n"; + echo "$key. $element2\n"; } echo "Przed ...:\n"; -array_walk ($owoce, 'testowe_wyswietlenie'); +array_walk ($fruits, 'test_print'); -array_walk ($owoce, 'testowa_zmiana', 'owoc'); +array_walk ($fruits, 'test_alter', 'fruit'); echo "... i po:\n"; -array_walk ($owoce, 'testowe_wyswietlenie'); +array_walk ($fruits, 'test_print'); ?> ]]> @@ -160,15 +160,40 @@ array_walk ($owoce, 'testowe_wyswietlenie'); + + + + + + <function>array_walk</function> przykład z użyciem funkcji anonimowej + + {$value}\n"; +}); + +?> +]]> + + &example.outputs; + + a +1 => b +2 => c ]]> diff --git a/reference/array/functions/array.xml b/reference/array/functions/array.xml index 4376a747..039473ec 100644 --- a/reference/array/functions/array.xml +++ b/reference/array/functions/array.xml @@ -1,21 +1,21 @@ - + - + array - Stwórz tablicę + Tworzy tablicę &reftitle.description; arrayarray - mixed... + mixedvalues - Tworzy tablicę. Przeczytaj rozdział poświęcony - typowi tablicowemu, żeby dowiedzieć się + Tworzy tablicę. Przeczytaj rozdział poświęcony typowi tablicowemu + array type, żeby dowiedzieć się czym jest tablica. @@ -24,7 +24,7 @@ - ... + values Składnia "index => wartości", oddzielona przecinkami, definiuje pary @@ -32,8 +32,8 @@ stałoprzecinkową. Jeśli indeks zostanie pominięty, automatycznie wygenerowany zostanie indeks będący liczbą całkowitą, poczynając od 0. Jeśli indeks jest liczbą całkowitą, następny wygenerowany indeks będzie - miał wartość "największy indeks + 1". Zauważ, że jeśli pojawią się dwie - wartości o tym samym indeksie, ostatnia nadpisze wcześniejsze. + miał wartość "największy indeks + 1". Zauważ, że jeśli są zdefiniowane + dwa takie same indeksy, ostatni zastąpi pierwszy. Przecinek po ostatniej podanej wartości, mimo że jest niespotykany, jest @@ -48,8 +48,8 @@ &reftitle.returnvalues; Zwraca tablicę parametrów. Parametrom można przypisać - indeks używając operatora =>. Przeczytaj rozdział - o typie tablicowym, aby dowiedzieć się + indeks używając operatora =>. Przeczytaj rozdział o typie tablicowym + array type, aby dowiedzieć się czym dokładnie jest tablica. @@ -65,9 +65,9 @@ array("a" => "pomarańcza", "b" => "banan", "c" => "jabłko"), - "liczby" => array(1, 2, 3, 4, 5, 6), - "dziury" => array("pierwsza", 5 => "druga", "trzecia") + "fruits" => array("a" => "orange", "b" => "banana", "c" => "apple"), + "numbers" => array(1, 2, 3, 4, 5, 6), + "dziury" => array("first", 5 => "second", "third") ); ?> ]]> @@ -114,8 +114,8 @@ Array 'Styczeń', 'Luty', 'Marzec'); -print_r($kwartal); +$firstquarter = array(1 => 'January', 'February', 'March'); +print_r($firstquarter); ?> ]]> @@ -124,9 +124,9 @@ print_r($kwartal); Styczeń - [2] => Luty - [3] => Marzec + [1] => January + [2] => February + [3] => March ) ]]> diff --git a/reference/array/sorting.xml b/reference/array/sorting.xml index b39fa391..6714006d 100644 --- a/reference/array/sorting.xml +++ b/reference/array/sorting.xml @@ -1,5 +1,6 @@ - + + Sortowanie tablic @@ -18,8 +19,8 @@ są resetowane i tablice otrzymują indeksy numeryczne (0,1,2...) - Kolejność sortowania: alfabetyczna, rosnąca, malejąca, numeryczna, - naturalna, losowa lub określona przez użytkownika + Kolejność sortowania: alfabetyczna, rosnąca (od najniższej do najwyższej), + malejąca (od najwyższej do najniższej), naturalna, losowa lub zdefiniowana przez użytkownika Uwaga: wszystkie z funkcji sortujących operują bezpośrednio @@ -27,8 +28,9 @@ tablicę. - Jeżeli którakolwiek z tych funkcji określa dwa elementy jako równoznaczne, - oznacza to że kolejność nie została zdefiniowana (sortowanie nie działa poprawnie). + Jeśli którakolwiek z tych funkcji sortowania oceni dwa elementy jako równe, + zachowują one swoją pierwotną kolejność. + Przed PHP 8.0.0 ich kolejność była niezdefiniowana (sortowanie nie było stabilne). @@ -49,7 +51,7 @@ array_multisort wartości - asocjacyjne tak, numeryczne nie + string klucze tak, int klucze nie pierwsza tablica lub opcje sortowania array_walk @@ -142,7 +144,6 @@ -