Skip to content

Commit

Permalink
Add translations: reference/strings
Browse files Browse the repository at this point in the history
  • Loading branch information
msamesch committed Aug 28, 2024
1 parent 90b8ad4 commit 76964c7
Show file tree
Hide file tree
Showing 5 changed files with 733 additions and 0 deletions.
154 changes: 154 additions & 0 deletions reference/strings/functions/str-contains.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9737e4b259e5673b055d4c8316d4c9e2892f984b Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-contains">
<refnamediv>
<refname>str_contains</refname>
<refpurpose>Prüft, ob eine Zeichenkette eine bestimmte Teilzeichenkette enthält</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>str_contains</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
<methodparam><type>string</type><parameter>needle</parameter></methodparam>
</methodsynopsis>
<para>
Überprüft unter Berücksichtigung der Groß- und Kleinschreibung, ob
<parameter>needle</parameter> in <parameter>haystack</parameter> enthalten
ist.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>haystack</parameter></term>
<listitem>
<para>
Die zu durchsuchende Zeichenkette.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>needle</parameter></term>
<listitem>
<para>
Die Teilzeichenkette, nach der in <parameter>haystack</parameter>
gesucht werden soll.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt &true; zurück, wenn <parameter>needle</parameter> in
<parameter>haystack</parameter> enthalten ist, andernfalls &false;.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Verwendung der leeren Zeichenkette <literal>''</literal></title>
<programlisting role="php">
<![CDATA[
<?php
if (str_contains('abc', '')) {
echo "Die Prüfung auf die leere Zeichenkette ergibt immer true";
}
?>
]]>
</programlisting>
&example.outputs;
<screen role="php">
<![CDATA[
Die Prüfung auf die leere Zeichenkette ergibt immer true
]]>
</screen>
</example>

<example>
<title>Beispiel für die Berücksichtigung von Groß- und Kleinschreibung</title>
<programlisting role="php">
<![CDATA[
<?php
$string = 'The lazy fox jumped over the fence';
if (str_contains($string, 'lazy')) {
echo "Die Zeichenkette 'lazy' wurde in der Zeichenkette gefunden\n";
}
if (str_contains($string, 'Lazy')) {
echo 'Die Zeichenkette "Lazy" wurde in der Zeichenkette gefunden';
} else {
echo '"Lazy" wurde nicht gefunden, weil die Groß- und Kleinschreibung nicht übereinstimmt';
}
?>
]]>
</programlisting>
&example.outputs;
<screen role="php">
<![CDATA[
Die Zeichenkette 'lazy' wurde in der Zeichenkette gefunden
"Lazy" wurde nicht gefunden, weil die Groß- und Kleinschreibung nicht übereinstimmt
]]>
</screen>
</example>
</para>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
&note.bin-safe;
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>str_ends_with</function></member>
<member><function>str_starts_with</function></member>
<member><function>stripos</function></member>
<member><function>strrpos</function></member>
<member><function>strripos</function></member>
<member><function>strstr</function></member>
<member><function>strpbrk</function></member>
<member><function>substr</function></member>
<member><function>preg_match</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
-->
139 changes: 139 additions & 0 deletions reference/strings/functions/str-decrement.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 57c83578be2f0ebf3528f1296040fe738dac37de Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-decrement">
<refnamediv>
<refname>str_decrement</refname>
<refpurpose>Dekrementiert eine alphanumerische Zeichenkette</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>
Dekrementiert die aus alphanumerischen Zeichen bestehende
<acronym>ASCII</acronym>-Zeichenkette <parameter>string</parameter> und gibt
die resultierende Zeichenkette zurück.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
Die Eingabezeichenkette
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt die dekrementierte alphanumerische
<acronym>ASCII</acronym>-Zeichenkette zurück.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Wenn <parameter>string</parameter> leer ist, wird ein
<classname>ValueError</classname> geworfen.
</para>
<para>
Wenn <parameter>string</parameter> keine alphanumerische ASCII-Zeichenkette
ist, wird ein <classname>ValueError</classname> geworfen.
</para>
<para>
Wenn <parameter>string</parameter> nicht dekrementiert werden kann, &zb;
<literal>"A"</literal> oder <literal>"0"</literal>, wird ein
<classname>ValueError</classname> geworfen.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Grundlegendes <function>str_decrement</function>-Beispiel</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><function>str_decrement</function>-Beispiel mit einem Übertrag</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
-->
Loading

0 comments on commit 76964c7

Please sign in to comment.