ここに文書

コンピューティングにおいて、ヒアドキュメント( here-document、here-text、heredoc、hereis、here-stringまたはhere-script ) は、ファイルリテラルまたは入力ストリームリテラルです。これは、別のファイルであるかのように扱われるソースコードファイルのセクションです。この用語は、同様の構文を使用し、テキスト内の改行やその他の空白 (インデントを含む) を保持する、複数行の文字列リテラルの形式にも使用されます。

ヒアドキュメントはUnixシェル^[1]に由来し、 1979年以降のBourneシェル、およびその後のほとんどのシェルに見られます。ヒアドキュメントスタイルの文字列リテラルは、さまざまな高級言語、特にPerlプログラミング言語（Unixシェルに触発された構文）や、 PHPやRubyなどPerlの影響を受けた言語に見られます。JavaScriptも、第6リビジョン（ES6 ）で追加された機能であるテンプレートリテラルを介してこの機能をサポートしています。Python 、Julia、Tclなどの他の高級言語には、複数行の文字列のための他の機能があります。

ここでのドキュメントは、ファイルまたは文字列として扱うことができます。一部のシェルは、それらをフォーマット文字列リテラルとして扱い、リテラル内で 変数の置換とコマンドの置換を許可します。

ヒアドキュメントの最も一般的な構文は Unix シェルに由来し、区切り識別子(多くの場合は単語または^[2]<< )が続き、次の行から引用するテキストが続き、同じ区切り識別子で独自の行に閉じられます。この構文は、ヒアドキュメントが形式的にはストリームリテラルであり、ヒアドキュメントの内容が先行するコマンドまたは現在のシェルスクリプト/実行可能ファイルのstdin (標準入力) にリダイレクトされることが多いためです。 EOFEND

ヒアドキュメント構文は、入力リダイレクトのシェル構文に似ており、その後<に入力として使用されるファイルの名前が続きます。

他の言語でも、実質的に同様の構文が使用されることがよくありますが、構文の詳細と実際の機能は大幅に異なる場合があります。単に文字列リテラルに使用される場合、 は<<間接指定を示すのではなく、単に開始区切り記号の規則を示します。Ruby などの一部の言語では、<<は入力リダイレクトにも使用されるため、<<ヒアドキュメントの文字列リテラルからリダイレクトする場合は が 2 回使用されることになります。

狭義に言えば、ヒアドキュメントはファイルリテラルまたはストリームリテラルです。これらは Unix シェルに由来しますが、他の言語でも同様の機能が利用できます。

ヒアドキュメントは多くの Unix シェルで利用可能です。^[1]次の例では、trヒアドキュメントを使用してテキストがコマンドに渡されます (小文字を大文字に変換)。これはシェルファイル内にある場合もあれば、プロンプトで対話的に入力される場合もあります。

$ LANG = C tr a-z A-Z << END > 一 二 三> 四 五 六> END
一二三     


  
4  5  6

この場合、END区切り識別子として使用されます。これは、ヒア ドキュメントの開始と終了を指定します。リダイレクトと区切り識別子は、スペースで区切る必要はなく、<<ENDどちら<< ENDも同じように機能します。

デフォルトでは、動作は二重引用符の内容とほぼ同じです。変数名はその値に置き換えられ、バックティック内のコマンドは評価されます。^[a]

$  cat << EOF > \$ 作業ディレクトリ "$PWD" `pwd` > EOF 
$作業ディレクトリ"/home/user" /home/user
 

    

これは、ラベルの任意の部分を引用符で囲み、引用符で囲まれていない値で終了させることで無効にできます。 ^[b]動作は、内容が一重引用符で囲まれている場合と基本的に同じです。たとえば、一重引用符で設定すると次のようになります。

$ cat  << 'EOF' > \$ 作業ディレクトリ "$PWD" `pwd` > EOF \$ 作業ディレクトリ "$PWD" `pwd` 

