Skip to content

Commit

Permalink
Sync array functions with EN (#4)
Browse files Browse the repository at this point in the history
  • Loading branch information
@grzegorz-bankowski
grzegorz-bankowski authored May 22, 2024
1 parent 673af20 commit 0409835
Show file tree
Hide file tree
Showing 20 changed files with 836 additions and 516 deletions.
59 changes: 42 additions & 17 deletions reference/array/functions/array-chunk.xml
View file
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: leszek Status: ready -->
<!-- EN-Revision: 214519fdbdd6bfe2942775d3554fa8f440f85404 Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak -->
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.array-chunk" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_chunk</refname>
<refpurpose>Podziel tablicę na kawałki</refpurpose>
<refpurpose>Dzieli tablicę na kawałki</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>array_chunk</methodname>
<methodparam><type>array</type><parameter>tablica</parameter></methodparam>
<methodparam><type>int</type><parameter>rozmiar</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>zachowaj_klucze</parameter><initializer>&false;</initializer></methodparam>
<methodparam><type>array</type><parameter>array</parameter></methodparam>
<methodparam><type>int</type><parameter>length</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>preserve_keys</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Dzieli tablicę po ilości elementów określonej jako <parameter>rozmiar</parameter>.
Ostatni kawałek może zawierać mniej elementów niż określono w argumencie
<parameter>rozmiar</parameter>.
Dzieli tablicę po ilości elementów określonej jako <parameter>length</parameter>.
Ostatni kawałek może zawierać mniej elementów niż określono w parametrze
<parameter>length</parameter>.
</para>
</refsect1>

Expand All @@ -29,7 +29,7 @@
<variablelist>

<varlistentry>
<term><parameter>tablica</parameter></term>
<term><parameter>array</parameter></term>
<listitem>
<para>
Tablica do podzielenia
Expand All @@ -38,7 +38,7 @@
</varlistentry>

<varlistentry>
<term><parameter>rozmiar</parameter></term>
<term><parameter>length</parameter></term>
<listitem>
<para>
Rozmiar każdego z fragmentów
Expand All @@ -47,7 +47,7 @@
</varlistentry>

<varlistentry>
<term><parameter>zachowaj_klucze</parameter></term>
<term><parameter>preserve_keys</parameter></term>
<listitem>
<para>
Kiedy ustawione na &true;, klucze zostaną zachowane.
Expand All @@ -65,18 +65,44 @@
&reftitle.returnvalues;
<para>
Zwraca tablicę wielowymiarową, numerowaną od zera, gdzie każdy
wymiar zawiera ilość elementów określoną jako <parameter>rozmiar</parameter>.
wymiar zawiera ilość elementów określoną jako parametr <parameter>length</parameter>.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Jeżeli <parameter>rozmiar</parameter> jest mniejszy niż 1,
zostanie wygenerowany <constant>E_WARNING</constant> i zwrócony &null;.
Jeżeli parametr <parameter>length</parameter> jest mniejszy niż <literal>1</literal>,
zostanie zgłoszony błąd<classname>ValueError</classname>.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Jeśli <parameter>length</parameter> jest mniejszy niż <literal>1</literal>,
Jeśli parametr <parameter>length</parameter> jest mniejszy niż <literal>1</literal>,
zostanie teraz zgłoszony błąd <classname>ValueError</classname>;
poprzednio zamiast tego zgłaszany był błąd poziomu<constant>E_WARNING</constant>
i funkcja zwracała &null;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -150,7 +176,6 @@ Array
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
75 changes: 40 additions & 35 deletions reference/array/functions/array-combine.xml
View file
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 12ccdb90a13179977809887611fdca0e5aa5b4eb Maintainer: sobak Status: ready -->
<!-- EN-Revision: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: leszek -->
<!-- CREDITS: leszek, grzesiek -->
<refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_combine</refname>
<refpurpose>Tworzy tablicę używając wartości jednej tablicy jako kluczy a drugiej jako wartości</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>array_combine</methodname>
<methodparam><type>array</type><parameter>klucze</parameter></methodparam>
<methodparam><type>array</type><parameter>wartości</parameter></methodparam>
<methodparam><type>array</type><parameter>keys</parameter></methodparam>
<methodparam><type>array</type><parameter>values</parameter></methodparam>
</methodsynopsis>
<para>
Tworzy tablicę używając wartości z tablicy
<parameter>klucze</parameter> jako kluczy i wartości z tablicy
<parameter>wartości</parameter> jako ich wartości.
<parameter>keys</parameter> jako kluczy i wartości z tablicy
<parameter>values</parameter> jako ich wartości.
</para>
</refsect1>

Expand All @@ -28,7 +28,7 @@
<variablelist>

<varlistentry>
<term><parameter>klucze</parameter></term>
<term><parameter>keys</parameter></term>
<listitem>
<para>
Tablica kluczy do użycia. Niepoprawne wartości będą
Expand All @@ -38,7 +38,7 @@
</varlistentry>

<varlistentry>
<term><parameter>wartości</parameter></term>
<term><parameter>values</parameter></term>
<listitem>
<para>
Tablica wartości do użycia.
Expand All @@ -53,45 +53,49 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca wynikową tablicę lub &false; jeżeli liczba elementów z obu tablic
nie pasuje do siebie.
Zwraca połączoną tablicę (<type>array</type>).
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Generuje błąd <constant>E_WARNING</constant> jeżeli liczba elementów w tablicach
<parameter>klucze</parameter> i <parameter>wartości</parameter> nie jest
Od PHP 8.0.0 zgłaszany jest błąd <classname>ValueError</classname>, jeśli liczba elementów w
<parameter>keys</parameter> i <parameter>values</parameter> nie jest
jednakowa.
Przed PHP 8.0.0 zamiast tego emitowany był błąd <constant>E_WARNING</constant>.
Od PHP 8.0.0 zgłaszany jest błąd <classname>ValueError</classname>, jeśli liczba elementów w
parametrach <parameter>keys</parameter> i <parameter>values</parameter>
nie jest jednakowa.
Przed PHP 8.0.0 zamiast tego emitowany był błąd <constant>E_WARNING</constant>.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.4.0</entry>
<entry>
Poprzednie wersje generowały błąd <constant>E_WARNING</constant> i zwracały
&false; dla pustych tablic.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<function>array_combine</function> zgłasza teraz błąd
<classname>ValueError</classname> jeśli liczba elementów
dla każdej z tablic nie jest równa;
poprzednio funkcja ta zwracała &false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -130,6 +134,7 @@ Array
<member><function>array_merge</function></member>
<member><function>array_walk</function></member>
<member><function>array_values</function></member>
<member><function>array_map</function></member>
</simplelist>
</para>
</refsect1>
Expand Down
19 changes: 10 additions & 9 deletions reference/array/functions/array-count-values.xml
View file
Original file line number Diff line number Diff line change
@@ -1,22 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3ce14fde5cd5f15171a7ed2b64fdc7bd652c3842 Maintainer: sobak Status: ready -->
<!-- EN-Revision: 6b56e6f444e49396ee5122258ee85b99a8543f6a Maintainer: sobak Status: ready -->
<!-- $Revision$ -->
<!-- CREDITS: sobak, grzesiek -->
<refentry xml:id="function.array-count-values" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_count_values</refname>
<refpurpose>Zlicza wszystkie wartości w tablicy</refpurpose>
<refpurpose>Zlicza wystąpienia każdej odrębnej wartości w tablicy</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>array_count_values</methodname>
<methodparam><type>array</type><parameter>tablica</parameter></methodparam>
<methodparam><type>array</type><parameter>array</parameter></methodparam>
</methodsynopsis>
<para>
<function>array_count_values</function> zwraca tablicę zawierającą
wartości <parameter>tablicy</parameter> jako klucze i częstość
ich występowania w <parameter>tablicy</parameter> jako wartości.
wartości tablicy <parameter>array</parameter> (które muszą być typu &integer; lub &string;) jako klucze i
ile razy wystąpiły w tablicy <parameter>array</parameter> jako wartości.
</para>
</refsect1>

Expand All @@ -26,7 +27,7 @@
<variablelist>

<varlistentry>
<term><parameter>tablica</parameter></term>
<term><parameter>array</parameter></term>
<listitem>
<para>
Tablica wartości do zliczenia
Expand All @@ -41,7 +42,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca asocjacyjną tablicę wartości z <parameter>tablica</parameter> jako
Zwraca asocjacyjną tablicę wartości z <parameter>array</parameter> jako
kluczami i ich ilością jako wartością.
</para>
</refsect1>
Expand All @@ -50,7 +51,7 @@
&reftitle.errors;
<para>
Emituje błąd <constant>E_WARNING</constant> dla każdego elementu, który nie jest typu
<type>string</type> lub <type>integer</type>.
<type>string</type> lub <type>int</type>.
</para>
</refsect1>

Expand Down
Loading

0 comments on commit 0409835

Please sign in to comment.