Приложения

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

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

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

А.5.32.15. Команда RDS_CSV_OPENFILEWRITE – открыть файл для записи

Команда RDS_CSV_OPENFILEWRITE открывает указанный файл для записи в него строк при помощи команды RDS_CSV_STRTOFILE.

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

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

или

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

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

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

Параметры

Csv (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с CSV, ранее созданного функцией rdsCSVCreate.

sFileName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем файла. Имя файла может содержать символические обозначения стандартных папок RDS. Если в имени файла нет пути, он будет создан в одной папке с загруженной схемой.

Примечания

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

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

См. также

rdsCSVCreate, rdsSetObjectStr, RDS_CSV_CLOSEFILE, RDS_CSV_STRTOFILE, RDS_CSV_FILEISOPEN, RDS_CSV_FILEERROR, RDS_CSV_SAVETOFILE, RDS_CSV_OPENFILEREAD.