Dongxu Ma > Audio-TagLib-1.43 > Audio::TagLib::Ogg::FieldListMap

Download:
Audio-TagLib-1.43.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 1.41   Source   Latest Release: Audio-TagLib-1.50_01

NAME ^

Audio::TagLib::Ogg::FieldListMap - Perl-only class

SYNOPSIS ^

  use Audio::TagLib::Ogg::FieldListMap;
  
  my $xc = Audio::TagLib::Ogg::XiphComment->new();
  $xc->setTitle(Audio::TagLib::String->new("title"));
  $xc->setArtist(Audio::TagLib::String->new("artist"));
  my $i  = $xc->fieldListMap();

  tie my %i, ref($i), $i;
  print $i{Audio::TagLib::String->new("TITLE")}->toString()->toCString(),
  "\n"; # got "title"

DESCRIPTION ^

Implements TagLib::Ogg::FieldListMap in C/C++ code, which is of type TagLib::Map<String, StringList>.

Optionally, you can tie an instance of ItemListMap with a hash symbol, just like this: tie my %h, ref($i), $i;, Then operate throught %h.

see Audio::TagLib::Ogg::XiphComment::fieldListMap()

new()

Constructs an empty FieldListMap.

new(FieldListMap $m)

Make a shallow, implicitly shared, copy of $m.

DESTROY()

Destroys this instance of the FieldListMap.

Iterator begin()

Returns an STL style iterator to the beginning of the map.

see Audio::TagLib::Ogg::FieldListMap::Iterator

Iterator end()

Returns an STL style iterator to the end of the map.

see Audio::TagLib::Ogg::FieldListMap::Iterator

void insert(String $key, StringList $value)

Inserts $value under $key in the map. If a value for $key already exists it will be overwritten.

void clear()

Removes all of the elements from elements from the map. This however will not free memory of all the items.

UV size()

The number of elements in the map.

see isEmpty()

BOOL isEmpty()

Returns true if the map is empty.

see size()

Iterator find(String $key)

Find the first occurance of $key.

BOOL contains(String $key)

Returns true if the map contains an instance of $key.

void erase(Iterator $it)

Erase the item at $it from the list.

StringList getItem(String $key)

Returns the value associated with $key.

note This has undefined behavior if the key is not present in the map.

copy(FieldListMap $m)

Make a shallow, implicitly shared, copy of $m.

EXPORT

None by default.

SEE ALSO ^

Audio::TagLib

AUTHOR ^

Dongxu Ma, <dongxu@cpan.org>

COPYRIGHT AND LICENSE ^

Copyright (C) 2005 by Dongxu Ma

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: