<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 2832df2e1bd7daa1ec29ffb167dce1c9feb8cc6b Maintainer: nobody Status: ready -->

<!-- Reviewed: no -->

<sect1 xml:id="language.types.string">

<title>Strings (Zeichenketten)</title>

<para>

Ein <type>String</type> stellt eine Kette von Zeichen dar, in der ein

Zeichen gleichbedeutend mit einem Byte ist. Das bedeutet, es gibt exakt 256

mögliche Zeichen. Es impliziert zudem, dass PHP keine native Unterstützung

von Unicode bietet. Siehe auch

<link linkend="language.types.string.details">Details zum String-Typ</link>.

</para>

<note>

<simpara>

Unter 32-bit-Versionen kann ein <type>String</type> bis zu 2GB (maximal

2147483647 Bytes) groß werden.

</simpara>

</note>

<sect2 xml:id="language.types.string.syntax">

<title>Syntax</title>

<para>

Ein <type>String</type>-Literal kann auf vier unterschiedliche Arten

spezifiziert werden:

</para>

<itemizedlist>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.single">einfache Anführungszeichen</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.double">doppelte Anführungszeichen</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.heredoc">Heredoc-Syntax</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.nowdoc">Nowdoc-Syntax</link>

</simpara>

</listitem>

</itemizedlist>

<sect3 xml:id="language.types.string.syntax.single">

<title>Einfache Anführungszeichen</title>

<para>

Der einfachste Weg einen <type>String</type> anzugeben, ist ihn mit

