Сканкод · дистрибьютор в РФ и СНГМетод .rename
| Назначение: | Переименовывает файл, заданный по имени. |
| Синтаксис: | fd.create(byref old_name as string, byref new_name as string) as pl_fd_status_codes |
| Возвращает: | Один из следующих pl_fd_status_codes; значение также влияет на fd.laststatus: 0 - PL_FD_STATUS_OK: выполнено успешно. 1 - PL_FD_STATUS_FAIL : сбой физической флеш-памяти (критический). 2 - PL_FD_STATUS_CHECKSUM_ERR: в одном из секторов диска обнаружена ошибка контрольной суммы (критическая). 4 - PL_FD_STATUS_INV_PARAM: old_name - пустая (NULL) строка, что недопустимо. 5 - PL_FD_STATUS_DUPLICATE_NAME: файл с именем new_name уже существует. 8 - PL_FD_STATUS_NOT_READY: диск не смонтирован. 9 - PL_FD_STATUS_NOT_FOUND: файл old_name не найден. 14 - PL_FD_STATUS_TRANSACTION_CAPACITY_EXCEEDED: в ходе текущей транзакции изменено слишком много секторов диска (критическая ошибка). |
| См. также: | Создание, удаление и переименование файлов, Имена и атрибуты файлов, fd.create, fd.delete, fd.getnumfiles, fd.maxstoredfiles |
| Часть | Описание |
| old_name | Строка (1-56 символов) с именем переименовываемого файла. Все символы после первого встретившегося пробела (не считая начальных пробелов) игнорируются. Имена файлов чувствительны к регистру. |
| new_name | Строка (1-56 символов) с новым именем файла. Все символы после первого встретившегося пробела (не считая начальных пробелов) игнорируются. |
Подробности
При переименовании файла его атрибуты сохраняются.
Метод изменяет секторы флеш-диска. Для максимальной надёжности вызывайте его в рамках дисковых транзакций.