ldap_first_attribute

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

ldap_first_attribute — 最初の属性を返す

ldap_first_attribute(LDAP\Connection $ldap, LDAP\ResultEntry $entry): string|false

指定したエントリの最初の属性を取得します。残りの属性は、 ldap_next_attribute() を逐次コールして取得します。

エントリの読み込みと同様、エントリからの属性の読み込みもひとつづつ行われます。

ldap: ldap_connect() が返す LDAP\Connection クラスのインスタンス。
entry: LDAP\ResultEntry クラスのインスタンス。
ber_identifier: ber_identifier は内部メモリにおける位置ポインタの ID です。この ID は参照渡しされます。同じ ber_identifier が ldap_next_attribute() 関数に渡された場合、そのポインタは修正されます。

注意:
このパラメータは使用されなくなりました。現在は PHP が自動的にこれを処理します。後方互換性を保持するため、もしこのパラメータが渡されても PHP はエラーを発生させません。

成功した場合にエントリの最初の属性、エラーの場合に false を返します。

バージョン	説明
8.1.0	引数 `ldap` は、LDAP\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、リソースを期待していました。
8.1.0	引数 `entry` は、 LDAP\ResultEntry クラスのインスタンスを期待するようになりました。これより前のバージョンでは、リソースを期待していました。