Skip to content

[Sync EN] Add PHP 8.4.0 changelog entries for SPL, Standard, and Filesystem pages #317

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 1 commit into
base: master
Choose a base branch
from
+446 −2
Open

[Sync EN] Add PHP 8.4.0 changelog entries for SPL, Standard, and Filesystem pages #317

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
9 changes: 8 additions & 1 deletion reference/filesystem/functions/tempnam.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d1cacac75c04a115ee9b464015ce8e7782bd1517 Maintainer: wiesemann Status: ready -->
<!-- EN-Revision: 17ebcd2ea14b405b781bd93aea6fa7219b6e29ae Maintainer: wiesemann Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 2f07d53d999169b7446669a51dfd6ce9b3c20435 Reviewer: samesch -->
<refentry xml:id="function.tempnam" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -75,6 +75,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Der Name der von <function>tempnam</function> erstellten Dateien ist
nun 13 Bytes länger. Die Gesamtlänge ist weiterhin plattformabhängig.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Expand Down
216 changes: 216 additions & 0 deletions reference/spl/splfixedarray.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,216 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 17ebcd2ea14b405b781bd93aea6fa7219b6e29ae Maintainer: lacatoire Status: ready -->
<reference xml:id="class.splfixedarray" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Die Klasse SplFixedArray</title>
<titleabbrev>SplFixedArray</titleabbrev>

<partintro>

<!-- {{{ splfixedarray intro -->
<section xml:id="splfixedarray.intro">
&reftitle.intro;
<para>
Die Klasse SplFixedArray stellt die wesentlichen Funktionen eines Arrays
bereit. Der Hauptunterschied zwischen einem SplFixedArray und einem
normalen PHP-Array besteht darin, dass die Größe eines SplFixedArray
manuell geändert werden muss und nur Ganzzahlen innerhalb des Bereichs
als Indizes zulässig sind. Der Vorteil ist, dass es weniger Speicher als
ein normales <type>array</type> verbraucht.
</para>
</section>
<!-- }}} -->

<section xml:id="splfixedarray.synopsis">
&reftitle.classsynopsis;

<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>SplFixedArray</classname>
</ooclass>

<oointerface>
<modifier>implements</modifier>
<interfacename>IteratorAggregate</interfacename>
</oointerface>

<oointerface>
<interfacename>ArrayAccess</interfacename>
</oointerface>

<oointerface>
<interfacename>Countable</interfacename>
</oointerface>

<oointerface>
<interfacename>JsonSerializable</interfacename>
</oointerface>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.splfixedarray')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SplFixedArray'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.splfixedarray')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SplFixedArray'])">
<xi:fallback/>
</xi:include>
</classsynopsis>

</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Zugriffe außerhalb des gültigen Bereichs in
<classname>SplFixedArray</classname> werfen nun Exceptions vom Typ
<exceptionname>OutOfBoundsException</exceptionname> anstelle von
<exceptionname>RuntimeException</exceptionname>. Da
<exceptionname>OutOfBoundsException</exceptionname> eine Unterklasse
von <exceptionname>RuntimeException</exceptionname> ist, ergeben sich
beim Abfangen dieser Exceptions keine Verhaltensänderungen.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
Die magischen Methoden
<methodname>SplFixedArray::__serialize</methodname> und
<methodname>SplFixedArray::__unserialize</methodname>
wurden zu <classname>SplFixedArray</classname> hinzugefügt.
</entry>
</row>
<row>
<entry>8.1.0</entry>
<entry>
<classname>SplFixedArray</classname> implementiert nun
<interfacename>JsonSerializable</interfacename>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<classname>SplFixedArray</classname> implementiert nun
<interfacename>IteratorAggregate</interfacename>.
Zuvor wurde stattdessen <interfacename>Iterator</interfacename>
implementiert.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

<!-- {{{ splfixedarray examples -->
<section xml:id="splfixedarray.examples">
&reftitle.examples;
<para>
<example>
<title><classname>SplFixedArray</classname>-Anwendungsbeispiel</title>
<programlisting role="php">
<![CDATA[
<?php
// Das Array mit fester Länge initialisieren
$array = new SplFixedArray(5);

$array[1] = 2;
$array[4] = "foo";

var_dump($array[0]); // NULL
var_dump($array[1]); // int(2)

var_dump($array["4"]); // string(3) "foo"

// Die Größe des Arrays auf 10 erhöhen
$array->setSize(10);

$array[9] = "asdf";

// Das Array auf eine Größe von 2 verkleinern
$array->setSize(2);

// Die folgenden Zeilen werfen eine RuntimeException: Index invalid or out of range
try {
var_dump($array["non-numeric"]);
} catch(RuntimeException $re) {
echo "RuntimeException: ".$re->getMessage()."\n";
}

try {
var_dump($array[-1]);
} catch(RuntimeException $re) {
echo "RuntimeException: ".$re->getMessage()."\n";
}

try {
var_dump($array[5]);
} catch(RuntimeException $re) {
echo "RuntimeException: ".$re->getMessage()."\n";
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
NULL
int(2)
string(3) "foo"
RuntimeException: Index invalid or out of range
RuntimeException: Index invalid or out of range
RuntimeException: Index invalid or out of range
]]>
</screen>
</example>
</para>
</section>
<!-- }}} -->

<!-- {{{ splfixedarray properties
<section xml:id="splfixedarray.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="splfixedarray.props.name">
<term><varname>name</varname></term>
<listitem>
<para>Prop description</para>
</listitem>
</varlistentry>
</variablelist>
</section>
}}} -->

</partintro>

&reference.spl.entities.splfixedarray;

</reference>
<!-- 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
Loading