GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Config::Setting(3) User Contributed Perl Documentation Config::Setting(3)

Config::Setting - Perl extension for configuration files.

  use Config::Setting;
  my $stg = Config::Setting->new;
  $stg->get("section", "key");

This module provides an OO interface to a file full of settings. Settings are assumed to be contained in collections (known as "sections"). Each setting has a key and a value. The value of a setting may refer to other settings using a similiar syntax to variables in perl.

Whilst this module can be used directly it is anticipated that it will be subclassed. This way policy regarding the location and layout of the settings can be determined for your project.

new ( )
The constructor. Takes no arguments.
is_configured ( )
Returns true if more than one configuration file has been found and read.
provider ( )
Returns an object which can be used to collect the contents of files. The default returns a Config::Setting::FileProvider object. You probably want to override this method when you set up your subclass, in order to set the policy for file locations.
parser ( )
Returns a parser object. The default is the Config::Setting::IniParser object. You may want to override this in a subclass if you wish to use an alternative format for your configuration files.
sections ( )
Return a list of which sections are available from this object.
keylist ( SECTION )
Return a list of keys that SECTION contains.
has ( SECTION, KEY )
Returns true if SECTION contains KEY.
expand ( )
Internal use only.
get ( SECTION, KEY )
Return the value of KEY in SECTION. If the value contains any variables of the form ${word}, they will be fully expanded in the return value.

When trying to replace a variable "word", first, "word" will be looked up as a key in the current section. If not found, it will then be looked up sequentially in all the other sections. If still not found, it will be replaced with an empty string.

Expansion is recursive, so an expanded variable can contain other variables.

It would be useful to know where each setting derived from, in order to help debugging.

Dominic Mitchell, <cpan (at) happygiraffe.net>

Config::Setting::FileProvider, Config::Setting::IniParser, Config::Setting::XMLParser.
2022-04-09 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.