<?php

declare(strict_types=1);

namespace libphonenumber;

use InvalidArgumentException;

use function mb_strlen;

/**
 * @no-named-arguments
 */
class PhoneNumberMatch
{
    /**
     * The start index into the text.
     */
    private int $start;

    /**
     * The raw substring matched.
     */
    private string $rawString;

    /**
     * The matched phone number.
     */
    private PhoneNumber $number;

    /**
     * Creates a new match
     *
     * @param int $start The start index into the target text
     * @param string $rawString The matched substring of the target text
     * @param PhoneNumber $number The matched phone number
     */
    public function __construct(int $start, string $rawString, PhoneNumber $number)
    {
        if ($start < 0) {
            throw new InvalidArgumentException('Start index must be >= 0.');
        }

        $this->start = $start;
        $this->rawString = $rawString;
        $this->number = $number;
    }

    /**
     * Returns the phone number matched by the receiver.
     */
    public function number(): PhoneNumber
    {
        return $this->number;
    }

    /**
     * Returns the start index of the matched phone number within the searched text.
     */
    public function start(): int
    {
        return $this->start;
    }

    /**
     * Returns the exclusive end index of the matched phone number within the searched text.
     */
    public function end(): int
    {
        return $this->start + mb_strlen($this->rawString);
    }

    /**
     * Returns the raw string matched as a phone number in the searched text.
     */
    public function rawString(): string
    {
        return $this->rawString;
    }

    public function __toString()
    {
        return "PhoneNumberMatch [{$this->start()},{$this->end()}) {$this->rawString}";
    }
}