二重引用符も使用できますが、これは混乱を招く可能性があります。なぜなら、二重引用符で囲まれた文字列では展開が発生しますが、二重引用符で囲まれた区切り文字を含むヒアドキュメントでは展開が発生しないからです。 ^[4]一重引用符と二重引用符の区切り文字は、他の言語、特にPerl（下記参照）では区別されており、その動作は対応する文字列の引用と似ています。

POSIXシェルでは、csh/tcshとは異なり、マイナス記号を追加すると<<（つまり<<-）、先頭のタブが無視されます。^[5]これにより、シェルスクリプト内のヒアドキュメントをインデントすることができます（主に既存のインデントと揃えるため）。値を変更せずにインデントできます。^[c]

次の内容を含むスクリプト:

LANG = C  tr  a-z  A-Z <<- END_TEXTここで、<<- のドキュメントがあります。この行の先頭には 1 つのスペース文字 (つまり 0x20) が	あります。この行は、次の行と同様に 1 つのタブ文字 (つまり 0x09) で始まります	。END_TEXT 





echo 意図 された 終了はこの行echoの前に あり、これらはtr
 echoによって処理されませんでした+++++++++++++++    
        

LANG = C  tr  a-z  A-Z << END_TEXTここで、<< 1 つのスペース文字 (つまり 0x20) がこの行の先頭にあります。	この行は、次の行と同様に 1 つのタブ文字 (つまり 0x09) で始まります	。END_TEXT 





echo 意図 した 終了はこの行の前に ありましたが、区切り識別子を持つ行がタブで始まっていたため認識されず、
 echo trコマンドは処理を続行しました。
    
                      

生成:

HERE DOC WITH <<-
単一のスペース文字 (IE 0X20 ) がこの行の先頭にあります
この行は、次の行と同様に単一のタブ文字 (IE 0X09) で始まっています
意図された終了はこの行の前でした
が、tr によって処理されませんでした
+++++++++++++++ 
HERE DOC WITH <<
単一のスペース文字 (IE 0X20 ) がこの行の先頭にあります
	この行は、次の行と同様に単一のタブ文字 (IE 0X09) で始まっています
	END_TEXT

ECHO 意図された終了はこの行の前にありました
が、ECHO 区切り識別子のある行がタブで始まっていたため認識されず、
ECHO TR コマンドは処理を続行しました。

もう 1 つの用途は、ファイルに出力することです。

$ cat  <<  EOF  >  ~/testFile001
 > このテキストの前には 3 つのスペースがあります。
> この行の先頭には 1 つのタブ文字があります。 > このテキストの前には何も
EOF がありません

here 文字列( bash、ksh、またはzshで使用可能) は構文的に似ており、 、 で構成され、ワード<<<(シェルによって単位として扱われるシーケンス、このコンテキストでは通常文字列リテラル)からの入力リダイレクトに影響します。この場合、通常のシェル構文がワードに使用され (「here 文字列構文」)、構文はリダイレクトのみです。here 文字列は入力リダイレクトに使用される通常の文字列であり、特別な種類の文字列ではありません。

1つの単語を引用する必要はありません。

$ LANG = C  tr  a-z  A-Z <<< 1
 ONE  

スペースを含む文字列の場合は引用符で囲む必要があります。

$ LANG = C  tr  a-z  A-Z <<< '一、二、三' ONE TWO THREE  

これは次のように書くこともできます:

$ foo = 'one two three' 
$ LANG = C  tr  a-z  A-Z <<< " $foo " ONE TWO THREE  

複数行の文字列が許容され、次のようになります。

$ LANG = C  tr  a-z  A-Z <<< ' 1
 > 2 3' 1 2 3  

先頭と末尾の改行がある場合は、それが含まれることに注意してください。

$ LANG = C  tr  a-z  A-Z <<< ' > 1 > 2 3 > '  




1 
2 3

$

