NAME

MP3::Napster::Channel - Object-oriented access to Napster channels

SYNOPSIS

@channels = $nap->channels;
foreach $chan (@channels) {
   print $chan->name,"\n";
   print $chan->topic,"\n";
   print $chan->user_count,"\n";
   print $chan->server,"\n";
   @users = $chan->users,"\n";
}

$chan->join && print "Welcome to $chan!\n";
$chan->part && print "Goodbye!\n";

DESCRIPTION

MP3::Napster::Channel provides object-oriented access to discussion channels on the Napster service.

OBJECT CONSTRUCTION

Channel objects are normally not constructed from scratch but are returned by the MPEG::Napster channels() method.

OBJECT METHODS

Methods provide access to various attributes of the Channel object and allow you to join and depart the channel.

Accessors

The accessors provide read-only access to the following Channel attributes.

Accessor                Description
--------                -----------
$channel->name          Channel name
$channel->user_count    Number of users enrolled in channel
$channel->topic         Channel's topic (welcome banner)
$channel->server        MP3::Napster object from which channel was derived

@users = $channel->users

This method returns the current list of users subscribed to the channel. The return value is an array of MP3::Napster::User objects.

$result = $channel->join

Attempt to join the channel, and return a true result if successful.

$result = $channel->join

Attempt to join the channel, returning a true result if successful.

$result = $channel->part

Attempt to depart from the channel, returning a true result if successful.

String Overloading

If used in a string context, MPEG::Napster::Channel objects will invoke the name() method, allowing the objects to be directly interpolated into strings, printed, and pattern matched.

AUTHOR

Lincoln Stein <lstein@cshl.org>.

COPYRIGHT

Copyright (c) 2000 Cold Spring Harbor Laboratory. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

MP3::Napster, MP3::Napster::Song, MP3::Napster::User, and MPEG::Napster::Transfer