できない.dev

コマンドライン引数を受け取るには

プログラムの起動時に渡されたコマンドライン引数を受け取る書き方を各言語で示す。
先頭の要素がプログラム名かどうかの違いと、引数が足りないときや数値に変換できないときの扱いもまとめる。

公開:

選んだ言語は、ほかのサンプルコードを開いたときも最初に表示する。

Python

import sys
 
# sys.argv[0] はスクリプト名なので、引数は [1:] から
args = sys.argv[1:]
print(args)  # ['report.txt', '3']
 
name = args[0] if args else "default.txt"
count = int(args[1]) if len(args) > 1 else 1
print(name, count)  # report.txt 3

sys.argv の先頭はスクリプト名なので、sys.argv[1:] で渡された引数だけを取り出す。
引数が足りない場合に IndexError にならないよう、長さを見て既定値を使う。

JavaScript

// process.argv[0] は node、[1] はスクリプトのパスなので、引数は slice(2) から
const args = process.argv.slice(2);
console.log(args); // [ 'report.txt', '3' ]
 
const name = args[0] ?? "default.txt";
const count = args[1] !== undefined ? Number(args[1]) : 1;
console.log(name, count); // report.txt 3

process.argv の先頭 2 つは node の実行パスとスクリプトのパスなので、slice(2) で引数だけにする。
値はすべて文字列で届くため、数として使うなら Number で変換する。

TypeScript

// process.argv[0] は node、[1] はスクリプトのパスなので、引数は slice(2) から
const args: string[] = process.argv.slice(2);
console.log(args); // [ 'report.txt', '3' ]
 
const name: string = args[0] ?? "default.txt";
const count: number = args[1] !== undefined ? Number(args[1]) : 1;
console.log(name, count); // report.txt 3

process.argv は string[] として扱え、先頭 2 つを slice(2) で除く。
process を型として解決するには @types/node が要る。

できないときTypeScript「Cannot find name 'process'」の原因と直し方

Go

package main
 
import (
	"fmt"
	"os"
	"strconv"
)
 
func main() {
	// os.Args[0] は実行ファイル名なので、引数は [1:] から
	args := os.Args[1:]
	fmt.Println(args) // [report.txt 3]
 
	name := "default.txt"
	if len(args) > 0 {
		name = args[0]
	}
	count := 1
	if len(args) > 1 {
		n, err := strconv.Atoi(args[1])
		if err != nil {
			fmt.Fprintln(os.Stderr, "count は整数で指定する:", err)
			os.Exit(2)
		}
		count = n
	}
	fmt.Println(name, count) // report.txt 3
}

os.Args の先頭は実行ファイル名なので os.Args[1:] を使う。
数値は strconv.Atoi で変換し、失敗したときの err を必ず確かめる。

Rust

use std::env;
 
fn main() {
    // 最初の要素は実行ファイル名なので skip(1) で飛ばす
    let args: Vec<String> = env::args().skip(1).collect();
    println!("{:?}", args); // ["report.txt", "3"]
 
    let name = args.get(0).map(String::as_str).unwrap_or("default.txt");
    let count: u32 = match args.get(1) {
        Some(s) => s.parse().expect("count は整数で指定する"),
        None => 1,
    };
    println!("{} {}", name, count); // report.txt 3
}

std::env::args() は実行ファイル名を含むイテレータを返すので、skip(1) で飛ばして Vec<String> に集める。
インデックスで直接読むと範囲外で panic するため、get で Option として受ける。

Java

import java.util.Arrays;
 
public class Main {
    // args にはクラス名を含まず、渡した引数だけが入る
    public static void main(String[] args) {
        System.out.println(Arrays.toString(args)); // [report.txt, 3]
 
        String name = args.length > 0 ? args[0] : "default.txt";
        int count = args.length > 1 ? Integer.parseInt(args[1]) : 1;
        System.out.println(name + " " + count); // report.txt 3
    }
}

main の args にはクラス名を含まず、渡した引数だけが入る。
数値は Integer.parseInt で変換し、整数でない文字列が来ると NumberFormatException になる。

C#

// トップレベルのプログラムでは args が最初から使える(プログラム名は含まれない)
Console.WriteLine($"[{string.Join(", ", args)}]"); // [report.txt, 3]
 
var name = args.Length > 0 ? args[0] : "default.txt";
var count = args.Length > 1 ? int.Parse(args[1]) : 1;
Console.WriteLine($"{name} {count}"); // report.txt 3

トップレベルのプログラムでは、宣言なしで args が使える。
数値は int.Parse で変換し、変換できない文字列が来ると FormatException になる。

つまずき

言語によって、引数の配列の先頭にプログラム名が入るかどうかが違う。
Python の sys.argv、Node.js の process.argv、Go の os.Args、Rust の env::args() は先頭がプログラム側の情報で、渡した引数は後ろから始まる。
Java の main の args と C# のトップレベルの args には最初から渡した引数だけが入る。
この違いを知らずに [0] を読むと、ファイル名のつもりが実行ファイル名やスクリプトのパスを読むことになる。

値はすべて文字列で届く

引数は数字に見えても文字列のまま渡される。
個数やポート番号として使うなら、各言語の変換関数で数値にする。
変換できない文字列が来たときの挙動は言語ごとに違い、Go は err を返し、Java と C# は例外を投げ、Rust は Result で失敗を返す。
Python の int は ValueError、JavaScript の Number は NaN になる。

引数が足りないとき

引数が 1 つも渡されない場合を考えずに [0] を読むと、Python は IndexError、Java は ArrayIndexOutOfBoundsException、Rust と Go は panic で止まる。
先に長さを確かめるか、ここで示したように既定値を用意しておく。
空白を含む値は、シェル側で引用符で囲まないと 2 つの引数に分かれる点にも注意する。

オプション付きの引数

--verbose や --count 3 のような名前付きの引数が増えてきたら、自前で配列を走査せず標準のパーサを使うほうが安全である。
Python は argparse、Node.js は util.parseArgs、Go は flag パッケージが標準で用意されている。