einfachen Anführungszeichen (das Zeichen <literal>'</literal>) zu

umschließen.

</para>

<para>

Um ein einfaches Anführungszeichen hierin anzugeben, fügen sie einen

Backslash (<literal>\</literal>) vor dem Zeichen ein. Um einen Backslash

als Zeichen anzugeben, verdoppeln Sie ihn (<literal>\\</literal>). Alle

anderen Instanzen von Backslash werden als buchstäblicher Backslash

behandelt: Das bedeutet, dass die anderen Escape-Sequenzen, die Sie

vielleicht gewohnt sind, wie <literal>\r</literal> oder

<literal>\n</literal>, buchstäblich wie angegeben ausgegeben werden und

keine besondere Bedeutung haben.

</para>

<note>

<simpara>

Im Gegensatz zu den

<link linkend="language.types.string.syntax.double">doppelten Anführungszeichen</link>- und

<link linkend="language.types.string.syntax.heredoc">Heredoc</link>-Notationen

werden <link linkend="language.variables">Variablen</link> und

Escape-Sequenzen für Sonderzeichen <emphasis>nicht</emphasis> aufgelöst

(ersetzt), wenn sie in einem mit einfachen Anführungszeichen

umschlossenen <type>String</type> erscheinen.

</simpara>

</note>

<example>

<title>Syntax-Varianten</title>

<programlisting role="php">

<![CDATA[

<?php

echo 'dies ist ein einfacher String', PHP_EOL;

echo 'Sie können auch Zeilenumbrüche

in dieser Art angeben,

dies ist okay so', PHP_EOL;

// Gibt aus: Arnold sagte einst: "I'll be back"

echo 'Arnold sagte einst: "I\'ll be back"', PHP_EOL;

// Ausgabe: Sie löschten C:\*.*?

echo 'Sie löschten C:\\*.*?', PHP_EOL;

// Ausgabe: Sie löschten C:\*.*?

echo 'Sie löschten C:\*.*?', PHP_EOL;

// Ausgabe: Dies erzeugt keinen: \n Zeilenumbruch

echo 'Dies erzeugt keinen: \n Zeilenumbruch', PHP_EOL;

// Ausgabe: Variablen werden $ebenfalls $nicht ersetzt

echo 'Variablen werden $ebenfalls $nicht ersetzt', PHP_EOL;

?>

]]>

</programlisting>

</example>

</sect3>

<sect3 xml:id="language.types.string.syntax.double">

<title>Doppelte Anführungszeichen</title>

<para>

Wenn der <type>String</type> in doppelte Anführungszeichen

(<literal>"</literal>) eingeschlossen wird, interpretiert PHP die folgenden

Escape-Sequenzen für Sonderzeichen:

</para>

<table>

<title>Maskierte Zeichen</title>

<tgroup cols="2">

<thead>

<row>

<entry>Sequenz</entry>

<entry>Bedeutung</entry>

</row>

</thead>

<tbody>

<row>

<entry><literal>\n</literal></entry>

<entry>Zeilenumbruch (LF or 0x0A (10) in ASCII)</entry>

</row>

<row>

<entry><literal>\r</literal></entry>

<entry>Wagenrücklauf (CR or 0x0D (13) in ASCII)</entry>

</row>

<row>

<entry><literal>\t</literal></entry>

<entry>horizontaler Tabulator (HT or 0x09 (9) in ASCII)</entry>

</row>

<row>

<entry><literal>\v</literal></entry>

<entry>vertikaler Tabulator (VT or 0x0B (11) in ASCII)</entry>

</row>

<row>

<entry><literal>\e</literal></entry>

<entry>Escape-Zeichen (ESC or 0x1B (27) in ASCII)</entry>

</row>

<row>

<entry><literal>\f</literal></entry>

<entry>Seitenvorschub (FF or 0x0C (12) in ASCII)</entry>

</row>

<row>

<entry><literal>\\</literal></entry>

<entry>Backslash (Rückstrich)</entry>

</row>

<row>

<entry><literal>\$</literal></entry>

<entry>Dollar-Zeichen</entry>

</row>

<row>

<entry><literal>\"</literal></entry>

<entry>doppeltes Anführungszeichen</entry>

</row>

<row>

<entry><literal>\[0-7]{1,3}</literal></entry>

<entry>

Oktal: die Folge von Zeichen, die auf den regulären Ausdruck

<literal>[0-7]{1,3}</literal> passt, ist ein Zeichen in oktaler

Notation (&zb; <literal>"\101" === "A"</literal>), die stillschweigend

überläuft, um in ein Byte zu passen (&zb; "\400" === "\000")

</entry>

</row>

<row>

<entry><literal>\x[0-9A-Fa-f]{1,2}</literal></entry>

<entry>

Hexadezimal: die Folge von Zeichen, die auf den regulären Ausdruck

<literal>[0-9A-Fa-f]{1,2}</literal> passt, ist ein Zeichen in

hexadezimaler Schreibweise (&zb; <literal>"\x41" === "A"</literal>)

</entry>

</row>

<row>

<entry><literal>\u{[0-9A-Fa-f]+}</literal></entry>

<entry>

Unicode: die Folge von Zeichen, die auf den regulären Ausdruck

<literal>[0-9A-Fa-f]+</literal> passt, ist ein Unicode-Codepunkt, der

in der Zeichenkette als UTF-8-Darstellung des Codepunkts ausgegeben

wird. Die geschweiften Klammern in der Zeichenkette sind erforderlich

(&zb; <literal>"\u{41}" === "A"</literal>)

</entry>

</row>

</tbody>

</tgroup>

</table>

<para>

Wie bei <type>String</type>s in einfachen Anführungszeichen wird beim

Maskieren aller anderen Zeichen der Backslash mit ausgegeben.

</para>

<para>

Das Auflösen von Variablen-Namen ist eine der wichtigsten Besonderheiten

von in doppelten Anführungszeichen angegebenen <type>String</type>s. Siehe

hierzu

<link linkend="language.types.string.parsing">String-Interpolation</link>

für weitere Details.

</para>

</sect3>

<sect3 xml:id="language.types.string.syntax.heredoc">

<title>Heredoc</title>

<simpara>

Eine dritte Möglichkeit, <type>String</type>s zu begrenzen, stellt die

Heredoc-Syntax dar: <literal>&lt;&lt;&lt;</literal>. Nach diesem Operator

wird ein beliebiger Bezeichner angegeben, dann eine neue Zeile. Hiernach

folgt der eigentliche <type>String</type> und abschließend erneut der

Bezeichner, um die Auszeichnung abzuschließen.

</simpara>

<simpara>

Der schließende Bezeichner darf durch Leerzeichen oder Tabulatoren

eingerückt sein, wobei in diesem Fall die Einrückung aus allen Zeilen des

Doc-Strings entfernt wird. Vor PHP 7.3.0 <emphasis>muss</emphasis> der

schließende Bezeichner in der ersten Spalte der Zeile beginnen.

</simpara>

<simpara>

Außerdem muss der schließende Bezeichner den gleichen Benennungsregeln

folgen wie jeder andere Bezeichner in PHP: Er darf nur alphanumerische

Zeichen sowie Unterstriche enthalten und muss mit einem nicht-numerischen

Zeichen oder einem Unterstrich beginnen.

</simpara>

<example>

<title>Grundlegendes Heredoc-Beispiel ab PHP 7.3.0</title>

<programlisting role="php">

<![CDATA[

<?php

// keine Einrückung

echo <<<END

a

b

c

\n

END;

// vier Leerzeichen Einrückung

echo <<<END

a

b

c

END;

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

a

b

c

a

b

c

]]>

</screen>

</example>

<simpara>

Wenn der schließende Bezeichner weiter eingerückt ist als alle Zeilen des

Textkörpers, wird ein <classname>ParseError</classname> ausgelöst:

</simpara>

<example>

<title>Der schließende Bezeichner darf nicht weiter eingerückt sein, als die Zeilen des Textkörpers</title>

<programlisting role="php">

<![CDATA[

<?php

echo <<<END

a

b

c

END;

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

Parse error: Invalid body indentation level (expecting an indentation level of at least 3) in example.php on line 4

]]>

</screen>

</example>

<simpara>

Wenn der schließende Bezeichner eingerückt ist, können auch Tabulatoren

verwendet werden, allerdings dürfen Tabulatoren und Leerzeichen in Bezug

auf die Einrückung des schließenden Bezeichners und die Einrückung des

Textkörpers (bis zum schließenden Bezeichner) <emphasis>nicht</emphasis>

miteinander vermischt werden. In jedem dieser Fälle wird ein

<classname>ParseError</classname> ausgelöst. Diese

Whitespace-Einschränkungen wurden aufgenommen, weil die Vermischung von

Tabulatoren und Leerzeichen für die Einrückung die Lesbarkeit

beeinträchtigt.

</simpara>

<example>

<title>Unterschiedliche Einrückung für den Bezeichner, der den Textkörper (Leerzeichen) schließt</title>

<programlisting role="php" annotations="non-interactive">

<![CDATA[

<?php

// Der gesamte folgende Code funktioniert nicht.

// Unterschiedliche Einrückung für den Bezeichner (Tabulatoren), der den

// Textkörper (Leerzeichen) schließt

{

echo <<<END

a

END;

}

// Vermischung von Leerzeichen und Tabulatoren im Textkörper

{

echo <<<END

a

END;

}

// Vermischung von Leerzeichen und Tabulatoren in der Endmarkierung

{

echo <<<END

a

END;

}

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

Parse error: Invalid indentation - tabs and spaces cannot be mixed in example.php line 8

]]>

</screen>

</example>

<simpara>

Der schließende Bezeichner für den Textkörper muss nicht von einem

Semikolon oder Zeilenumbruch gefolgt werden. Zum Beispiel ist der folgende

Code ist ab PHP 7.3.0 erlaubt:

</simpara>

<example>

<title>Fortsetzen eines Ausdrucks nach einem schließenden Bezeichner</title>

<programlisting role="php">

<![CDATA[

<?php

$values = [<<<END

a

b

c

END, 'd e f'];

var_dump($values);

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

array(2) {

[0] =>

string(11) "a

b

c"

[1] =>

string(5) "d e f"

}

]]>

</screen>

</example>

<warning>

<simpara>

Wenn der schließende Bezeichner am Anfang einer Zeile gefunden wurde,

dann kann er unabhängig davon, ob er Teil eines anderen Wortes war, als

schließender Bezeichner betrachtet werden und führt zu einem

<classname>ParseError</classname>.

</simpara>

<example>

<title>Ein schließender Bezeichner im Textkörper der Zeichenkette führt zu einem ParseError</title>

<programlisting role="php">

<![CDATA[

<?php

$values = [<<<END

a

b

END ING

END, 'd e f'];

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

Parse error: syntax error, unexpected identifier "ING", expecting "]" in example.php on line 5

]]>

</screen>

</example>

<simpara>

Um dieses Problem zu vermeiden, ist es ratsam, die einfache Regel zu

befolgen: <emphasis>keines der im Textkörper vorkommenden Wörter als

schließenden Bezeichner wählen</emphasis>.

</simpara>

</warning>

<warning>

<simpara>

Vor PHP 7.3.0 ist es sehr wichtig, darauf zu achten, dass die Zeile mit

dem schließenden Bezeichner keine anderen Zeichen außer einem Semikolon

(<literal>;</literal>) enthalten darf. Das heißt insbesondere auch, dass

der Bezeichner nicht <emphasis>eingerückt werden darf</emphasis> und dass

es vor oder nach dem Semikolon auch keine Leerzeichen oder Tabulatoren

geben darf. Zudem muss das erste Zeichen vor dem schließenden Bezeichner

ein Zeilenumbruch sein, so wie er vom Betriebssystem definiert wird. In

UNIX-Systemen, inlusive macOS, ist dies <literal>\n</literal>. Auf den

schließenden Bezeichner muss ebenfalls ein Zeilenumbruch folgen.

</simpara>

<simpara>

Wenn diese Regel gebrochen wird und der schließende Bezeichner nicht

valide ist, wird er nicht als Bezeichner angenommen und PHP wird weiter

nach einem solchen schließenden Bezeichner suchen. Wird kein gültiger

schließender Bezeichner vor dem Dateiende gefunden, gibt PHP einen auf

die letzte Zeile der Datei weisenden Parser-Fehler aus.

</simpara>

<example>

<title>Ungültiges Beispiel vor PHP 7.3.0</title>

<programlisting role="php">

<!-- This is an INVALID example -->

<![CDATA[

<?php

class foo {

public $bar = <<<EOT

bar

EOT;

}

// Identifier must not be indented

?>

]]>

</programlisting>

</example>

<example>

<title>Gültiges Beispiel, auch vor PHP 7.3.0</title>

<programlisting role="php">

<!-- This is a VALID example -->

<![CDATA[

<?php

class foo {

public $bar = <<<EOT

bar

EOT;

}

?>

]]>

</programlisting>

</example>

<para>

Heredocs, die Variablen enthalten, können nicht für die Initialisierung

von Klasseneigenschaften verwendet werden.

</para>

</warning>

<para>

Heredoc-Text verhält sich genau wie ein <type>String</type> in doppelten

Anführungsstrichen, ohne die doppelten Anführungszeichen. Das bedeutet,

dass Anführungszeichen in einem Heredoc nicht maskiert werden müssen, aber

die oben aufgeführten Maskierungscodes können trotzdem verwendet werden.

Variablen werden aufgelöst, aber wenn komplexe Variablen innerhalb eines

Heredocs verwendet werden, ist die gleiche Vorsicht geboten wie bei

<type>String</type>s.

</para>

<example>

<title>Beispiel für das Notieren von Heredoc-Strings</title>

<programlisting role="php">

<![CDATA[

<?php

$str = <<<EOD

Ein Beispiel für einen String, der sich

unter Verwendung der heredoc-Syntax

über mehrere Zeilen erstreckt.

EOD;

/* Ein komplexeres Beispiel mit Variablen. */

class foo

{

var $foo;

var $bar;

function __construct()

{

$this->foo = 'Foo';

$this->bar = array('Bar1', 'Bar2', 'Bar3');

}

}

$foo = new foo();

$name = 'MeinName';

echo <<<EOT

Mein Name ist "$name". Ich gebe etwas $foo->foo aus.

Jetzt gebe ich etwas {$foo->bar[1]} aus.

Dies sollte ein großes 'A' ausgeben: \x41

EOT;

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Mein Name ist "MeinName". Ich gebe etwas Foo aus.

Jetzt gebe ich etwas Bar2 aus.

Dies sollte ein großes 'A' ausgeben: A]]>

</screen>

</example>

<para>

Es ist auch möglich, die Heredoc-Syntax zu verwenden, um Daten an

Funktionsargumente zu übergeben:

</para>

<example>

<title>Beispiel für Heredoc in Argumenten</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(array(<<<EOD

foobar!

EOD

));

?>

]]>

