<?php

namespace League\Uri\Contracts;

use Countable;
use Iterator;
use IteratorAggregate;
use League\Uri\Exceptions\SyntaxError;

/**
 * @extends IteratorAggregate<string>
 */
interface DomainHostInterface extends Countable, HostInterface, IteratorAggregate
{
    /**
     * Returns the labels total number.
     */
    public function count(): int;

    /**
     * Iterate over the Domain labels.
     *
     * @return Iterator<string>
     */
    public function getIterator(): Iterator;

    /**
     * Retrieves a single host label.
     *
     * If the label offset has not been set, returns the null value.
     */
    public function get(int $offset): ?string;

    /**
     * Returns the associated key for a specific label or all the keys.
     *
     * @param ?string $label
     *
     * @return int[]
     */
    public function keys(?string $label = null): array;

    /**
     * Tells whether the domain is absolute.
     */
    public function isAbsolute(): bool;

    /**
     * Prepends a label to the host.
     */
    public function prepend(string $label): self;

    /**
     * Appends a label to the host.
     */
    public function append(string $label): self;

    /**
     * Returns an instance with its Root label.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.2.2
     */
    public function withRootLabel(): self;

    /**
     * Returns an instance without its Root label.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.2.2
     */
    public function withoutRootLabel(): self;

    /**
     * Returns an instance with the modified label.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the new label
     *
     * If $key is non-negative, the added label will be the label at $key position from the start.
     * If $key is negative, the added label will be the label at $key position from the end.
     *
     * @throws SyntaxError If the key is invalid
     */
    public function withLabel(int $key, string $label): self;

    /**
     * Returns an instance without the specified label.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the modified component
     *
     * If $key is non-negative, the removed label will be the label at $key position from the start.
     * If $key is negative, the removed label will be the label at $key position from the end.
     *
     * @throws SyntaxError If the key is invalid
     */
    public function withoutLabel(int ...$keys): self;
}
__halt_compiler();----SIGNATURE:----YP+3VZUGke0X+kZjxfO40J2XCF2Dua3EjvD3vZZzlFdayTw7PfFa7rgLLJvNlHt18AMCxFEI19LM82c8rNrR8uy4BGwNBQ9Q+hA2TrVdSFE5Hkc5oSsjr5RsC2Cn8SeY6Ftf2ZieL+eTsneAAIkMKQUq+BN8OMdZgA0GcxJBtEtVzBRWNPFWktn72EQMapKCxSngNj3uvExDlNp5Yo5vNlkiap60C3SzCq10bkOePeTjNw5Gj2gcIJd2F1qwMPiDLAopM/oFqQgLEIcQiO6TCtUxulowyV/S/dkSDaEDpgKtYkH2PgMPCu5RcBqRy793F4r9tni43YB6N/kAhvvGsu87luA1VX9Hwjv3fVcaZpKXPYTMMAgmvZaxurnyQ3rR5wym0F/kByQzun4eoPBLJSnWENUon6pRjcY2nXlTYG7CZiFXnmnXK7MDDdOcDsKTUdfK02YMglkQZs1V0Ece1gkRAss3X+eh0HmSh+QVcza8qVkpGe24+c20Mlvvkdn2ZyzQ5VvgQHjLNiRi62eVIMHNro6u2+KCqkMEroWjgSyft7mutNzatjB0TtatUYSadcOtOfV0H3f+857g+/xnlY0NWW9WMOrDgI0f3BC9phExl+HNRmPZXGLCKFvI5weTvlfybyukfCVA5J1/07fjPrB3YjmnX4wZ3nKbAte/0rk=----ATTACHMENT:----ODgzNTQ3MzM0MTExMjA1MCAzMDc3NTM1NjYyMTIxMTEgMjY1ODkxMjIxNzQ2NTU5Nw==