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


Manual Reference Pages  -  XML::PASTOR::BUILTIN::LIST (3)

.ds Aq ’

NAME

XML::Pastor::Builtin::List - Ancestor of all classes that correspond to whitespace separated list W3C simple types.

CONTENTS

WARNING

This module is used internally by XML::Pastor. You do not normally know much about this module to actually use XML::Pastor. It is documented here for completeness and for XML::Pastor developers. Do not count on the interface of this module. It may change in any of the subsequent releases. You have been warned.

ISA

This class descends from XML::Pastor::Builtin::SimpleType.

DESCRIPTION

This class is used for grouping the <B>builtinB> classes that have whitespace separated <B>listB> content. Some utility methods are defined for easing the use of such content.

Some <B>builtinB> W3C types have a <B>listB> nature on their own, such as <B>NMTOKENSB> (whitespace seperated <B>NMTOKENB> values) or <B>IDREFSB>.

In W3C schemas it is also possible to define a simple type to be a <B>listB> of another atomic simple type.

METHODS

    INHERITED METHODS

This class inherits many methods from its ancestors. Please see XML::Pastor::Builtin::SimpleType for more methods.

    CONSTRUCTORS

fromList()



  my $object = XML::Pastor::Builtin::List->fromList(hello, world);



Creates a new object and sets its value by joining the values passed as the parameter list with a space seperator.

    OTHER METHODS

setFromList()



  $object->setFromList(hello, world);



Sets the object’s value by joining the values passed as the parameter list with a space seperator.

toList()



  @list = $object->toList();



Splits the object’s value on whitespace and returns the resulting list.

xml_validate()



  $object->xml_validate();



<B>OBJECT METHODB> overriden from XML::Pastor::SimpleType.

Normaly the <B>xml_validateB> method checks an atomic value. However, <B>listB> types are aggregate values made up of <B>itemsB> whose type is known via <B>itemTypeB> and <B>itemClassB> properties (see XML::Pastor::Schema::SimpleType).

This method will first split the object’s value into a list and then run <B>xml_validateB> on each item by instantiating an simple type object on their own and invoking the <B>xml_validateB> method on each of them. If all those invocations return TRUE, this method will return TRUE. Otherwise, it would have died along the way before even returning FALSE.

BUGS & CAVEATS

There no known bugs at this time, but this doesn’t mean there are aren’t any. Note that, although some testing was done prior to releasing the module, this should still be considered alpha code. So use it at your own risk.

Note that there may be other bugs or limitations that the author is not aware of.

AUTHOR

Ayhan Ulusoy <dev(at)ulusoy(dot)name>

COPYRIGHT



  Copyright (C) 2006-2007 Ayhan Ulusoy. All Rights Reserved.



This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

See also XML::Pastor, XML::Pastor::ComplexType, XML::Pastor::SimpleType, XML::Pastor::Builtin

If you are curious about the implementation, see XML::Pastor::Schema::Parser, XML::Pastor::Schema::Model, XML::Pastor::Generator.

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


perl v5.20.3 XML::PASTOR::BUILTIN::LIST (3) 2008-08-02

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