Net_NNTP::getHeaders()
Net_NNTP::getHeaders() -- 記事のヘッダを取得する
概要
require_once 'Net/NNTP.php'; |
string Net_NNTP::getHeaders (string $articleId)
説明
現在選択されているニュースグループの指定した記事について、
そのヘッダ行の内容を返します。
| 警告 |
この関数は
非推奨の関数です。
今後、このパッケージの将来のバージョンでは、
サポートされないかもしれません。
|
この関数は廃止予定であることに気をつけてください。
代わりに
Net_NNTP::getHeaderRaw() を利用してください。
返り値
string - 記事が存在した場合、
そのヘッダを文字列形式で返します。もし失敗した場合は
PEAR_Error を返します。
例外・エラー
表 47-1PEAR_Error の値
| エラー番号 | エラーメッセージ | 原因 | 対応方法 |
|---|
| NULL |
いろいろなエラーメッセージ
|
ニュースサーバから返される文字列をそのままの形式で返します。
たいがいの場合、存在しない記事を取得しようとしたことが原因です。
|
記事 ID を確認してください。あるいは、サーバと正しく
接続できているかどうかを確認します
（
Net_NNTP::isConnected()）。
|
注意
この関数は、スタティックにコールする
ことはできません。
例
例 47-1getHeaders() の使用
<?php
...
$headers = $nntp->getHeaders($msgId);
if( PEAR::isError($headers)) {
// エラー処理
} else {
// 成功 - 文字列を配列に分解する
$headersArray = explode( "\n", $headers);
}
?>
|
|