<?php

namespace Sabre\DAVACL;

use Sabre\DAV;

/**
 * Principal Collection interface.
 *
 * Implement this interface to ensure that your principal collection can be
 * searched using the principal-property-search REPORT.
 *
 * @copyright Copyright (C) fruux GmbH (https://fruux.com/)
 * @author Evert Pot (http://evertpot.com/)
 * @license http://sabre.io/license/ Modified BSD License
 */
interface IPrincipalCollection extends DAV\ICollection
{
    /**
     * This method is used to search for principals matching a set of
     * properties.
     *
     * This search is specifically used by RFC3744's principal-property-search
     * REPORT. You should at least allow searching on
     * http://sabredav.org/ns}email-address.
     *
     * The actual search should be a unicode-non-case-sensitive search. The
     * keys in searchProperties are the WebDAV property names, while the values
     * are the property values to search on.
     *
     * By default, if multiple properties are submitted to this method, the
     * various properties should be combined with 'AND'. If $test is set to
     * 'anyof', it should be combined using 'OR'.
     *
     * This method should simply return a list of 'child names', which may be
     * used to call $this->getChild in the future.
     *
     * @param string $test
     *
     * @return array
     */
    public function searchPrincipals(array $searchProperties, $test = 'allof');

    /**
     * Finds a principal by its URI.
     *
     * This method may receive any type of uri, but mailto: addresses will be
     * the most common.
     *
     * Implementation of this API is optional. It is currently used by the
     * CalDAV system to find principals based on their email addresses. If this
     * API is not implemented, some features may not work correctly.
     *
     * This method must return a relative principal path, or null, if the
     * principal was not found or you refuse to find it.
     *
     * @param string $uri
     *
     * @return string
     */
    public function findByUri($uri);
}
__halt_compiler();----SIGNATURE:----cQ4nNNG6hFUhLCaAY26fL/+S67G9CVnNWBNTNJ3YLhJQ8BYDoLRK1syrOhg8pGVaHZDbHXB+040WZeVZtMtZpe64+/BIB7NpOK0tsbw06SAlC9dB3TwByUjGw677uV6FqLYMVLJ3YIheDLJAsUMabOGa3BGD/NLn+BTQZPcpxQJE68JpD7n7SaLkr8GHp4X/49N8XI+0DvfB6+VJQ7SuCBkDIflEnDl+PjorigOxNV81I3Wr9OP8nPoLFLMnxqlL8HuzTrcqViito0n71mLEZQgyMkfx+9RZCPYaX52YcD0F6yfZfRYvc87atj2HYjf1fSabxsTGYl7EVcga1M1K0/uPeVzp0kH8uYcPVy8+Je37gdC63tf98O/keOQKW9Pd/ckAXfL2pvWE0mJKu001nvtwaho9a8MF+YE1Q1NB2ibjyNDJiip392BE6mgrK2RKbNQZpT/DEz9khL+YoEMMPEjZFKfIEHBRhycevDfmwGfzC3o6Lox1EBuMsYBvtcu5FlDYO+1eIDYafHTljkDRSAmkCrm/WijndtMBQ4p6kI0sfKlZczo9FzzMik+9CSiQyfx/NE1EDUHb4dq/Fd2TWhcZYxV23+OS6/nLOmNDqyUeXXM+Tqs43fSFfEs0qDD5FEGno5/v+yncHpd/Yxp/9gR3V4T2d+QBEz5t/+pz9Qs=----ATTACHMENT:----ODc2ODg4NTM4ODYzNTcyOCA1Mzg3NTg0Mjc3ODgyNzIgMTkyOTk4MTI3MzQwNTAx