Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
137 changes: 137 additions & 0 deletions reference/strings/functions/str-decrement.xml
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
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
-->
Loading