ヒアドキュメントとの主な違いは、ヒアドキュメントでは区切り文字が別の行にあり、先頭と末尾の改行が削除されることです。ヒアドキュメントとは異なり、ヒア文字列では区切り文字は使用されません。

ここで、文字列は、計算機などの短い入力を頻繁に行うコマンドに特に役立ちますbc。

$ bc <<< 2 ^10
 1024  

echoここで、文字列の動作は、次のように パイプとコマンドを使用して (順序を逆にして) 実現することもできることに注意してください。

$ echo 'one two three' | LANG = C tr a-z A-Z
 ONE TWO THREE      

ただし、ここでの文字列は、組み込みの場合のように、最後のコマンドを現在のプロセスで実行する必要がある場合に特に便利ですread。

$ echo '1,2,3' | read -r a b c
 $ echo " $a $b $c "          

何も得られない一方で

$ read  -r  a  b  c <<< '一、二、三' $ echo " $a $b $c "一、二、三  
   

これは、前の例ではパイプによってreadサブプロセスで実行され、親プロセスの環境に影響を与えることができないために発生します。

Microsoft NMAKEでは、ヒア ドキュメントはインライン ファイルと呼ばれます。インライン ファイルは<<または として参照されます<<pathname。最初の表記は一時ファイルを作成し、2 番目の表記は指定されたパス名でファイルを作成 (または上書き) します。インライン ファイルは<<1 行で終了し、オプションで (大文字と小文字を区別しない) キーワードKEEPまたは が続き、NOKEEP作成されたファイルを保持するかどうかを示します。

target0 :依存0
 command0 <<
一時インラインファイル... <<        



target1 :依存1
コマンド 1 <<
一時的だが保存されたインラインファイル... <<KEEP target2 :依存2
コマンド 2 <<filename2
名前付きだが破棄されたインラインファイル... <<NOKEEP target3 :依存3
コマンド 3 <<filename3
名前付きインラインファイル... <<KEEP          



          



        

R にはファイル リテラルはありませんが、文字列リテラルと文字列からファイルへの関数を組み合わせることで同等の機能を提供します。R では、文字列に改行を含む任意の空白を使用できます。その後、関数を使用して文字列をファイル記述子textConnection()に変換できます。たとえば、次のコードは、ソース コードに埋め込まれたデータ テーブルをデータ フレーム変数に変換します。

str <- "州 人口 収入 非識字率 生涯経験 殺人率 高校卒業率 フロストアラバマ 3615 3624 2.1 69.05 15.1 41.3 20アラスカ 365 6315 1.5 69.31 11.3 66.7 152アリゾナ 2212 4530 1.8 70.55 7.8 58.1 15アーカンソー 2110 3378 1.9 70.66 10.1 39.9 65" x <- read.table ( textConnection ( str ), header = TRUE , row.names = 1 ) 





    

Perl ^[6]と Ruby ^[7]にはファイルリテラルの形式があり、これはデータセグメントの形式と見なすことができます。これらの言語では、行__DATA__(Perl) または(Ruby、古い Perl) を含めることで、コードセグメント__END__の終了とデータセグメントの開始が示されます。この行より前のコンテンツのみが実行され、この行より後のソースファイルの内容は、Perl (例) とRuby のファイルオブジェクトとして使用できます。インラインファイルであるため、これらは意味的にはヒアドキュメントに似ていますが、スクリプトごとに 1 つしか存在できません。ただし、これらの言語では、「ヒアドキュメント」という用語は、以下で説明するように、複数行の文字列リテラルを指します。 PACKAGE::DATAmain::DATADATA

Data URI スキームでさらに説明されているように、すべての主要な Web ブラウザーは、here document にあるように 、data:で始まる URI を理解します。

「ヒアドキュメント」または「ヒア文字列」という用語は、さまざまなプログラミング言語、特に Perl (Unix シェルの影響を受けた構文) や、Perl の影響を受けた言語 (特に PHP と Ruby) の複数行の文字列リテラルにも使用されます。シェル スタイルの<<構文は、入力リダイレクトには使用されないにもかかわらず、多くの場合保持されます。

