NAME

Data::Metadata::KeyValue - Data object for one metadata key/value pair.

SYNOPSIS

use Data::Metadata::KeyValue;

my $obj = Data::Metadata::KeyValue->new(%params);
my $id = $obj->id;
my $key = $obj->key;
my $value = $obj->value;

DESCRIPTION

This class represents one metadata item as a required key, optional value and optional identifier.

METHODS

new

my $obj = Data::Metadata::KeyValue->new(%params);

Constructor.

  • id

    Id of key/value pair. The number is positive natural number.

    It's optional.

  • key

    Metadata key string.

    It's required.

  • value

    Metadata value string.

    It's optional.

Returns instance of object.

id

my $id = $obj->id;

Returns number or undef.

key

my $key = $obj->key;

Returns string.

value

my $value = $obj->value;

Returns string or undef.

ERRORS

new():
        From Mo::utils::check_required():
                Parameter 'key' is required.
        From Mo::utils::Number::check_positive_natural():
                Parameter 'id' must be a positive natural number.
                        Value: %s

EXAMPLES

EXAMPLE

use strict;
use warnings;

use Data::Metadata::KeyValue;

my $obj = Data::Metadata::KeyValue->new(
        'id' => 7,
        'key' => 'text',
        'value' => 'This is text',
);

# Print out.
print 'id: '.$obj->id."\n";
print 'key: '.$obj->key."\n";
print 'value: '.$obj->value."\n";

# Output:
# id: 7
# key: text
# value: This is text

DEPENDENCIES

Mo Mo::utils, Mo::utils::Number.

SEE ALSO

Data::Metadata

Class containing multiple metadata key/value items.

REPOSITORY

https://github.com/michal-josef-spacek/Data-Metadata

AUTHOR

Michal Josef Špaček mailto:skim@cpan.org

http://skim.cz

LICENSE AND COPYRIGHT

© 2025-2026 Michal Josef Špaček

BSD 2-Clause License

VERSION

0.01