Struct ldap3::SearchEntry

pub struct SearchEntry {
    pub dn: String,
    pub attrs: HashMap<String, Vec<String>>,
    pub bin_attrs: HashMap<String, Vec<Vec<u8>>>,
}

Parsed search result entry.

While LDAP attributes can have a variety of syntaxes, they’re all returned in search results as octet strings, without any associated type information. A general-purpose result parser could leave all values in that format, but then retrieving them from user code would be cumbersome and tedious.

For that reason, the parser tries to convert every value into a String. If an attribute can contain unconstrained binary strings, the conversion may fail. In that case, the attribute and all its values will be in the bin_attrs hashmap. Since it’s possible that a particular set of values for a binary attribute could be converted into UTF-8 Strings, the presence of of such attribute in the result entry should be checked for both in attrs and bin_atrrs.

Fields

dn: String

Entry DN.

attrs: HashMap<String, Vec<String>>

Attributes.

bin_attrs: HashMap<String, Vec<Vec<u8>>>

Binary-valued attributes.

Implementations

impl SearchEntry

pub fn construct(re: ResultEntry) -> SearchEntry

Parse raw BER data and convert it into attribute map(s).

Note: this function will panic on parsing error.

Trait Implementations

impl Clone for SearchEntry

fn clone(&self) -> SearchEntry

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SearchEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.