</programlisting>

</example>

<para>

Es ist möglich, statische Variablen und Klasseneigenschaften/Konstanten

mit Hilfe der Heredoc-Syntax zu initialisieren:

</para>

<example>

<title>Verwendung von Heredoc zur Initialisierung von statischen Werten</title>

<programlisting role="php" annotations="non-interactive">

<![CDATA[

<?php

// Statische Variablen

function foo()

{

static $bar = <<<LABEL

Hier steht nichts drin...

LABEL;

}

// Klasseneigenschaften/Konstanten

class foo

{

const BAR = <<<FOOBAR

Beispiel für eine Konstante

FOOBAR;

public $baz = <<<FOOBAR

Beispiel für eine Eigenschaft

FOOBAR;

}

?>

]]>

</programlisting>

</example>

<para>

Der öffnende Heredoc-Bezeichner kann optional in doppelte

Anführungszeichen gesetzt werden:

</para>

<example>

<title>Verwendung von doppelten Anführungszeichen in Heredoc</title>

<programlisting role="php">

<![CDATA[

<?php

echo <<<"FOOBAR"

Hallo Welt!

FOOBAR;

?>

]]>

</programlisting>

</example>

</sect3>

<sect3 xml:id="language.types.string.syntax.nowdoc">

<title>Nowdoc</title>

