{
    "mode": "perldoc",
    "parameter": "Net::LDAP::Search",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3ASearch/json",
    "generated": "2026-06-09T19:31:57Z",
    "synopsis": "use Net::LDAP;\n$mesg = $ldap->search( @searchargs );\n@entries = $mesg->entries;",
    "sections": {
        "NAME": {
            "content": "Net::LDAP::Search - Object returned by Net::LDAP search method\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "use Net::LDAP;\n\n$mesg = $ldap->search( @searchargs );\n\n@entries = $mesg->entries;\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "A Net::LDAP::Search object is returned from the search method of a Net::LDAP object. It is a\ncontainer object which holds the results of the search.\n",
            "subsections": []
        },
        "METHODS": {
            "content": "Net::LDAP::Search inherits from Net::LDAP::Message, and so supports all methods defined in\nNet::LDAP::Message.\n\nasstruct ( )\nReturns a reference to a HASH, where the keys are the DNs of the results and the values are\nHASH references. These second level HASHes hold the attributes such that the keys are the\nattribute names, in lowercase, and the values are references to an ARRAY holding the values.\n\nThis method will block until the whole search request has finished.\n\ncount ( )\nReturns the number of entries returned by the server.\n\nThis method will block until the whole search request has finished.\n\nentry ( INDEX )\nReturn the N'th entry (zero-based), which will be a Net::LDAP::Entry object. If INDEX is\ngreater or equal than the total number of entries returned then \"undef\" will be returned.\n\nThis method will block until the search request has returned enough entries.\n\nentries ( )\nReturn an array of Net::LDAP::Entry objects that were returned from the server.\n\nThis method will block until the whole search request has finished.\n\npopentry ( )\nPop an entry from the internal list of Net::LDAP::Entry objects for this search. If there\nare no more entries then \"undef\" is returned.\n\nThis call will block if the list is empty, until the server returns another entry.\n\nreferences ( )\nReturn a list of references that the server returned. This will be a list of\nNet::LDAP::Reference objects.\n\nsorted ( )\nReturn a list Net::LDAP::Entry objects, sorted by their DNs.\n\nThe sorting is done on the client side using Perl's alphanumerical sort operator \"cmp\".\n\nsorted ( ATTR, ... )\nReturn a list of Net::LDAP::Entry objects, sorted by the specified attributes. The\nattributes are compared in the order specified, each only being compared if all the prior\nattributes compare equal.\n\nThe sorting is done on the client side using Perl's alphanumerical sort operator \"cmp\".\n\nshiftentry ( )\nShift an entry from the internal list of Net::LDAP::Entry objects for this search. If there\nare no more entries then \"undef\" is returned.\n\nThis call will block if the list is empty, until the server returns another entry.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Net::LDAP, Net::LDAP::Message, Net::LDAP::Entry, Net::LDAP::Reference\n",
            "subsections": []
        },
        "ACKNOWLEDGEMENTS": {
            "content": "This document is based on a document originally written by Russell Fulton\n<r.fulton@auckland.ac.nz>.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Graham Barr <gbarr@pobox.com>\n\nPlease report any bugs, or post any suggestions, to the perl-ldap mailing list\n<perl-ldap@perl.org>.\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright (c) 1997-2004 Graham Barr. All rights reserved. This program is free software; you can\nredistribute it and/or modify it under the same terms as Perl itself.\n",
            "subsections": []
        }
    },
    "summary": "Net::LDAP::Search - Object returned by Net::LDAP search method",
    "flags": [],
    "examples": [],
    "see_also": []
}