Perl では、ヒアドキュメントを呼び出す方法がいくつかあります。^[8]タグを囲む区切り文字は、ヒアドキュメント内でも通常の文字列リテラルと同じ効果があります。たとえば、タグを二重引用符で囲むと変数を挿入できますが、一重引用符では挿入できません。また、タグを二重引用符なしで使用した場合、二重引用符のように動作します。タグを囲む区切り文字としてバックティックを使用すると、ヒアドキュメントのコンテンツがシェルスクリプトとして実行されます。終了タグが行の先頭にあることを確認する必要があります。そうしないと、インタープリターによってタグが認識されません。

ヒアドキュメントはタグから始まるのではなく、次の行から始まることに注意してください。そのため、タグを含むステートメントはタグの後に続きます。

二重引用符を使用した例を次に示します。

私の$sender = "バフィー 〜恋する十字架〜" ;私の$recipient = "スパイク" ;   
   

<<" END "を印刷します。 

親愛なる$recipient様、

あなたにはサニーデールを去って二度と戻って来ないでほしい。

愛ではないよ、
$sender

終わり

出力：

スパイク様

あなたにはサニーデールを去って二度と戻って来ないでほしい。

愛じゃない、
バフィー 〜恋する十字架〜

以下は一重引用符を使用した例です。

印刷<<' END '; $recipient 様、 


あなたにはサニーデールを去って二度と戻って来ないでほしい。

愛ではない、
$sender 
END

出力：

親愛なる$recipient様、

あなたにはサニーデールを去って二度と戻って来ないでほしい。

愛ではないよ、
$sender

バックティックを使用した例（移植性がない可能性があります）:

私の$shell_script_stdout = << `END` ; echo foo echo bar END   
 
 

同じ行で複数のヒアドキュメントを開始することも可能です。

say ( << BEGIN . "これが真ん中です\n" . << END );これが始まりです: BEGINそして、これで終わりです! END    
   

    


# これは次の文と同等です: 
say ( "ここが始まりです:\nここが真ん中です\nそしてこれで終わりです!\n" );

タグ自体に空白が含まれる場合があり、これにより、インデントを壊さずにヒアドキュメントを使用できる場合があります。

  << 'END' ; Hello World ENDと言う 
 
  

Perlバージョン5.26以降では、^[9]ヒアドキュメントにインデントを含めることができるようになりました。

        #先頭の空白なしで「Hello there\n」を出力します。
if ( 1 ) { print <<~ EOF ; Hello there EOF }          
           
             
            
        

これらの文字列に加えて、Perl にはファイル リテラル、つまり__DATA__（以前は__END__）に続くファイルの内容が 1 行だけ続く機能もあります。これはPACKAGE::DATAなどのファイル オブジェクトとしてアクセスでき、データ セグメントmain::DATAの形式として表示できます。

PHP では、ヒアドキュメントはヒアドキュメントと呼ばれます。PHP では、ヒアドキュメントは文字列リテラルではありません。ヒアドキュメントのテキストは、二重引用符のない二重引用符で囲まれた文字列と同じように動作します。たとえば、`$` は変数の開始として解析され、`${` または `{$` は複雑な変数の開始として解析されます。

<?php
 
$name        =  "Joe Smith" ; 
$occupation  =  "Programmer" ; 
echo  <<< EOF

	これはヒアドキュメント セクションです。
	詳細については、地元の $occupation である $name にお問い合わせください。

	ありがとう！

EOF ;

$toprint  =  <<< EOF

	やあ、$name! 実際にヒアドキュメントセクションを変数に割り当てることができます!

EOF ; 
$toprint をエコーし​​ます ;

?>

出力

これは heredoc セクションです。
詳細については、ローカル プログラマーの Joe Smith にお問い合わせください。

