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