A FileStat object represents the result of calling the POSIX stat() function on a file system object. It is an immutable object, representing the snapshotted values returned by the stat() call.
Properties
- accessed → DateTime
-
The time of the last access to the data of the file system
object. On Windows platforms, this may have 1 day granularity, and be
out of date by an hour.
final
- changed → DateTime
-
The time of the last change to the data or metadata of the file system
object. On Windows platforms, this is instead the file creation time.
final
- mode → int
-
The mode of the file system object. Permissions are encoded in the lower
16 bits of this number, and can be decoded using the modeString getter.
final
- modified → DateTime
-
The time of the last change to the data of the file system
object.
final
- size → int
-
The size of the file system object.
final
- type → FileSystemEntityType
-
The type of the object (file, directory, or link). If the call to
stat() fails, the type of the returned object is NOT_FOUND.
final
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Methods
-
modeString(
) → String - Returns the mode value as a human-readable string, in the format "rwxrwxrwx", reflecting the user, group, and world permissions to read, write, and execute the file system object, with "-" replacing the letter for missing permissions. Extra permission bits may be represented by prepending "(suid)", "(guid)", and/or "(sticky)" to the mode string.
-
toString(
) → String - Returns a string representation of this object.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
Operators
-
operator ==(
other) → bool -
The equality operator. [...]
inherited
Static Methods
-
stat(
String path) → Future<FileStat> -
Asynchronously calls the operating system's stat() function on
path. Returns a Future which completes with a FileStat object containing the data returned by stat(). If the call fails, completes the future with a FileStat object with .type set to FileSystemEntityType.NOT_FOUND and the other fields invalid. -
statSync(
String path) → FileStat -
Calls the operating system's stat() function on
path. Returns a FileStat object containing the data returned by stat(). If the call fails, returns a FileStat object with .type set to FileSystemEntityType.NOT_FOUND and the other fields invalid.