dart:io

Класс FileSystemEntity (абстрактный)

Общий базовый класс для объектов File, Directory и Link.

Объекты FileSystemEntity возвращаются в результате операций перечисления каталога. Чтобы определить, является ли объект FileSystemEntity объектом File, Directory или Link, выполните проверку типа:

if (entity is File) (entity as File).readAsStringSync();

Также вы можете использовать методы type или typeSync, чтобы определить тип объекта файловой системы.

Большинство методов в этом классе имеют синхронные и асинхронные пары, например, exists и existsSync. Если у вас нет конкретной причины использовать синхронную версию метода, предпочитайте асинхронную версию, чтобы избежать блокировки вашей программы.

Вот метод exists в действии:

entity.exists().then((isThere) {
  isThere ? print('exists') : print('non-existent');
});

Другие ресурсы

• Dart by Example предоставляет дополнительные примеры кода, ориентированные на задачи, которые демонстрируют, как использовать различные API из класса Directory и класса File, являющихся подклассами FileSystemEntity.

• Ввод/вывод для командных приложений, раздел из Путеводитель по библиотекам Dart, посвящен файлам и каталогам.

• Создание командных приложений, учебник по написанию командных приложений, содержит информацию о файлах и каталогах.

Реализуется в

• Directory
• File
• Link

Статические свойства

isWatchSupported → bool

только для чтения

Проверяет, поддерживается ли watch в текущей системе.

Статические методы

identical(String path1, String path2) → Future<bool>

Проверяет, ссылаются ли два пути на один и тот же объект в файловой системе. Возвращает Future<bool>, который завершается результатом.

identicalSync(String path1, String path2) → bool

Синхронно проверяет, ссылаются ли два пути на один и тот же объект в файловой системе.

isDirectory(String path) → Future<bool>

Проверяет, является ли тип(path) типом FileSystemEntityType.DIRECTORY.

isDirectorySync(String path) → bool

Синхронно проверяет, является ли типSync(path) типом FileSystemEntityType.DIRECTORY.

isFile(String path) → Future<bool>

Проверяет, является ли тип(path) типом FileSystemEntityType.FILE.

isFileSync(String path) → bool

Синхронно проверяет, является ли типSync(path) типом FileSystemEntityType.FILE.

isLink(String path) → Future<bool>

Проверяет, является ли тип(path, followLinks: false) типом FileSystemEntityType.LINK.

isLinkSync(String path) → bool

Синхронно проверяет, является ли типSync(path, followLinks: false) типом FileSystemEntityType.LINK.

parentOf(String path) → String

Удаляет последнюю компоненту пути, используя разделитель пути платформы для разделения пути. Не удаляет корневую компоненту пути Windows, такие как «C:\» или «\\server_name\». Игнорирует заключительные разделители путей и не оставляет заключительных разделителей путей.

type(String path, { bool followLinks: true }) → Future<FileSystemEntityType>

Определяет тип объекта файловой системы, на который указывает путь. Возвращает Future<FileSystemEntityType> , который завершается результатом.

typeSync(String path, { bool followLinks: true }) → FileSystemEntityType

Синхронно определяет тип объекта файловой системы, на который указывает путь. Возвращает FileSystemEntityType.

Конструкторы

FileSystemEntity()

Свойства экземпляра

absolute → FileSystemEntity

только для чтения

Возвращает FileSystemEntity с путем, являющимся абсолютным путем к this. Тип возвращённого экземпляра — тип this.

isAbsolute → bool

только для чтения

Возвращает bool, указывающий, является ли путь этого объекта абсолютным.

parent → Directory

только для чтения

Каталог, содержащий this.

path → String

только для чтения

uri → Uri

только для чтения

Возвращает Uri, представляющий расположение сущности файловой системы.

hashCode → int

только для чтения, унаследованное

Хеш-код для этого объекта.

runtimeType → Type

только для чтения, унаследованное

Представление реального типа объекта.

Операторы

operator ==(other) → bool

унаследованное

Оператор равенства.

Методы экземпляра

delete({bool recursive: false }) → Future<FileSystemEntity>

Удаляет этот объект FileSystemEntity.

deleteSync({bool recursive: false }) → void

Синхронно удаляет этот объект FileSystemEntity.

exists() → Future<bool>

Проверяет, существует ли сущность файловой системы с этим путем. Возвращает Future<bool>, который завершается результатом.

existsSync() → bool

Синхронно проверяет, существует ли сущность файловой системы по этому пути.

rename(String newPath) → Future<FileSystemEntity>

Переименовывает этот объект файловой системы. Возвращает Future<FileSystemEntity>, который завершается объектом FileSystemEntity для переименованной сущности файловой системы.

renameSync(String newPath) → FileSystemEntity

Синхронно переименовывает этот объект файловой системы. Возвращает объект FileSystemEntity для переименованной сущности.

resolveSymbolicLinks() → Future<String>

Разрешает путь объекта файловой системы относительно текущей рабочей директории, разрешая все символические ссылки в пути и разрешая все .. и . сегменты пути.

resolveSymbolicLinksSync() → String

Разрешает путь объекта файловой системы относительно текущей рабочей директории, разрешая все символические ссылки в пути и разрешая все .. и . сегменты пути.

stat() → Future<FileStat>

Вызывает функцию stat() операционной системы для пути path этого объекта FileSystemEntity. Идентично FileStat.stat(this.path).

statSync() → FileStat

Синхронно вызывает функцию stat() операционной системы для пути path этого объекта FileSystemEntity. Идентично FileStat.statSync(this.path).

watch({int events: FileSystemEvent.ALL, bool recursive: false }) → Stream<FileSystemEvent>

Начинает наблюдение за объектом FileSystemEntity для изменений.

noSuchMethod(Invocation invocation) → dynamic

inherited

Вызывается, когда обращаются к несуществующему методу или свойству.

toString() → String

inherited

Возвращает строковое представление этого объекта.