Function home::home_dir

pub fn home_dir() -> Option<PathBuf>

Returns the path of the current user’s home directory using environment variables or OS-specific APIs.

Unix

Returns the value of the HOME environment variable if it is set even if it is an empty string. Otherwise, it tries to determine the home directory by invoking the getpwuid_r function with the UID of the current user.

Windows

Returns the value of the USERPROFILE environment variable if it is set and it is not an empty string. Otherwise, it tries to determine the home directory by invoking the SHGetKnownFolderPath function with FOLDERID_Profile.

Examples

match home::home_dir() {
    Some(path) if !path.as_os_str().is_empty() => println!("{}", path.display()),
    _ => println!("Unable to get your home dir!"),
}