DublinCore::Element(3pm)				User Contributed Perl Documentation				  DublinCore::Element(3pm)

NAME

       DublinCore::Element - Class for representing a Dublin Core element

SYNOPSIS

	   my $element = DublinCore::Element->new( \%info );
	   print "content:   ", $element->content(), "
";
	   print "qualifier: ", $element->qualifier(), "
";
	   print "language:  ", $element->language(), "
";
	   print "scheme:    ", $element->scheme(), "
";

DESCRIPTION

       DublinCore::Record methods such as element(), elements(), title(), etc return DublinCore::Element objects as their result. These can be
       queried further to extract an elements content, qualifier, language, and schema. For a definition of these attributes please see RFC 2731
       and <http://www.dublincore.org>.

METHODS

       new()

       The constructor. Take a hashref of input arguments.

       content()

       Gets and sets the content of the element.

	   ## extract the element
	   my $title = $record->element( 'title' );
	   print $title->content();

	   ## or you can chain them together
	   print $record->element( 'title' )->content();

       qualifier()

       Gets and sets the qualifier used by the element.

       language()

       Gets and sets the language of the content in element.

       scheme()

       Gets and sets the scheme used by the element.

       name()

       Gets and sets the element name (title, creator, date, etc).

       is_empty()

       Gets and sets the "empty" status of an element. This is useful when using DublinCore::Record's element() method.

       To see if the record has an creator elements:

	   if( $record->element( 'creator' )->is_empty ) {
	       # no creators
	   }

       set()

       This function overrides the default set() behavior in order to remove the is_empty flag.

SEE ALSO

       * DublinCore::Record

AUTHOR

       * Ed Summers <ehs@pobox.com>
       * Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2007 by Ed Summers, Brian Cassidy

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

perl v5.8.8							    2007-11-24						  DublinCore::Element(3pm)