config::model::listid(3pm) [debian man page]

Config::Model::ListId(3pm)				User Contributed Perl Documentation				Config::Model::ListId(3pm)

NAME

       Config::Model::ListId - Handle list element for configuration model

VERSION

       version 2.021

SYNOPSIS

       See "SYNOPSIS" in Config::Model::AnyId

DESCRIPTION

       This class provides list elements for a Config::Model::Node.

CONSTRUCTOR

       ListId object should not be created directly.

List model declaration
       See model declaration section from Config::Model::AnyId.

Methods
   get_type
       Returns "list".

   fetch_size
       Returns the number of elements of the list.

   load(string, [ check => 'no' ] )
       Store a set of values passed as a comma separated list of values.  Values can be quoted strings. (i.e ""a,a",b" will yield "('a,a', 'b')"
       list).

       "check" can be yes, no or skip

   store_set( ... )
       Store a set of values (passed as list)

       If tinkering with check is required, use the following way :

	store_set ( @v , check => 'skip' );

   move ( from_index, to_index, [ check => 'no' )
       Move an element within the list. "check" can be 'yes' 'no' 'skip'

   push( value1, [ value2 ... ] )
       push some values at the end of the list.

   push_x ( values => [ v1','v2', ...] , [ ... ] )
       Like push with extended options. Options are:

       check
	   Check value validaty. Either "yes" (default), "no", "skip"

       values
	   Values to push (array_ref)

       value
	   Single value to push

       annotation

   store
       Equivalent to push_x. This method is provided to help write configuration parser, so the call is the same when dealing with leaf or list
       values. Prefer "push_x" when practical.

       check
	   "yes", "no" or "skip"

       annotation
	   list ref of annotation to store with the list values

       Example:

	$elt->push_x (
	   values => [ v1','v2' ] ,
	   annotation => [ 'v1 comment', 'v2 comment' ],
	   check => ''skip'
	);

   swap ( "ida" , "idb" )
       Swap 2 elements within the array

   remove ( "idx" )
       Remove an element from the list. Equivalent to "splice @list,$idx,1"

   load_data ( array_ref | data )
       Clear and load list from data contained in the array ref. If a scalar or a hash ref is passed, the list is cleared and the data is stored
       in the first element of the list.

AUTHOR

       Dominique Dumont, (ddumont at cpan dot org)

SEE ALSO

       Config::Model::Model, Config::Model::Instance, Config::Model::AnyId, Config::Model::HashId, Config::Model::Value

perl v5.14.2							    2012-11-09						Config::Model::ListId(3pm)

Check Out this Related Man Page

Config::Model::HashId(3pm)				User Contributed Perl Documentation				Config::Model::HashId(3pm)

NAME

       Config::Model::HashId - Handle hash element for configuration model

VERSION

       version 2.021

SYNOPSIS

       See "SYNOPSIS" in Config::Model::AnyId

DESCRIPTION

       This class provides hash elements for a Config::Model::Node.

       The hash index can either be en enumerated type, a boolean, an integer or a string.

CONSTRUCTOR

       HashId object should not be created directly.

Hash model declaration
       See model declaration section from Config::Model::AnyId.

Methods
   get_type
       Returns "hash".

   fetch_size
       Returns the number of elements of the hash.

   firstkey
       Returns the first key of the hash. Behaves like "each" core perl function.

   nextkey
       Returns the next key of the hash. Behaves like "each" core perl function.

   swap ( key1 , key2 )
       Swap the order of the 2 keys. Ignored for non ordered hash.

   move ( key1 , key2 )
       Rename key1 in key2.

   move_after ( key_to_move [ , after_this_key ] )
       Move the first key after the second one. If the second parameter is omitted, the first key is placed in first position. Ignored for non
       ordered hash.

   move_up ( key )
       Move the key up in a ordered hash. Attempt to move up the first key of an ordered hash will be ignored. Ignored for non ordered hash.

   move_down ( key )
       Move the key down in a ordered hash. Attempt to move up the last key of an ordered hash will be ignored. Ignored for non ordered hash.

   load_data ( hash_ref | array_ref )
       Load check_list as a hash ref for standard hash.

       Ordered hash should be loaded with an array ref or with a hash containing a special "__order" element. E.g. loaded with either:

	 [ a => 'foo', b => 'bar' ]

       or

	 { __order => ['a','b'], b => 'bar', a => 'foo' }

AUTHOR

       Dominique Dumont, (ddumont at cpan dot org)

SEE ALSO

       Config::Model, Config::Model::Instance, Config::Model::AnyId, Config::Model::ListId, Config::Model::Value

perl v5.14.2							    2012-11-09						Config::Model::HashId(3pm)

Linux and UNIX Man Pages

config::model::listid(3pm) [debian man page]

Check Out this Related Man Page