Here文档

here文档，又称作heredoc、hereis、here-字串或here-脚本，是一种在命令行shell（如sh、csh、ksh、bash、PowerShell和zsh）和程序语言（像Perl、PHP、Python和Ruby）里定义一个字串的方法。它可以保存文字里面的换行或是缩排等空白字元。一些语言允许在字串里执行变量替换和命令替换。
here文档最通用的语法是codice_1紧跟一个标识符，从下一行开始是想要引用的文字，然后再在单独的一行用相同的标识符关闭。在Unix shell里，here文档通常用于给命令提供输入内容。
实例.
以下几节提供了不同语言和环境中的例子。
命令行 shell.
Unix shell.
在以下几个例子中，文字用here文档传递给tr命令。
<syntaxhighlight lang="bash">
</syntaxhighlight>
codice_2被用作标识符。它指定了here文档的开始和结束codice_3和codice_4是执行后codice_5的输出。
在Â«后面添加一个减号，可以使TAB字元被忽略。这允许在shell脚本中缩进here文档而不改变它们的值。（注意在命令行上可能会需要输入"Ctrl-v TAB"来真正地输入一个制表符。下边的例子用空格模拟制表符；不要复制粘贴。）
<syntaxhighlight lang="bash">
</syntaxhighlight>
默认地，会进行变量替换和命令替换：
<syntaxhighlight lang="bash">
</syntaxhighlight>
这可以通过使用引号包裹标识符来禁用。可以使用单引号或双引号：
<syntaxhighlight lang="bash">
</syntaxhighlight>
bash，ksh或zsh中也可以用here-字串：
<syntaxhighlight lang="bash">
</syntaxhighlight>
Windows 命令行.
等价的代码目前没有找到。下列代码较为有用。
<syntaxhighlight lang="bash">
set GREETING=Hello
echo %GREETING%
cmd /k 
exit
echo %GREETING%
C:\>
C:\>set GREETING=Hello
C:\>echo %GREETING%
Hello
C:\>cmd /k
C:\> echo %GREETING%
Hello
C:\> set GREETING=Goodbye
C:\> echo %GREETING%
Goodbye
C:\>exit
C:\>echo %GREETING%
Hello
C:\>
</syntaxhighlight>
Windows PowerShell.
在Windows PowerShell里，here文档表示的是here-字串。一个here-字串是由codice_6或codice_7开始，由独立成行的codice_8或codice_9结束的字串。所有在开始符号和结束符号之间的字符都被当做字面的字串。
使用双引号引起来的here-字串允许变量替换，而单引号不行。
变量替换只发生于简单变量（如codice_10，但不是codice_11或codice_10）。
可以将命令放进codice_13中来获取执行结果。
在如下的PowerShell的代码中，文字使用here-字串传递给一个函数。这个函数codice_14定义如下：
下边是一个证明了双引号的here-字串里的变量替换和命令替换的例子：
输出：
如果用单引号的here-字串代替，输出看起来会像这样：
编程语言.
C++.
C++11引入了原始字面字串。原始字面字串的前缀有一个“R”，以codice_15开始，以codice_16结束。分隔符可以是0到16字符长，可以包括简单的字符，除开空格，括号与反斜杠。
<syntaxhighlight lang="cpp">
char const *a = R"(The escape sequence '\n' represents a newline character.)";
wchar_t const *b = LR"...(Raw strings look like R"(...)")...";
char16_t const *b = uR"xyz(
Universal character names such as "\u5367\u864E\u85CF\u3863" are not
processed in raw string literals. Therefore the above can be written
as "卧虎藏龙" in a raw string literal, but only if the source character
set contains those characters.
)xyz";
</syntaxhighlight>
D语言.
从2.0版本开始，D语言支持用“q”引导的here-字串。这些字串以一个括号（<>，[]，()，{}）或者单独成行的标识符开始。
下列D代码展示了使用括号和标识符的here-字串。
<syntaxhighlight lang="D">
int main() {
2. Item Two
3. Item Three]";
</syntaxhighlight>
使用标识符：
<syntaxhighlight lang="D">
int main() {
1. Item One
2. Item Two
3. Item Three
IDENT";
</syntaxhighlight>
Lua.
Lua使用codice_17和codice_17定义字面字串，字面字串中的换行会原样保留，不允许含有转义字符。这不便放置长的注释（codice_19）和一些字串（codice_20）。所以在版本5.1时，Lua添加了一个新语法：起始的两个括号中间可以加入任意多的等号，并且只有相同的等号数字才能关闭字串。
<syntaxhighlight lang="Lua">
local ls = 
Initial newline isn't part of the string.
Two lines.
local lls = [==[
This notation can be used for Windows paths: 
local path = [=[C:\Windows\Fonts]=]
</syntaxhighlight>
Perl.
在Perl里有许多不同的方法使用here文档。在here文档的标签名前后加括号的效果和一般的字面字串效果是一样的：标签前后加双引号允许变量扩展，单引号则不行，不加引号的和加双引号的效果一样。加反引号将会把here文档当做shell脚本执行，并获取输出。需要保证结束标签必须在一行的开始，不然这个标签不会被直译器认出。
注意here文档不是从标签开始的，而是从下一行开始的。所以包含标签的语句将会在标签后继续。
这是一个使用双引号的例子：
<syntaxhighlight lang="Perl">
my $sender = "Buffy the Vampire Slayer";
my $recipient = "Spike";
print Â«"END";
Dear $recipient, 
I wish you to leave Sunnydale and never return.
Not Quite Love,
$sender
END
</syntaxhighlight>
输出：
这是使用单引号的例子：
<syntaxhighlight lang="Perl">
print Â«'END';
Dear $recipient,
I wish you to leave Sunnydale and never return.
Not Quite Love,
$sender
END
</syntaxhighlight>
输出：
另外一个使用反引号的例子（可能不具有可移植性）：
<syntaxhighlight lang="Perl">
my $shell_script_stdout = Â«`END`;
echo foo
echo bar
END
</syntaxhighlight>
可以在同一行上开始多个here文档：
<syntaxhighlight lang="Perl">
say(Â«BEGIN . "this is the middle\n" . Â«END);
This is the beginning:
BEGIN
And now it is over!
END
say("This is the beginning:\nthis is the middle\nAnd now it is over!");
</syntaxhighlight>
标签本身可以使用空格，这允许here文档不会破坏缩进。
<syntaxhighlight lang="Perl">
Hello World
</syntaxhighlight>
PHP.
<syntaxhighlight lang="PHP">
<?php
$name = "Joe Smith";
$occupation = "Programmer";
echo Â«<EOF
 This is a heredoc section.
 For more information talk to $name, your local $occupation.
 Thanks!
EOF;
$toprint = Â«<EOF
 Hey $name! You can actually assign the heredoc section to a variable!
EOF;
echo $toprint;
</syntaxhighlight>
输出：
包含关闭标识符的行不得包含除了（可选的）分号的任何其他字符。不然它就不会被识别为关闭标识符，PHP就会继续寻找一个。如果没有找到关闭标识符，分析错误会发生在最后一行。
在PHP 5.3和以后的版本中，就像Perl一样，可以用单引号包裹标识符阻止变量扩展；这叫作"nowdoc"：
<syntaxhighlight lang="php">
$x = Â«<'END'
Dear $recipient,
I wish you to leave Sunnydale and never return.
Not Quite Love,
$sender
END;
</syntaxhighlight>
在PHP5.3和以后的版本中，也可以用双引号包裹标识符，像Perl一样，和不用引号的效果一样。
Python.
Python支持使用三个连续单引号或双引号的字面字串（如codice_17或codice_22）。这些字面字串可以跨越多行，支持here文档的功能。
一个简单的Python3兼容的例子给出像上边第一个Perl例子一样：
<syntaxhighlight lang="Python">
message="""Dear {recipient},
I wish you to leave Sunnydale and never return.
Not Quite Love,
print(message.format(sender='Buffy the Vampire Slayer', recipient='Spike'))
</syntaxhighlight>
在Python3.0以前的版本中，用print关键字代替print函数。
R.
R语言在字串里使用空格，包括换行。不执行变量替换。字串可以用codice_23函数转化为文件描述符。例如，以下代码将一个嵌入源码的数据表转化为一个数据框架变量：
<syntaxhighlight lang="rsplus">
str <-
"State Population Income Illiteracy Life.Exp Murder HS.Grad Frost
Alabama 3615 3624 2.1 69.05 15.1 41.3 20
Alaska 365 6315 1.5 69.31 11.3 66.7 152
Arizona 2212 4530 1.8 70.55 7.8 58.1 15
Arkansas 2110 3378 1.9 70.66 10.1 39.9 65"
x <- read.table(textConnection(str), header=TRUE, row.names=1)
</syntaxhighlight>
Racket.
Racket的here字串以codice_24开始，紧跟定义字串终止的标识符。
字串的内容包括所有的在codice_24一行和仅包括定义了的终止符的那一行。即：字串的内容开始于codice_24后的新行，结束于终止符之前的一行。
<syntaxhighlight lang="Scheme">
(displayln
This is a simple here string in Racket.
HERESTRING
</syntaxhighlight>
输出：
here字串中的转义字符不被识别；字串（和终止符）中所有的字符都会保持原样。
<syntaxhighlight lang="Scheme">
(displayln
输出：
here字串可以像一般的字串一样使用：
<syntaxhighlight lang="Scheme">
(printf #Â«END
Dear ~a,
Thanks for the insightful conversation ~a.
END
</syntaxhighlight>
输出：
一个有趣的替代方案是使用语言的扩展codice_27来写@-表达式。
它们看起来像这样：
<syntaxhighlight lang="Scheme">
(displayln @string-append{
</syntaxhighlight>
输出：
Ruby.
下列Ruby代码用here文档显示了一个列表：
<syntaxhighlight lang="Ruby">
puts Â«GROCERY_LIST
Grocery list
1. Salad mix.
2. Strawberries.*
3. Cereal.
4. Milk.*
GROCERY_LIST
</syntaxhighlight>
输出：
写入文件：
<syntaxhighlight lang="Ruby">
File::open("grocery-list", "w") do |f|
Grocery list
1. Salad mix.
2. Strawberries.*
3. Cereal.
4. Milk.*
GROCERY_LIST
end
</syntaxhighlight>
Ruby也允许标识符不起始于行首，需要以codice_28起始here文档。
另外，Ruby对待here文档就像一个双引号括起来的字串，即可以使用#{}来进行代码替换。
以下例子展示了这2个特性：
<syntaxhighlight lang="Ruby">
now = Time.now
puts Â«-EOF
</syntaxhighlight>
但是如果标识符是用单引号引起来的，则当做单引号内的字串对待。
类似于Perl，Ruby允许在一行内开始多个here文档：
<syntaxhighlight lang="Ruby">
puts Â«BEGIN + "<--- middle --->\n" + Â«END
This is the beginning:
BEGIN
And now it is over!
END
puts "This is the beginning:\n<--- middle --->\nAnd now it is over!"
</syntaxhighlight>
Tcl.
Tcl没有为here文档设立特殊的语法，因为一般的字串语法已经允许嵌入换行和保持缩进。用括号括起来的字串，没有扩展：
<syntaxhighlight lang="text">
puts {
Grocery list
1. Salad mix.
2. Strawberries.*
3. Cereal.
4. Milk.*
</syntaxhighlight>
用引号括起来的字串在运行时执行替换：
<syntaxhighlight lang="Tcl">
set sender "Buffy the Vampire Slayer"
set recipient "Spike"
puts "
Dear $recipient, 
I wish you to leave Sunnydale and never return.
Not Quite Love,
$sender
</syntaxhighlight>
在括号包裹的字串里，起始括号和终止括号数量应该一样多。在引号包裹的字串里，括号可以不一样多，但是反斜杠，美元符号和括号都会被替换，此时第一个没有被转义的双引号会结束字串。
需要注意的一点是：上边的字串的第一个和最后一个字符都是换行。codice_29可以用来删除头尾空行：
<syntaxhighlight lang="Tcl">
puts [string trim "
Dear $recipient, 
I wish you to leave Sunnydale and never return.
Not Quite Love,
$sender
" \n]
</syntaxhighlight>
其它.
微软 NMAKE.
在微软NMAKE里，here文档是行内的文件。行内文件以codice_1或codice_31开始。第一种方法创建一个临时文件。第二种创建（或覆盖）特定文件。所有的行内文件都终止于独自成行的codice_1，后边可以添加不区分大小写的codice_33或codice_34来决定该文件是否保留。两个都不添加和加入codice_34效果一样。
<syntaxhighlight lang="make">
target0: dependent0
临时行内文件
Â«
target1: dependent1
临时行内文件，但保留
Â«KEEP
target2: dependent2
专有行内文件，但用完后删除
Â«NOKEEP
target3: dependent3
专有行内文件
Â«KEEP
</syntaxhighlight>