Directory namespace
Filesystem utilities.
This library is built if WITH_UTILITY is enabled when building Corrade. To use this library with CMake, you need to request the Utility component of the Corrade package and link to the Corrade::Utility target.
find_package(Corrade REQUIRED Utility) # ... target_link_libraries(your-app Corrade::Utility)
See also Downloading and building Corrade and Using Corrade with CMake for more information.
Enums
- enum class Flag: unsigned char { SkipDotAndDotDot = 1 << 0, SkipFiles = 1 << 1, SkipDirectories = 1 << 2, SkipSpecial = 1 << 3, SortAscending = (1 << 4) | (1 << 5), SortDescending = 1 << 5 }
- Listing flag.
Typedefs
-
using Flags = Containers::
EnumSet<Flag> - Listing flags.
Functions
-
auto fromNativeSeparators(std::
string path) -> std:: string - Convert path from native separators.
-
auto toNativeSeparators(std::
string path) -> std:: string - Convert path to native separators.
-
auto path(const std::
string& filename) -> std:: string - Extract path from filename.
-
auto filename(const std::
string& filename) -> std:: string - Extract filename (without path) from filename.
-
auto join(const std::
string& path, const std:: string& filename) -> std:: string - Join path and filename.
-
auto mkpath(const std::
string& path) -> bool - Create path.
-
auto rm(const std::
string& path) -> bool - Remove file or directory.
-
auto move(const std::
string& oldPath, const std:: string& newPath) -> bool - Move given file or directory.
-
auto fileExists(const std::
string& filename) -> bool - Check if the file exists.
- auto isSandboxed() -> bool
- Whether the application runs in a sandboxed environment.
-
auto executableLocation() -> std::
string - Executable location.
-
auto home() -> std::
string - Current user's home directory.
-
auto configurationDir(const std::
string& name) -> std:: string - Application configuration dir.
-
auto tmp() -> std::
string - Temporary dir.
-
auto list(const std::
string& path, Flags flags = Flags()) -> std:: vector<std:: string> - List directory contents.
-
auto read(const std::
string& filename) -> Containers:: Array<char> - Read file into array.
-
auto readString(const std::
string& filename) -> std:: string - Read file into string.
-
auto write(const std::
string& filename, Containers:: ArrayView<const void> data) -> bool - Write array into file.
-
auto writeString(const std::
string& filename, const std:: string& data) -> bool - Write string into file.
-
auto map(const std::
string& filename, std:: size_t size) -> Containers:: Array<char, MapDeleter> - Map file for reading and writing.
-
auto mapRead(const std::
string& filename) -> Containers:: Array<const char, MapDeleter> - Map file for reading.
Enum documentation
enum class Corrade::
Listing flag.
| Enumerators | |
|---|---|
| SkipDotAndDotDot |
Skip |
| SkipFiles |
Skip regular files |
| SkipDirectories |
Skip directories (including |
| SkipSpecial |
Skip everything what is not a file or directory |
| SortAscending |
Sort items in ascending order. If both Flag:: |
| SortDescending |
Sort items in descending order. If both Flag:: |
Typedef documentation
typedef Containers::
Listing flags.
Function documentation
std::
Convert path from native separators.
On Windows converts backward slashes to forward slashes, on all other platforms returns the input argument untouched.
std::
Convert path to native separators.
On Windows converts forward slashes to backward slashes, on all other platforms returns the input argument untouched.
std::
Extract path from filename.
Returns everything before first slash. If the filename doesn't contain any path, returns empty string, if the filename is already a path (ends with slash), returns whole string without trailing slash.
std::
Extract filename (without path) from filename.
If the filename doesn't contain any slash, returns whole string, otherwise returns everything after last slash.
std::
Join path and filename.
If the path is empty or the filename is absolute (with leading slash), returns filename.
bool Corrade::
Create path.
Returns true if path was successfully created, false otherwise. Expects that the path is in UTF-8.
bool Corrade::
Remove file or directory.
Returns true if path is file or empty directory and was successfully removed, false otherwise. Expects that the path is in UTF-8.
bool Corrade::
Move given file or directory.
Returns true on success, false otherwise. Expects that the paths are in UTF-8.
bool Corrade::
Check if the file exists.
Returns true if the file exists and is accessible (e.g. user has permission to open it), false otherwise. Expects that the filename is in UTF-8.
bool Corrade::
Whether the application runs in a sandboxed environment.
Returns true if running on iOS, Android, as a macOS app bundle, Windows Phone/Store application or in a browser through Emscripten, false otherwise.
std::
Executable location.
Returns location of the executable on Linux, Windows, non-sandboxed and sandboxed macOS and iOS. On other systems or if the directory can't be found, empty string is returned. Returned value is encoded in UTF-8.
std::
Current user's home directory.
On Unix and non-sandboxed macOS, the directory is equivalent to ${HOME} environment variable. On sandboxed macOS and iOS the directory is equivalent to what's returned by NSHomeDirectory(). On Windows the directory is equivalent to %USERPROFILE%/Documents or similar. On other systems or if the directory can't be found, empty string is returned. Returned value is encoded in UTF-8.
std::
Application configuration dir.
| Parameters | |
|---|---|
| name | Application name |
On Unix (except for macOS), the configuration dir is ${XDG_CONFIG_HOME}/name or ${HOME}/.config/name (name is lowercased), on Windows the configuration dir is in %APPDATA%/name (name is left as is). On macOS and iOS the configuration dir is ${HOME}/Library/Application Support/name. On other systems or if the directory can't be found, empty string is returned. Returned value is encoded in UTF-8.
std::
Temporary dir.
On Unix and non-sandboxed macOS, the directory is equivalent to /tmp. On sandboxed macOS and iOS the directory is the /tmp subfolder of the app sandbox. On non-RT Windows the directory is equivalent to %TEMP%. On other systems or if the directory can't be found, empty string is returned. Returned value is encoded in UTF-8.
std::
List directory contents.
On failure returns empty vector.
Containers::
Read file into array.
Reads whole file as binary (i.e. without newline conversion). Returns nullptr and prints message to Error if the file can't be read. Expects that the filename is in UTF-8.
std::
Read file into string.
Convenience overload for read().
bool Corrade::
Write array into file.
Writes the file as binary (i.e. without newline conversion). Returns false and prints message to Error if the file can't be written, true otherwise. Expects that the filename is in UTF-8.
bool Corrade::
Write string into file.
Convenience overload for write().
Containers::
Map file for reading and writing.
Maps the file as read-write memory and enlarges it to size. If the file does not exist yet, it is created, if it exists, it's truncated. The array deleter takes care of unmapping, however the file is not deleted after unmapping. If an error occurs, nullptr is returned and a message is printed to Error. Expects that the filename is in UTF-8.
Containers::
Map file for reading.
Maps the file as read-only memory. The array deleter takes care of unmapping. If the file doesn't exist or an error occurs while mapping, nullptr is returned and a message is printed to Error. Expects that the filename is in UTF-8.