Клиппер 5. Справочник

Функция переименовывает файл, возвращая код


                                файл с таким именем уже существует)
    -17 ER_DIFFERENT_DEVICE     Расположение выходного файла задано
                                в другой сети
    --------------------------------------------------------------------
 
  Описание
 
     Функция переименовывает файл, возвращая код результата. Это позволяет
    организовать обработку ошибочных ситуаций, возникающих при
    переименовании файла, например, на сетевом устройстве при
    одновременном открытии его другим пользователем.
 
  Примечания


 
  . Не допускается использование в параметрах универсальных символов
    сопоставления для задания групповых имен.
 
  . При задании параметром <cTargetFile> пути доступа и/или имени
    диска, отличающихся от заданных параметром <cSourceFile>, функция
    производит не переименование, а перемещение файла.
 
  Примеры
 
  . Переименование файла "OLD" на "NEW"
 
    IF RENAMEFILE("OLD", "NEW") = 0
        ? "Файл переименован!"
    ENDIF
 
  . Использование пути доступа переименовываемого файла для выходного:
 
    cFSpecOld := "C:\TEST\TEST.TXT"
    cFileName := TOKEN(cFSpecOld, ":\")         // Последний элемент
    cFSpecNew := BEFOREATNUM(cFileName, cFSpecOld) + "TEST.NEW"
    RENAMEFILE(cFSpecOld, cFSpecNew)
 

See Also: DELETEFILE()

 

 

 RESTFSEEK()
 Восстанавливает сохраненную ранее среду функции FILESEEK().
------------------------------------------------------------------------------
 
  Синтаксис
 
    RESTFSEEK(<cFileSeekEnvironment>) --> cNull
 
  Параметры
 
    <cFileSeekEnvironment> - символьная строка, содержащая среду,
    установленную функцией FILESEEK() и сохраненную функцией SAVEFSEEK().
 
  Возвращаемое значение
 
    cNull - всегда пустая строка.
 
  Описание

Содержание раздела