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

<!-- EN-Revision: ddc2a2d0966f746b67292b6c0987ef288747e409 Maintainer: rjhdby Status: ready -->

<!-- Reviewed: no -->

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

<title>Строки</title>

<para>

Строка (<type>string</type>) — набор символов. Каждый байт строки

интерпретируется как один символ. PHP поддерживает набор только из 256 символов и поэтому

внутренне не поддерживает кодировку Unicode. Подробнее об этом рассказывает раздел

«<link linkend="language.types.string.details">Подробные сведения о строковом типе</link>».

</para>

<note>

<simpara>

В 32-битных сборках размер строки (<type>string</type>) ограничивается 2 ГБ — максимум 2 147 483 647 байтов.

</simpara>

</note>

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

<title>Синтаксис</title>

<para>

Строковый литерал определяют четырьмя способами:

</para>

<itemizedlist>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.single">одинарными кавычками</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.double">двойными кавычками</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.heredoc">heredoc-синтаксисом</link>

</simpara>

</listitem>

<listitem>

<simpara>

<link linkend="language.types.string.syntax.nowdoc">nowdoc-синтаксисом</link>

</simpara>

</listitem>

</itemizedlist>

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

<title>Одинарные кавычки</title>

<para>

Простейший способ определить строку — заключить строку в одинарные кавычки —

символ <literal>'</literal>.

</para>

<para>

Буквальную одинарную кавычку при записи в строке экранируют обратным

слешем — <literal>\</literal>. Сам обратный слеш дублируют —

<literal>\\</literal>. В остальных случаях обратный слеш в одинарных кавычках

обрабатывается как буквальный обратный слеш: PHP не интерпретирует последовательности

вроде <literal>\r</literal> или <literal>\n</literal> в одинарных кавычках как управляющие,

а выводит как записали.

</para>

<note>

<simpara>

<link linkend="language.variables">Переменные</link> и управляющие последовательности

служебных символов в одинарных кавычках <emphasis>не</emphasis> обрабатываются,

в отличие от синтаксиса <link linkend="language.types.string.syntax.double">двойных кавычек</link>

и <link linkend="language.types.string.syntax.heredoc">heredoc</link>.

</simpara>

</note>

<example>

<title>Виды синтаксиса</title>

<programlisting role="php">

<![CDATA[

<?php

echo 'Это — простая строка', PHP_EOL;

echo 'Переводы строки внутри кавычек

становятся частью строкового значения

и корректно обрабатываются', PHP_EOL;

// Выводит: Однажды Арнольд сказал: "I'll be back"

echo 'Однажды Арнольд сказал: "I\'ll be back"', PHP_EOL;

// Выводит: Вы удалили C:\*.*?

// (Обратите внимание на экранирование обратным слешем спецсимвола \ — прим. перев.)

echo 'Вы удалили C:\\*.*?', PHP_EOL;

// Выводит: Вы удалили C:\*.*?

// (Символ * не относится к спецсимволам и не образует в паре с обратным слешем управляющую последовательность,

// поэтому обратный слеш не экранирует символ * и выводится как есть — прим. перев.)

echo 'Вы удалили C:\*.*?', PHP_EOL;

// Выводит: В одинарных кавычках управляющая последовательность \n не разворачивается в символ перевода строки

echo 'В одинарных кавычках управляющая последовательность \n не разворачивается в символ перевода строки', PHP_EOL;

// Выводит: Переменные $expand и $either также не разворачиваются

echo 'Переменные $expand и $either также не разворачиваются', PHP_EOL;

]]>

</programlisting>

</example>

</sect3>

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

<title>Двойные кавычки</title>

<para>

В строке в двойных кавычках — <literal>"</literal> —

PHP распознает следующие управляющие последовательности служебных символов:

</para>

<table>

<title>Управляющие последовательности</title>

<tgroup cols="2">

<thead>

<row>

<entry>Последовательность</entry>

<entry>Значение</entry>

</row>

</thead>

<tbody>

<row>

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

