Latest revision as of 20:32, 7 June 2024

The /writeini command is used to write and update a standard initialization file.

Overview[edit]

The Standard INI file has the following format:

[Section]
Item=value
Item2=value
;some comment
[Section2]
Item=value
Item2=value

Note:

For mIRC <= 6.35: Writing to a file bigger than 64KB requires the -n switch, otherwise an error will be generated, halting the script. (This is a limitation of the standard Win32 API GetPrivateProfileString() and WritePrivateProfileString())

For mIRC >= 7.00: mIRC now uses its own custom INI routine, the -n switch is obsolete.

Synopsis[edit]

/writeini [-nz] <inifile> <section> <item> <value>

Switches[edit]

• -n - Forces mIRC to write to an INI file, even if it's bigger then 64k (see note above)
• -z - Write an empty value

Parameters[edit]

• <inifile> - The filename to write to
• <section> - Section name
• <item> - Item name
• <value> - The data to store for the item

Example[edit]

;Write a few items to a file
/writeini abb.ini abbreviations lol Laughing Out Loud
/writeini abb.ini abbreviations rofl Rolling On the Floor, Laughing
 
/*
abb.ini format:

[abbreviations]
lol=Laughing Out Loud
rofl=Rolling On the Floor, Laughing
*/
 
;Retrieve 'lol'
//echo -a $readini(abb.ini, n, abbreviations, lol)
 
;Prints out: Laughing Out Loud

Compatibility[edit]

Added: mIRC v4.5
Added on: 30 Jun 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also[edit]

• List of commands
• List of identifiers

• /remini
• $readini
• $ini
• $mircini