inifile-set


Synopsis

(inifile-set <section> <entry> <string> <filename> )

Description

Replaces or adds an entry to the specified section in the Windows-style initialization (.INI) file.

The initialization file must have the following form:

[section]

entry=string

.

.

Example

(inifile-set "drawings" "dwg1" "dwg1.dwg" (findfile "dwg.ini")) 
=> "C:\\DRAWINGS\\DWG.INI"

This is the same as the doslib 1.4 functions (dos_setini). 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. The section does not need to exist. Case-independant

entry: A string. The entry does not need to exist. Case-independant

string: The new value of an entry.

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

Return Value

The filename or nil on any error.

Side Effects

None, besides opening, changing and closing a text file.

Module

(std-require 'INIFILE)

Defined in INIFILE