WP_Duotone::colord_parse_rgba_string │ private static │ WP 6.3.0

Parses a valid RGB[A] CSS color function/string.

Direct port of colord's parseRgbaString function.

Method of the class: WP_Duotone{}

No Hooks.

Returns

Array|null. An array of RGBA values or null if the RGB string is invalid.

Usage

$result = WP_Duotone::colord_parse_rgba_string( $input );
$input(string) (required)
The RGBA string to parse.

Changelog

Since 6.3.0 Introduced.

WP_Duotone::colord_parse_rgba_string() code WP 6.8.1

wp-includes/class-wp-duotone.php 
private static function colord_parse_rgba_string( $input ) {
	// Functional syntax.
	$is_match = preg_match(
		'/^rgba?\(\s*([+-]?\d*\.?\d+)(%)?\s*,\s*([+-]?\d*\.?\d+)(%)?\s*,\s*([+-]?\d*\.?\d+)(%)?\s*(?:,\s*([+-]?\d*\.?\d+)(%)?\s*)?\)$/i',
		$input,
		$match
	);

	if ( ! $is_match ) {
		// Whitespace syntax.
		$is_match = preg_match(
			'/^rgba?\(\s*([+-]?\d*\.?\d+)(%)?\s+([+-]?\d*\.?\d+)(%)?\s+([+-]?\d*\.?\d+)(%)?\s*(?:\/\s*([+-]?\d*\.?\d+)(%)?\s*)?\)$/i',
			$input,
			$match
		);
	}

	if ( ! $is_match ) {
		return null;
	}

	/*
	 * For some reason, preg_match doesn't include empty matches at the end
	 * of the array, so we add them manually to make things easier later.
	 */
	for ( $i = 1; $i <= 8; $i++ ) {
		if ( ! isset( $match[ $i ] ) ) {
			$match[ $i ] = '';
		}
	}

	if ( $match[2] !== $match[4] || $match[4] !== $match[6] ) {
		return null;
	}

	return self::colord_clamp_rgba(
		array(
			'r' => (float) $match[1] / ( $match[2] ? 100 / 255 : 1 ),
			'g' => (float) $match[3] / ( $match[4] ? 100 / 255 : 1 ),
			'b' => (float) $match[5] / ( $match[6] ? 100 / 255 : 1 ),
			'a' => '' === $match[7] ? 1 : (float) $match[7] / ( $match[8] ? 100 : 1 ),
		)
	);
}