iniobj=new("inifile"[,filename$])
This class manages sections and items in a text file in "ini" format, where sections in the file have a [name] header, and items are stored in name=value lines. The ini file format is common in many applications, including UnForm. Both the uf101d.ini and ufparam.txt file use this format.
If filename$ does not exist and not null, it is interpreted as a string version of INI file content. It must have headers and name=value pairs under those headers. You can use \n sequences to represent line feeds, and \\ to represent backslashes.
If filename$ is not provided, a temporary file is created that is erased when the object is destroyed.
Properties
content$ is the read-only content of the entire file.
|
filename$ is the read-only name of the file being managed.
|
Methods
getitem$(section$,name$) returns the value of the named line in the named section.
|
getitems$(section$) returns a line-feed delimited list of item names in the named section.
|
getname$(section$,value$) returns the first name in the section that has the value specified.
|
getnames$(section$) returns a list of names in a section, delimited by linefeeds ($0A$).
|
getsection$(section$[,alltext]) returns all lines in the section, delimited by linefeeds ($0A$). If alltext is supplied and true (non-zero), then all lines, including blank and comment lines, are included.
|
putitem(section$,name$,value$) replaces or adds a line in the section, in name=value format.
|
putsection(section$,lines$) replaces or adds an entire section with the contents of lines$, which should be a series of name=value lines separated by linefeeds ($0A$).
|
removeitem(section$,name$) removes the line identified by name$ from section$
|
removesection(section$) removes the entire section.
|
|