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

FTPloadF @приёмник , @имя_файла , $смещение_от_начала

Загрузка содержимого файла на сервере, в регистр приёмник.


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


Модифицирует регистр $N если $N не равен 3:
$N=0 загружен текст с переносом строки Unix[0a]
$N=1 загружен текст с переносом строки Dos[0d0a]
$N=2 загружен текст с переносом строки Zx[0d]

Если регистр $N=3 то приведение к *NIX стандарту не производится, данные из файла помещается в регистр в виде "как есть", модификация $N не производится.

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

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

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

Если указано $смещение_от_начала больше реальной длины файла то в зависимости от типа вашего FTP сервера вы либо получите ошибку $F=4, либо будет прочитана пустая строка.

Если в качестве имени файла указана строка не являющаяся именем файла или обнаружены иные ошибки, то в приёмник помещается пустая строка.

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

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

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

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

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

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

---

Содержание