Net_NNTP::selectGroup()

Net_NNTP::selectGroup() -- ニュースグループを選択する

概要

require_once 'Net/NNTP.php';

array Net_NNTP::selectGroup (string $newsgroup)

説明

ニュースサーバ上の指定したニュースグループを選択します。

パラメータ

返り値

array - ニュースグループが存在した場合、 配列が返されます。その中身は、最初の記事の記事番号 (キー: ['first'])と最後の記事の記事番号 (キー: ['last'])です。 もし失敗した場合は PEAR_Error が返されます。

例外・エラー

表 47-1PEAR_Error の値

エラー番号エラーメッセージ原因対応方法
NULL いろいろなエラーメッセージ ニュースサーバから返される文字列をそのままの形式で返します。 たいがいの場合、存在しない記事を取得しようとしたことが原因です。 記事番号を確認してください。あるいは、サーバと正しく 接続できているかどうかを確認します ( Net_NNTP::isConnected())。

注意

この関数は、スタティックにコールする ことはできません。

参照

Net_NNTP::connect() , Net_NNTP::getGroups()

例 47-1selectGroup() の使用


<?php
...
$ret = $nntp->connect("news.php.net");
if( PEAR::isError($ret)) {
 // エラー処理
} else {
 // 成功
 $data = $nntp->selectGroup("php.pear.dev");
 // 記事の総数を表示
 echo "Count: ", $data['last'] - $data['first'];
}
?>