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