web-dev-qa-db-ja.com

コマンドラインパラメータにアクセスするには?

Rustチュートリアル では、コマンドラインからパラメーターを取得する方法については説明していません。 fn main()は、すべての例で空のパラメーターリストでのみ表示されます。

mainからコマンドラインパラメーターにアクセスする正しい方法は何ですか?

145
shutefan

std::env::args または std::env::args_os 関数を使用して、コマンドライン引数にアクセスできます。両方の関数は、引数の反復子を返します。前者はStrings(簡単に操作できます)を反復処理しますが、引数の1つが有効なUnicodeでない場合はパニックします。後者はOsStringsを反復処理し、パニックに陥ることはありません。

イテレータの最初の要素はプログラム自体の名前であることに注意してください(これはすべての主要なOSの規則です)。したがって、実際には最初の引数は2番目の反復要素です。

argsの結果を処理する簡単な方法は、それをVecに変換することです。

use std::env;

fn main() {
    let args: Vec<_> = env::args().collect();
    if args.len() > 1 {
        println!("The first argument is {}", args[1]);
    }
}

標準イテレータツールボックス 全体を使用して、これらの引数を操作できます。たとえば、最初の引数のみを取得するには:

use std::env;

fn main() {
    if let Some(arg1) = env::args().nth(1) {
        println!("The first argument is {}", arg1);
    }
}

コマンドライン引数を解析するためのライブラリは crates.io にあります:

  • docopt :ヘルプメッセージを記述するだけで、解析コードが生成されます。
  • clap :Fluent APIを使用して解析するオプションを記述します。 docoptよりも高速で、より詳細に制御できます。
  • getopts :人気のあるCライブラリのポート。下位レベルでさらに制御可能。
  • structopt :拍手の上に構築され、使用するのはさらに人間工学的です。
160
barjak

Docopt は、Rustでも使用できます。Rustは、使用法の文字列からパーサーを生成します。 Rustのボーナスとして、マクロを使用して構造体を自動的に生成し、型ベースのデコードを実行できます。

docopt!(Args, "
Usage: cp [-a] SOURCE DEST
       cp [-a] SOURCE... DIR

Options:
    -a, --archive  Copy everything.
")

そして、あなたは引数を得ることができます:

let args: Args = Args::docopt().decode().unwrap_or_else(|e| e.exit());

READMEおよび documentation には、完全な実例がたくさんあります。

免責事項:私はこのライブラリの著者の一人です。

22
BurntSushi5

Rustには、 getopts crategetopt- style CLI引数解析があります。

11
Tobu

私にとって、getoptsはいつも低すぎると感じ、docopt.rsはあまりにも魔法でした。必要に応じてすべての機能を提供する明示的でわかりやすいものが必要です。

これは clap-rs が便利な場所です。
Pythonのargparseに少し似ています。以下に例を示します。

let matches = App::new("myapp")
                      .version("1.0")
                      .author("Kevin K. <[email protected]>")
                      .about("Does awesome things")
                      .arg(Arg::with_name("CONFIG")
                           .short("c")
                           .long("config")
                           .help("Sets a custom config file")
                           .takes_value(true))
                      .arg(Arg::with_name("INPUT")
                           .help("Sets the input file to use")
                           .required(true)
                           .index(1))
                      .arg(Arg::with_name("debug")
                           .short("d")
                           .multiple(true)
                           .help("Sets the level of debugging information"))
                      .get_matches();

次のようにパラメーターにアクセスできます。

println!("Using input file: {}", matches.value_of("INPUT").unwrap());

// Gets a value for config if supplied by user, or defaults to "default.conf"
let config = matches.value_of("CONFIG").unwrap_or("default.conf");
println!("Value for config: {}", config);

公式ドキュメント からコピー)

8
mre

バージョン0.8/0.9では、関数args()への正しいパスは::std::os::argsになります。つまり:

fn main() {
  let args: ~[~str] = ::std::os::args();
  println(args[0]);
}

