Skip to content

Add translation for str_increment() and str_decrement() #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Add translation for str_increment() and str_decrement() #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
229f431
Add Polish translation for str_increment() and str_decrement()
lacatoire Feb 25, 2026
0fb771d
Fix CI: add missing xml:id for scale parameter in bcadd
lacatoire Feb 27, 2026
9db90e7
Fix CI: align bcadd.xml and fgetcsv.xml with doc-en structure
lacatoire Feb 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions reference/bc/functions/bcadd.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,15 +42,15 @@
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>scale</parameter></term>
<varlistentry xml:id="function.bcadd..parameters.scale">
<term><parameter>scale</parameter></term>
<listitem>
<para>
<simpara>
Ten parametr służy do ustawienia liczby cyfr po kropce w wyniku.
Jeśli zostanie ustawiony na &null;, to funkcja użyje domyślnej skali ustawionej funkcją <function>bcscale</function>
lub alternatywnie skorzysta z wartości
dyrektywy INI <link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
Expand Down
23 changes: 13 additions & 10 deletions reference/filesystem/functions/fgetcsv.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,18 +89,21 @@
Musi być znakiem jednobajtowym lub pustym ciągiem znaków.
Pusty ciąg znaków (<literal>""</literal>) wyłącza własnościowy mechanizm ucieczki.
</para>
<note>
<warning xml:id="function.fgetcsv..warn.escape.parameter">
<simpara>
Zazwyczaj znak <parameter>enclosure</parameter> jest unikany wewnątrz pola
poprzez jego podwojenie; jednak znak <parameter>escape</parameter>
może być użyty jako alternatywa. Tak więc dla domyślnych wartości
parametrów <literal>""</literal> i <literal>\"</literal> mają takie samo
znaczenie. Poza umożliwieniem ucieczki przed znakiem
<parameter>enclosure</parameter>, znak
<parameter>escape</parameter> nie specjalnego znaczenia; nie jest nawet
przeznaczony do ucieczki przed samym sobą.
W strumieniu wejściowym znak <parameter>enclosure</parameter>
zawsze może być unikany przez podwojenie wewnątrz cytowanego ciągu,
co daje pojedynczy znak <parameter>enclosure</parameter>
w przetworzonym wyniku.
Znak <parameter>escape</parameter> działa inaczej:
jeśli sekwencja znaków <parameter>escape</parameter> i
<parameter>enclosure</parameter> pojawia się na wejściu,
oba znaki będą obecne w przetworzonym wyniku.
Tak więc dla domyślnych parametrów, linia CSV taka jak
<literal>"a""b","c\"d"</literal> będzie miała pola przetworzone jako
<literal>a"b</literal> i <literal>c\"d</literal>.
</simpara>
</note>
</warning>
<warning>
<simpara>
Począwszy od PHP 8.4.0 poleganie na domyślnej wartości
Expand Down
137 changes: 137 additions & 0 deletions reference/strings/functions/str-decrement.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,137 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 57c83578be2f0ebf3528f1296040fe738dac37de Maintainer: lacatoire Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-decrement">
<refnamediv>
<refname>str_decrement</refname>
<refpurpose>Dekrementuje ciąg alfanumeryczny</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>str_decrement</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Zwraca zdekrementowany alfanumeryczny ciąg <acronym>ASCII</acronym>
<parameter>string</parameter>.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
Ciąg wejściowy.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca zdekrementowany alfanumeryczny ciąg <acronym>ASCII</acronym>.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Jeśli <parameter>string</parameter> jest pusty, zostanie zgłoszony
wyjątek <classname>ValueError</classname>.
</para>
<para>
Jeśli <parameter>string</parameter> nie jest alfanumerycznym ciągiem
<acronym>ASCII</acronym>, zostanie zgłoszony wyjątek
<classname>ValueError</classname>.
</para>
<para>
Jeśli <parameter>string</parameter> nie może być zdekrementowany,
zostanie zgłoszony wyjątek <classname>ValueError</classname>.
Na przykład <literal>"A"</literal> lub <literal>"0"</literal>.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Podstawowy przykład użycia <function>str_decrement</function></title>
<programlisting role="php">
<![CDATA[
<?php
$str = 'ABC';
var_dump(str_decrement($str));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
string(3) "ABB"
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Przykład <function>str_decrement</function> z przeniesieniem</title>
<programlisting role="php">
<![CDATA[
<?php
$str = 'ZA';
var_dump(str_decrement($str));

$str = 'AA';
var_dump(str_decrement($str));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
string(2) "YZ"
string(1) "Z"
]]>
</screen>
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>str_increment</function></member>
</simplelist>
</para>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
132 changes: 132 additions & 0 deletions reference/strings/functions/str-increment.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 57c83578be2f0ebf3528f1296040fe738dac37de Maintainer: lacatoire Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-increment">
<refnamediv>
<refname>str_increment</refname>
<refpurpose>Inkrementuje ciąg alfanumeryczny</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>str_increment</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Zwraca zinkrementowany alfanumeryczny ciąg <acronym>ASCII</acronym>
<parameter>string</parameter>.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
Ciąg wejściowy.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca zinkrementowany alfanumeryczny ciąg <acronym>ASCII</acronym>.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Jeśli <parameter>string</parameter> jest pusty, zostanie zgłoszony
wyjątek <classname>ValueError</classname>.
</para>
<para>
Jeśli <parameter>string</parameter> nie jest alfanumerycznym ciągiem
<acronym>ASCII</acronym>, zostanie zgłoszony wyjątek
<classname>ValueError</classname>.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Podstawowy przykład użycia <function>str_increment</function></title>
<programlisting role="php">
<![CDATA[
<?php
$str = 'ABC';
var_dump(str_increment($str));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
string(3) "ABD"
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Przykład <function>str_increment</function> z przeniesieniem</title>
<programlisting role="php">
<![CDATA[
<?php
$str = 'DZ';
var_dump(str_increment($str));

$str = 'ZZ';
var_dump(str_increment($str));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
string(2) "EA"
string(3) "AAA"
]]>
</screen>
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>str_decrement</function></member>
</simplelist>
</para>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->