Net_NNTP::getGroups()

Description

Returns a list of all avaible newsgroups from the connected news server

Parameter

• $fetch - can be irgnored, unused

Return value

array - a two dimensional, nested array indicated by the name of the newsgroup, every entry contains information about the newsgroup:

• $groups[newsgroup_name]['group'] name of the newsgroup

• $groups[newsgroup_name]['last'] message number of the last message

• $groups[newsgroup_name]['first'] message number of the first message

• $groups[newsgroup_name]['posting_allowed'] values: y - yes, n - no, m - moderated)

• $groups[newsgroup_name]['desc'] newsgroup description

Note

This function can not be called statically.

See

Net_NNTP::selectGroup()

Example

...
$ret = $nntp->connect("news.php.net");
if( PEAR::isError($ret)) {
 // handle error
} else {
 // success
 $groups = $nntp->getGroups();
 // Print a list of avaible newsgroups
 foreach($groups as $group) {
    echo $group['group'].': '.$group['desc'].'<br>';
 }
}