<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.strings.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'function.ord.php',
    1 => 'ord',
    2 => 'Konvertiert das erste Byte einer Zeichenkette in einen Wert zwischen 0 und
   255',
  ),
  'up' => 
  array (
    0 => 'ref.strings.php',
    1 => 'String-Funktionen',
  ),
  'prev' => 
  array (
    0 => 'function.number-format.php',
    1 => 'number_format',
  ),
  'next' => 
  array (
    0 => 'function.parse-str.php',
    1 => 'parse_str',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'reference/strings/functions/ord.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.ord" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ord</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">ord</span> &mdash; <span class="dc-title">
   Konvertiert das erste Byte einer Zeichenkette in einen Wert zwischen 0 und
   255
  </span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.ord-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>ord</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$character</code></span>): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>

  <p class="para rdfs-comment">
   Interpretiert den ASCII-Wert des ersten Bytes von
   <code class="parameter">character</code> als vorzeichenlose Ganzzahl zwischen 0 und
   255.
  </p>
  <p class="para">
   Liegt die Zeichenkette in einer Ein-Byte-Kodierung, wie ASCII, ISO-8859
   oder Windows 1252, vor, ist dies gleichwertig zur Rückgabe der Position des
   Zeichens in der Zuordnungstabelle des Zeichensatzes. Allerdings ist zu
   beachten, dass diese Funktion keine Zeichenkettenkodierung kennt, und
   insbesondere niemals einen Unicode-Codepoint in einer Multibyte-Kodierung
   wie UTF-8 oder UTF-16 erkennt.
  </p>
  <p class="para">
   Die Funktion ist das Gegenstück zu <span class="function"><a href="function.chr.php" class="function">chr()</a></span>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.ord-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">character</code></dt>
     <dd>
      <p class="para">
       Ein Zeichen.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.ord-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="para">
   Ein Integer zwischen 0 und 255.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.ord-examples">
  <h3 class="title">Beispiele</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Beispiel #1 <span class="function"><strong>ord()</strong></span>-Beispiel</strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$str </span><span style="color: #007700">= </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />if (</span><span style="color: #0000BB">ord</span><span style="color: #007700">(</span><span style="color: #0000BB">$str</span><span style="color: #007700">) == </span><span style="color: #0000BB">10</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"Das erste Zeichen von \$str ist ein Zeilenvorschub.\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>Beispiel #2 Untersuchen der einzelnen Bytes einer UTF-8-Zeichenkette</strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$str </span><span style="color: #007700">= </span><span style="color: #DD0000">"🐘"</span><span style="color: #007700">;<br />for ( </span><span style="color: #0000BB">$pos</span><span style="color: #007700">=</span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #0000BB">$pos </span><span style="color: #007700">&lt; </span><span style="color: #0000BB">strlen</span><span style="color: #007700">(</span><span style="color: #0000BB">$str</span><span style="color: #007700">); </span><span style="color: #0000BB">$pos </span><span style="color: #007700">++ ) {<br /> </span><span style="color: #0000BB">$byte </span><span style="color: #007700">= </span><span style="color: #0000BB">substr</span><span style="color: #007700">(</span><span style="color: #0000BB">$str</span><span style="color: #007700">, </span><span style="color: #0000BB">$pos</span><span style="color: #007700">);<br /> echo </span><span style="color: #DD0000">'Byte ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$pos </span><span style="color: #007700">. </span><span style="color: #DD0000">' von $str hat den Wert ' </span><span style="color: #007700">. </span><span style="color: #0000BB">ord</span><span style="color: #007700">(</span><span style="color: #0000BB">$byte</span><span style="color: #007700">) . </span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p></div>
    <div class="example-contents screen"><br />
Byte 0 von $str hat den Wert 240<br />
Byte 1 von $str hat den Wert 159<br />
Byte 2 von $str hat den Wert 144<br />
Byte 3 von $str hat den Wert 152<br />
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.ord-seealso">
  <h3 class="title">Siehe auch</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.chr.php" class="function" rel="rdfs-seeAlso">chr()</a> - Erzeugt eine Ein-Byte-Zeichenkette aus einer Zahl</span></li>
    <li>Eine <a href="https://www.man7.org/linux/man-pages/man7/ascii.7.html" class="link external">&raquo;&nbsp;ASCII-Tabelle</a></li>
    <li><span class="function"><a href="function.mb-ord.php" class="function" rel="rdfs-seeAlso">mb_ord()</a> - Get Unicode code point of character</span></li>
    <li><span class="function"><a href="intlchar.ord.php" class="function" rel="rdfs-seeAlso">IntlChar::ord()</a> - Return Unicode code point value of character</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>