Net::LD...erMatch(3)

💖 NAME 💖

okay bestie, welcome to the Net::LDAP::FilterMatch(3) page — the header truncates it to Net::LD...erMatch(3) because terminal width is dramatic, but the module is Net::LDAP::FilterMatch, and it does LDAP entry matching. That's the whole vibe. ✨

---

✨ SYNOPSIS ✨

  use Net::LDAP::Entry;
  use Net::LDAP::Filter;
  use Net::LDAP::FilterMatch;

  my $entry = new Net::LDAP::Entry;
  $entry->dn("cn=dummy entry");
  $entry->add (
   'cn' => 'dummy entry',
   'street' => [ '1 some road','nowhere' ] );

  my @filters = (qw/(cn=dummy*)
                 (ou=*)
                 (&(cn=dummy*)(street=*road))
                 (&(cn=dummy*)(!(street=nowhere)))/);

  for (@filters) {
    my $filter = Net::LDAP::Filter->new($_);
    print $_,' : ', $filter->match($entry) ? 'match' : 'no match' ,"\n";
  }

---

🧚 ABSTRACT 🧚

This extension of the class Net::LDAP::Filter provides entry matching functionality on the Perl side. Slay. 💅

Give it an entry and it will tell you whether the entry matches the filter object. That's literally the job.

It can be used on its own, or as part of a Net::LDAP::Server based LDAP server. Versatile icon behavior. 🦋

---

💅 METHOD 💅

🎯 match ( ENTRY [ ,SCHEMA ] )

Return whether ENTRY matches the filter object. If a schema object is provided, the selection of matching algorithms will be derived from schema.

In case of error, undef is returned. Not a slay, but important to know. 😭

For approximate matching like (cn~=Schmidt) there are several modules that can be used. By default the following modules will be tried in this order:

1. String::Approx
2. Text::Metaphone
3. Text::Soundex

If none of these modules is found, it will fall back on a simple regexp algorithm. Backup plan energy. 🫶

If you want to specifically use one implementation only, simply do:

  use Net::LDAP::FilterMatch qw(Text::Soundex);

---

🔥 SEE ALSO 🔥

• Net::LDAP::Filter

---

👑 COPYRIGHT 👑

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

🎀 AUTHORS 🎀

• Hans Klunder <hans.klunder@bigfoot.com>
• Peter Marschall <peter@adpm.de>

---

mwah 💋 this was the Net::LD...erMatch(3) page, from perl v5.42.0, dated 2024-01-02. periodt. 🌈👑