inifile-get


Synopsis

(inifile-get <section> <entry> <filename>)

Description

Returns a string from the entry under the specified section in the Windows-style initialization (.INI) file.

The initialization file must have the following form:

[section]

entry=string

.

.

Example

(inifile-get "drawings" "dwg1" (findfile "dwg.ini")) 
=> "DWG1.DWG"

This is the same as the doslib 1.4 functions (dos_getini). Its actual implementation might even call the external library DOSLIB.

Note:

Since R14 inifile-like sections are stored in the Windows registry, which is faster, but inifiles are easily copied.

Note:

R14 introduced two new functions (getcfg) and (setcfg) to store values in the INI file-alike ACAD.CFG or ACADNT.CFG. (inifile-set) and (inifile-get) should also work with this CFG files.

Arguments

section: A string without the enclosing brackets. Case-independant

entry: A string. The left side on a line below a section. Case-independant

filename: The fully qualified filename of a textfile. (findfile) is not used.

Return Value

A string associated with the entry or

nil if not found or on any error.

Side Effects

None, besides opening and closing a text file.

Module

(std-require-external 'BINIO)

Defined in INIFILE