User Tools

Site Tools

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

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


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]


next entry=another value

For example, WIN.INI contains entries such as:






sCountry=United States


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.



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

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

See Also:


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