Heredoc - Versionsgeschichte

176.198.236.19: Bezeichner unwahrscheinlich (`cat <
2023-10-25T10:55:52Z

Bezeichner unwahrscheinlich (`cat <<IFS=5 ...`), transientes Token? Overhead?

Neue Seite
Ein '''Heredoc''', auch '''here document''' (von [[Englische Sprache|englisch]], wörtlich ''hier dokument'') genannt, ist ein Sprachkonzept der [[Informatik]] zur Spezifikation eines Zeichenfolgenliterals in [[Kommandozeileninterpreter]]n wie beispielsweise der [[Bourne-again shell|bash]], [[Windows PowerShell]] und der [[Bourne-Shell]] sowie in [[Programmiersprache]]n wie etwa [[Perl (Programmiersprache)|Perl]], [[PHP]], [[Python (Programmiersprache)|Python]] und [[Ruby (Programmiersprache)|Ruby]]. Der Bezeichnung entsprechend dienen Heredocs zur Definition von Textabschnitten. Im Unterschied zu herkömmlichen [[Zeichenkette|Stringdefinitionen]] werden enthaltene Zeilenumbrüche sowie Einzüge und viele Sonderzeichen im Text bewahrt. Einige Sprachen ermöglichen auch die Interpolation von Variablen oder auch Programmcode innerhalb der Zeichenfolge.

Je nach Programmiersprache werden Heredocs durch <code><<</code>, <code><<<</code>, <code><!--</code>, <code><<-</code> oder ähnliche Zeichenfolgen eingeleitet, gefolgt von einer weitgehend frei wählbaren Zeichenfolge, die das Ende des Heredoc markiert ([[Delimiter]]); in der nächsten Zeile beginnt der Text des Heredoc. Das Ende des Heredoc wird durch eine Zeile mit dem zuvor gewählten Delimiter und gegebenenfalls einem Semikolon oder einem Zeilenende markiert.

Viele UNIX-Shells, einschließlich der Bourne-Shell (sh) und zsh, bieten Heredocs als eine Möglichkeit, um Eingabewerte für Kommandozeilenbefehle anzugeben. Die Microsoft PowerShell bietet eine ähnliche Funktionalität, sowohl interaktiv in der Shell selbst, als auch über eine spezielle Skriptsyntax in Skriptdateien, die in der PowerShell ausführbar sind.

Beispielhafte Umsetzung in [[PHP]]:<ref>David Sklar, Adam Trachtenberg: PHP Kochbuch, O’Reilly, Köln, 2003, ISBN 3-89721-351-6, S. 2–3</ref><ref>[https://www.php.net/manual/de/language.types.string.php#language.types.string.syntax.heredoc Heredoc auf php.net]</ref>

<syntaxhighlight lang="PHP">
<?php
echo <<<ENDE
Dies ist ein Heredoc
zweite Zeile
ENDE;
?>
</syntaxhighlight>

Ein Beispiel in [[Python (Programmiersprache)|Python]]:<ref>[https://devcamp.com/trails/introduction-programming-python/campsites/python-strings/guides/guide-heredocs-python devcamp.com Guide to Heredocs in Python]</ref>
<syntaxhighlight lang="PYTHON">
text="""{name}
wohnt in
{place}"""
print(text.format(name='Christoph', place='Chur'))
</syntaxhighlight>
Gibt
<pre>
Christoph
wohnt in
Chur
</pre>
aus.

== Siehe auch ==
* [[Literal]]
* [[Zeichenkette]]
* [[Einzeiler (Informatik)|Einzeiler in der Informatik]]

== Einzelnachweise ==
<references />

[[Kategorie:Programmiersprachelement]]