Функция ПОЛУЧИТЬ_ФАЙЛ
Функция ПОЛУЧИТЬ_ФАЙЛ позволяет обратиться к удаленному серверу с запросом по протоколу http или ftp.
ФУНКЦИЯ ЦЕЛОЕ: ПОЛУЧИТЬ_ФАЙЛ(СТРОКА: url;
СТРОКА: имя_файла;
ОПЦИИ_ПОЛУЧЕНИЯ_ФАЙЛА: опции)
Параметры
- url
- Строка запроса. В этой строке передаются тип протокола, расположение сервера, запрашиваемый файл и параметры запроса.
- имя_файла
- Имя файла для сохранения. Файл создается в текущей папке. Для сохранения в другом месте необходимо указать полный путь. Существующий файл по этому пути перезаписывается.
- опции
- Дополнительные параметры, задаются значением типа ОПЦИИ_ПОЛУЧЕНИЯ_ФАЙЛА. Указание параметров формы позволяет выполнять запрос POST протокола http.
Возвращаемое значение
Функция возвращает числовой код:
| -1 | – | не найдена необходимая библиотека gnet3.dll; |
| 0 | – | получение файла выполнено успешно; |
| 1 | – | сервер/файл не найден или ошибка в сети или еще какая-то ошибка; |
| 2 | – | ошибка разбора строки URL; |
| 3 | – | ошибка создания локального файла; |
| 4 | – | передача файла отменена; |
| 5 | – | превышен таймаут соединения или получения порции данных; |
| 7 | – | отсутствует соединение с интернетом. |
Пример:
ПЕРЕМ ОПЦИИ_ПОЛУЧЕНИЯ_ФАЙЛА: опции
опции.бинарный = НЕТ
опции.игнорировать_кэш = ДА
ПЕРЕМ ЧИСЛО: рез = ПОЛУЧИТЬ_ФАЙЛ (
"http://www.cbr.ru/scripts/XML_daily.asp?date_req=16/10/2006",
"today_currency.xml",
опции )
ЕСЛИ рез = 0 ТО
// данные получены и сохранены в файл "today_currency.xml"
// …
КОНЕЦ_ЕСЛИ