<entry>Перевод строки. В кодировке ASCII управляющий символ обозначается аббревиатурой LF и соответствует коду 0x0A в шестнадцатеричной или 10 в десятичной нотации</entry>

</row>

<row>

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

<entry>Возврат каретки. В кодировке ASCII управляющий символ обозначается аббревиатурой CR и соответствует коду 0x0D в шестнадцатеричной или 13 в десятичной нотации</entry>

</row>

<row>

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

<entry>Горизонтальная табуляция. В кодировке ASCII этот управляющий символ обозначается аббревиатурой HT и соответствует коду 0x09 в шестнадцатеричной или 9 в десятичной нотации</entry>

</row>

<row>

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

<entry>Вертикальная табуляция. В кодировке ASCII этот управляющий символ обозначается аббревиатурой VT и соответствует коду 0x0B в шестнадцатеричной или 11 в десятичной нотации</entry>

</row>

<row>

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

<entry>Escape-символ. В кодировке ASCII этот управляющий символ обозначается аббревиатурой HT и соответствует коду 0x1B в шестнадцатеричной или 27 в десятичной нотации</entry>

</row>

<row>

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

<entry>Подача страницы. В кодировке ASCII этот управляющий символ обозначается аббревиатурой HT и соответствует коду 0x0C в шестнадцатеричной или 12 в десятичной нотации</entry>

</row>

<row>

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

<entry>Обратный слеш</entry>

</row>

<row>

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

<entry>Знак доллара</entry>

</row>

<row>

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

<entry>Двойная кавычка</entry>

</row>

<row>

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

<entry>

Восьмеричная запись: последовательность символов, которая соответствует

регулярному выражению <literal>[0-7]{1,3}</literal>, — <literal>"\101" === "A"</literal>.

При целочисленном переполнении, когда символ не помещается в один байт,

старшие биты без предупреждения отбрасываются: <literal>"\400" === "\000"</literal>

</entry>

</row>

<row>

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

<entry>

Шестнадцатеричная запись: последовательность символов, которая соответствует

регулярному выражению <literal>[0-9A-Fa-f]{1,2}</literal>, — <literal>"\x41" === "A"</literal>

</entry>

</row>

<row>

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

<entry>

Символы Юникода: последовательность символов, которая соответствует

регулярному выражению <literal>[0-9A-Fa-f]+</literal>, — кодовая точка Юникода,

которая выводится как строка в кодировке UTF-8.

Последовательность указывается в фигурных скобках:

<literal>"\u{41}" === "A"</literal>

</entry>

</row>

</tbody>

</tgroup>

</table>

<para>

Как и в строках в одинарных кавычках, при попытке заэкранировать другие символы,

которые не относятся к управляющим, обратный слеш не интерпретируется как символ экранирования и выводится буквально.

</para>

<para>

Наиболее важное свойство строк в двойных кавычках состоит в том,

что названия переменных в них развернутся и обработаются.

Подробнее об этом рассказывает раздел

«<link linkend="language.types.string.parsing">Интерполяция строк</link>».

</para>

</sect3>

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

<title>Heredoc</title>

<simpara>

Третий способ определения строк — heredoc-синтаксис:

<literal>&lt;&lt;&lt;</literal>. Следом за этим оператором указывают идентификатор,

а затем перевод строки. Затем идёт сама строка, за которой снова идёт тот же идентификатор,

чтобы закрыть вставку.

</simpara>

<simpara>

Закрывающий идентификатор разрешается отбивать пробелами или символами табуляции,

и тогда отступ удалится из каждой строки в блоке документа. До PHP 7.3.0

закрывающий идентификатор указывали <emphasis>в самом начале</emphasis> новой строки.

</simpara>

<simpara>

Кроме того, закрывающий идентификатор подчиняется тем же правилам именования,

что и другие метки в PHP: содержит только буквенно-цифровые символы

и подчёркивания, и не начинается с цифрового символа или символа подчёркивания.

</simpara>

<example>

<title>Базовый пример heredoc-синтаксиса в PHP 7.3.0</title>

<programlisting role="php">

