The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

version 1.259

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

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