<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: c97d168c2b347e0e63a9e367b4c92dffe071e22a Maintainer: nobody Status: ready -->

<!-- Reviewed: yes -->

<!-- Rev-Revision: bc90525a5a5ebcf8412ef34b8355d2de12166fff Reviewer: samesch -->

<refentry xml:id="function.ldap-get-attributes" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>ldap_get_attributes</refname>

<refpurpose>Liefert die Merkmale eines Eintrags aus einem Suchergebnis</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>array</type><methodname>ldap_get_attributes</methodname>

<methodparam><type>LDAP\Connection</type><parameter>ldap</parameter></methodparam>

<methodparam><type>LDAP\ResultEntry</type><parameter>entry</parameter></methodparam>

</methodsynopsis>

<para>

Liest Merkmale und Werte eines Eintrags im Suchergebnis.

</para>

<para>

Nachdem ein bestimmter Eintrag in dem Verzeichnis lokalisiert wurde, kann

mit dieser Funktion herausgefunden werden, welche Informationen für diesen

Eintrag verfügbar sind. Diese Funktion würde in einer Anwendung verwendet

werden, die Verzeichniseinträge "durchstöbert" und/oder wo die Struktur der

Verzeichniseinträge nicht bekannt ist. In vielen Anwendungen wird nach

einem bestimmten Merkmal gesucht, &zb; einer E-Mail-Adresse oder einem

Nachnamen, und welche anderen Daten verfügbar sind, interessiert nicht.

<informalexample>

<programlisting>

<![CDATA[

return_value["count"] = Anzahl der Merkmale des Eintrags

return_value[0] = das erste Merkmal

return_value[n] = das n-te Merkmal

return_value["merkmal"]["count"] = Anzahl der Werte des Merkmals

return_value["merkmal"][0] = der erste Wert des Merkmals

return_value["merkmal"][i] = der i+1-te Wert des Merkmals

]]>

</programlisting>

</informalexample>

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>ldap</parameter></term>

<listitem>

<para>

&ldap.parameter.ldap;

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>entry</parameter></term>

<listitem>

<para>

&ldap.parameter.entry;

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Gibt im Erfolgfall die vollständige Eintragsinformation in einem

mehrdimensionalen Array zurück.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&ldap.changelog.ldap-object;

&ldap.changelog.entry-object;

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>

Anzeigen der Liste der Merkmale für einen ausgewählten

Verzeichnis-Eintrag

</title>

<programlisting role="php">

<![CDATA[

<?php

// $ds ist eine gültige LDAP\Connection-Instanz für einen Verzeichnis-Server

// $sr ist ein gültiges Suchergebnis eines früheren Aufrufs

// einer der LDAP-Verzeichnis-Suchfunktionen

$entry = ldap_first_entry($ds, $sr);

$attrs = ldap_get_attributes($ds, $entry);

echo $attrs["count"] . " Merkmale für diesen Eintrag:<p>";

for ($i=0; $i < $attrs["count"]; $i++) {

echo $attrs[$i] . "<br />";

}

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>ldap_first_attribute</function></member>

<member><function>ldap_next_attribute</function></member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->