HOD Text Processor - Команды языка.

FTPsaveF @имя_файла , @источник , $смещение_от_начала

Сохранение данных из источника в файл на сервере.


Модифицирует регистр $F:
$F=0 Успешно
$F=1 Ошибка в пути (некорректные символы или путь отсутствует)
$F=2 Управляющее соединение потеряно или не соединено с сервером
$F=3 Нет места для сохранения файла на дисках сервера
$F=4 Не могу создать такой файл на сервере
$F=5 Ошибка передачи данных


Использует значение регистра $N.
В соответствии с значением в регистре $N расставляется код переноса строк:
$N=0 Unix[0a]
$N=1 Dos[0d0a]
$N=2 Zx[0d]
$N=3 Сохранять в виде "как есть"


Исключения при выполнении:

Если Ваш компьютер не содержит библиотеки WINSOCK32.DLL или эта библиотека не была успешно загружена и инициализирована, то команда игнорируется модификация $F не производится.

Если файл существует, то его содержимое безоговорочно заменяется.

Если смещение равно 0, то команды необходимые для позиционирования файла, серверу не отправляются, следовательно, если ваш FTP не поддерживает доступ к файлу с произвольной позиции, то используйте смещение равное 0.

Если указано $смещение_от_начала больше реальной длины файла, то файл будет дополнен нулями до необходимой длины, а после произведена запись данных. Таким образом если мы имели файл длиной 20 байт, установили смещение 100 и записали 5 байт, то мы получим файл содержаший 20 оригинальных байт + 80 байт нулей + 5 байт новых данных. Эту работу выволняет FTP сервер по умолчанию.

Примечание:
Потеря управляющего соединения равноценна выполненной команде FTPdisconnect выполнение FTP команд после этого невозможно и требуется соединиться вновь (FTPconnect).

Допустимо указывать как полный путь к имени файла, так и путь относительно рабочего каталога на сервере (заданого командой FTPcwd).

Необходимо помнить, что для операционных систем WINDOWS путь указывается в виде:

c:\info\image\logo.jpg
image\logo.jpg

а для операционных систем *NIX, под управлением которых работает большинство серверов в сети интернет, путь указывается в виде:

/info/image/logo.jpg
image/logo.jpg

---

Содержание