Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла
А.5.27.14. Команда RDS_HINI_LOADFILE – загрузить текст из файла
Команда RDS_HINI_LOADFILE загружает в объект текст из файла с указанным именем.
Вызов команды
RDSSTR strFileName= … // Имя файла (UTF8) rdsSetObjectStrA(Ini,RDS_HINI_LOADFILE,0,strFileName);
или
RDSWSTR strFileName= … // Имя файла (UTF16) rdsSetObjectStrW(Ini,RDS_HINI_LOADFILE,0,strFileName);
или (через функцию-псевдоним)
RDSXSTR strFileName= … // Имя файла (кодировка по умолчанию) rdsSetObjectStr(Ini,RDS_HINI_LOADFILE,0,strFileName);
Параметры и результат
- Ini (RDS_HOBJECT)
- Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
- strFileName (RDSSTR, RDSWSTR, RDSXSTR)
- Указатель на строку, в которой записано имя файла, из которого нужно загрузить текст. Имя файла может содержать как полный путь, так и сокращенный с символическими обозначениями стандартных путей.
Примечания
Эта команда загружает в объект текст из файла с указанным именем. Успешность загрузки можно узнать, выполнив команду RDS_HINI_GETLASTERROR.
Пример
Пример использования команды RDS_HINI_LOADFILE приведен в §3.2 руководства программиста.
См. также
rdsINICreateTextHolder, rdsSetObjectStr, RDS_HINI_SAVEFILE, RDS_HINI_SETTEXT, RDS_HINI_GETLASTERROR.