Struct directories::UserDirs
[−]
[src]
pub struct UserDirs { /* fields omitted */ }UserDirs provides paths of user-facing standard directories, following the conventions of the operating system the library is running on.
Examples
All examples on this page are computed with a user named Alice.
use directories::UserDirs; let user_dirs = UserDirs::new(); user_dirs.audio_dir(); // Linux: /home/alice/Music // Windows: /Users/Alice/Music // macOS: C:\Users\Alice\Music
Methods
impl UserDirs[src]
pub fn new() -> UserDirs[src]
Creates a UserDirs struct which holds the paths to user-facing directories for audio, font, video, etc. data on the system.
The returned struct is a snapshot of the state of the system at the time new() was invoked.
impl UserDirs[src]
pub fn home_dir(&self) -> &Path[src]
Returns the path to the user's home directory.
| Platform | Value | Example |
|---|---|---|
| Linux | $HOME | /home/alice |
| macOS | $HOME | /Users/Alice |
| Windows | {FOLDERID_Profile} | C:\Users\Alice |
pub fn audio_dir(&self) -> Option<&Path>[src]
Returns the path to the user's audio directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_MUSIC_DIR | /home/alice/Music |
| macOS | $HOME/Music | /Users/Alice/Music |
| Windows | {FOLDERID_Music} | C:\Users\Alice\Music |
pub fn desktop_dir(&self) -> Option<&Path>[src]
Returns the path to the user's desktop directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DESKTOP_DIR | /home/alice/Desktop |
| macOS | $HOME/Desktop | /Users/Alice/Desktop |
| Windows | {FOLDERID_Desktop} | C:\Users\Alice\Desktop |
pub fn document_dir(&self) -> Option<&Path>[src]
Returns the path to the user's document directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DOCUMENTS_DIR | /home/alice/Documents |
| macOS | $HOME/Documents | /Users/Alice/Documents |
| Windows | {FOLDERID_Documents} | C:\Users\Alice\Documents |
pub fn download_dir(&self) -> Option<&Path>[src]
Returns the path to the user's download directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DOWNLOAD_DIR | /home/alice/Downloads |
| macOS | $HOME/Downloads | /Users/Alice/Downloads |
| Windows | {FOLDERID_Downloads} | C:\Users\Alice\Downloads |
pub fn font_dir(&self) -> Option<&Path>[src]
Returns the path to the user's font directory.
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_DATA_HOME/fonts or $HOME/.local/share/fonts | /home/alice/.local/share/fonts |
| macOS | $HOME/Library/Fonts | /Users/Alice/Library/Fonts |
| Windows | – | – |
pub fn picture_dir(&self) -> Option<&Path>[src]
Returns the path to the user's picture directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_PICTURES_DIR | /home/alice/Pictures |
| macOS | $HOME/Pictures | /Users/Alice/Pictures |
| Windows | {FOLDERID_Pictures} | C:\Users\Alice\Pictures |
pub fn public_dir(&self) -> Option<&Path>[src]
Returns the path to the user's public directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_PUBLICSHARE_DIR | /home/alice/Public |
| macOS | $HOME/Public | /Users/Alice/Public |
| Windows | {FOLDERID_Public} | C:\Users\Public |
pub fn template_dir(&self) -> Option<&Path>[src]
Returns the path to the user's template directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_TEMPLATES_DIR | /home/alice/Templates |
| macOS | – | – |
| Windows | {FOLDERID_Templates} | C:\Users\Alice\AppData\Roaming\Microsoft\Windows\Templates |
pub fn video_dir(&self) -> Option<&Path>[src]
Returns the path to the user's video directory.
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_VIDEOS_DIR | /home/alice/Videos |
| macOS | $HOME/Movies | /Users/Alice/Movies |
| Windows | {FOLDERID_Videos} | C:\Users\Alice\Videos |
Trait Implementations
impl Debug for UserDirs[src]
fn fmt(&self, __arg_0: &mut Formatter) -> Result[src]
Formats the value using the given formatter. Read more