Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла
Описываются функции и команды вспомогательного объекта RDS, предназначенного для разбора и формирования текста в стандартном формате INI-файлов Windows.
А.5.27.1. rdsINICreateTextHolder – создать объект для работы с текстом
Функция rdsINICreateTextHolder создает вспомогательный объект RDS, с помощью которого можно работать с текстом, хранящим значения различных параметров в формате INI-файлов Windows, то есть в виде «имя=значение».
RDS_HOBJECT RDSCALL rdsINICreateTextHolder( BOOL IgnoreCase // Без учета регистра );
Тип указателя на эту функцию
RDS_HoB
Параметр
- IgnoreCase (BOOL)
- TRUE – искать в тексте названия параметров и секций без учета регистра символов, FALSE – с его учетом.
Возвращаемое значение
Уникальный идентификатор созданного объекта (RDS_HOBJECT).
Примечания
Эта функция создает вспомогательный объект для работы с текстом и возвращает его идентификатор типа RDS_HOBJECT. Текст, с которым работает этот объект, разделен на секции, каждая из которых начинается с названия секции на отдельной строке в квадратных скобках. Внутри секции каждая строка имеет вид «имя=значение». Например, текст
[Section1] var1=value1 var2=0 [OtherSection] var1=текстовая строка var3=10
состоит из двух секций «Section1» и «OtherSection», в первой из которых записаны значения параметров «var1» и «var2», во второй – «var1» и «var3» (при этом «var1» в разных секциях имеет разное значение). С помощью различных сервисных функций RDS (как общих для всех типов вспомогательных объектов, так и специализированных для данного) в этот объект можно записывать значения параметров и считывать их из него, создавать и удалять секции и т.п. Объект может загружать текст из файла и записывать его в файл, а также передавать текст в RDS для использования его в качестве сохраняемых параметров блока при реакции на событие RDS_BFM_SAVETXT.
Если в параметре IgnoreCase передано значение TRUE, при поиске в тексте названий секций и параметров объект не будет учитывать регистр символов – например, секции «SECTION» и «Section» будут считаться совпадающими.
Созданный вспомогательный объект будет существовать до тех пор, пока схема не будет выгружена из памяти, или пока он не будет удален вызовом функции rdsDeleteObject.
Пример
Примеры использования функции rdsINICreateTextHolder приведены в руководстве программиста: §2.8.5, §3.2 и др.
См. также