ありがとう！

やあ、ジョー・スミス！ヒアドキュメントセクションを変数に割り当てることができるんだ！

PHP 7.3 より前のバージョンでは、終了識別子を含む行には、オプションの終了セミコロン以外の文字を含めることはできません。それ以外の場合、終了識別子とは見なされず、PHP は終了識別子を探し続けます。適切な終了識別子が見つからない場合、スクリプトの最終行で解析エラーが発生します。ただし、バージョン 7.3 以降では、終了識別子の後にセミコロンまたは改行が続く必要はなくなりました。また、終了識別子はインデントできますが、その場合、ドキュメント文字列のすべての行からインデントが削除されます。^[10]

PHP 5.3以降では、Perlと同様に、タグをシングルクォートで囲むことで変数を挿入しないようにすることができます。これはnowdocと呼ばれます。^[11]

$x  =  <<<' END '
親愛なる$recipient様、

あなたにはサニーデールを去って二度と戻って来ないでほしい。

まったく愛じゃない、
$sender 
END ;

PHP 5.3 以降では、タグを二重引用符で囲むことも可能です。これは、Perl と同様に、タグを何も囲まないのと同じ効果があります。

次の Ruby コードは、ヒアドキュメントを使用して食料品リストを表示します。

puts << GROCERY_LIST食料品リスト---- 1. サラダミックス。2. イチゴ。* 3. シリアル。4. 牛乳。* * オーガニックGROCERY_LIST 






 

結果：

$ ruby ​​ gross-list.rb
食料品リスト
------------ 
1. サラダミックス。
2. イチゴ。* 
3. シリアル。
4. 牛乳。* 
* オーガニック 

ヒアドキュメント内のは<<入力リダイレクトを示しませんが、Ruby は<<入力リダイレクトにも を使用するため、ヒアドキュメントからファイルにリダイレクトするには<<、異なる意味で を 2 回使用する必要があります。

ファイル:: open ( "grocery-list" , "w" ) do | f | f << << GROCERY_LIST食料品リスト---- 1. サラダミックス。2. イチゴ。* 3. シリアル。4. 牛乳。* * オーガニックGROCERY_LIST end   
    






 

Unix シェルと同様に、Ruby でも、ヒアドキュメントの開始がわずかに異なる starter でマークされている場合、区切り識別子が行の最初の列から始まらないようにすることができます<<-。また、Ruby はヒアドキュメントを二重引用符で囲まれた文字列として扱うため、 構造を使用してコードを挿入することができます#{}。次の例は、これらの両方の機能を示しています。

now = Time . now puts <<- EOF今  は #{now.hour} 時です。ジョン、あなたの子供はどこにいますか?   EOF  
 

Ruby では、ヒアドキュメントのインデントを省略するための「<<~」構文を提供することでこれを拡張しています。

puts <<~ EOF  この行はスペース 2 つ分インデントされています。    この行はスペース 4 つ分インデントされています。      この行はスペース 6 つ分インデントされています。  EOF 

すべての行で、2 つのスペースによる共通のインデントが省略されます。

$ ruby ​​ indented-heredoc.rb
この行は 2 スペース分インデントされています。
  この行は 4 スペース分インデントされています。
    この行は 6 スペース分インデントされています。

Perl と同様に、Ruby では 1 行で複数の here ドキュメントを開始できます。

puts << BEGIN + "<--- 中間 ---> \n " + << ENDこれが始まりです: BEGINこれで終わりです! END     





# これは次の式に相当します: 
puts "これが始まりです: \n <--- 中間 ---> \nそして今終わりです!" 

Perl と同様に、Ruby にはファイル リテラル、つまりファイルの内容が__END__1 行に 1 つだけ続く機能があります。これはファイル オブジェクトとしてアクセス可能で、データ セグメントDATAの形式として表示できます。

