<?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:----EAFOMayNK2BXjbg6ICmnGd/V+auBaIaJy/ZAhXDG3wrvXYXjSoNprXD9IX1Bs9dmH4zd5yVWLbWqwjqV/HhHkes7bUbPnpBQwKbqdLLHhQjTgarhaiyvW4xReKs4m6fl4l/6ifZLAqSJ+Obauri8XcJnvVnY/NXkBPR7u3n7JfTqBdMbzJt4j0oSM2G/WbbkaPcdxNMfJfZda8i7JqHH60TPYgLi1pS4tW/xnnuK3uI8k1BEcCgECmUpmnNAw6LGtNT4bcK4I+qDbjsAyZ12oKPEjWwxZRKFt1FjKbz+R2GDQECCaCoaZAahH2T44fBxuH9VFgweEy/H5X2EtYUjV9eLZJKlMlRqJreVBAPO+UuhMHXcvM5Lwpq9BoeavWFTf3j6aOpPKxOEYB4CuitjZegDvBTToKyAQM2JF74pdYKZml6NXgJCjedFf7uAtr66414xHSMF03PJrbScz4PbYBlbxd7T23949j4tUTpTPWdoL60cAaSpfGIvQs0fl5BEv9tW21TuUj66tl6BGlcbweiuBO34dI61Ytsxdh8WPU4uOnCDhCJnjt/FeU8CeCs99zecmN+dlnwK5JPpbwbpjKbI4IM8BwkIFNosBHElZmsPJANURY5SlBP2eRl8+a8MMIIwdmKK9fHvANF6894RdkGaUD6lyxdArSuDykBZYOk=----ATTACHMENT:----MTc0ODIxMzA0NzMxNzE4MyA1MzQwNjIzMjQ0NTgyOTc1IDgyNDQ2NTk0ODI1MDcyMjQ=