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

Net_NNTP::getHeaders()

Net_NNTP::getHeaders() -- 記事のヘッダを取得する

概要

require_once 'Net/NNTP.php';

string Net_NNTP::getHeaders (string $articleId)

説明

現在選択されているニュースグループの指定した記事について、 そのヘッダ行の内容を返します。

警告

この関数は 非推奨の関数です。 今後、このパッケージの将来のバージョンでは、 サポートされないかもしれません。

この関数は廃止予定であることに気をつけてください。 代わりに Net_NNTP::getHeaderRaw() を利用してください。

パラメータ

返り値

string - 記事が存在した場合、 そのヘッダを文字列形式で返します。もし失敗した場合は PEAR_Error を返します。

例外・エラー

表 54-1PEAR_Error の値

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

注意

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

参照

Net_NNTP::splitHeaders() , Net_NNTP::getBody() , Net_NNTP::getOverview()

例

例 54-1getHeaders() の使用

...

$headers = $nntp->getHeaders($msgId);
if( PEAR::isError($headers)) {
 // エラー処理
} else {
 // 成功 - 文字列を配列に分解する
 $headersArray = explode( "\n", $headers);
}
前のページホーム次のページ
Net_NNTP::getHeaderRaw()上に戻るNet_NNTP::getOverview()