NAME

Audio::TagLib::StringList - A list of strings

SYNOPSIS

  use Audio::TagLib::StringList;
  my $i = Audio::TagLib::StringList->new();
  $i->append(Audio::TagLib::String->new("catch"));
  $i->append(Audio::TagLib::String->new("me!"));
  print $i->toString()->toCString(), "\n"; # got "catch me!"

DESCRIPTION

This is a spcialization of the List class with some members convention for string operations.

new()

Constructs an empty StringList.

new(StringList $l)

Make a shallow, implicitly shared, copy of $l. Because this is implicitly shared, this method is lightweight and suitable for pass-by-value usage.

new(String $s)

Constructs a StringList with $s as a member.

new(ByteVectorList $vl, PV $t = "Latin1")

Makes a deep copy of the data in $vl.

NOTE This should only be used with the 8-bit codecs Latin1 and UTF8, when used with other codecs it will simply print a warning and exit.

DESTROY()

Destroys this StringList instance.

String toString(String $separator = " ")

Concatenate the list of strings into one string separated by $separator.

StringList append(String $s)

Appends $s to to the end of the list and returns a reference to the list.

StringList append(StringList $l)

Appends all of the values in $l to the end of the list and returns a reference to the list.

StringList split(String $s, String $pattern) [static]

Splits the String $s into several strings at $pattern. This will not include the pattern in the returned strings.

EXPORT

None by default.

SEE ALSO

Audio::TagLib

AUTHOR

Dongxu Ma, <dongxu@cpan.org>

MAINTAINER

Geoffrey Leach GLEACH@cpan.org

COPYRIGHT AND LICENSE

Copyright (C) 2005-2010 by Dongxu Ma

Copyright (C) 2011 - 2012 Geoffrey Leach

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.