<para>

Nowdocs sind für Strings in einfachen Anführungszeichen das, was Heredocs

für Strings in doppelten Anführungszeichen sind. Ein Nowdoc wird ähnlich

wie ein Heredoc angegeben, aber innerhalb eines Nowdocs wird

<emphasis>keine String-Interpolation</emphasis> durchgeführt. Das Konstrukt

ist ideal für die Einbettung von PHP-Code oder anderen großen Textblöcken

ohne maskieren zu müssen. Es hat einige Eigenschaften mit dem

<literal>&lt;![CDATA[ ]]&gt;</literal>-Konstrukt in SGML gemeinsam, indem

es einen Textblock deklariert, der nicht geparst werden soll.

</para>

<para>

Ein Nowdoc wird mit der gleichen <literal>&lt;&lt;&lt;</literal>-Sequenz

identifiziert, die für Heredocs verwendet wird, aber der nachfolgende

Bezeichner wird in einfachen Anführungszeichen eingeschlossen, &zb;

<literal>&lt;&lt;&lt;'EOT'</literal>. Alle Regeln für Heredoc-Bezeichner

gelten auch für Nowdoc-Bezeichner, insbesondere die hinsichtlich des

Aussehens des schließenden Bezeichners.

</para>

<example>

<title>Nowdoc-Beispiel für das Notieren von Strings</title>

