PHP マニュアル: NET-SNMP ライブラリで enable の値を設定する

説明

true snmp_set_quick_print(bool $enable)

NET-SNMP ライブラリで enable の値を設定します。この値を (1) に設定した場合、SNMP ライブラリは、'簡潔に表示された (quick printed)' 値を返します。これは、値のみが出力されることを意味します。 enable が有効でない場合(デフォルト)、NET-SNMP ライブラリは、 (IP アドレスまたは OID のような)その値の種類を含む、より詳細な情報を出力します。加えて、quick_print が有効でない場合、ライブラリは 3 文字以下の全ての文字列について 16 進数値も出力します。

デフォルトで、NET-SNMP ライブラリは冗長な値を返します。 quick_print は、値のみを返すために用いられます。

現在、文字列は引用符で括られて返されますが、この動作は将来のリリースでは修正される予定です。

パラメータ

enable

戻り値

常に true を返します。

変更履歴

バージョン	説明
8.2.0	戻り値の型が、`true` になりました。これより前のバージョンでは、bool でした。

例

quick_print の設定は、結果を表示するよりもその内容を使いたい場合によく行われます。

例1 snmp_set_quick_print の使用例

<?php
snmp_set_quick_print(0);
$a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1");
echo "$a\n";
snmp_set_quick_print(1);
$a = snmpget("127.0.0.1", "public", ".1.3.6.1.2.1.2.2.1.9.1");
echo "$a\n";
?>

上の例の出力は、たとえば以下のようになります。

'Timeticks: (0) 0:00:00.00'
'0:00:00.00'

参考

snmp_get_quick_print