<![CDATA[

<?php

// Без отступа перед маркером закрытия

echo <<<END

a

b

c

\n

END;

// Отступ в 4 пробела перед маркером закрытия

echo <<<END

a

b

c

END;

]]>

</programlisting>

&example.outputs.73;

<screen>

<![CDATA[

a

b

c

a

b

c

]]>

</screen>

</example>

<simpara>

PHP выбросит исключение <classname>ParseError</classname>,

если закрывающий идентификатор сместили дальше хотя бы одной строки тела:

</simpara>

<example>

<title>Идентификатору закрытия нельзя отступать дальше строк тела</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>

В теле и перед идентификатором окончания heredoc-блока разрешается делать отступы

символами пробелов и табуляции, но <emphasis>нельзя</emphasis> смешивать символы

табуляции и пробелы относительно отступа идентификатора закрытия и отступа тела

до начала закрывающего идентификатора; heredoc-синтаксис будет работать с отступом перед маркером закрытия,

только если каждая строка тела начинается, но не ограничивается, с того же отступа,

что и отступ перед маркером закрытия. При несовпадении отступов в начале строк тела с отступом

перед идентификатором закрытия PHP выбросит исключение <classname>ParseError</classname>.

Ограничения на пробельные отступы добавили, потому что смешивание табуляций

и пробелов для отступов вредно для разбора.

</simpara>

<example>

<title>Пример несовпадения отступов в теле и перед идентификатором закрытия тела</title>

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

<!-- Не исправляйте отступы в примере:

они выглядят как пробелы, но часть символов — пробельные (0x0032), часть — символы табуляции (0x0009)!

Символьный состав отступов тела и маркера окончания описывается глазами читателя; в первом примере

в теле в действительности 1 таб + 1 пробел, но для читателя это 5 пробелов -->

