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