FileSystemException | API reference | Android Developers (original) (raw)
open class FileSystemException : IOException
| kotlin.Any | |||
|---|---|---|---|
| ↳ | kotlin.Throwable | ||
| ↳ | java.lang.Exception | ||
| ↳ | java.io.IOException | ||
| ↳ |
Known Direct Subclasses
| AccessDeniedException | Checked exception thrown when a file system operation is denied, typically due to a file permission or other access check. |
|---|---|
| AtomicMoveNotSupportedException | Checked exception thrown when a file cannot be moved as an atomic file system operation. |
| DirectoryNotEmptyException | Checked exception thrown when a file system operation fails because a directory is not empty. |
| FileAlreadyExistsException | Checked exception thrown when an attempt is made to create a file or directory and a file of that name already exists. |
| FileSystemLoopException | Checked exception thrown when a file system loop, or cycle, is encountered. |
| NoSuchFileException | Checked exception thrown when an attempt is made to access a file that does not exist. |
| NotDirectoryException | Checked exception thrown when a file system operation, intended for a directory, fails because the file is not a directory. |
| NotLinkException | Checked exception thrown when a file system operation fails because a file is not a symbolic link. |
Thrown when a file system operation fails on one or two files. This class is the general class for file system exceptions.
Summary
| Public constructors |
|---|
| FileSystemException(file: String!) Constructs an instance of this class. |
| FileSystemException(file: String!, other: String!, reason: String!) Constructs an instance of this class. |
| Public methods | |
|---|---|
| open String! | getFile() Returns the file used to create this exception. |
| open String! | getOtherFile() Returns the other file used to create this exception. |
| open String! | getReason() Returns the string explaining why the file system operation failed. |
| Properties | |
|---|---|
| open String? | message Returns the detail message string. |
Public constructors
FileSystemException
FileSystemException(file: String!)
Constructs an instance of this class. This constructor should be used when an operation involving one file fails and there isn't any additional information to explain the reason.
| Parameters | |
|---|---|
| file | String!: a string identifying the file or null if not known. |
FileSystemException
FileSystemException(
file: String!,
other: String!,
reason: String!)
Constructs an instance of this class. This constructor should be used when an operation involving two files fails, or there is additional information to explain the reason.
| Parameters | |
|---|---|
| file | String!: a string identifying the file or null if not known. |
| other | String!: a string identifying the other file or null if there isn't another file or if not known |
| reason | String!: a reason message with additional information or null |
Public methods
getFile
open fun getFile(): String!
Returns the file used to create this exception.
| Return | |
|---|---|
| String! | the file (can be null) |
getOtherFile
open fun getOtherFile(): String!
Returns the other file used to create this exception.
| Return | |
|---|---|
| String! | the other file (can be null) |
getReason
open fun getReason(): String!
Returns the string explaining why the file system operation failed.
| Return | |
|---|---|
| String! | the string explaining why the file system operation failed |
Properties
message
open val message: String?
Returns the detail message string.
| Return | |
|---|---|
| String? | the detail message string of this Throwable instance (which may be null). |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.