Приложения

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

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

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

А.5.32.14. Команда RDS_CSV_OPENFILEREAD – открыть файл для чтения

Команда RDS_CSV_OPENFILEREAD открывает указанный файл для чтения из него строк в объект при помощи команды RDS_CSV_STRFROMFILE.

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

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

или

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

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

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

Параметры

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

Примечания

По этой команде объект Csv открывает файл sFileName для построчного чтения командой RDS_CSV_STRFROMFILE. При обработке файлов большого размера такой режим может оказаться удобнее, чем загрузка всего файла в память командой RDS_CSV_LOADFROMFILE.

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

Пример

Пример использования этой команды приведен в §2.16.2 руководства программиста.

См. также

rdsCSVCreate, rdsSetObjectStr, RDS_CSV_CLOSEFILE, RDS_CSV_STRFROMFILE, RDS_CSV_FILEISOPEN, RDS_CSV_FILEERROR, RDS_CSV_LOADFROMFILE, RDS_CSV_OPENFILEWRITE.