endtoend-test-psl/tests/Psl/Str/Grapheme/SliceTest.php

<?php

declare(strict_types=1);

namespace Psl\Tests\Str\Grapheme;

use PHPUnit\Framework\TestCase;
use Psl\Exception;
use Psl\Str\Grapheme;

final class SliceTest extends TestCase
{
    /**
     * @dataProvider provideData
     */
    public function testSlice(string $expected, string $string, int $offset, ?int $length = null): void
    {
        static::assertSame($expected, Grapheme\slice($string, $offset, $length));
    }

    public function provideData(): array
    {
        return [
            ['', '', 0, 0, ],
            ['Hello', 'Hello, World!', 0, 5],
            ['Hello, World!', 'Hello, World!', 0],
            ['World', 'Hello, World!', 7, 5],
            ['سيف', 'مرحبا سيف', 6, 3],
            ['اهلا', 'اهلا بكم', 0, 4],
            ['destiny', 'People linked by destiny will always find each other.', 17, 7],
            ['lö ', 'héllö wôrld', 3, 3, ],
            ['lö wôrld', 'héllö wôrld', 3, null, ],
            ['', 'héllö wôrld', 3, 0],
            ['', 'fôo', 3, null, ],
            ['', 'fôo', 3, 12, ],
            ['wôrld', 'héllö wôrld', -5, null, ],
            ['wôrld', 'héllö wôrld', -5, 100, ],
            ['wôr', 'héllö wôrld', -5, 3, ],
        ];
    }

    public function testSliceThrowsForNegativeLength(): void
    {
        $this->expectException(Exception\InvariantViolationException::class);

        Grapheme\slice('Hello', 0, -1);
    }

    public function testSliceThrowsForOutOfBoundOffset(): void
    {
        $this->expectException(Exception\InvariantViolationException::class);

        Grapheme\slice('Hello', 10);
    }

    public function testSliceThrowsForNegativeOutOfBoundOffset(): void
    {
        $this->expectException(Exception\InvariantViolationException::class);

        Grapheme\slice('hello', -6);
    }
}