_mb_strlen( string $str, string|null $encoding = null ): int

Description

Parameters

$strstring

The string to retrieve the character length from.

$encodingstring|nulloptional

Count characters according to this encoding. Default is to consult blog_charset.Default: null

Return

int

Count of code points if UTF-8, byte length otherwise.

Uses · 3

• _is_utf8_charset()Indicates if a given slug for a character set represents the UTF-8 text encoding.
• get_option()Retrieves an option value based on an option name.
• _wp_utf8_codepoint_count()Returns how many code points are found in the given UTF-8 string.

Used by · 1

• mb_strlen()Compat function to mimic mb_strlen().

Source

View on Trac ↗View on GitHub ↗

225function _mb_strlen( $str, $encoding = null ) {226	return _is_utf8_charset( $encoding ?? get_option( 'blog_charset' ) )227		? _wp_utf8_codepoint_count( $str )228		: strlen( $str );229}

History

Introduced in 4.2.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/compat.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.