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

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.