---
name: "DublinCore::Element"
section: "3pm"
platform: "linux"
package: "libdublincore-record-perl"
version: "0.03-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/DublinCore::Element"
---

# DublinCore::Element(3pm)

Class for representing a Dublin Core element

## NAME

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

## SYNOPSIS

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

## 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.