PEAR Manual
PrevNext

Net_NNTP_Realtime::selectGroup()

Net_NNTP_Realtime::selectGroup() -- select a newsgroup

Synopsis

require_once 'Net/NNTP/Realtime.php';

array Net_NNTP_Realtime::selectGroup (string $newsgroup)

Description

Selects a specific newsgroup on the NNTP-server

Parameter

Return value

array - If the newsgroup exists, an array is returned:

Table 31-1.

KeyValue
'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 31-2. Possible PEAR_Error values

Error codeError messageReasonSolution
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_Realtime::connect() , Net_NNTP_Realtime::getGroups()

Example

Example 31-1. Using selectGroup()

...
$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'];
}
PrevHomeNext
Net_NNTP_Realtime::quit()UpConstants