Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Menerima Argumen Command Line

Mari kita buat proyek baru dengan, seperti biasa, cargo new. Kita akan menyebut proyek kita minigrep agar berbeda dari tool grep yang mungkin sudah ada di sistem kamu:

$ cargo new minigrep
     Created binary (application) `minigrep` project
$ cd minigrep

Tugas pertama adalah membuat minigrep menerima dua argumen command line: path file dan string yang dicari. Dengan kata lain, kita ingin bisa menjalankan program kita dengan cargo run, dua tanda hubung untuk menandakan bahwa argumen setelahnya ditujukan untuk program kita, bukan untuk cargo, sebuah string yang dicari, dan path ke file tempat mencari, seperti ini:

$ cargo run -- searchstring example-filename.txt

Saat ini, program yang dihasilkan oleh cargo new belum bisa memproses argumen yang kita berikan. Beberapa library yang sudah ada di crates.io bisa membantu menulis program yang menerima argumen command line, tetapi karena kamu baru belajar konsep ini, mari kita terapkan kemampuan ini sendiri.

Membaca Nilai Argumen

Agar minigrep bisa membaca nilai argumen command line yang kita berikan kepadanya, kita membutuhkan fungsi std::env::args yang disediakan oleh library standar Rust. Fungsi ini mengembalikan iterator berisi argumen command line yang diberikan kepada minigrep. Kita akan membahas iterator secara lengkap di Chapter 13. Untuk sekarang, kamu hanya perlu tahu dua hal tentang iterator: iterator menghasilkan serangkaian nilai, dan kita bisa memanggil method collect pada iterator untuk mengubahnya menjadi sebuah koleksi, seperti vector, yang berisi semua elemen yang dihasilkan iterator tersebut.

Kode di Listing 12-1 memungkinkan program minigrep kamu membaca argumen command line apa pun yang diberikan kepadanya, lalu mengumpulkan nilainya ke dalam sebuah vector.

Filename: src/main.rs
use std::env;

fn main() {
    let args: Vec<String> = env::args().collect();
    dbg!(args);
}
Listing 12-1: Mengumpulkan argumen command line ke dalam vector dan mencetaknya

Pertama, kita memasukkan module std::env ke dalam scope dengan statement use agar bisa menggunakan fungsi args-nya. Perhatikan bahwa fungsi std::env::args bersarang dua tingkat di dalam module. Seperti yang kita bahas di Chapter 7, ketika fungsi yang diinginkan bersarang di lebih dari satu module, kita memilih untuk memasukkan module induknya ke dalam scope alih-alih fungsinya. Dengan begitu, kita bisa dengan mudah menggunakan fungsi lain dari std::env. Cara ini juga lebih tidak ambigu daripada menambahkan use std::env::args lalu memanggil fungsinya cukup dengan args, karena args bisa dengan mudah dikira sebagai fungsi yang didefinisikan di module saat ini.

Fungsi args dan Unicode yang Tidak Valid

Perhatikan bahwa std::env::args akan panic jika ada argumen yang mengandung Unicode tidak valid. Jika program kamu perlu menerima argumen yang mengandung Unicode tidak valid, gunakan std::env::args_os sebagai gantinya. Fungsi itu mengembalikan iterator yang menghasilkan nilai OsString, bukan nilai String. Kita memilih memakai std::env::args di sini demi kesederhanaan karena nilai OsString berbeda-beda tiap platform dan lebih sulit dikerjakan daripada nilai String.

Di baris pertama main, kita memanggil env::args, lalu langsung menggunakan collect untuk mengubah iterator menjadi vector yang berisi semua nilai yang dihasilkan iterator tersebut. Kita bisa memakai fungsi collect untuk membuat berbagai macam koleksi, jadi kita secara eksplisit memberi anotasi tipe pada args untuk menentukan bahwa kita menginginkan vector berisi string. Meski kamu sangat jarang perlu memberi anotasi tipe di Rust, collect adalah salah satu fungsi yang sering kali perlu diberi anotasi karena Rust tidak bisa menyimpulkan jenis koleksi yang kamu inginkan.

Terakhir, kita mencetak vector tersebut menggunakan macro debug. Mari kita coba jalankan kode ini, pertama tanpa argumen, lalu dengan dua argumen:

$ cargo run
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.61s
     Running `target/debug/minigrep`
[src/main.rs:5:5] args = [
    "target/debug/minigrep",
]
$ cargo run -- needle haystack
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.57s
     Running `target/debug/minigrep needle haystack`
[src/main.rs:5:5] args = [
    "target/debug/minigrep",
    "needle",
    "haystack",
]

Perhatikan bahwa nilai pertama dalam vector adalah "target/debug/minigrep", yaitu nama binary kita. Ini sesuai dengan perilaku daftar argumen di C, yang memungkinkan program memakai nama yang dipakai untuk memanggilnya saat dijalankan. Sering kali berguna untuk bisa mengakses nama program, misalnya jika kamu ingin mencetaknya di pesan atau mengubah perilaku program berdasarkan alias command line yang dipakai untuk memanggilnya. Namun untuk kebutuhan bab ini, kita akan mengabaikannya dan hanya menyimpan dua argumen yang kita butuhkan.

Menyimpan Nilai Argumen dalam Variabel

Saat ini program sudah bisa mengakses nilai-nilai yang ditentukan sebagai argumen command line. Sekarang kita perlu menyimpan nilai kedua argumen itu dalam variabel agar bisa memakainya di seluruh sisa program. Kita melakukan itu di Listing 12-2.

Filename: src/main.rs
use std::env;

fn main() {
    let args: Vec<String> = env::args().collect();

    let query = &args[1];
    let file_path = &args[2];

    println!("Searching for {query}");
    println!("In file {file_path}");
}
Listing 12-2: Membuat variabel untuk menampung argumen query dan argumen path file

Seperti yang kita lihat saat mencetak vector, nama program menempati nilai pertama di vector pada args[0], jadi kita mulai argumen dari indeks 1. Argumen pertama yang diterima minigrep adalah string yang kita cari, jadi kita memasukkan reference ke argumen pertama ke dalam variabel query. Argumen kedua adalah path file, jadi kita memasukkan reference ke argumen kedua ke dalam variabel file_path.

Kita sementara mencetak nilai variabel-variabel ini untuk membuktikan bahwa kode bekerja sesuai rencana. Mari jalankan lagi program ini dengan argumen test dan sample.txt:

$ cargo run -- test sample.txt
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.0s
     Running `target/debug/minigrep test sample.txt`
Searching for test
In file sample.txt

Mantap, programnya berhasil! Nilai argumen yang kita butuhkan tersimpan di variabel yang tepat. Nanti kita akan menambahkan penanganan error untuk mengatasi sejumlah situasi yang berpotensi bermasalah, misalnya saat pengguna tidak memberikan argumen; untuk sekarang, kita abaikan dulu situasi itu dan kerjakan penambahan kemampuan membaca file.