Net_NNTP_Client::selectGroup() -- ニュースグループを選択する
説明
NNTP サーバ上の指定したニュースグループを選択します。
返り値
array - ニュースグループが存在した場合、
配列が返されます：
表 54-1
| キー | 値 |
|---|
| 'count' | グループ内の記事の数 |
| 'first' | グループ内の最初の記事番号 |
| 'last' | グループ内の最後の記事番号 |
| 'group' | グループ名 |
それ以外の場合、
PEAR_Error が返されます。
例外・エラー
表 54-2PEAR_Error の値
| エラー番号 | エラーメッセージ | 原因 | 対応方法 |
|---|
| NULL |
いろいろなエラーメッセージ
|
ニュースサーバから返される文字列をそのままの形式で返します。
たいがいの場合、存在しない記事を取得しようとしたことが原因です。
| |
注意
この関数は、スタティックにコールする
ことはできません。
例
例 54-1selectGroup() の使用 ...
$ret = $nntp->connect('news.php.net');
if( PEAR::isError($ret)) {
// エラー処理
} else {
// 成功
$data = $nntp->selectGroup('php.pear.dev');
// 記事の数を取得する
echo "記事の数: ", $data['last'] - $data['first'];
} |
|