array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.snmp-set-quick-print.php', 1 => 'snmp_set_quick_print', 2 => 'NET-SNMP ライブラリで enable の値を設定する', ), 'up' => array ( 0 => 'ref.snmp.php', 1 => 'SNMP 関数', ), 'prev' => array ( 0 => 'function.snmp-set-oid-output-format.php', 1 => 'snmp_set_oid_output_format', ), 'next' => array ( 0 => 'function.snmp-set-valueretrieval.php', 1 => 'snmp_set_valueretrieval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/snmp/functions/snmp-set-quick-print.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

snmp_set_quick_print

(PHP 4, PHP 5, PHP 7, PHP 8)

snmp_set_quick_print — NET-SNMP ライブラリで enable の値を設定する

説明

snmp_set_quick_print(bool $enable): true

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'

参考