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

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

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