<![CDATA[

<?php

/**

* Каждый следующий пример кода не работает

*/

// Отступ тела отличается от отступа маркера окончания:

// тело — 5 пробелов, маркер окончания — 2 символа табуляции

{

echo <<<END

a

END;

}

// Смешивание пробелов и табуляций в теле:

// тело — 4 пробела + 1 символ табуляции, маркер окончания — 5 пробелов

{

echo <<<END

a

END;

}

// Смешивание пробелов и табуляций в маркере окончания:

// тело — 10 пробелов, маркер окончания — 2 символа табуляции + 1 пробел

{

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>

За идентификатором закрытия строки тела не обязательно ставить точку с запятой

или новую строку. Приведём пример кода, который разрешается с PHP 7.3.0:

</simpara>

<example>

<title>Продолжение выражения после идентификатора закрытия</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>

Парсер примет идентификатор за закрывающий и выбросит

исключение <classname>ParseError</classname>, если найдёт

закрывающий идентификатор в начале строки, даже если это часть слова.

</simpara>

<example>

<title>Закрывающий идентификатор в теле текста провоцирует исключение 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>

Таких проблем помогает избегать несложное, но надёжное правило:

<emphasis>не указывать как идентификатор закрытия слово, которое встречается в теле текста</emphasis>.

</simpara>

</warning>

<warning>

<simpara>

До PHP 7.3.0 строке с закрывающим идентификатором нельзя было содержать

других символов, кроме точки с запятой — <literal>;</literal>. То есть

идентификатор <emphasis>нельзя вводить с отступом</emphasis>,

а пробелы или знаки табуляции нельзя вводить до или после точки с запятой.

Учитывают также, что первым символом перед закрывающим идентификатором идёт

символ новой строки, который определяет операционная система. Например,

в Unix-системах, включая macOS, это символ <literal>\n</literal>. После идентификатора

закрытия должна сразу начинаться новая строка.

</simpara>

<simpara>

PHP не будет считать идентификатор закрывающим и продолжит поиск идентификатора,

если это правило нарушили и идентификатор закрытия не «чистый».

На последней строке возникнет ошибка синтаксического анализа, если PHP

так и не найдёт правильный идентификатор закрытия до конца текущего файла.

</simpara>

<example>

<title>Пример неправильного до PHP 7.3.0 синтаксиса</title>

<programlisting role="php">

<![CDATA[

<?php

class Foo {

public $bar = <<<EOT

bar

EOT;

// Отступ перед закрывающим идентификатором недопустим

}

]]>

</programlisting>

</example>

<example>

<title>Пример правильного даже до PHP 7.3.0 синтаксиса</title>

<programlisting role="php">

<![CDATA[

<?php

class Foo

{

public $bar = <<<EOT

bar

EOT;

}

]]>

</programlisting>

</example>

<para>

В Heredoc-синтаксисе, который содержит переменные, нельзя инициализировать свойства класса.

</para>

</warning>

<para>

Heredoc-текст ведёт себя как строка в двойных кавычках, хотя и не заключается в двойные кавычки.

То есть в heredoc кавычки не экранируют,

но перечисленные управляющие коды по-прежнему разрешено указывать.

Переменные разворачиваются, но в выражениях со сложными переменными внутри heredoc

работают так же внимательно, как и при работе со строками.

</para>

<example>

<title>Пример определения heredoc-строки</title>

<programlisting role="php">

<![CDATA[

<?php

$str = <<<EOD

Пример строки,

которую записали heredoc-синтаксисом

в несколько строк.

EOD;

/* Более сложный пример с переменными. */

class Foo

{

var $foo;

var $bar;

function __construct()

{

$this->foo = 'Foo';

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

}

}

$foo = new Foo();

$name = 'Расмус';

echo <<<EOT

Меня зовут "$name". Я печатаю $foo->foo.

Теперь я вывожу {$foo->bar[1]}.

Это выведет заглавную букву 'A': \x41

EOT;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Меня зовут "Расмус". Я печатаю Foo.

Теперь, я вывожу Bar2.

Это выведет заглавную букву 'A': A]]>

</screen>

</example>

<para>

Heredoc-синтаксис работает также и при передаче данных через аргументы функции:

</para>

<example>

<title>Пример heredoc-синтаксиса с аргументами</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(array(<<<EOD

foobar!

EOD

));

]]>

</programlisting>

</example>

<para>

В heredoc-синтаксисе разрешено инициализировать статические переменные и свойства или константы класса:

</para>

<example>

<title>Инициализация статических переменных heredoc-синтаксисом</title>

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

<![CDATA[

<?php

// Статические переменные

function foo()

{

static $bar = <<<LABEL

Здесь ничего нет...

LABEL;

}

// Константы/свойства класса

class Foo

{

const BAR = <<<FOOBAR

Пример использования константы

FOOBAR;

public $baz = <<<FOOBAR

Пример использования поля

FOOBAR;

}

]]>

</programlisting>

</example>

<para>

Допустимо также окружать heredoc-идентификатор двойными кавычками:

</para>

<example>

<title>Двойные кавычки в heredoc</title>

<programlisting role="php">

<![CDATA[

<?php

echo <<<"FOOBAR"

Привет, мир!

FOOBAR;

]]>

</programlisting>

</example>

</sect3>

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

<title>Nowdoc</title>

<para>

Nowdoc — то же для строк в одинарных кавычках, что и heredoc для строк

в двойных кавычках. Синтаксис Nowdoc похож на heredoc-синтаксис, но внутри него

<emphasis>не выполняются интерполяция строк</emphasis>. Конструкция

легко встраивает PHP-код или другие большие блоки текста без

предварительного экранирования. В этом он отчасти похож на SGML-конструкцию

<literal>&lt;![CDATA[ ]]&gt;</literal>, в том, что он объявляет блок текста,

который не требует обработки.

</para>

<para>

Nowdoc задают той же последовательностью символов <literal>&lt;&lt;&lt;</literal>,

что и в heredoc, но следующий за ней идентификатор берут

в одинарные кавычки, например, <literal>&lt;&lt;&lt;'EOT'</literal>.

Условия, которые распространяются на идентификаторы heredoc-синтаксиса, действительны также

и для синтаксиса nowdoc, а больше остальных те, что относятся к закрывающему идентификатору.

</para>

<example>

<title>Пример nowdoc-синтаксиса</title>

<programlisting role="php">

<![CDATA[

<?php

echo <<<'EOD'

Пример текста,

занимающего несколько строк,

написанного синтаксисом nowdoc. Обратные слеши выводятся без обработки,

например, \\ и \'.

EOD;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Пример текста,

занимающего несколько строк,

написанного синтаксисом nowdoc. Обратные слеши выводятся без обработки,

например, \\ и \'.

]]>

</screen>

</example>

<example>

<title>Nowdoc-синтаксис с переменными в строках с двойными кавычками</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 = 'Расмус';

echo <<<'EOT'

Меня зовут "$name". Я печатаю $foo->foo.

Теперь я печатаю {$foo->bar[1]}.

Это не выведет заглавную 'A': \x41

EOT;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Меня зовут "$name". Я печатаю $foo->foo.

Теперь я печатаю {$foo->bar[1]}.

Это не выведет заглавную 'A': \x41]]>