Python は、複数行の文字列を「逐語的」な文字列としてサポートします。複数行の文字列は、3 つの一重引用符 (') または二重引用符 (") で囲むことができます。後者の例を以下に示します。

print ( """
客: たいしたチーズ屋じゃないですね。
店主: この地区で一番美味しいですよ、ご主人様。
""" )

Python 3.6 以降では、逐語的 f 文字列は変数と式の補間をサポートします。

shop_type  =  "CHEESE" 
accolade  =  "finest" 
print ( f """
お客様: あまり{ shop_type . lower () }なお店ではないですね。
店主:この地域では{ accolade . capitalize () }なお店ですよ、ご主人様。
""" )

テキストブロックはJava 15 以降、JEP 378でサポートされています: ^{[12] [13]}

文字列html = """     <html>         <body>             <p>Hello, world</p>         </body>     </html> """ ;   

C++11以降、C++ はカスタム区切り文字 (この例では "my_delimiter") を使用した文字列リテラルをサポートしています。

#include <ostream> 

const char * str = R " my_delimiter(文字列の開始。改行スラッシュ \ 引用符 " ' 括弧 ) ( 文字列の終了)my_delimiter " ; std :: cout << str << std :: endl ;    

    

印刷されます

文字列の開始。改行
スラッシュ\引用符"'括弧)(文字列の終わり

バージョン 2.0 以降、D は'q' プレフィックス文字を使用したヒア ドキュメント スタイルの文字列をサポートしています。これらの文字列は で始まり、q"IDENTその直後に改行文字 (任意の識別子 IDENT 用) が続き、IDENT"行の先頭で で終わります。

int main () { string list = q "IDENT 1. 項目 1 2. 項目 2 3. 項目 3 IDENT" ; writef ( list ); }  
       




      

D は、同様の構文を持ついくつかの引用符区切り文字もサポートしており、そのような文字列は で始まり でq"[終わるか]"、または他の区切り文字 (() <> {} または [] のいずれか) についても同様です。

以前のMVSおよび現在のz/OSオペレーティング システム で使用されているIBM のジョブ制御言語(JCL)では、ジョブ ストリームにインラインのデータは、 または のように、DD ステートメントの * によって識別できます 。最初のケースでは、テキスト行が続き、DD 名 SYSIN の疑似ファイルに結合されます。コマンドに続くすべてのレコードは、別の OS/JCL コマンドが発生するか (で始まる任意の行)、デフォルトのEOFシーケンス ( ) が見つかるか、または物理的なデータ終了が発生するまで結合されます。2 番目のケースでは、条件は同じですが、 DLM= オペランドを使用してデータの終了を示すテキスト文字列を指定します。これは、データ ストリームに JCL (これも、で始まる任意の行)、またはシーケンス (C または C++ ソース コードのコメントなど) が含まれる場合に使用できます。次のコードは、アセンブラーにインライン データとして提供されるアセンブリ言語プログラムをコンパイルして実行します。 //SYSIN DD *//SYSIN DD *,DLM=text///*///*

// AHAR JOB ( 'ALEX HARRIS' ) // EXEC ASMLG // SYSIN DD * APROG START         XR 15,15         BR 14         END /* //* ジョブ終了  
      

この文は 、 のデータ ストリームが続き、 で終了することを示すと機能的に同等です 。 //SYSIN DD *<</*/*

Racketのhere 文字列は で始まり、#<<その後に文字列の終端子を定義する文字が続きます。^[14] 文字列の内容には、#<<行と、指定された終端子のみを含む行の間にあるすべての文字が含まれます。より正確には、文字列の内容は の後の改行の後に始まり#<<、 の後の改行の前に終わります。

#ラングラケット

( displayln 
#<<HERESTRINGこれは Racket の単純な here 文字列です。  * 1   * 2   * 3 HERESTRING ) 





 

出力:

これは Racket の単純な文字列です。
  * 1 
  * 2 
  * 3

開始行と終了行の間にはエスケープ シーケンスは認識されません。すべての文字が文字列 (および終了文字) にそのまま含まれます。

#ラングラケット

( displayln 
#<<Racket のここの文字列☺この文字列は複数行にまたがり、任意の Unicode 記号を含めることができます。したがって、λ、☠、α、β などはすべて問題ありません。 




次の行にはターミネータが来ます。スペースやスマイリーも含め、任意の Unicode シンボルを含めることができます。Racket
の here 文字列です ☺ 
) 

出力:

この文字列は複数行にまたがり
、任意の Unicode 記号を含めることができます。
したがって、λ、☠、α、β などはすべて問題ありません。

次の行にはターミネータが来ます。スペースやスマイリーも含め、任意の Unicode シンボルを含めることができます。

ここでは、通常の文字列が使用されるコンテキストで文字列を通常どおり使用できます。

#ラングラケット

( printf #<<END親愛なる~a様、 


洞察力のある会話をありがとう〜a。

                ~あ

END 
「アイザック」「昨日」「カール」）        
        
        

出力:

親愛なるアイザックへ

昨日は有意義な会話をありがとうございました。

                カール

興味深い代替案としては、言語拡張を使用してat-exp@式を記述することです。^[15] 次のようになります。

#lang at-exp racket

(displayln @string-append{
これは長い文字列です。
非常に便利です
長いテキストは
必要です。

逃げる心配はありません
「引用符」または\エスケープ。
λ、γ、θ、… でも構いません。

埋め込みコード:@(number->string (+ 3 4))
})

出力:

これは長い文字列であり、
長いテキストの塊が必要な場合に非常に便利です
。



「引用符」や \escapes の
エスケープについて心配する必要はありません。λ 、γ、θ などを使用しても問題ありません。

埋め込みコード: 7

@ 式は文字列に固有のものでも制限されるものでもなく、言語の残りの部分と組み合わせることができる構文形式です。

PowerShellでは、ヒア ドキュメントはヒア文字列と呼ばれます。ヒア文字列は、開き区切り文字 (@"または@') で始まり、閉じ区切り文字 ("@または'@) で終わる文字列で、それ自体の行で文字列を終了します。開き区切り文字と閉じ区切り文字の間にあるすべての文字は、文字列リテラルとみなされます。ヒア文字列を二重引用符で囲むと変数を解釈できますが、一重引用符では解釈できません。 変数の補間は、単純な変数 (例: $xbut NOT$x.yまたは$x[0]) で発生します。ステートメントのセットを$()(例:$($x.y)または$(Get-Process | Out-String)) に入れることで実行できます。

次の PowerShell コードでは、here-string を使用してテキストが関数に渡されます。関数はConvertTo-UpperCase次のように定義されています。

PS > function  ConvertTo-UpperCase ( $string )  {  $string . ToUpper ()  } 
PS > ConvertTo-UpperCase @ ' >> one two three >> eins zwei drei >> '@ ONE TWO THREE EINS ZWEI DREI 
 

以下は、二重引用符付きの here-string を使用して変数の補間とステートメントの実行を示す例です。

PS > $doc 、 $marty  =  'Dr. Emmett Brown' 、 'Marty McFly' 
PS > $time  =  [DateTime] 'Friday, October 25, 1985 8:00:00 AM' 
PS > $diff  =  New-TimeSpan  -Minutes  25 
PS > @" 
>> $doc : 聞こえているのは私の時計ですか? 
>> $marty : うん! えっと、$($time.Hour) 時だよ! 
>> $doc : 完璧! 実験は成功した! すべて正確に $($diff.Minutes) 分遅れている。
>> $marty : ちょっと待って。ちょっと待って。先生... $(($time + $diff).ToShortTimeString()) だって? 
>> $doc : その通り。
>> $marty : やばい! 学校に遅刻しちゃった! 
>> "@ 
Dr. Emmett Brown : 聞こえているのは私の時計ですか?
マーティ・マクフライ: ああ！えーと、8時だよ！
エメット・ブラウン博士: 完璧！実験は成功した！すべてちょうど25分遅れている。
マーティ・マクフライ: ちょっと待って。ちょっと待って。先生… 8時25分だって言ってるの？
エメット・ブラウン博士: その通り。
マーティ・マクフライ: やばい！学校に遅刻しちゃった！

代わりに一重引用符付きの here-string を使用すると、出力は次のようになります。

PS > @ ' 
>> $doc : 聞こえているのは私の時計ですか? 
>> $marty : うん! えーと、$($time.Hour) 時だよ! 
>> $doc : 完璧! 実験はうまくいった! 全部、きっちり $($diff.Minutes) 分遅れているよ。
>> $marty : ちょっと待って。ちょっと待って。先生... $(($time + $diff).ToShortTimeString()) だって? 
>> $doc : その通り。
>> $marty : しまった! 学校に遅刻しちゃった! 
>> '@ 
$doc : 聞こえているのは私の時計ですか? 
$marty : うん! えーと、$($time.Hour) 時だよ! 
$doc : 完璧! 実験はうまくいった! 全部、きっちり $($diff.Minutes) 分遅れているよ。
$marty : ちょっと待って。ちょっと待って。ドク... $(($time + $diff).ToShortTimeString()) だと言ってるんですか? 
$doc : その通り。
$marty : やばい! 学校に遅刻しちゃった!

DCL スクリプトでは、$ 記号で始まらない入力行は暗黙的に前のコマンドへの入力として扱われます。つまり、$ で始まらないすべての行は here ドキュメントです。入力はプログラムに渡されるか、論理名 SYS$INPUT (Unix のstdinの概念に類似) によって明示的に参照されます。

たとえば、入力を SYS$INPUT として明示的に参照します。

$ TYPE  SYS $INPUTこのテキストは
、TYPE コマンドによって画面に直接表示されます。 
$ !その他のコマンド...

   

生成:

このテキストは、TYPE コマンドによって画面に直接表示されます。

さらに、当初はパンチカードのサポートを目的としていたDECKコマンド（データデッキの始まりを意味するため、その名前が付けられている）は、先行するコマンドへの入力を供給するために使用できます。^[16]入力デッキは、コマンド$ EOD、またはDECKの/DOLLARSパラメータで指定された文字パターンによって終了します。

金銭的価値を合計するプログラムの例:

$ ADD_SUMS.EXE を実行
$ デッキ
13.53ドル
3.33ドル
2.33ドル
$ 終了時間

次の出力が生成されます (ADD_SUMS が値を読み取って追加するように記述されていると仮定します)。

19.19ドル

DECK /DOLLARS を使用して、あるコマンド ファイルから別のコマンド ファイルを作成する例:

$ COPY  SYS $INPUT  SYS $SCRATCH :TEMP.COM
 $ DECK  /DOLLARS = $$$$ 
$ TYPE  SYS $INPUTこれは、
コマンド ファイル内からコマンド ファイルを作成するために DECK を使用する例です。 
$ $$ $
 $ !その他のコマンドは続きます...

    

YAML は主に空白のインデントによって構造化されており、区切り文字の衝突に耐性があり、折り畳まれた文字列リテラルを使用して複数行の文字列を表すことができます。

---
キャプション: " YAMLを使用したヒアドキュメント形式の機能の例"日付: "2007-06-01"例: > HTML は変更されずに YAML に入りますメッセージ: |      
    
 
        
 

        <blockquote style="font: italic 12pt Times"> 
<p>「3 は常に 2 より大きい。2が大きな値であっても」</p> <p>--著者不明</p> </blockquote>        
           
        
        

• CDATA
• パイプライン (Unix)

• ヒアドキュメント。15を超える言語でのヒアドキュメントの例を含むRosetta コードタスクへのリンク。