Skip to main content

A.51. File, Path, Directory

Pada chapter ini kita akan belajar tentang beberapa API milik Rust yang disediakan untuk manajemen path dan file system.

A.51.1. File path (std::path::Path)​

"/home/novalagung/Desktop/my text.txt" adalah salah satu contoh file path. Di Rust, file path bisa direpresentasikan sebagai string (seperti yang sudah dicontohkan), atau menggunakan tipe data Path.

Tipe data Path tersedia dalam module std::path. Cara penggunaannya cukup mudah, sebagai contoh, beberapa filepath berikut menghasilkan path yang sama:

let filepath_1 = "/home/novalagung/Desktop/my text.txt";
let filepath_2 = Path::new("/home/novalagung/Desktop/my text.txt");
let filepath_3 = Path::new("/home/novalagung/Desktop").join("my text.txt");
let filepath_4 = Path::new("/home/novalagung").join("Desktop").join("my text.txt");
let filepath_5 = Path::new("/home").join("novalagung/Desktop/my text.txt");

A.52.2. Method filepath​

◉ Associated function Path::new()​

Digunakan untuk membuat object Path dari suatu string. Contoh penerapan:

Path::new("/home/novalagung/Desktop/my text.txt");

◉ Method join()​

Digunakan untuk menggabungkan segment filepath. Contoh penerapan:

Path::new("/home/novalagung").join("Desktop").join("my text.txt");

Hasil dari operasi di atas adalah path:

/home/novalagung/Desktop/my text.txt

◉ Method exists()​

Digunakan untuk mengecek apakah suatu filepath ada atau tidak.

if Path::new(path).exists() {
    // path exists
}

◉ Method is_file() & is_dir()​

Method is_file() digunakan untuk mengecek apakah suatu filepath berisi file.

if Path::new(path).is_file() {
    // path is a file
}

Sedangkan method is_dir() digunakan untuk mengecek apakah suatu filepath adalah folder/directory.

if Path::new(path).is_dir() {
    // path contains directory
}

◉ Method is_absolute() & is_relative()​

Method is_absolute() digunakan untuk mengecek apakah suatu filepath adalah absolute path.

if Path::new(path).is_absolute() {
    // path is an absolute path
}

Sedangkan method is_relative() digunakan untuk mengecek apakah suatu filepath adalah relative path.

if Path::new(path).is_relative() {
    // path is a relative path
}

A.52.3. Module std::fs (file system)​

std::fs merupakan module yang disediakan Rust untuk pengolahan file system. Didalamnya berisinya banyak sekali fungsi untuk keperluan seperti pembuatan file, modifikasi konten file, dan lainnya.

Sebagai contoh, untuk membuat suatu directory bisa menggunakan fs::create_dir. Isi argument pemanggilan fungsi dengan path dalam bentuk string (atau std::path::Path juga boleh).

let path = "./files";
let res = fs::create_dir(path);

Fungsi fs::create_dir mengembalikan value bertipe Result<(), Error>. Gunakan pattern matching match untuk mengecek hasil operasi apakah sukses atau tidak.

match fs::create_dir("./files") {
    Err(err) => {
        println!("error on creating directory! {}", err);
        return
    },
    _ => {},
}

A.52.4. Manajemen file system​

◉ Pembuatan folder (fs::create_dir)​

Fungsi fs::create_dir digunakan untuk membuat folder. Contoh penerapannya sudah dibahas di sesi A.52.3. Module std::fs (file system) di atas.

◉ Menulis konten file (fs::write)​

Fungsi fs::write digunakan untuk membuat folder. Contoh penerapan:

let path = Path::new("./files").join("target.txt");
let content = "hello rust!";
let res = fs::write(path, content);

match res {
    Err(err) => {
        println!("error on writing file {}! {}", path.to_str().unwrap_or_default(), err);
        return
    },
    _ => {},
}

Fungsi fs::write melakukan penulisan konten pada variabel content ke path path. Mode penulisannya adalah overwrite (bukan append), yang artinya konten lama pada filepath akan di-replace total dengan konten baru.

Jika file tidak ada pada path tujuan, maka otomatis dibuatkan file baru. Namun jika folder/directory dimana file akan dibuat/ditulis tidak ada, maka muncul error.

◉ Menghapus file (fs::remove_file)​

Fungsi fs::remove_file digunakan untuk menghapus file pada suatu path. Contoh penerapan:

let path = Path::new("./files").join("target.txt");
let res = fs::remove_file(path);

match res {
    Err(err) => {
        println!("error on deleting file {}! {}", path.to_str().unwrap_or_default(), err);
        return
    },
    _ => {},
}

◉ Menghapus folder (fs::remove_dir)​

Fungsi fs::remove_dir digunakan untuk menghapus folder/directory. Contoh penerapan:

let path = Path::new("./files");
let res = fs::remove_dir(path);

match res {
    Err(err) => {
        println!("error on deleting directory {}! {}", path.to_str().unwrap_or_default(), err);
        return
    },
    _ => {},
}

◉ List items dalam folder​

Fungsi fs::read_dir digunakan untuk menampilkan list items suatu folder (baik subfolder ataupun file). Fungsi ini mengmbalikan nilai bertipe Result<ReadDir, Error>, untuk mengakses list items bisa menggunakan teknik pattern matching, atau boleh juga langsung di unwrap() (dengan resiko program bisa panic ketika ada error).

let path = Path::new("D:\\Labs\\Adam Studio\\Ebook\\dasarpemrogramanrust\\file_path_directory_1");
let paths = fs::read_dir(path).unwrap();

for path in paths {
    let item = path.unwrap();
    println!("file name: {:?}, file path: {:?}", item.file_name(), item.path().display())
}

Pada contoh di atas, penulis menggunakan testing path yang isinya 4 buah item:

File, Path, Directory

Output program bisa dilihat pada gambar berikut:

File, Path, Directory

Tipe data variabel paths di atas adalah ReadDir yang merupakan tipe data iterator. Jika digunakan pada keyword for, maka variabel element perulangan path akan bertipe data Result<DirEntry, Error>. Dari tipe ini kita bisa mengakses file name maupun file path.

Catatan chapter 📑​

◉ Source code praktik​

github.com/novalagung/dasarpemrogramanrust-example/../file_path_directory

◉ Work in progress​

◉ Chapter relevan lainnya​

◉ Referensi​