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.

See

Net_NNTP_Client::connect() , Net_NNTP_Client::getGroups()

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