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_identifierldap_next_attribute() 関数に渡された場合、 そのポインタは修正されます。

注意:

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

戻り値

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

変更履歴

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

参考

関連キーワード:  属性, 最初, attribute, エントリ, 期待, entry, インスタンス, クラス, next, バージョン