HOWTO · C++
C++ で複数行の文字列を宣言
この記事では、C++ で複数行の文字列を宣言する方法を示します。
このページの内容
長いテキストを扱うときや、ソース内の書式をそのまま保ちたいときには、複数行の文字列が重要になります。C++ には複数行文字列専用の型はありませんが、隣接する文字列リテラル、raw 文字列リテラル、バックスラッシュと改行による行連結(スプライシング)、プリプロセッサの文字列化という、いくつかの構築方法があります。これらの手法の主な違いは、ソース内の改行が値の中の改行になるかどうかです。
このガイドでは、実行可能な例を使って各手法を順に見ていき、最後に比較を示すので、自分のコードに適した手法を選べます。
隣接する文字列リテラルで複数行の文字列を構築する
コンパイラは、空白だけで区切られて並んだ 2 つ以上の二重引用符付き文字列リテラルを見つけると、コンパイル時にそれらを 1 つの値に連結します。リテラルをソースの複数行に分割するのは純粋に書式上の選択であり、自分で \n を書かない限り値に改行は追加されません。また、単語を区切るべき場所にはスペースを明示的に含める必要があります。
次の例を実行してみましょう。コード中の文字列と出力は、例をそのまま保つため英語のままです。
#include <iostream>
#include <string>
int main() {
std::string message =
"I love"
" getting my doubts solved"
" by the help of Delft Stack Tutorials.";
std::cout << message << std::endl;
return 0;
}
I love getting my doubts solved by the help of Delft Stack Tutorials.
隣接するリテラルの連結は、代入先が const char *(リテラルを指す読み取り専用のポインタ)であっても、std::string オブジェクトの場合と同じように機能します。次の例でも、コード中の文字列と出力は英語のままです。
#include <cstdio>
int main() {
const char *lines =
"Line 1 "
"Line 2 "
"Line 3";
std::printf("%s\n", lines);
return 0;
}
Line 1 Line 2 Line 3
テキストを変更したり、文字列を扱う API に渡したりする場合は std::string を選びます。表示や確認だけを行う静的なテキストには const char * が適しています。
raw 文字列リテラルで改行を保持する
C++11 で追加された raw 文字列リテラルを使うと、物理的な改行をリテラル自体の中に含められます。R"( と )" の間にあるものは、改行、インデント、引用符、バックスラッシュを含め、すべてそのまま値の一部になるため、エスケープシーケンスは不要です。次の例でも、コード中の文字列と出力は英語のままです。
#include <iostream>
#include <string>
int main() {
std::string page = R"(I love
getting my doubts solved
by the help of Delft Stack Tutorials.)";
std::cout << page << std::endl;
return 0;
}
I love
getting my doubts solved
by the help of Delft Stack Tutorials.
内容はそのままコピーされるため、2 つの点に注意してください。開始の R"( の直後に入力した改行は値に格納され、継続行の前にあるインデントも保持されます。テキストに )" という並びが含まれる可能性がある場合は、R"tag(...)tag" のようなカスタムデリミタを選びます。終了マーカーにタグが必須になるため、テキスト中の単なる )" は無害なままです。
バックスラッシュと改行の連結で文字列リテラルを継続する
ソース行の末尾の文字として置いたバックスラッシュは、コンパイル前にその行を次の行へ連結(スプライス)します。文字列リテラルの内部では、これによりリテラルをソースの複数行にまたがらせられますが、連結された改行は取り除かれるため、値の中に改行は生成されません。これが、値に改行を追加する \n エスケープとの重要な違いです。次の例でも、コード中の文字列と出力は英語のままです。
#include <cstdio>
int main() {
const char *text =
"First line\n"
"Second line\n\
Third line\n";
std::printf("%s", text);
return 0;
}
First line
Second line
Third line
出力には両方の仕組みが表れています。各 \n は改行を書き込み、バックスラッシュによる連結はソース行を結合するだけです。また、継続行の先頭にあるスペースは値の中の実際の文字になります。この空白への敏感さが主な落とし穴です。読みやすさのために入力したインデントが文字列に残り、バックスラッシュの後にスペースであっても何らかの文字があると連結が成立しません。連結は、周囲のレイアウトを完全に制御できる場所でのみ使ってください。
マクロの文字列化の制限を理解する
可変長引数マクロは、#define MULTILINE_STRING(...) #__VA_ARGS__ のように文字列化演算子を使って、引数を文字列リテラルに変換できます。複数行にまたがるテキストを渡すと 1 つの引用符付きリテラルが得られますが、プリプロセッサは改行を含む連続した空白をすべて 1 つのスペースに正規化します。次の例でも、コード中の文字列と出力は英語のままです。
#include <iostream>
#include <string>
#define MULTILINE_STRING(...) #__VA_ARGS__
int main() {
std::string message = MULTILINE_STRING(
I love getting my doubts solved by the help of Delft Stack Tutorials.);
std::cout << message << std::endl;
return 0;
}
I love getting my doubts solved by the help of Delft Stack Tutorials.
このため、マクロの文字列化は汎用の複数行文字列ツールではなく、用途が限られた選択肢です。改行を保持できず、引数のテキストは文字列コンテンツとしてではなくトークンとして処理されるため、紛れ込んだ句読点が予期しない結果を生むことがあります。また、マクロベースのコードは読みにくく、デバッグも困難です。プリプロセッサ主導のコードが本当にトークンをテキストへ変換する必要がある場合にだけ使いましょう。
適切な複数行文字列の手法を選ぶ
- raw 文字列リテラルは、改行、インデント、
\や"などの文字をそのまま値に残したい場合の既定の選択肢です。埋め込みテキストブロック、JSON、SQL、正規表現に最適です。 - 隣接する文字列リテラルは、ソース行を短く保ちながら値を正確に制御できます。すべてのスペースと
\nが明示的なので、意図しないものが混入しません。 - バックスラッシュと改行の連結は壊れやすく、インデントの影響を受けます。主にレガシーコードや、定義を複数行に継続するために今も必要とされるマクロ定義の中に残っています。
- マクロの文字列化は、トークンからテキストへの変換が本当に必要なプリプロセッサ中心のコードにのみ適しています。
値が実際に複数行にわたる場合は raw 文字列リテラルを使います。ソース上で複数行に整形したい長い単一行の値には、隣接するリテラルが最も分かりやすく、std::string と const char * のどちらとも自然に組み合わせられます。