User Tools

Site Tools


putini_set_ini_file_entry_.htm
Navigation:  Language Reference > 13 - Built-in Functions >====== PUTINI (set INI file entry) ====== Previous pageReturn to chapter overviewNext page

PUTINI( section [,entry] [,value] [,file] )

blk2blue.jpg

PUTINI Sets the value for an INI file entry.
section A string constant or variable containing the name of the portion of the INI file which contains the entry.
entry A string constant or variable containing the name of the specific entry to set. If this parameter is omitted, the entire section, including all entries within the section, is deleted.
value A string constant or variable containing the setting to place in the entry (up to 1023 characters). An empty string ('') leaves the entry empty. If omitted, the entry is deleted.
file A string constant or variable containing the name of the INI file to search. A file name without a full path (e.g. 'Autolog.ini') looks for the file in the Windows directory. To look for the file in the current directory enter a dot path (e.g. '.\Autolog.ini'). If the file doesn't exist, a new .INI file is created. If omitted, PUTINI places the entry in the WIN.INI file.

The PUTINI procedure places the value into an entry in a Windows-standard .INI file (maximum size of the file is 64K). A Windows-standard .INI file is an ASCII text file with the following format:

[some section name]

entry=value

next entry=another value

For example, WIN.INI contains entries such as:

[windows]

spooler=yes

load=nwpopup.exe

[intl]

sLanguage=enu

sCountry=United States

iCountry=1

The PUTINI procedure searches the specified file for the entry within the section you specify. It replaces the current entry value with the value you specify. If necessary, the section and entry are created.

Example:

CODE

PUTINI('MyApp','SomeSetting','Initialized')   !Place setting in WIN.INI

PUTINI('MyApp','ASetting','2','MYAPP.INI')    !Place setting in MYAPP.INI

See Also:

GETINI

putini_set_ini_file_entry_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)