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>';  } }