Prima::IniFile - support of Windows-like initialization files
The module provides mapping of a text initialization file to a two-level hash structure. The first level is sections, which groups the second level hashes, items. Sections must have unique keys. The values of the items hashes are arrays of text strings. The methods that operate on these arrays are get_values, set_values, add_values, and replace_values.
use Prima::IniFile; my $ini = create Prima::IniFile; my $ini = create Prima::IniFile FILENAME; my $ini = create Prima::IniFile FILENAME, default => HASHREF_OR_ARRAYREF; my $ini = create Prima::IniFile file => FILENAME, default => HASHREF_OR_ARRAYREF; my @sections = $ini->sections; my @items = $ini->items(SECTION); my @items = $ini->items(SECTION, 1); my @items = $ini->items(SECTION, all => 1); my $value = $ini-> get_values(SECTION, ITEM); my @vals = $ini-> get_values(SECTION, ITEM); my $nvals = $ini-> nvalues(SECTION, ITEM); $ini-> set_values(SECTION, ITEM, LIST); $ini-> add_values(SECTION, ITEM, LIST); $ini-> replace_values(SECTION, ITEM, LIST); $ini-> write; $ini-> clean; $ini-> read( FILENAME); $ini-> read( FILENAME, default => HASHREF_OR_ARRAYREF); my $sec = $ini->section(SECTION); $sec->{ITEM} = VALUE; my $val = $sec->{ITEM}; delete $sec->{ITEM}; my %everything = %$sec; %$sec = (); for ( keys %$sec) { ... } while ( my ($k,$v) = each %$sec) { ... }
Adds LIST of string values to the ITEM in SECTION.
Cleans all internal data in the object, including the name of the file.
Creates an instance of the class. The PROFILE is treated partly as an array, and partly as a hash. If PROFILE consists of a single item, the item is treated as a filename. Otherwise, PROFILE is treated as a hash, where the following keys are allowed:
Selects the name of the file.
Selects the initial values for the file, where VALUES is a two-level hash of sections and items. It is passed to read, where it is merged with the file data.
Returns an array of values for ITEM in SECTION. If called in scalar context and there is more than one value, the first value in the list is returned.
Returns items in SECTION. HINTS parameters are used to tell if a multiple-valued item must be returned as several items of the same name; HINTS can be supplied in the following forms:
items( $section, 1 ) items( $section, all => 1);
Same as create.
Returns the number of values in ITEM in SECTION.
Flushes the old content and opens a new file. FILENAME is a text string, PROFILE is a two-level hash of default values for the new file. PROFILE is merged with the data from the file, and the latter keeps the precedence. Does not return any success values but warns if any error is occurred.
Removes all values from ITEM in SECTION and assigns it to the new list of VALUES.
Returns a tied hash for SECTION. All its read and write operations are reflected in the caller object which allows the following syntax:
my $section = $inifile-> section( 'Sample section'); $section-> {Item1} = 'Value1';
which is identical to
$inifile-> set_items( 'Sample section', 'Item1', 'Value1');
Returns an array of section names.
Assigns VALUES to ITEM in SECTION. If the number of new values is equal to or greater than the number of the old, the method is the same as replace_values. Otherwise, the values with indices higher than the number of new values are not touched.
Rewrites the file with the object content. The object keeps an internal modification flag {changed}; in case it is undef, no actual write is performed.
{changed}
undef
Anton Berezin, <tobez@plab.ku.dk>
Dmitry Karasik <dmitry@karasik.eu.org>
To install Prima, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Prima
CPAN shell
perl -MCPAN -e shell install Prima
For more information on module installation, please visit the detailed CPAN module installation guide.