可変長引数（かへんちょうひきすう、英: variable length arguments、variadic arguments）とはプログラミング言語において、関数（サブルーチンやメソッドを含む）やマクロの引数が固定ではなく任意の個数となっている引数のことである。 可変引数、可変個引数とも呼ばれる。
可変長引数を持つ関数を可変長引数関数（英: variadic function）と言う。
いくつかの言語では型安全が保証されなくなるので注意が必要である。
手法
可変長引数を取る手続きあるいは関数やメソッドは、多くのコンピュータプログラミング言語でサポートされている。
- C言語 - を使う。仮引数に型の指定は特に行わない。
- C# - 配列型の仮引数の直前に
paramsキーワードを指定する。 - Java - 仮引数の型名と仮引数名の間に
...を記述する。実引数は配列に格納され、型には制限が付く。J2SE 5.0で追加された機能。(Javaの文法#可変引数)を参照。 - JavaScript - argumentsオブジェクトを利用する。
- Perl - サブルーチンに固定の仮引数を指定することはできない。どんなサブルーチンでも引数はリスト変数
@_を通して動的に受け取る以外に方法がない。 - Python - 仮引数名の前に
*あるいは**を付けてアクセスする。 - Common Lisp -
&restに続けてリストを受け取る仮引数名を指定する。 - Scheme -
.に続けてリストを受け取る仮引数名を指定する。
例
C言語
C言語においては printf、scanf といった標準ライブラリの関数が可変長引数をとる代表例である。可変長引数をとる関数のユーザー定義も可能である。信頼できない入力を扱う場合は書式文字列攻撃に注意する必要がある。可変長引数として渡す際に型情報が失われるため、型に関する情報を別途渡すなどする必要がある。
倍精度浮動小数点数の平均値を求める関数average_of_doublesの例を考える。
#include <assert.h> #include <stdarg.h> /* stdarg.h には、マクロ va_start、va_arg、va_end が定義されている。対応する va_start と va_end の呼び出しは、同じ関数内でなければならない。 */ double average_of_doubles(int count, ...) { va_list ap; double sum = 0; int i; assert(count > 0); va_start(ap, count); /* スタック変数のアドレスを参照するため、最後の引数が必要である。 */ for (i = 0; i < count; ++i) { /* スタックに積まれているはずの double 型の値を取り出し、ポインタ変数 ap が次の引数を指すように変更する。 */ sum += va_arg(ap, double); } va_end(ap); return sum / count; } 上記を呼び出すコード例は次の通りである。データの個数を最初の引数として与えている。
#include <stdio.h> int main(void) { double average1 = average_of_doubles(3, 1.0, 2.0, 3.0); double average2 = average_of_doubles(4, 1.5, 2.1, -3.0, 0.7); printf("%f\n", average1); printf("%f\n", average2); return 0; } 上記の例では、可変長引数にdouble型の値が渡されることを想定しているが、可変長引数に間違ってintなどの整数型の値を渡してもコンパイルは通ってしまい、未定義動作を引き起こす。この例では同じdouble型の1つ以上の値を渡すことができればよいので、可変長引数を使うのではなく、単純にdoubleの配列を使って型安全に実装すべきである。
double average_of_doubles(const double* values, int count) { double sum = 0; int i; assert(count > 0); for (i = 0; i < count; ++i) { sum += values[i]; } return sum / count; } Cプリプロセッサ・マクロ
C言語のプリプロセッサのマクロ定義において、可変長引数マクロ[1]には、以前はトリック的な方法[2]が使われていたが、C99で本物の可変長引数マクロが標準化された。__VA_ARGS__という識別子を使用する。
次のような関数の呼び出しに展開されるマクロを定義したいとする。関数が可変長引数をとるため、機能を制限したくなければ、マクロも可変長引数をとるようにしたい。
void realdbgprintf(const char *sourceFilename, int sourceLineNumber, const char *formatString, ...); C++での可変長引数マクロの設計に問題があるため[要説明]、以下に示すような定義は行えない。
#define dbgprintf(cformat, ...) realdbgprintf(__FILE__, __LINE__, cformat, __VA_ARGS__) この書き方だと、dbgprintf("Hello")と記述した際にrealdbgprintf(__FILE__, __LINE__, "Hello", )と展開される。関数の引数リストをコンマで終えると構文エラーを起こすため、printfのような使い勝手は得られない。
gccの独自構文では##__VA_ARGS__という識別子もサポートしている。これを利用することにより引数がゼロ個のものも定義できる。
#define dbgprintf(cformat, ...) realdbgprintf(__FILE__, __LINE__, cformat, ##__VA_ARGS__) gcc以外でも使用するためには__VA_ARGS__を使うほかないが、その場合は書式文字列も含めて可変長引数として渡す必要がある。
#define dbgprintf(...) realdbgprintf(__FILE__, __LINE__, __VA_ARGS__) の独自拡張モードでは、ゼロ個の引数を受け取る__VA_ARGS__は末尾コンマを抑制する動作をする[3]。
では、空の可変引数を処理するための__VA_OPT__マクロをサポートする[4]。
C++
可変長引数テンプレート[5]がでサポートされた。
template<typename... Args> class tuple; このtupleクラステンプレートは、テンプレート引数としていくらでも型名を取れる:
tuple<std::vector<int>, std::map<std::string, std::vector<int>>> someTuple; // tuple インスタンス。 tuple<> emptyTuple; std::tupleとしても標準化されている。
また、C++11ではC99との互換性向上のため、可変長引数マクロが標準化された (N1653)。
Java
平均値を求める静的メソッド average の例を考える。平均値の計算には最小でも1個の値が必要であるから、固定個数の仮引数（必須の仮引数）として x0 を指定しており、それ以降を任意個数の引数としている。任意個数の値は仮引数 xs に double 型の配列として格納される。
static double average(double x0, double ... xs) { double sum = x0; int count = 1; for (double x: xs) { sum += x; ++count; } return sum / count; } 上記を呼び出すコード片の例は次の通りである。
System.out.println(average(0.3, 9.4, 5.2, 4.5, 9.7)); Scheme
平均値を求める手続き average の例を考える。平均値の計算には最小でも1個の値が必要であるから、固定個数の仮引数（必須の仮引数）として x0 を指定しており、それ以降を任意個数の引数としている。任意個数の値は仮引数 xs にリストとして格納される。
(define (average x0 . xs) (let ((sum x0) (count 1)) (for-each (lambda (x) (set! sum (+ sum x)) (set! count (+ count 1))) xs) (/ sum count))) 上記を呼び出すコードの例は次の通りである。
(display (average 0.3 9.4 5.2 4.5 9.7)) (newline) 英語
variadicは「可変長引数の」「可変個引数の」という意味の形容詞である。C言語などでは可変長引数のことを「variable argument」と呼ぶ。辞典などでは直訳して「変数引数」とされていることがあるが、これは誤訳である。なお、「変数引数」という言葉は、Pascalなどで変数渡しに使用される「variable parameter」の定訳であり、これは可変長引数とは違うものを指す。したがって、可変長引数のことを「変数引数」と呼ぶのは混乱の原因となる。