previousNet_NNTP_Client::quit() (Previous) (Next) Net_NNTPnext

View this page in Last updated: Tue, 02 Jun 2009
English | Brazilian Portuguese | Chinese | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Turkish

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'];
}
?>
previousNet_NNTP_Client::quit() (Previous) (Next) Net_NNTPnext

Download Documentation Last updated: Tue, 02 Jun 2009
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.