Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.32. Вспомогательный объект для работы с форматом CSV

А.5.32.12. Команда RDS_CSV_LOADFROMFILE – загрузить текст из файла

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.32. Вспомогательный объект для работы с форматом CSV

##### А.5.32.12. Команда RDS_CSV_LOADFROMFILE – загрузить текст из файла

Команда RDS_CSV_LOADFROMFILE загружает в указанный объект текст из файла с указанным именем.

Вызов команды

      RDSCSTR sFileName= …  // Имя файла (UTF8)
      rdsSetObjectStrA(Csv,RDS_CSV_LOADFROMFILE,0,sFileName);

или

      RDSWCSTR sFileName= …  // Имя файла (UTF16)
      rdsSetObjectStrW(Csv,RDS_CSV_LOADFROMFILE,0,sFileName);

или (через функцию-псевдоним)

      RDSXCSTR sFileName= …  // Имя файла (кодировка по умолчанию)
      rdsSetObjectStr(Csv,RDS_CSV_LOADFROMFILE,0,sFileName);

Параметры

Csv(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для работы с CSV, ранее созданного функцией rdsCSVCreate.
sFileName(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с именем файла, из которого нужно загрузить текст. Имя файла может содержать символические обозначения стандартных папок RDS. Если в имени файла нет пути, он будет считаться находящимся в одной папке с загруженной схемой.

Примечания

Эта команда загружает в объект Csv весь текст из файла sFileName и разбирает его на отдельные строки и элементы. После этого к элементам текста можно обращаться при помощи функции rdsCSVGetItem. Для получения общего числа строк в загруженном тексте следует использовать команду RDS_CSV_LINECOUNT, для получения общего (максимального) числа элементов в строках – команду RDS_CSV_MAXCOLUMNS.

В команде RDS_CSV_LOADFROMFILE не предусмотрен возврат результата операции, поэтому для того, чтобы узнать, удалось ли загрузить текст из файла, следует выполнить команду RDS_CSV_FILEERROR.

См. также

rdsCSVCreate, rdsSetObjectStr, rdsCSVGetItem, RDS_CSV_LINECOUNT, RDS_CSV_MAXCOLUMNS, RDS_CSV_FILEERROR, RDS_CSV_TEXT.