PHP マニュアル
前のページ |  | 次のページ

# ldap_get_values

(PHP 3, PHP 4 )

ldap_get_values -- 結果エントリから全ての値を得る

## 説明

array ldap_get_values ( int link_identifier, int result_entry_identifier, string attribute)

成功した場合、指定した属性に関する値を配列を返します。エラーの場合 には、`FALSE`を返します。

ldap_get_values() 関数は、結果のエントリにおけ る属性の全ての値を読み込むために使用されます。 エントリは、`result_entry_identifier` により指定されます。結果を有する配列において "count" と インデックス指定することにより値の数を得ることができます。 個々の値は、配列において整数インデックスを指定するこhによりアクセス できます。最初のインデックスは、0 です。

この関数のコールは、`result_entry_identifier` を必要とします。このため、事前に LDAP の検索用関数のコールと個々の エントリ取得用関数のコールを行っておく必要があります。

アプリケーションでは、("surname" または "mail" のような)特定の属性 を探すためにその特性をコードに埋め込んで置くか、さもなくば、指定し たエントリに関して存在する属性を調べるために ldap_get_attributes() をコールする必要があります。

LDAP ではある属性に関して複数のエントリを持つことが可能です。 このため、例えば、ある人に関する "mail" という属性で呼ばれる全ての ディレクトリエントリについて多数の電子メールアドレスを保存することが できます。

return_value["count"] = 属性の値の数
return_value[0] = 属性の最初の値
return_value[i] = 属性の i 番目の値

例 1 あるディレクトリエントリの全ての "mail" 属性の一覧を表示します
    // $ds はディレクトリサーバーの有効なリンク ID
    // $sr は事前の LDAP 検索コールのどれかから返された有効な検索結果
    // $entry はディレクトリエントリを返すコールのどれかから返された有効な
    // エントリ ID

    $values = ldap_get_values($ds, $entry,"mail");

    echo $values["count"]." email addresses for this entry.<p>";

    for ($i=0; $i < $values["count"]; $i++)
         echo $values[$i]."<br>";

前のページ | ホーム | 次のページ
ldap_get_values_len | 上に戻る | ldap_list