<programlisting role="php">

<![CDATA[

<?php

echo <<<'EOD'

Ein Beispiel für einen String, der sich über mehrere Zeilen erstreckt

unter Verwendung der Nowdoc-Syntax. Backslashes werden immer als

Buchstaben behandelt,

z. B. \\ und \'.

EOD;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Ein Beispiel für einen String, der sich über mehrere Zeilen erstreckt

unter Verwendung der Nowdoc-Syntax. Backslashes werden immer als

Buchstaben behandelt,

z. B. \\ und \'.

]]>

</screen>

</example>

<example>

<title>Nowdoc Beispiel für Strings mit Variablen</title>

<programlisting role="php">

<![CDATA[

<?php

class foo

{

public $foo;

public $bar;

function __construct()

{

$this->foo = 'Foo';

$this->bar = array('Bar1', 'Bar2', 'Bar3');

}

}

$foo = new foo();

$name = 'MeinName';

echo <<<'EOT'

Mein Name ist "$name". Ich gebe etwas $foo->foo aus.

Jetzt gebe ich etwas {$foo->bar[1]} aus.

Dies sollte ein großes 'A' ausgeben: \x41

EOT;

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Mein Name ist "$name". Ich gebe etwas $foo->foo aus.

Jetzt gebe ich etwas {$foo->bar[1]} aus.

Dies sollte ein großes 'A' ausgeben: \x41]]>

