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  -  METADATA::IAFA (3)

.ds Aq ’

NAME

Metadata::IAFA - IAFA Template metadata class

CONTENTS

SYNOPSIS



  use Metadata::IAFA
  ...
  $i=new Metadata::IAFA;
  $i->set(element1, [qw(v1 v2 v3)]);
  $i->set(element2, v2);

  my $val=$i->get(element2);
  for my $v ($i->get(element1) {
    ...
  }
  ...



DESCRIPTION

The Metadata::IAFA class supports IAFA Templates metadata using the Metadata::Base class and customises it for IAFA Templates where element names have variants to represent to sub-values.

CONSTRUCTOR

new [OPTIONS] An optional hash of options can be given to the constructor to set various options. There are currently three Metadata::IAFA options defined:
STRICT This is defined to turn on strict interpretation of the draft IAFA Templates standard. See the <B>readB> method for what this implies.
TEMPLATE_TYPE Set the template type for this IAFA Template (default is DOCUMENT). The alternate ways to set this are via the <B>template_typeB> or <B>setB> methods.
DEBUG This class has a separate <B>debugB> class / object method that works in the same fashion as the Metadata::Base method <B>debugB>. Setting it here also sets the debugging on the base Metadata::Base object too.
WRAP When formatting the metadata for output, word wrap the results so that they fit into 80-columns. This is done using the Text::Wrap class.

METHODS

The methods here describe the differences from the Metadata::Base class methods.
set ELEMENT, VALUE, [INDEX]
get ELEMENT, [INDEX]
exists ELEMENT, [INDEX] These methods work in the same way as the <B>Metadata::Base::setB> methods except that ELEMENT can contain the variant if it is of the form: ELEMENT-INDEX where INDEX is a decimal number.
template_type [TEMPLATE-TYPE] The Template-Type of the metadata can be set by the <B>setB> method but it is stored separately from the regular elements and can only be retrieved from using this method when it is called with no arguments.
read HANDLE Implements reading a single IAFA Template from the given HANDLE. This is done in a generous style (different from the draft standard), rather than ending the template on a blank line, uses empty lines and thus allows element values to contain multiple paragraphs separated by entirely white space lines.
format Returns a formatted version of the IAFA Template suitable for writing to a file (and reading in with the <B>readB> method).
get_date_as_seconds ELEMENT This handles the strict IAFA format as well as a format of YYYY-MM-DD and a raw decimal number-of-seconds.
decode_uri_element VALUE Return a list of three elements from decoding the VALUE as a URI element: the base file name, the full path and the destination path (if a symlink). If the URI is just a plain URI, the full path will be empty.
encode_uri_element URI =item encode_uri_element FILE, PATH Return an encoding for either a URI or a local FILE and its remote PATH (symlink).
order_template_type TEMPLATE-TYPE Return an ordering of the TEMPLATE-TYPE suitable for <B>sortB>.

SEE ALSO

Metadata::Base, Text::Wrap

AUTHOR

By Dave Beckett - http://purl.org/net/dajobe/

COPYRIGHT

Copyright (C) 1997-2001 Dave Beckett - http://purl.org/net/dajobe/ All rights reserved.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 370: You forgot a ’=back’ before ’=head1’
Around line 428: =back doesn’t take any parameters, but you said =back 4
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 METADATA::IAFA (3) 2001-01-09

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