PEAR Manual
Prev |  | Next

# 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:

Table 48-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 48-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.

## See

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

## Example

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

Prev | Home | Next
Net_NNTP_Client::`quit`() | Up | Net_Ping