</screen>

</example>

<example>

<title>Beispiel für statische Daten</title>

<programlisting role="php" annotations="non-interactive">

<![CDATA[

<?php

class foo {

public $bar = <<<'EOT'

bar

EOT;

}

?>

]]>

</programlisting>

</example>

</sect3>

<sect3 xml:id="language.types.string.parsing">

<title>String-Interpolation</title>

<simpara>

Wenn ein <type>string</type> in doppelten Anführungszeichen oder mit

Heredoc angegeben wird, können die

<link linkend="language.variables">Variablen</link> darin ersetzt werden.

</simpara>

<simpara>

Es gibt zwei Arten von Syntax: eine

<link linkend="language.types.string.parsing.basic">einfache</link> und eine

<link linkend="language.types.string.parsing.advanced">erweiterte</link>.

Die einfache Syntax ist die gebräuchlichste und bequemste. Sie bietet eine

Möglichkeit, eine Variable, einen <type>&array;</type>-Wert oder eine

<type>&object;</type>-Eigenschaft mit minimalem Aufwand in einen

<type>String</type> einzubetten.

</simpara>

<simpara>

Die komplexe Syntax erkennt man an den geschweifte Klammern, die den

Ausdruck umgeben.

</simpara>

<sect4 xml:id="language.types.string.parsing.basic">

<title>Einfache Syntax</title>

<simpara>

Wenn ein Dollarzeichen (<literal>$</literal>) erkannt wird, werden die

darauf folgenden Zeichen, die in einem Variablennamen verwendet werden

können, als solche interpretiert und ersetzt.

</simpara>

<example>

<title>String-Interpolation</title>

<programlisting role="php">

<![CDATA[

<?php

$juice = "apple";

echo "He drank some $juice juice." . PHP_EOL;

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

He drank some apple juice.

]]>

</screen>

</example>

<simpara>

Formal ist die Struktur für die grundlegende Syntax der Ersetzung von

Variablen wie folgt:

</simpara>

<informalexample>

<programlisting>

