引数の引用符付け(組み立て関数)

引数の配列から、受け取り側の分割規則で元どおりに割れる1本のコマンドライン文字列を組み立てる処理。空白か引用符を含むか空の引数を引用符で囲み(空の引数は引用符2つだけになる)、引用符の直前のバックスラッシュを2倍+1、末尾のバックスラッシュを2倍にし、引用符にはバックスラッシュを前置する。往復が保証されるのは受け取り側がCommandLineToArgvW・Cランタイム・.NETランタイムと同じ分割規則でワイド文字のまま分割し(独自の文法で生のコマンドラインを解釈する相手や、途中にシェルのパーサが挟まる場合は対象外)、かつsetargv.obj/wsetargv.objによるワイルドカード展開を有効にしていない場合で(展開が有効だと*や?を含む引数がファイル名に置き換わる)、組み立てた文字列全体がCreateProcessのlpCommandLineの上限(終端のnull文字を含めて32,767 UTF-16コード単位)に収まることも前提になる。コマンドラインがnull終端文字列であるためNUL文字を含む引数は渡せず、狭い文字列のmainではコードページで表せない文字が失われる。

概念URI: https://comcomponent.com/knowledge/argument-quoting-function/
別名・表記: ArgvQuote / コマンドラインの組み立て
最終確認日: 2026-08-01
機械可読データ: JSON-LD

この概念が関わる関係

引数の引用符付け(組み立て関数)は末尾バックスラッシュによる引数の巻き込みを防ぎます。組み立て関数は引用符で囲む引数の末尾のバックスラッシュを2倍にして偶数個にするため、閉じ引用符が正しく囲みを終了させ、後続の引数を巻き込まない。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
引数の引用符付け(組み立て関数)は囲みの内側の引用符2連続(非空の引数)を防ぎます。組み立て関数は引数中の引用符に必ずバックスラッシュを前置するため、中身のある引数の内側で引用符が隣接する形を生成しない。この形は2008年より前と後のVCで解釈が異なるため、.NETの組み立てコードも意図的に避けている。空の引数を表す引用符2つだけの形はこれとは別で、正しく生成される。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
ProcessStartInfo.ArgumentListは引数の引用符付け(組み立て関数)の実装を担います。ProcessStartInfo.ArgumentListは追加された要素ごとに引用符付けとエスケープを行い、内部で1本の文字列に組み立ててからOSに渡す。その規則は空白も引用符も含まない引数はそのまま、それ以外は引用符で囲み、引用符の直前のバックスラッシュを2倍+1、末尾を2倍にするというもの。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典出典
ProcessStartInfo.Arguments(手組み文字列)は引数の引用符付け(組み立て関数)を前提とします。UseShellExecute=falseで実行ファイルを直接起動し、受け取り側が公開された分割規則で解釈する場合、ProcessStartInfo.Argumentsは自分で組み立てた1本の文字列をそのまま渡すため、呼び出し側が分割規則に沿った引用符付けを行う必要がある(ArgumentListのない.NET Frameworkでは同じ規則の関数で組み立てる)。UseShellExecute=trueで文書やURLを開く場合はシェルの関連付けがハンドラのコマンドラインを組み立てるため、この関数だけでは足りない。 / 確度: 条件付きの関係 / 確認日: 2026-09-02 出典出典
引数の引用符付け(組み立て関数)は子プロセスへの引数の受け渡しに対する本記事の推奨です。C++や.NET Frameworkのように組み立てを自分で行い、実行ファイルを直接起動して、受け取り側がCommandLineToArgvW・Cランタイム・.NETランタイムの分割規則で解釈する場合に、引用符を手で書かず、分割規則の逆写像となる1つの関数で全引数を組み立てることを本記事は推奨している。cmd.exeやバッチファイルを経由する場合は別のパーサが挟まるため、この関数だけでは足りない。 / 確度: 条件付きの関係 / 確認日: 2026-09-02 出典出典

この概念を扱う記事

引数はなぜ壊れるか ── Windowsのコマンドライン引数の規則(主要トピック)

一次資料

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。