| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== PUTINI (set INI file entry) ====== | [[put  re write record .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[putreg write value to windows registry .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

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

{{blk2blue.jpg|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  return ini file entry .htm|GETINI]]