« ldap_control_paged_result_response
ldap_count_references »

ldap_count_entries

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

ldap_count_entries — 検索結果のエントリ数を数える

説明

function ldap_count_entries(LDAP\Connection $ldap, LDAP\Result $result): int

直前の検索結果として保存されたエントリの数を返します。

パラメータ

ldap

ldap_connect() が返す LDAP\Connection クラスのインスタンス。

result

ldap_list() や ldap_search() が返す、LDAP\Result クラスのインスタンス。.

戻り値

結果のエントリ数を返します。 エラーの場合は -1 を返します。

変更履歴

バージョン 説明
8.1.0 引数 ldap は、LDAP\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な ldap link resource を期待していました。
8.1.0 引数 result は、 LDAP\Result クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な ldap result resource を期待していました。

例

例1 ldap_count_entries() の例

結果のエントリ数を取得します。

// $ds は、有効な LDAP\Connection のインスタンスです

     $dn        = 'ou=example,dc=org';
     $filter    = '(|(sn=Doe*)(givenname=John*))';
     $justthese = array('ou', 'sn', 'givenname', 'mail');

     $sr = ldap_search($ds, $dn, $filter, $justthese);

     var_dump(ldap_count_entries($ds, $sr));

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

int(1)

関連キーワード:
ldap   エントリ   count   entries   インスタンス   Connection   期待   resource   filter   givenname   justthese   control   paged   response   references   connect   list   履歴   link   example   John   mail   dump
関連する関数・ページ:
function.ldap-count-references   function.ldap-get-entries   function.ldap-get-dn   function.ldap-add-ext   function.ldap-delete   function.ldap-first-entry