Приложения

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

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

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

А.5.32.18. Команда RDS_CSV_STRFROMFILE – считать строку из файла

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

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

  int iStrNum= …  // Номер строки-получателя в объекте
  BOOL bOk=rdsCommandObjectEx(Csv,RDS_CSV_STRFROMFILE,iStrNum,NULL);

Параметры и результат

Csv (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с CSV, ранее созданного функцией rdsCSVCreate.
iStrNum (int): Номер, под которым считанная из файла строка будет записана в объект (строки нумеруются начиная с нуля).
bOk (BOOL): Результат чтения: TRUE – строка считана, FALSE – произошла ошибка.

Примечания

Эта команда считывает из ранее открытого командой RDS_CSV_OPENFILEREAD файла очередную строку (то есть последовательность символов до кода перевода строки или, если его нет, до конца файла), разбирает эту строку на элементы и записывает ее в объект Csv под номером iStrNum. Если строка с этим номером уже есть в объекте, она заменяется на считанную. Если строки с этим номером нет, она добавляется. Чтобы узнать, удалось ли загрузить строку из файла, следует проверить результат возврата команды или выполнить команду RDS_CSV_FILEERROR.

Если на момент чтения строки общее число строк в объекте меньше iStrNum, текст в объекте автоматически дополняется пустыми строками. Например, если в объекте три строки (0, 1 и 2), и добавляется строка с номером 5, в объект дополнительно будут добавлены пустые строки с номерами 3 и 4.

Пример

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

См. также

rdsCSVCreate, rdsCommandObjectEx, RDS_CSV_OPENFILEREAD, RDS_CSV_CLOSEFILE, RDS_CSV_FILEERROR, RDS_CSV_STRTOFILE.