« snmp_set_quick_print
snmp2_get »

snmp_set_valueretrieval

(PHP 4 >= 4.3.3, PHP 5, PHP 7, PHP 8)

snmp_set_valueretrieval — SNMP の値が返される方法を設定する

説明

function snmp_set_valueretrieval(int $method): true

パラメータ

method
型
SNMP_VALUE_LIBRARY Net-SNMP ライブラリの返す形式のままで返します。
SNMP_VALUE_PLAIN SNMP の型情報を含まないプレーンな値を返します。
SNMP_VALUE_OBJECT プロパティ value および type をもつオブジェクトを返します。 type は SNMP_OCTET_STR や SNMP_COUNTER などの定数のいずれかとなります。 value を返す方法は、定数 SNMP_VALUE_LIBRARY, SNMP_VALUE_PLAIN のどちらが設定されているかによって決まります。

戻り値

常に true を返します。

変更履歴

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

例

例1 snmp_set_valueretrieval() の使用法

<?php
 snmp_set_valueretrieval(SNMP_VALUE_LIBRARY);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // $ret = "STRING: lo"

 snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // $ret = "lo";

 snmp_set_valueretrieval(SNMP_VALUE_OBJECT);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, see constants
 //   [value] => lo
 // )

 snmp_set_valueretrieval(SNMP_VALUE_OBJECT | SNMP_VALUE_PLAIN);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, see constants
 //   [value] => lo
 // )

 snmp_set_valueretrieval(SNMP_VALUE_OBJECT | SNMP_VALUE_LIBRARY);
 $ret = snmpget('localhost', 'public', 'IF-MIB::ifName.1');
 // stdClass Object
 // (
 //   [type] => 4        <-- SNMP_OCTET_STR, see constants
 //   [value] => STRING: lo
 // )

?>

参考

関連キーワード:
snmp   valueretrieval   方法   type   snmpget   localhost   ifName   定数   stdClass   constants   method   quick   print   ライブラリ   プレーン   プロパティ   履歴   参考
関連する関数・ページ:
function.snmp-get-valueretrieval   snmp.constants   ref.snmp   function.snmp2-set   function.snmp2-get   book.snmp