<?php
/**
 * PHP 7.4-safe string helpers (the plugin supports PHP 7.4, which lacks the PHP 8 str_* functions).
 *
 * @package BRVerify
 */

declare(strict_types=1);

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Whether $haystack contains $needle.
 *
 * @param string $haystack Haystack.
 * @param string $needle   Needle.
 */
function brverify_str_contains( string $haystack, string $needle ): bool {
	return '' === $needle || false !== strpos( $haystack, $needle );
}

/**
 * Whether $haystack starts with $needle.
 *
 * @param string $haystack Haystack.
 * @param string $needle   Needle.
 */
function brverify_str_starts_with( string $haystack, string $needle ): bool {
	return 0 === strncmp( $haystack, $needle, strlen( $needle ) );
}

/**
 * Whether $haystack ends with $needle.
 *
 * @param string $haystack Haystack.
 * @param string $needle   Needle.
 */
function brverify_str_ends_with( string $haystack, string $needle ): bool {
	$len = strlen( $needle );
	return 0 === $len || ( strlen( $haystack ) >= $len && 0 === substr_compare( $haystack, $needle, -$len, $len ) );
}