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


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

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

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