</screen>

</example>

<example>

<title>Пример со статичными данными</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>Интерполяция строк</title>

<simpara>

PHP умеет подставлять внутри строк значения вместо <link linkend="language.variables">переменных</link>,

если строку (<type>string</type>) указали в двойных кавычках или heredoc-синтаксисом.

</simpara>

<simpara>

В PHP предусмотрели два вида синтаксиса для указания переменных в строках:

<link linkend="language.types.string.parsing.basic">базовый</link>

и <link linkend="language.types.string.parsing.advanced">продвинутый</link>.

Базовым синтаксисом пользуются чаще, им легко

встраивать переменную, значение массива (<type>array</type>)

или свойство объекта (<type>object</type>) с минимумом усилий.

</simpara>

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

<title>Базовый синтаксис</title>

<simpara>

PHP интерпретирует как переменную и подставит вместо переменной значение этой переменной,

если встретит в строке знак доллара <literal>$</literal>,

за которым идут символы, допустимые для составления названий переменных.

</simpara>

<example>

<title>Интерполяция строк</title>

<programlisting role="php">

<![CDATA[

<?php

$juice = "яблочного";

echo "Он выпил немного $juice сока." . PHP_EOL;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Он выпил немного яблочного сока.

]]>

</screen>

</example>

<simpara>

Формально структура базового синтаксиса подстановки переменных

выглядит вот так:

</simpara>

<informalexample>

<programlisting>

<![CDATA[

строковая переменная::

имя-переменной (смещение-или-свойство)?

| ${ выражение }

смещение-или-свойство::

смещение в строке

| свойство-в-строке

смещение-в-строке::

[ имя ]

| [ имя-переменной ]

| [ целочисленный-литерал ]

свойство-в-строке::

-> имя

имя-переменной::

$ имя

имя::

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

]]>

</programlisting>

</informalexample>

<warning>

<para>

Синтаксис <literal>${ выражение }</literal> устарел

с PHP 8.2.0, поскольку интерпретируется

как <link linkend="language.variables.variable">переменные переменных</link>:

<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>

Вместо этого пользуются

<link linkend="language.types.string.parsing.advanced">продвинутым</link>

синтаксисом интерполяции строк.

</para>

</warning>

<note>

<simpara>

Знак доллара остается в строке как сам знак доллара,

если невозможно сформировать допустимое имя:

</simpara>

<informalexample>

<programlisting role="php">

<![CDATA[

<?php

echo "Строка не содержит переменных $ для интерполяции\n";

echo "Строка не содержит переменных $\n для интерполяции\n";

echo "Строка не содержит переменных $2 для интерполяции\n";

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Строка не содержит переменных $ для интерполяции

Строка не содержит переменных $

для интерполяции

Строка не содержит переменных $2 для интерполяции

]]>

</screen>

</informalexample>

</note>

<example>

<title>Пример интерполяции значений первого уровня массива или свойства объекта</title>

<programlisting role="php">

