Skip to content
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

Jump to bottom

Add translations: reference/simplexml #188

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

Add translations: reference/simplexml #188

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f6953f9
Add translations: reference/simplexml (draft)
msamesch Sep 15, 2024
5deca7f
Fix typo
msamesch Sep 16, 2024
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
107 changes: 107 additions & 0 deletions reference/simplexml/simplexmlelement/count.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 770c6facae667218f69c8ea2715ea20f6fab32f3 Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="simplexmlelement.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SimpleXMLElement::count</refname>
<refpurpose>Zählt die Anzahl der Kinder eines Elements</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SimpleXMLElement">
<modifier>public</modifier> <type>int</type><methodname>SimpleXMLElement::count</methodname>
<void/>
</methodsynopsis>
<para>
Diese Methode zählt die Anzahl der Kinder eines Elements.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt die Anzahl der Elemente eines Elements zurück.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Zählen der Kinder</title>
<programlisting role="php">
<![CDATA[
<?php
$xml = <<<EOF
<people>
<person name="Person 1">
<child/>
<child/>
<child/>
</person>
<person name="Person 2">
<child/>
<child/>
<child/>
<child/>
<child/>
</person>
</people>
EOF;

$elem = new SimpleXMLElement($xml);

foreach ($elem as $person) {
printf("%s hat %d Kinder.\n", $person['name'], $person->count());
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Person 1 hat 3 Kinder.
Person 2 hat 5 Kinder.
]]>
</screen>
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>SimpleXMLElement::children</methodname></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
-->
138 changes: 138 additions & 0 deletions reference/simplexml/simplexmlelement/current.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 523e43a7d96eab72bb16ccfc08b9b4741ab5322a Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="simplexmlelement.current" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>SimpleXMLElement::current</refname>
<refpurpose>Liefert das aktuelle Element</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SimpleXMLElement">
<modifier>public</modifier> <type>SimpleXMLElement</type><methodname>SimpleXMLElement::current</methodname>
<void/>
</methodsynopsis>

<warning>
<simpara>
Vor PHP 8.0 war <methodname>SimpleXMLElement::current</methodname> nur in
der Kindklasse <classname>SimpleXMLIterator</classname> deklariert.
</simpara>
</warning>

<para>
Diese Methode gibt das aktuelle Element als
<classname>SimpleXMLElement</classname>-Objekt zurück.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt das aktuelle Element als <classname>SimpleXMLElement</classname>-Objekt
zurück.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Wirft bei einem Fehler einen <classname>Error</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.1.0</entry>
<entry>
Wenn <methodname>SimpleXMLElement::current</methodname> mit einem
ungültigen Iterator aufgerufen wird, wird nun ein
<classname>Error</classname> geworfen; zuvor wurde &null;
zurückgegeben.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Zurückgeben des aktuellen Elements</title>
<programlisting role="php">
<![CDATA[
<?php
$xmlElement = new SimpleXMLElement('<books><book>PHP basics</book><book>XML basics</book></books>');

$xmlElement->rewind(); // zurücksetzen auf das erste Element,
// sonst funktioniert current() nicht
var_dump($xmlElement->current());
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
object(SimpleXMLElement)#2 (1) {
[0]=>
string(10) "PHP basics"
}
]]>
</screen>
</example>
</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>SimpleXMLElement::key</methodname></member>
<member><methodname>SimpleXMLElement::next</methodname></member>
<member><methodname>SimpleXMLElement::rewind</methodname></member>
<member><methodname>SimpleXMLElement::valid</methodname></member>
<member><classname>SimpleXMLElement</classname></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
-->
103 changes: 103 additions & 0 deletions reference/simplexml/simplexmlelement/getchildren.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dcb657b7e9e4f7622ce3394ae1fa3c14538721e1 Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="simplexmlelement.getchildren" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>SimpleXMLElement::getChildren</refname>
<refpurpose>Liefert die Kind-Elemente des aktuellen Elements</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SimpleXMLElement">
<modifier>public</modifier> <type class="union"><type>SimpleXMLElement</type><type>null</type></type><methodname>SimpleXMLElement::getChildren</methodname>
<void/>
</methodsynopsis>

<warning>
<simpara>
Vor PHP 8.0 war <methodname>SimpleXMLElement::getChildren</methodname> nur
in der Kindklasse <classname>SimpleXMLIterator</classname> deklariert.
</simpara>
</warning>

<para>
Diese Methode gibt ein <classname>SimpleXMLElement</classname>-Objekt
zurück, das die Kind-Elemente des aktuellen
<classname>SimpleXMLElement</classname>-Elements enthält.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt ein <classname>SimpleXMLElement</classname>-Objekt
zurück, das die Kind-Elemente des aktuellen Elements enthält.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Rückgabe der Kinder des aktuellen Elements</title>
<programlisting role="php">
<![CDATA[
<?php
$xml = <<<XML
<books>
<book>
<title>PHP Basics</title>
<author>Jim Smith</author>
</book>
<book>XML basics</book>
</books>
XML;

$xmlElement = new SimpleXMLElement($xml);
for ($xmlElement->rewind(); $xmlElement->valid(); $xmlElement->next()) {
foreach($xmlElement->getChildren() as $name => $data) {
echo "Der Wert von $name ist '$data' aus der Klasse " . get_class($data) . "\n";
}
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Der Wert von title ist 'PHP Basics' aus der Klasse SimpleXMLElement
Der Wert von author ist 'Jim Smith' aus der Klasse SimpleXMLElement
]]>
</screen>
</example>
</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