W3cubDocs

/WordPress

wpdb::check_ascii( string $input_string ): bool

Checks if a string is ASCII.

Description

The negative regex is faster for non-ASCII strings, as it allows the search to finish as soon as it encounters a non-ASCII character.

Parameters

$input_stringstringrequired
String to check.

Return

bool True if ASCII, false if not.

Source

protected function check_ascii( $input_string ) {
	if ( function_exists( 'mb_check_encoding' ) ) {
		if ( mb_check_encoding( $input_string, 'ASCII' ) ) {
			return true;
		}
	} elseif ( ! preg_match( '/[^\x00-\x7F]/', $input_string ) ) {
		return true;
	}

	return false;
}

Changelog

Version Description
4.2.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wpdb/check_ascii