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