svn: /pear/peardoc/trunk/en/package/networking/net-ldap2/ filter.xml

beni                                     Thu, 27 Oct 2011 12:55:31 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=318469

Log:
* Example for filter negation

Changed paths:
    U   pear/peardoc/trunk/en/package/networking/net-ldap2/filter.xml

Modified: pear/peardoc/trunk/en/package/networking/net-ldap2/filter.xml
===================================================================
--- pear/peardoc/trunk/en/package/networking/net-ldap2/filter.xml	2011-10-27 12:43:37 UTC (rev 318468)
+++ pear/peardoc/trunk/en/package/networking/net-ldap2/filter.xml	2011-10-27 12:55:31 UTC (rev 318469)
@@ -152,6 +152,9 @@
                         </tbody>
                     </tgroup>
                 </table>
+                Since Net_LDAP2 2.0.12 you can also negate the match rules by using the <literal>not</literal> keyword
+                to easily negate the basic filter expression. Prior to that, you had to use <function>combine</function>
+                manually.
             </para>
             <example><info><title>Creating LDAP filters</title></info>

@@ -159,6 +162,11 @@
 // Filter entries whose first name is 'Benedikt':
 $filter = Net_LDAP2_Filter::create('givenName', 'equals', 'Benedikt');

+// Filter entries whose first name is NOT 'Benedikt':
+// (this was first introduced in 2.0.12)
+$filter = Net_LDAP2_Filter::create('givenName', 'not equals', 'Benedikt');
+$filter = Net_LDAP2_Filter::create('givenName', '! =', 'Benedikt'); // works too :)
+
 // Filter entries whose first name starts with 'Steph':
 $filter = Net_LDAP2_Filter::create('givenName', 'begins', 'Steph');