Net_NNTP_Client::selectGroup()
Net_NNTP_Client::selectGroup() – select a newsgroup
Synopsis
require_once 'Net/NNTP/Client.php';
array Net_NNTP_Client::selectGroup (
string $newsgroup
)
Description
Selects a specific newsgroup on the NNTP-server
Parameter
-
string
$newsgroup- Name of the newsgroup to access
Return value
array - If the newsgroup exists, an array
is returned:
| 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
| 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
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'];
}
?>