Heredoc-синтаксис
Heredóc-синтаксис (/həˈredɒk/) — способ определения строковых переменных в исходном коде программ.
Heredoc (дословно с английского «здесь документ») — синтаксис занесения в переменную одно- или (часто) многострочного свободно форматированного текста «как есть».[1]
При определении строковых переменных их содержимое, обычно, заключается в одинарные или двойные кавычки, в связи с чем символы кавычек, которые должны быть частью данных, приходится экранировать с помощью escape-последовательностей. Heredoc-синтаксис позволяет определить строку, не заключая её в кавычки, в связи с чем необходимость экранирования этих символов отпадает.[2]
Примеры
Обычное определение строки:
$s = 'Кавычки бывают \'одинарными\'';
$t = "Кавычки бывают \"двойными\"";
heredoc-определение (PHP):
Переменные внутри heredoc интерпретируются.
$s = <<<EOL
Кавычки бывают 'одинарными' и "двойными".
$name и {$foo->bar[1]}
EOL;
В PHP 5.3+ появилась версия heredoc, в которой переменные не интерпретируются. Для этого идентификатор нужно окружить одинарными кавычками. Это называется nowdoc.
$s = <<<'EOL'
Кавычки бывают 'одинарными' и "двойными".
$name и {$foo->bar[1]}
EOL;
Также в PHP 5.3+ идентификатор можно окружить двойными кавычками. Это соответствует варианту без кавычек.
heredoc-определение (Perl):
$s = <<EOL;
Кавычки бывают 'одинарными' и "двойными".
EOL
После <<< (или << в Perl) необходимо указать идентификатор, затем идет строка, а потом этот же идентификатор, закрывающий вставку.[1][3]
Закрывающий идентификатор должен начинаться в первом столбце строки. Кроме того, в PHP идентификатор должен соответствовать тем же правилам именования, что и все остальные метки: содержать только буквенно-цифровые символы и знак подчеркивания, и не должен начинаться с цифры.[4] В Perl идентификатором может служить любая строка, заключенная в кавычки для открывающего идентификатора.
heredoc-определение (Ruby):
$s = <<HEREDOC
Кавычки бывают 'одинарными' и "двойными".
HEREDOC
В языке Ruby идентификатор может быть произвольным и не зависеть от регистра. Чаще всего в практике используется HEREDOC. Открывающийся идентификатор в одинарных кавычках не интерпретирует переменные, а в двойных кавычках ведет себя так же, как и без них.[5]
Примечания
Ссылки
- Strings — PHP manual (англ.)