Net_NNTP::getGroups()

PEAR マニュアル
前のページ		次のページ

概要

require_once 'Net/NNTP.php';

array Net_NNTP::getGroups ([string $fetch = TRUE])

説明

接続されているニュースサーバから、有効なニュースグループの一覧を返します。

パラメータ

$fetch - 無視できます。利用されません。

返り値

array - 二次元配列です。最初の要素がニュースグループ名を表し、それぞれの要素の下にニュースグループの情報が格納されています。

$groups[newsgroup_name]['group'] ニュースグループの名前
$groups[newsgroup_name]['last'] 最新の記事の記事番号
$groups[newsgroup_name]['first'] 最初の記事の記事番号
$groups[newsgroup_name]['posting_allowed'] とりうる値：y - はい、 n - いいえ、 m - モデレートされています
$groups[newsgroup_name]['desc'] ニュースグループの概要

注意

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

警告

一般向けに公開されているニュースサーバの場合、30,000 以上のニュースグループが含まれていることもあります。そのような場合、この関数の実行時間が php.ini で設定されている maximum execution time を超えてしまうかもしれません。

参照

Net_NNTP::selectGroup()

例

例 47-1getGroups() の使用


<?php
...
$ret = $nntp->connect("news.php.net");
if( PEAR::isError($ret)) {
 // エラー処理
} else {
 // 成功
 $groups = $nntp->getGroups();
 // 有効なニュースグループ一覧の表示
 foreach($groups as $group) {
    echo $group['group'].': '.$group['desc'].'<br>';
 }
}
?>

前のページ	ホーム	次のページ
Net_NNTP::getDate()	上に戻る	Net_NNTP::getHeaderRaw()