Rustチュートリアル では、コマンドラインからパラメーターを取得する方法については説明していません。 fn main()
は、すべての例で空のパラメーターリストでのみ表示されます。
main
からコマンドラインパラメーターにアクセスする正しい方法は何ですか?
std::env::args
または std::env::args_os
関数を使用して、コマンドライン引数にアクセスできます。両方の関数は、引数の反復子を返します。前者はString
s(簡単に操作できます)を反復処理しますが、引数の1つが有効なUnicodeでない場合はパニックします。後者はOsString
sを反復処理し、パニックに陥ることはありません。
イテレータの最初の要素はプログラム自体の名前であることに注意してください(これはすべての主要な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 は、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 には、完全な実例がたくさんあります。
免責事項:私はこのライブラリの著者の一人です。
Rustには、 getopts crate でgetopt
- style CLI引数解析があります。
私にとって、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);
( 公式ドキュメント からコピー)
バージョン0.8/0.9では、関数args()への正しいパスは::std::os::args
になります。つまり:
fn main() {
let args: ~[~str] = ::std::os::args();
println(args[0]);
}
Rustは、標準IOでさえ、今でもかなり不安定であるように思われるので、これはかなり早く時代遅れになるかもしれません。
さびが再び変わった。 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();
錆-変化の痛みを受け入れることを学ぶ
@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")
}
}
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);
}
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
モジュールは、物事を行うためのはるかに優れた方法のようです。完成のためにこの回答を投稿します。
新しい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
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);
}