<![CDATA[

String-Variable::

Variablen-Name (Offset-oder-Eigenschaft)?

| ${ Ausdruck }

Offset-oder-Eigenschaft::

Offset-im-String

| Eigenschaft-im-String

Offset-im-String::

[ Name ]

| [ Variablen-Name ]

| [ Ganzzahl-Literal ]

Eigenschaft-im-String::

-> Name

Variablen-Name::

$ Name

Name::

[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*

]]>

</programlisting>

</informalexample>

<warning>

<para>

Die Syntax <literal>${ expression }</literal> ist seit PHP 8.2.0

veraltet, da sie als

<link linkend="language.variables.variable">variable Variable</link>

interpretiert werden kann:

<informalexample>

<programlisting role="php">

<![CDATA[

<?php

const foo = 'bar';

$foo = 'foo';

$bar = 'bar';

var_dump("${foo}");

var_dump("${(foo)}");

?>

]]>

</programlisting>

&example.outputs.82;

<screen>

<![CDATA[

Deprecated: Using ${var} in strings is deprecated, use {$var} instead in file on line 6

Deprecated: Using ${expr} (variable variables) in strings is deprecated, use {${expr}} instead in file on line 9

string(3) "foo"

string(3) "bar"

]]>

</screen>

&example.outputs;

<screen>

<![CDATA[

string(3) "foo"

string(3) "bar"

]]>

</screen>

</informalexample>

Stattdessen sollte die

<link linkend="language.types.string.parsing.advanced">erweiterte</link>

Syntax der String-Interpolation verwendet werden.

</para>

</warning>

<note>

<simpara>

Wenn es nicht möglich ist, einen gültigen Namen zu bilden, bleibt das

Dollarzeichen unverändert im String erhalten:

</simpara>

<informalexample>

<programlisting role="php">

<![CDATA[

<?php

echo "Für $ wurde keine Interpolation durchgeführt\n";

echo "Für $\n wurde keine Interpolation durchgeführt\n";

echo "Für $2 wurde keine Interpolation durchgeführt\n";

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Für $ wurde keine Interpolation durchgeführt

Für $

wurde keine Interpolation durchgeführt

Für $2 wurde keine Interpolation durchgeführt

]]>

</screen>

</informalexample>

</note>

<example>

<title>Interpolieren des Wertes der ersten Dimension eines Arrays oder einer Eigenschaft</title>

<programlisting role="php">

<![CDATA[

<?php

$juices = array("apple", "orange", "string_key" => "purple");

echo "He drank some $juices[0] juice.";

echo PHP_EOL;

echo "He drank some $juices[1] juice.";

echo PHP_EOL;

echo "He drank some $juices[string_key] juice.";

echo PHP_EOL;

class A {

public $s = "string";

}

$o = new A();

echo "Wert des Objekts: $o->s.";

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

He drank some apple juice.

He drank some orange juice.

He drank some purple juice.

Wert des Objekts: string.

]]>

</screen>

</example>

<note>

<simpara>

Der Array-Schlüssel muss nicht in Anführungszeichen gesetzt werden, daher

ist es nicht möglich, mit der einfachen Syntax auf eine Konstante als

Schlüssel zu verweisen. Verwenden Sie stattdessen die

<link linkend="language.types.string.parsing.advanced">erweiterte</link>

Syntax.

</simpara>

</note>

<simpara>

Seit PHP 7.1.0 werden auch <emphasis>negative</emphasis> numerische

Indizes unterstützt.

</simpara>

<example>

<title>Negative numerische Indizes</title>

<programlisting role="php">

<![CDATA[

<?php

$string = 'string';

echo "Das Zeichen an Index -2 ist $string[-2].", PHP_EOL;

$string[-3] = 'o';

echo "Die Änderung des Zeichens an Index -3 auf o ergibt $string.", PHP_EOL;

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Das Zeichen an Index -2 ist n.

Die Änderung des Zeichens an Index -3 auf o ergibt strong.

]]>

</screen>

</example>

<simpara>

Für alles, das komplexer ist, muss die

<link linkend="language.types.string.parsing.advanced">erweiterte</link>

Syntax verwendet werden.

</simpara>

</sect4>

<sect4 xml:id="language.types.string.parsing.advanced">

<title>Erweiterte (geschweifte) Syntax</title>

<simpara>

Die erweiterte Syntax ermöglicht die Interpolation von

<emphasis>Variablen</emphasis> mit beliebigen Zugriffsmethoden.

</simpara>

<simpara>

Jede skalare Variable, jedes Array-Element oder jede Objekteigenschaft

(<modifier>static</modifier> oder nicht) mit einer

<type>String</type>-Darstellung kann über diese Syntax eingebunden werden.

Der Ausdruck wird so geschrieben, wie er auch außerhalb des

<type>String</type>s erscheinen würde, und dann von <literal>{</literal>

und <literal>}</literal> umschlossen. Da <literal>{</literal> nicht

maskiert werden kann, wird diese Syntax nur erkannt werden, wenn das

<literal>$</literal> unmittelbar auf das <literal>{</literal> folgt.

Verwenden Sie <literal>{\$</literal>, um ein wörtliches

<literal>{$</literal> zu erhalten. Einige Beispiele, um es zu

verdeutlichen:

</simpara>

<example>

<title>Syntax mit geschweiften Klammern</title>

<programlisting role="php">

<![CDATA[

<?php

const DATA_KEY = 'const-key';

$great = 'fantastisch';

$arr = [

'1',

'2',

'3',

[41, 42, 43],

'key' => 'Indexierter Wert',

'const-key' => 'Schlüssel mit Minuszeichen',

'foo' => ['foo1', 'foo2', 'foo3']

];

// Funktioniert nicht, Ausgabe: Das ist { fantastisch}

echo "Das ist { $great}";

// Funktioniert, Ausgabe: Das ist fantastisch

echo "Das ist {$great}";

class Square {

public $width;

public function __construct(int $width) { $this->width = $width; }

}

$square = new Square(5);

// Funktioniert

echo "Dieses Quadrat ist {$square->width}00 Zentimeter breit.";

// Funktioniert, Anführungszeichen funktionieren nur mit der