IniParser

function readFile()

Read the contents of an INI file into a two-dimensional array.  This method preserves comments in the file.

function getFile()

Serializes the INI file into a string.

Returns

The INI file structure as a string that can be written to a file.

function writeFile( $file  =  false )

Write the INI file back to the disk.

Parameters

Returns

True if the write succeeds, false otherwise.

function value( $sec,    $var  =  false, $default  =  false )

Get a value from the INI file.

Parameters

Takes up to three parameters.  If one parameter is given, then it is interpreted as a key in the current section (last section accessed).  If two are given, the first is a section and the second is a key.  If three, then the first is the section, the second is the key, and the third is a default value if the key is not set.

Returns

A string containing the value of the given key, or the default value.

function valueIsSet( $sec,    $var  =  false )

Determine if a particular key has been set.

Parameters

This can take one or two parameters.  If one is given, it is a key in the current section.  If two, the first is a secion and the second is a key.

Returns

True if the given key has been set, false otherwise.

function setValue ( $sec,    $var,    $val  =  false )

Sets a value for a key.

Parameters

Takes two or three parameters.  If two, then the first is a key in the current section and the second is a value.  If three, then the first is a section, the second a key, and the third the value.

Returns

The value to which the key was set.

function getSection( $sec )

Returns the given section as an array.  Removes any comments from that section of the file.

Parameters

Returns

An array of the section with variables as keys and values as elements.

function getSectionNames()

Gets a list of the section names available in the file.

Returns

An array of strings, each of which is the name of a section.

function merge( $file )

Merge another INI file into the current one.  If a key from the other file is not set, it will be set with the value from the other file.  Keys that are already set will not be modified.

Parameters