Thomas Sibley > Net-iTMS-0.15 > Net::iTMS::Search

Download:
Net-iTMS-0.15.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.15   Source  

NAME ^

Net::iTMS::Search - Represents a simple search of the iTunes Music Store

SYNOPSIS ^

    use Net::iTMS::Search;

    my $search = Net::iTMS::Search->new($iTMS, $query);
    
    for my $album ($search->albums) {
        print $album->title, " by ", $album->artist->name, "\n";
    }

DESCRIPTION ^

Net::iTMS::Search represents a search of the iTMS and encapsulates the associated data. PLEASE NOTE: This simple search is currently broken due to unresolvable changes in the iTMS. Please use Net::iTMS::Search::Advanced, which works.

Methods

new($itms, $query)

The first argument must be an instance of Net::iTMS, the second a query string.

Returns a blessed hashref (object) for Net::iTMS::Search.

query

Returns the query string the search is for.

songs

Returns an array or arrayref (depending on context) of Net::iTMS::Song objects for the songs found.

albums

Returns an array or arrayref (depending on context) of Net::iTMS::Album objects for the albums found.

NB: Due to an apparent limitation of the simple search in the iTMS, the maximum number of albums returned will be four.

LICENSE ^

Copyright 2004, Thomas R. Sibley.

You may use, modify, and distribute this package under the same terms as Perl itself.

AUTHOR ^

Thomas R. Sibley, http://zulutango.org:82/

SEE ALSO ^

Net::iTMS, Net::iTMS::Song, Net::iTMS::Artist

syntax highlighting: