terah / fluent-assert

     * @return Assert

     * @throws AssertionFailedException

     */

    public function length(int $length, string $message='', string $fieldName='', string $encoding='utf8') : Assert

    {

        if ( $this->doAllOrNullOr(__FUNCTION__, func_get_args()) )

        {

            return $this;

        }

        $this->string($message, $fieldName);

        if ( mb_strlen($this->value, $encoding) !== $length )

        {

            $message    = $message ?: $this->overrideError;

            $message    = sprintf(

                $message ?: 'Value "%s" has to be %d exactly characters long, but length is %d.',

                $this->stringify($this->value),

                $length,

                mb_strlen($this->value, $encoding)

            );

            $constraints = ['length' => $length, 'encoding' => $encoding];

            throw $this->createException($message, $this->overrideCode ?: self::INVALID_LENGTH, $fieldName, $constraints);

        }

        return $this;

    }

    /**

     * Assert that value is a string and has a character count which is

     * @return Assert

     * @throws AssertionFailedException

     */

    public function minLength(int $minLength, string $message='', string $fieldName='', string $encoding='utf8') : Assert

    {

        if ( $this->doAllOrNullOr(__FUNCTION__, func_get_args()) )

        {

            return $this;

        }

        $this->string($message, $fieldName);

        if ( mb_strlen($this->value, $encoding) < $minLength )

        {

            $message = $message ?: $this->overrideError;

            $message     = sprintf(

                $message

                    ?: 'Value "%s" is too short, it should have more than %d characters, but only has %d characters.',

                $this->stringify($this->value),

                $minLength,

                mb_strlen($this->value, $encoding)

            );

            $constraints = ['min_length' => $minLength, 'encoding' => $encoding];

            throw $this->createException($message, $this->overrideCode ?: self::INVALID_MIN_LENGTH, $fieldName, $constraints);

        }

        return $this;

    }

    /**

     * Assert that value is a string and has a character count which is

     * @return Assert

     * @throws AssertionFailedException

     */

    public function maxLength(int $maxLength, string $message='', string $fieldName='', string $encoding='utf8') : Assert

    {

        if ( $this->doAllOrNullOr(__FUNCTION__, func_get_args()) )

        {

            return $this;

        }

        $this->string($message, $fieldName);

        if ( mb_strlen($this->value, $encoding) > $maxLength )

        {

            $message = $message ?: $this->overrideError;

            $message     = sprintf(

                $message ?: 'Value "%s" is too long, it should have no more than %d characters, but has %d characters.',

                $this->stringify($this->value),

                $maxLength,

                mb_strlen($this->value, $encoding)

            );

            $constraints = ['max_length' => $maxLength, 'encoding' => $encoding];

            throw $this->createException($message, $this->overrideCode ?: self::INVALID_MAX_LENGTH, $fieldName, $constraints);

        }

        return $this;

    }

    /**

     * Assert that value has a length between min,max lengths (inclusive).

     * @return Assert

     * @throws AssertionFailedException

     */

    public function startsWith(string $needle, string $message='', string $fieldName='', string $encoding='utf8') : Assert

    {

        if ( $this->doAllOrNullOr(__FUNCTION__, func_get_args()) )

        {

            return $this;

        }

        $this->string($message, $fieldName);

        if ( mb_strpos($this->value, $needle, 0, $encoding) !== 0 )

        {

            $message = $message ?: $this->overrideError;

            $message     = sprintf(

                $message ?: 'Value "%s" does not start with "%s".',

                $this->stringify($this->value),

                $this->stringify($needle)

            );

            $constraints = ['needle' => $needle, 'encoding' => $encoding];

            throw $this->createException($message, $this->overrideCode ?: self::INVALID_STRING_START, $fieldName, $constraints);

        }

        return $this;

    }

    /**

     * Assert that value ends with a sequence of chars.

     * @return Assert

     * @throws AssertionFailedException

     */

    public function contains(string $needle, string $message='', string $fieldName='', string $encoding='utf8') : Assert

    {

        if ( $this->doAllOrNullOr(__FUNCTION__, func_get_args()) )

        {

            return $this;

        }

        $this->string($message, $fieldName);

        if ( mb_strpos($this->value, $needle, 0, $encoding) === false )

        {

            $message = $message ?: $this->overrideError;

            $message     = sprintf(

                $message ?: 'Value "%s" does not contain "%s".',

                $this->stringify($this->value),

                $this->stringify($needle)

            );

            $constraints = ['needle' => $needle, 'encoding' => $encoding];

            throw $this->createException($message, $this->overrideCode ?: self::INVALID_STRING_CONTAINS, $fieldName, $constraints);

        }

        return $this;

    }

    /**

     * Assert that value is in an array of choices.