Rustは、標準IOでさえ、今でもかなり不安定であるように思われるので、これはかなり早く時代遅れになるかもしれません。

3
Nick

さびが再び変わった。 os::args()は、std::args()を支持して廃止されました。ただし、std::args()は配列ではなく、iteratorを返します。コマンドライン引数を反復処理できますが、添え字を使用してアクセスすることはできません。

http://doc.Rust-lang.org/std/env/fn.args.html

コマンドライン引数を文字列のベクトルとして使用する場合は、これで機能します。

use std::env;
...
let args: Vec<String> = env::args().map(|s| s.into_string().unwrap()).collect();

錆-変化の痛みを受け入れることを学ぶ

3
John Nagle

@barjakが言ったことは文字列に対しては機能しますが、引数を数値(この場合はuint)として必要とする場合、次のように変換する必要があります。

fn main() {
    let arg : ~[~str] = os::args();
    match uint::from_str(arg[1]){
         Some(x)=>io::println(fmt!("%u",someFunction(x))),
         None=>io::println("I need a real number")
    }
}
2
Calvin

Structoptもチェックしてください:

extern crate structopt;
#[macro_use]
extern crate structopt_derive;

use structopt::StructOpt;

#[derive(StructOpt, Debug)]
#[structopt(name = "example", about = "An example of StructOpt usage.")]
struct Opt {
    /// A flag, true if used in the command line.
    #[structopt(short = "d", long = "debug", help = "Activate debug mode")]
    debug: bool,

    /// An argument of type float, with a default value.
    #[structopt(short = "s", long = "speed", help = "Set speed", default_value = "42")]
    speed: f64,

    /// Needed parameter, the first on the command line.
    #[structopt(help = "Input file")]
    input: String,

    /// An optional parameter, will be `None` if not present on the
    /// command line.
    #[structopt(help = "Output file, stdout if not present")]
    output: Option<String>,
}

fn main() {
    let opt = Opt::from_args();
    println!("{:?}", opt);
}

https://github.com/TeXitoi/structopt

1
mre

Rust book "No stdlib"章 は、コマンドラインパラメーターにアクセスする方法を説明しています(別の方法)。

// Entry point for this program
#[start]
fn start(_argc: isize, _argv: *const *const u8) -> isize {
    0
}

現在、この例には#![no_std]もあります。これは通常、stdライブラリがバイナリの真のエントリポイントを持ち、main()というグローバル関数を呼び出すことを意味します。別のオプションは、#![no_main]main shimを無効にすることです。私が間違っていなければ、プログラムの起動方法を完全に制御しているとコンパイラに言っています。

#![no_std]
#![no_main]

#[no_mangle] // ensure that this symbol is called `main` in the output
pub extern fn main(argc: isize, argv: *const *const u8) -> isize {
    0
}

コマンドライン引数を読みたいだけの場合、これが「良い」方法だとは思いません。他の回答で言及されているstd::osモジュールは、物事を行うためのはるかに優れた方法のようです。完成のためにこの回答を投稿します。

1
thecoshman

新しいRustバージョン(Rust> 0.10/11)では、配列構文は機能しません。 getメソッドを使用する必要があります。

[編集]配列構文は(再び)夜間に機能します。そのため、ゲッターインデックスまたは配列インデックスを選択できます。

use std::os;

fn main() {
  let args = os::args();
  println!("{}", args.get(1));
}

// Compile
 rustc args.rs && ./args hello-world // returns hello-world
1
stormpat

Rustは2013年5月のCalvinの回答以来進化してきました。今では、コマンドライン引数をas_slice()で解析します:

use std::os;

fn seen_arg(x: uint)
{       
    println!("you passed me {}", x);
}
fn main() {
    let args = os::args();
    let args = args.as_slice();
    let nitems = {
            if args.len() == 2 {
                    from_str::<uint>(args[1].as_slice()).unwrap()
            } else {
                    10000
            }
    };

    seen_arg(nitems);
}
1
Rob Latham