<![CDATA[

<?php

$juices = array("яблочного", "апельсинового", "string_key" => "фиолетового");

echo "Он выпил немного $juices[0] сока.";

echo PHP_EOL;

echo "Он выпил немного $juices[1] сока.";

echo PHP_EOL;

echo "Он выпил немного $juices[string_key] сока.";

echo PHP_EOL;

class A

{

public $s = "string";

}

$o = new A();

echo "Значение свойства объекта: $o->s.";

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Он выпил немного яблочного сока.

Он выпил немного апельсинового сока.

Он выпил немного фиолетового сока.

Значение свойства объекта: string.

]]>

</screen>

</example>

<note>

<simpara>

Ключ массива указывают без кавычек, поэтому невозможно

ссылаться на константу как на ключ в базовом синтаксисе. Вместо этого пользуются

<link linkend="language.types.string.parsing.advanced">продвинутым</link>

синтаксисом.

</simpara>

</note>

<simpara>

В PHP 7.1.0 добавили поддержку <emphasis>отрицательных</emphasis>

числовых индексов.

</simpara>

<example><title>Отрицательные числовые индексы</title>

<programlisting role="php">

<![CDATA[

<?php

$string = 'string';

echo "Символ с индексом -2 равен $string[-2].", PHP_EOL;

$string[-3] = 'o';

echo "Изменение символа на позиции -3 на 'o' даёт следующую строку: $string.", PHP_EOL;

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

Символ с индексом -2 равен n.

Изменение символа на позиции -3 на «o» даёт следующую строку: strong

]]>

</screen>

</example>

<simpara>

Для выражений, которые сложнее этих, лучше пользоваться

<link linkend="language.types.string.parsing.advanced">продвинутым</link>

синтаксисом.

</simpara>

</sect4>

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

<title>Продвинутый, или фигурный, синтаксис</title>

<simpara>

Продвинутый синтаксис разрешает интерполировать

<emphasis>переменные</emphasis> с произвольными методами доступа.

</simpara>

<simpara>

В строках продвинутым синтаксисом указывают скалярные переменные, элементы массива,

статические и динамические свойства объекта со строковым представлением.

Выражение записывается как и вне строки, а затем оборачивается

в фигурные скобки <literal>{</literal> и <literal>}</literal>.

Поскольку знак <literal>{</literal> невозможно экранировать, продвинутый синтаксис

распознаётся только тогда, когда знак <literal>$</literal> идёт непосредственно за знаком <literal>{</literal>.

Знак доллара экранируют синтаксисом <literal>{\$</literal>, чтобы получить литерал <literal>{$</literal>.

Поясняющие примеры:

</simpara>

<example>

<title>Синтаксис фигурных скобок</title>

<programlisting role="php">

<![CDATA[

<?php

const DATA_KEY = 'const-key';

$great = 'здорово';

$arr = [

'1',

'2',

'3',

[41, 42, 43],

'key' => 'Индексное значение',

'const-key' => 'Ключ со знаком минуса',

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

];

// Не работает, выводит: Это { здорово}

echo "Это { $great}" . PHP_EOL;

// Работает, выводит: Это здорово

echo "Это {$great}" . PHP_EOL;

// Для вывода самих фигурных скобок:

echo "Это {{$great}}" . PHP_EOL;

class Square

{

public $width;

public function __construct(int $width)

{

$this->width = $width;

}

}

$square = new Square(5);

// Работает

echo "Ширина квадрата составляет {$square->width}00 сантиметров." . PHP_EOL;

// Работает, ключи в кавычках работают только при записи синтаксисом фигурных скобок

echo "Это работает: {$arr['key']}" . PHP_EOL;

// Работает

echo "Это работает: {$arr[3][2]}" . PHP_EOL;

echo "Работает: {$arr[DATA_KEY]}" . PHP_EOL;

// При работе с многомерными массивами массивы внутри строк оборачивают в фигурные скобки

echo "Это работает: {$arr['foo'][2]}" . PHP_EOL;

echo "Работает: {$obj->values[3]->name}" . PHP_EOL;

echo "Работает: {$obj->$staticProp}" . PHP_EOL;