Net_NNTP::selectGroup()

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

Synopsis

require_once 'Net/NNTP.php';

array Net_NNTP::selectGroup ( string $newsgroup )

Description

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

Parameter

  • string $newsgroup - アクセスしたいニュースグループ名。

Return value

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

Throws

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

Note

This function can not be called statically.

Example

selectGroup() の使用

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