NAME
PerlBean::Attribute::Multi::Ordered - contains ordered MULTI bean attribute information
SYNOPSIS
use strict;
use PerlBean::Attribute::Multi::Ordered;
my $attr = PerlBean::Attribute::Multi::Ordered->new( {
method_factory_name => 'note_to_self',
short_description => 'my notes to self',
} );
ABSTRACT
Ordered MULTI bean attribute information
DESCRIPTION
PerlBean::Attribute::Multi::Ordered
contains ordered MULTI bean attribute information. It is a subclass of PerlBean::Attribute::Multi
. The code generation and documentation methods from PerlBean::Attribute
are implemented.
CONSTRUCTOR
- new(OPT_HASH_REF)
-
Creates a new
PerlBean::Attribute::Multi::Ordered
object.OPT_HASH_REF
is a hash reference used to pass initialization options.OPT_HASH_REF
is mandatory. On error an exceptionError::Simple
is thrown.Options for
OPT_HASH_REF
inherited through packagePerlBean::Attribute
may include:default_value
-
Passed to set_default_value().
documented
-
Passed to set_documented(). Defaults to 1.
exception_class
-
Passed to set_exception_class(). Defaults to 'Error::Simple'.
mandatory
-
Passed to set_mandatory(). Defaults to 0.
method_base
-
Passed to set_method_base().
short_description
-
Passed to set_short_description().
Options for
OPT_HASH_REF
inherited through packagePerlBean::Attribute::Single
may include:allow_empty
-
Passed to set_allow_empty(). Defaults to 1.
allow_isa
-
Passed to set_allow_isa(). Must be an
ARRAY
reference. allow_ref
-
Passed to set_allow_ref(). Must be an
ARRAY
reference. allow_rx
-
Passed to set_allow_rx(). Must be an
ARRAY
reference. allow_value
-
Passed to set_allow_value(). Must be an
ARRAY
reference.
Options for
OPT_HASH_REF
inherited through packagePerlBean::Method::Factory
may include:method_factory_name
-
Passed to set_method_factory_name(). Mandatory option.
perl_bean
-
Passed to set_perl_bean().
METHODS
- add_allow_isa(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Add additional values on the list of allowed classes.ARRAY
is the list value. The addition may not yield to multiple identical elements in the list. Hence, multiple occurrences of the same element cause the last occurrence to be inserted. On error an exceptionError::Simple
is thrown. - add_allow_ref(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Add additional values on the list of allowed references.ARRAY
is the list value. The addition may not yield to multiple identical elements in the list. Hence, multiple occurrences of the same element cause the last occurrence to be inserted. On error an exceptionError::Simple
is thrown. - add_allow_rx(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Add additional values on the list of allow regular expressions.ARRAY
is the list value. The addition may not yield to multiple identical elements in the list. Hence, multiple occurrences of the same element cause the last occurrence to be inserted. On error an exceptionError::Simple
is thrown. - add_allow_value(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Add additional values on allowed values.ARRAY
is the list value. The addition may not yield to multiple identical elements in the list. Hence, multiple occurrences of the same element cause the last occurrence to be inserted. On error an exceptionError::Simple
is thrown. - create_methods()
-
This method is an implementation from package
PerlBean::Attribute::Multi
. Returns a list ofPerlBean::Attribute::Method
objects. Access methods are set..., set_idx..., set_num..., push..., pop..., shift..., unshift..., exists... and get.... - delete_allow_isa(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Delete elements from the list of allowed classes. Returns the number of deleted elements. On error an exceptionError::Simple
is thrown. - delete_allow_ref(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Delete elements from the list of allowed references. Returns the number of deleted elements. On error an exceptionError::Simple
is thrown. - delete_allow_rx(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Delete elements from the list of allow regular expressions. Returns the number of deleted elements. On error an exceptionError::Simple
is thrown. - delete_allow_value(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Delete elements from allowed values. Returns the number of deleted elements. On error an exceptionError::Simple
is thrown. - exists_allow_isa(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns the count of items inARRAY
that are in the list of allowed classes. - exists_allow_ref(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns the count of items inARRAY
that are in the list of allowed references. - exists_allow_rx(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns the count of items inARRAY
that are in the list of allow regular expressions. - exists_allow_value(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns the count of items inARRAY
that are in allowed values. - get_default_value()
-
This method is inherited from package
PerlBean::Attribute
. Returns attribute default value. - get_exception_class()
-
This method is inherited from package
PerlBean::Attribute
. Returns the class to throw when an exception occurs. - get_method_base()
-
This method is inherited from package
PerlBean::Attribute
. Returns the method base name. - get_method_factory_name()
-
This method is inherited from package
PerlBean::Method::Factory
. Returns method factory's name. - get_package()
-
This method is inherited from package
PerlBean::Attribute
. Returns the package name. The package name is obtained from thePerlBean
to which thePerlBean::Attribute
belongs. Or, if thePerlBean::Attribute
does not belong to aPerlBean
,main
is returned. - get_package_us()
-
This method is inherited from package
PerlBean::Attribute
. Callsget_package()
and replaces:+
with C <_>. - get_perl_bean()
-
This method is inherited from package
PerlBean::Method::Factory
. Returns the PerlBean to which this method factory belongs. - get_short_description()
-
This method is inherited from package
PerlBean::Attribute
. Returns the attribute description. - is_allow_empty()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns whether the attribute is allowed to be empty or not. - is_documented()
-
This method is inherited from package
PerlBean::Attribute
. Returns whether the attribute is documented or not. - is_mandatory()
-
This method is inherited from package
PerlBean::Attribute
. Returns whether the attribute is mandatory for construction or not. - mk_doc_clauses()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns a string containing the documentation for the clauses to which the contents the contents of the attribute must adhere. - set_allow_empty(VALUE)
-
This method is inherited from package
PerlBean::Attribute::Single
. State that the attribute is allowed to be empty.VALUE
is the value. Default value at initialization is1
. On error an exceptionError::Simple
is thrown. - set_allow_isa(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Set the list of allowed classes absolutely.ARRAY
is the list value. Each element in the list is allowed to occur only once. Multiple occurrences of the same element yield in the last occurring element to be inserted and the rest to be ignored. On error an exceptionError::Simple
is thrown. - set_allow_ref(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Set the list of allowed references absolutely.ARRAY
is the list value. Each element in the list is allowed to occur only once. Multiple occurrences of the same element yield in the last occurring element to be inserted and the rest to be ignored. On error an exceptionError::Simple
is thrown. - set_allow_rx(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Set the list of allow regular expressions absolutely.ARRAY
is the list value. Each element in the list is allowed to occur only once. Multiple occurrences of the same element yield in the last occurring element to be inserted and the rest to be ignored. On error an exceptionError::Simple
is thrown. - set_allow_value(ARRAY)
-
This method is inherited from package
PerlBean::Attribute::Single
. Set allowed values absolutely.ARRAY
is the list value. Each element in the list is allowed to occur only once. Multiple occurrences of the same element yield in the last occurring element to be inserted and the rest to be ignored. On error an exceptionError::Simple
is thrown. - set_default_value(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. Set attribute default value.VALUE
is the value. On error an exceptionError::Simple
is thrown. - set_documented(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. State that the attribute is documented.VALUE
is the value. Default value at initialization is1
. On error an exceptionError::Simple
is thrown. - set_exception_class(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. Set the class to throw when an exception occurs.VALUE
is the value. Default value at initialization isError::Simple
.VALUE
may not beundef
. On error an exceptionError::Simple
is thrown. - set_mandatory(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. State that the attribute is mandatory for construction.VALUE
is the value. Default value at initialization is0
. On error an exceptionError::Simple
is thrown. - set_method_base(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. Set the method base name.VALUE
is the value. On error an exceptionError::Simple
is thrown. - set_method_factory_name(VALUE)
-
This method is inherited from package
PerlBean::Method::Factory
. Set method factory's name.VALUE
is the value.VALUE
may not beundef
. On error an exceptionError::Simple
is thrown. - set_perl_bean(VALUE)
-
This method is inherited from package
PerlBean::Method::Factory
. Set the PerlBean to which this method factory belongs.VALUE
is the value. On error an exceptionError::Simple
is thrown. - set_short_description(VALUE)
-
This method is inherited from package
PerlBean::Attribute
. Set the attribute description.VALUE
is the value. On error an exceptionError::Simple
is thrown. - type()
-
This method is inherited from package
PerlBean::Attribute
. Determines and returns the type of the attribute. The type is eitherBOOLEAN
,SINGLE
orMULTI
. - values_allow_isa()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns anARRAY
containing all values of the list of allowed classes. - values_allow_ref()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns anARRAY
containing all values of the list of allowed references. - values_allow_rx()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns anARRAY
containing all values of the list of allow regular expressions. - values_allow_value()
-
This method is inherited from package
PerlBean::Attribute::Single
. Returns anARRAY
containing all values of allowed values. - write_constructor_option_code()
-
This method is inherited from package
PerlBean::Attribute::Multi
. Writes constructor code for the attribute option. - write_constructor_option_doc()
-
This method is inherited from package
PerlBean::Attribute::Multi
. Writes constructor documentation for the attribute option. - write_default_value()
-
This method is inherited from package
PerlBean::Attribute::Multi
. Returns a%DEFAULT_VALUE
line string for the attribute.
SEE ALSO
PerlBean, PerlBean::Attribute, PerlBean::Attribute::Boolean, PerlBean::Attribute::Factory, PerlBean::Attribute::Multi, PerlBean::Attribute::Multi::Unique, PerlBean::Attribute::Multi::Unique::Associative, PerlBean::Attribute::Multi::Unique::Associative::MethodKey, PerlBean::Attribute::Multi::Unique::Ordered, PerlBean::Attribute::Single, PerlBean::Collection, PerlBean::Dependency, PerlBean::Dependency::Import, PerlBean::Dependency::Require, PerlBean::Dependency::Use, PerlBean::Described, PerlBean::Described::ExportTag, PerlBean::Method, PerlBean::Method::Constructor, PerlBean::Method::Factory, PerlBean::Style, PerlBean::Symbol
BUGS
None known (yet.)
HISTORY
First development: November 2002 Last update: September 2003
AUTHOR
Vincenzo Zocca
COPYRIGHT
Copyright 2002, 2003 by Vincenzo Zocca
LICENSE
This file is part of the PerlBean
module hierarchy for Perl by Vincenzo Zocca.
The PerlBean module hierarchy is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
The PerlBean module hierarchy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with the PerlBean module hierarchy; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA