is-numeric.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0817d5b2835f8a47314823338d983fa2c5005dfc Maintainer: sammywg Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 1f91a4b0fb7bb5a44d8033806bd2f554472f5f00 Reviewer: samesch -->
<refentry xml:id="function.is-numeric" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>is_numeric</refname>
  <refpurpose>
   Prüft, ob eine Variable eine Zahl oder ein numerischer String ist
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>is_numeric</methodname>
   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
  </methodsynopsis>
  <para>
   Prüft, ob die gegebene Variable eine Zahl oder ein
   <link linkend="language.types.numeric-strings">numerischer String</link>
   ist.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>value</parameter></term>
     <listitem>
      <para>
       Die zu untersuchende Variable
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt &true; zurück, wenn <parameter>value</parameter> eine Zahl oder ein
   <link linkend="language.types.numeric-strings">numerischer String</link>
   ist, ansonsten &false;.
  </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.0.0</entry>
      <entry>
       Numerische Strings, die mit einem Leerzeichen enden
       (<literal>"42 "</literal>), geben nun &true; zurück. Zuvor wurde
       stattdessen &false; zurückgegeben.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>is_numeric</function>-Beispiele</title>
    <programlisting role="php">
<![CDATA[
<?php
$tests = array(
    "42",
    1337,
    0x539,
    02471,
    0b10100111001,
    1337e0,
    "0x539",
    "02471",
    "0b10100111001",
    "1337e0",
    "nicht numerisch",
    array(),
    9.1,
    null,
    '',
);

foreach ($tests as $element) {
    if (is_numeric($element)) {
        echo var_export($element, true) . " ist numerisch", PHP_EOL;
    } else {
        echo var_export($element, true) . " ist NICHT numerisch", PHP_EOL;
    }
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
'42' ist numerisch
1337 ist numerisch
1337 ist numerisch
1337 ist numerisch
1337 ist numerisch
1337.0 ist numerisch
'0x539' ist NICHT numerisch
'02471' ist numerisch
'0b10100111001' ist NICHT numerisch
'1337e0' ist numerisch
'nicht numerisch' ist NICHT numerisch
array (
) ist NICHT numerisch
9.1 ist numerisch
NULL ist NICHT numerisch
'' ist NICHT numerisch
]]>
    </screen>
   </example>
  </para>

  <para>
   <example>
    <title><function>is_numeric</function> mit Leerzeichen</title>
    <programlisting role="php">
     <![CDATA[
<?php
$tests = [
    " 42",
    "42 ",
    "\u{A0}9001", // nicht umbrechendes Leerzeichen
    "9001\u{A0}", // nicht umbrechendes Leerzeichen
];

foreach ($tests as $element) {
    if (is_numeric($element)) {
        echo var_export($element, true) . " ist numerisch", PHP_EOL;
    } else {
        echo var_export($element, true) . " ist NICHT numerisch", PHP_EOL;
    }
}
?>
]]>
    </programlisting>
    &example.outputs.8;
    <screen>
     <![CDATA[
' 42' ist numerisch
'42 ' ist numerisch
' 9001' ist NICHT numerisch
'9001 ' ist NICHT numerisch
]]>
    </screen>
    &example.outputs.7;
    <screen>
     <![CDATA[
' 42' ist numerisch
'42 ' ist NICHT numerisch
' 9001' ist NICHT numerisch
'9001 ' ist NICHT numerisch
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="language.types.numeric-strings">Numerische Strings</link></member>
    <member><function>ctype_digit</function></member>
    <member><function>is_bool</function></member>
    <member><function>is_null</function></member>
    <member><function>is_float</function></member>
    <member><function>is_int</function></member>
    <member><function>is_string</function></member>
    <member><function>is_object</function></member>
    <member><function>is_array</function></member>
    <member><function>filter_var</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
-->