Spec-Zone.ru › Kotlin 2

deleteRecursively

kotlin-stdlib/kotlin.io.path/deleteRecursively

Начиная с Kotlin: 1.8

@ExperimentalPathApi
fun Path.deleteRecursively()

Рекурсивно удаляет этот каталог и его содержимое. Обратите внимание, что если эта функция выбрасывает исключение, часть содержимого могла быть удалена.

Если элемент, расположенный по этому пути, является каталогом, эта функция рекурсивно удаляет его содержимое и сам каталог. В противном случае эта функция удаляет только элемент. Символические ссылки не переходят к целевым объектам. Эта функция ничего не делает, если элемент, расположенный по этому пути, не существует.

Если базовая платформа поддерживает SecureDirectoryStream, обход дерева файлов и удаление элементов выполняются с его помощью. В противном случае каталоги в дереве файлов открываются с помощью менее безопасного Files.newDirectoryStream. Обратите внимание, что на платформе, которая поддерживает символические ссылки, но не поддерживает SecureDirectoryStream, рекурсивное удаление может удалить файлы и каталоги за пределами удаляемого каталога. Это может произойти, если после проверки того, что элемент является каталогом (а не символической ссылкой), этот каталог заменяется символической ссылкой на внешний каталог до вызова, открывающего каталог для чтения его элементов.

Если при попытке прочитать, открыть или удалить какой-либо элемент в указанном дереве файлов возникает исключение, этот элемент пропускается, а выполнение продолжается. Такие исключения собираются, и после попытки удалить все элементы выбрасывается IOException, содержащий эти исключения в качестве подавленных исключений. Собирается не более 64 исключений. После достижения этого количества выбрасываемые исключения игнорируются и не собираются.

Исключения

IOException

если какой-либо элемент в дереве файлов не удаётся удалить по любой причине.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.io.path/delete-recursively.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API