Net_NNTP_Client::selectGroup() -- select a newsgroup
Description
Selects a specific newsgroup on the NNTP-server
Return value
array - If the newsgroup exists, an array
is returned:
Table 54-1.
| Key | Value |
|---|
| 'count' | Number of articles in the group |
| 'first' | The first article number in the group |
| 'last' | The last article number in the group |
| 'group' | Groupname |
otherwise a
PEAR_Error is returned on fail.
Throws
Table 54-2. Possible PEAR_Error values
| Error code | Error message | Reason | Solution |
|---|
| NULL |
Different error messages
|
The messages are directly passed from the news server, in the
most cases caused by calling a non existing article
| |
Note
This function can not be called
statically.
Example
Example 54-1. Using selectGroup()
<?php
...
$ret = $nntp->connect('news.php.net');
if( PEAR::isError($ret)) {
// handle error
} else {
// success
$data = $nntp->selectGroup('php.pear.dev');
// Print the count of articles
echo "Count: ", $data['last'] - $data['first'];
}
?>
|
|
