Класс FileSystemEntity
Общий суперкласс для File, Directory и Link.
Объекты FileSystemEntity возвращаются в операциях перечисления каталогов. Чтобы определить, является ли FileSystemEntity объектом типа File, Directory или Link, выполните проверку типа:
if (entity is File) (entity as File).readAsStringSync();
Также можно использовать методы type или typeSync, чтобы определить тип объекта файловой системы.
Большинство методов в этом классе существуют как в синхронном, так и в асинхронном вариантах, например, exists и existsSync. Если у вас нет особой причины использовать синхронный вариант метода, предпочитайте асинхронный, чтобы избежать блокирования вашей программы.
Вот метод exists в действии:
var isThere = await entity.exists(); print(isThere ? 'exists' : 'non-existent');
Другие ресурсы
Раздел Файлы и каталоги в обзоре библиотек.
Создавайте приложения командной строки, учебник по созданию приложений командной строки, включает информацию о файлах и каталогах.
Конструкторы
- FileSystemEntity()
Свойства
-
absolute → FileSystemEntity
только для чтения
- Объект FileSystemEntity с абсолютным путем объекта path.
-
hashCode → int
только для чтения, унаследованно
- Хэш-код этого объекта.
-
isAbsolute → bool
только для чтения
- Является ли путь этого объекта абсолютным.
-
parent → Directory
только для чтения
- Родительский каталог этого объекта.
-
path → String
только для чтения
-
runtimeType → Type
только для чтения, унаследованно
- Представление типа объекта во время выполнения.
-
uri → Uri
только для чтения
- Объект Uri, представляющий расположение объекта файловой системы.
Методы
-
delete(
{bool recursive = false}) → Future< FileSystemEntity> - Удаляет этот
FileSystemEntity. -
deleteSync(
{bool recursive = false}) → void - Синхронно удаляет этот объект FileSystemEntity.
-
exists(
) → Future< bool> - Проверяет, существует ли объект файловой системы по этому пути.
-
existsSync(
) → bool - Синхронно проверяет, существует ли объект файловой системы по этому пути.
-
noSuchMethod(
Invocation invocation) → dynamic унаследованно - Вызывается при обращении к несуществующему методу или свойству.
-
rename(
String newPath) → Future< FileSystemEntity> - Переименовывает этот объект файловой системы.
-
renameSync(
String newPath) → FileSystemEntity - Синхронно переименовывает этот объект файловой системы.
-
resolveSymbolicLinks(
) → Future< String> - Разрешает путь объекта файловой системы относительно текущей рабочей директории.
-
resolveSymbolicLinksSync(
) → String - Разрешает путь объекта файловой системы относительно текущей рабочей директории.
-
stat(
) → Future< FileStat> - Вызывает операционную систему
stat()функцию по пути path. -
statSync(
) → FileStat - Синхронно вызывает операционную систему
stat()функцию по пути path. -
toString(
) → String унаследованно - Строковое представление этого объекта.
-
watch(
{int events = FileSystemEvent.all, bool recursive = false}) → Stream< FileSystemEvent> - Начать отслеживание объекта FileSystemEntity на предмет изменений.
Операторы
-
operator ==(
Object other) → bool унаследованно - Оператор равенства.
Статические свойства
-
isWatchSupported → bool
только для чтения
- Проверить, поддерживается ли watch на текущей системе.
Статические методы
-
identical(
String path1, String path2) → Future< bool> - Проверяет, ссылаются ли два пути на один и тот же объект в файловой системе.
-
identicalSync(
String path1, String path2) → bool - Синхронно проверяет, ссылаются ли два пути на один и тот же объект в файловой системе.
-
isDirectory(
String path) → Future< bool> - Является ли
pathкаталогом. -
isDirectorySync(
String path) → bool - Синхронно проверяет, является ли
pathкаталогом. -
isFile(
String path) → Future< bool> - Является ли
pathфайлом. -
isFileSync(
String path) → bool - Синхронно проверяет, является ли
pathфайлом. -
isLink(
String path) → Future< bool> - Является ли
pathссылкой. -
isLinkSync(
String path) → bool - Синхронно проверяет, является ли
pathссылкой. -
parentOf(
String path) → String - Родительский путь для данного пути.
-
type(
String path, {bool followLinks = true}) → Future< FileSystemEntityType> - Определяет тип объекта файловой системы, на который указывает путь.
-
typeSync(
String path, {bool followLinks = true}) → FileSystemEntityType - Синхронно определяет тип объекта файловой системы, на который указывает путь.
© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-io/FileSystemEntity-class.html