mirror of
https://github.com/php/doc-de.git
synced 2026-03-24 07:12:15 +01:00
316 lines
9.7 KiB
XML
316 lines
9.7 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: samesch Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<sect1 xml:id="language.types.integer">
|
|
<title>Ganzzahlen (Integer)</title>
|
|
|
|
<simpara>
|
|
Ein <type>int</type> ist eine Zahl aus der Menge
|
|
ℤ = {..., -2, -1, 0, 1, 2, ...}.
|
|
</simpara>
|
|
|
|
<sect2 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member><link linkend="language.types.float">Gleitkommazahlen</link></member>
|
|
<member><link linkend="book.bc">Rechnen mit beliebiger Genauigkeit (BCMath)</link></member>
|
|
<member><link linkend="book.gmp">Rechnen mit ganzen Zahlen mit beliebiger Genauigkeit (GMP)</link></member>
|
|
</simplelist>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.integer.syntax">
|
|
<title>Syntax</title>
|
|
|
|
<simpara>
|
|
<type>Int</type>s können in dezimaler (Basis 10), hexadezimaler (Basis 16),
|
|
oktaler (Basis 8) oder binärer (Basis 2) Schreibweise angegeben werden. Der
|
|
<link linkend="language.operators.arithmetic">Negationsoperator</link> kann
|
|
verwendet werden, um einen negativen <type>int</type> anzugeben.
|
|
</simpara>
|
|
|
|
<para>
|
|
Um die oktale Schreibweise zu verwenden, wird der Zahl eine
|
|
<literal>0</literal> (Null) vorangestellt. Seit PHP 8.1.0 kann der oktalen
|
|
Schreibweise auch ein <literal>0o</literal> oder <literal>0O</literal>
|
|
vorangestellt werden. Um die hexadezimale Schreibweise zu verwenden, muss
|
|
der Zahl <literal>0x</literal> vorangestellt werden, für die binäre
|
|
Schreibweise <literal>0x</literal>.
|
|
</para>
|
|
|
|
<para>
|
|
Um die Lesbarkeit von Integer-Literalen zu verbessern, dürfen diese seit
|
|
PHP 7.4.0 Unterstriche (<literal>_</literal>) zwischen den Ziffern
|
|
enthalten. Diese Unterstriche werden von PHPs Scanner entfernt.
|
|
</para>
|
|
|
|
<example>
|
|
<title>Integer-Literale</title>
|
|
<programlisting role="php" annotations="non-interactive">
|
|
<![CDATA[
|
|
<?php
|
|
$a = 1234; // Dezimalzahl
|
|
$a = 0123; // Oktalzahl (entspricht 83 dezimal)
|
|
$a = 0o123; // Oktalzahl (ab PHP 8.1.0)
|
|
$a = 0x1A; // Hexadezimalzahl (entspricht 26 dezimal)
|
|
$a = 0b11111111; // Binärzahl (entspricht 255 dezimal)
|
|
$a = 1_234_567; // Dezimalzahl (ab PHP 7.4.0)
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
Seit PHP 8.1.0 ist die Struktur für <type>int</type>-Literale formal wie
|
|
folgt definiert (vorher waren die Oktalpräfixe <literal>0o</literal> und
|
|
<literal>0O</literal> nicht erlaubt, und vor PHP 7.4.0 waren die
|
|
Unterstriche nicht erlaubt):
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting>
|
|
<![CDATA[
|
|
dezimal : [1-9][0-9]*(_[0-9]+)*
|
|
| 0
|
|
|
|
hexadezimal : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*
|
|
|
|
oktal : 0[oO]?[0-7]+(_[0-7]+)*
|
|
|
|
binär : 0[bB][01]+(_[01]+)*
|
|
|
|
ganzzahlig : dezimal
|
|
| hexadezimal
|
|
| oktal
|
|
| binär
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Die Größe eines Werts vom Typ <type>int</type> ist plattformabhängig, wobei
|
|
der Maximalwert normalerweise bei etwa zwei Milliarden liegt (das sind 32
|
|
Bit mit Vorzeichen). Bei 64-Bit-Plattformen liegt der Maximalwert
|
|
normalerweise bei etwa 9E18. PHP unterstützt keine vorzeichenlosen
|
|
<type>int</type>s. Die Größe von <type>int</type> kann mit der Konstante
|
|
<constant>PHP_INT_SIZE</constant> ermittelt werden, der maximale Wert mit
|
|
der Konstante <constant>PHP_INT_MAX</constant> und der minimale Wert mit
|
|
der Konstante <constant>PHP_INT_MIN</constant>.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.integer.overflow">
|
|
<title>Integer-Überlauf</title>
|
|
|
|
<para>
|
|
Wenn eine Zahl außerhalb der Grenzen des Typs <type>int</type> liegt,
|
|
interpretiert PHP sie stattdessen als <type>float</type>. Auch eine
|
|
Operation, die eine Zahl außerhalb der Grenzen des Typs <type>int</type>
|
|
ergibt, gibt stattdessen einen <type>Float</type> zurück.
|
|
</para>
|
|
|
|
<example>
|
|
<title>Integer-Überlauf</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$large_number = 50000000000000000000;
|
|
var_dump($large_number); // float(5.0E+19)
|
|
|
|
var_dump(PHP_INT_MAX + 1); // 32-bit-System: float(2147483648)
|
|
// 64-bit-System: float(9.2233720368548E+18)
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.integer.division">
|
|
<title>Integer-Division</title>
|
|
|
|
<para>
|
|
In PHP gibt es keinen Operator für die Division von <type>int</type>. Dafür
|
|
kann die Funktion <function>intdiv</function> verwendet werden. Das
|
|
Ergebnis von <literal>1/2</literal> ist der <type>Float</type>-Wert
|
|
<literal>0.5</literal>. Der Wert kann in einen <type>int</type> umgewandelt
|
|
werden, um ihn auf Null zu runden. Alternativ dazu kann die Funktion
|
|
<function>round</function> verwendet werden, die eine feinere Kontrolle
|
|
über das Runden ermöglicht.
|
|
</para>
|
|
|
|
<example>
|
|
<title>Divisionen</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
var_dump(25/7); // float(3.5714285714286)
|
|
var_dump((int) (25/7)); // int(3)
|
|
var_dump(round(25/7)); // float(4)
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
|
|
<sect2 xml:id="language.types.integer.casting">
|
|
<title>Umwandlung in Integer</title>
|
|
|
|
<simpara>
|
|
Um einen Wert explizit in <type>int</type> umzuwandeln, kann entweder
|
|
<literal>(int)</literal> oder <literal>(integer)</literal> verwendet
|
|
werden. In den meisten Fällen ist das jedoch nicht nötig, weil ein Wert
|
|
automatisch umgewandelt wird, wenn ein Operator, eine Funktion oder eine
|
|
Kontrollstruktur ein Argument vom Typ <type>int</type> benötigt. Ein Wert
|
|
kann auch mit der Funktion <function>intval</function> in <type>int</type>
|
|
umgewandelt werden.
|
|
</simpara>
|
|
|
|
<simpara>
|
|
Wenn eine <type>Ressource</type> in <type>int</type> umgewandelt wird, dann
|
|
ist das Ergebnis die eindeutige Nummer der Ressource, die der
|
|
<type>Ressource</type> von PHP zur Laufzeit zugewiesen wird.
|
|
</simpara>
|
|
|
|
<simpara>
|
|
Siehe auch <link linkend="language.types.type-juggling">Typumwandlung</link>.
|
|
</simpara>
|
|
|
|
<sect3 xml:id="language.types.integer.casting.from-boolean">
|
|
<title>Von <link linkend="language.types.boolean">Booleans</link></title>
|
|
|
|
<simpara>
|
|
&false; ergibt <literal>0</literal> (Null) und &true; ergibt
|
|
<literal>1</literal> (Eins).
|
|
</simpara>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.integer.casting.from-float">
|
|
<title>
|
|
Von <link linkend="language.types.float">Gleitkommazahlen</link>
|
|
</title>
|
|
|
|
<simpara>
|
|
Bei der Umwandlung von <type>float</type> nach <type>int</type> wird die
|
|
Zahl <emphasis>abgerundet</emphasis>. Seit PHP 8.1.0 wird davon abgeraten,
|
|
einen nicht-ganzzahligen &float; in &integer; umzuwandeln, weil dabei die
|
|
Genauigkeit abnimmt.
|
|
</simpara>
|
|
|
|
<example>
|
|
<title>Umwandlung von Float</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
function foo($value): int {
|
|
return $value;
|
|
}
|
|
|
|
var_dump(foo(8.1)); // seit PHP 8.1.0: "Deprecated: Implicit conversion from float 8.1 to int loses precision"
|
|
var_dump(foo(8.1)); // bis PHP 8.1.0: 8
|
|
var_dump(foo(8.0)); // in beiden Fällen 8
|
|
|
|
var_dump((int) 8.1); // in beiden Fällen 8
|
|
var_dump(intval(8.1)); // in beiden Fällen 8
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
Wenn der Float-Wert außerhalb der Grenzen von <type>int</type> liegt (auf
|
|
32-bit-Plattformen normalerweise <literal>+/- 2.15e+9 = 2^31</literal> und
|
|
auf 64-bit-Plattformen <literal>+/- 9.22e+18 = 2^63</literal>), ist das
|
|
Ergebnis undefiniert. Das liegt daran, dass der Typ <type>float</type>
|
|
nicht genau genug ist, um ein exaktes Ergebnis für den Typ
|
|
<type>int</type> zu liefern. In diesem Fall wird keine Warnung und nicht
|
|
einmal ein Hinweis ausgegeben!
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
Wenn <literal>NaN</literal>, <literal>Inf</literal> und
|
|
<literal>-Inf</literal> in <type>int</type> umgewandelt werden, ergibt
|
|
dies immer Null.
|
|
</para>
|
|
</note>
|
|
|
|
<warning>
|
|
<para>
|
|
Eine unbekannte Bruchzahl sollte niemals in <type>int</type> umgewandelt
|
|
werden, weil dies manchmal zu unerwarteten Ergebnissen führen kann.
|
|
</para>
|
|
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
echo (int) ( (0.1+0.7) * 10 ); // gibt 7 aus!
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Siehe auch den
|
|
<link linkend="warn.float-precision">Warnhinweis zur Genauigkeit von Gleitkommazahlen</link>.
|
|
</para>
|
|
</warning>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.integer.casting.from-string">
|
|
<title>Von einer Zeichenkette</title>
|
|
|
|
<simpara>
|
|
Wenn eine Zeichenkette
|
|
<link linkend="language.types.numeric-strings">numerisch</link> ist oder
|
|
numerisch beginnt, wird sie in den entsprechenden Integer-Wert umgewandelt,
|
|
andernfalls wird sie in Null (<literal>0</literal>) umgewandelt.
|
|
</simpara>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.integer.casting-from-null">
|
|
<title>Von <type>NULL</type></title>
|
|
|
|
<simpara>
|
|
&null; wird immer in Null (<literal>0</literal>) umgewandelt.
|
|
</simpara>
|
|
</sect3>
|
|
|
|
<sect3 xml:id="language.types.integer.casting.from-other">
|
|
<title>Von anderen Typen</title>
|
|
|
|
<caution>
|
|
<simpara>
|
|
Für andere Typen ist das Verhalten bei der Umwandlung in <type>int</type>
|
|
undefiniert. Es ist nicht empfehlenswert, sich auf ein beobachtetes
|
|
Verhalten zu verlassen, da es sich ohne Vorankündigung ändern kann.
|
|
</simpara>
|
|
</caution>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<!-- 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
|
|
-->
|