std::mblen
Template:cpp/string/multibyte/sidebar
| Defined in header <cstdlib>
|
||
| int mblen( const char* s, std::size_t n ); |
||
Determines the size, in bytes, of the multibyte character whose first byte is pointed to by s.
If s is a null pointer, resets the global conversion state and determined whether shift sequences are used.
This function is equivalent to the call Template:cpp, except that conversion state of Template:cpp is unaffected.
Contents |
Notes
Each call to mblen updates the internal global conversion state (a static object of type Template:cpp, only known to this function). If the multibyte encoding uses shift states, care must be taken to avoid backtracking or multiple scans. In any case, multiple threads should not call mblen without synchronization: Template:cpp may be used instead.
Parameters
| s | - | pointer to the multibyte character |
| n | - | limit on the number of bytes in s that can be examined |
Return value
If s is not a null pointer, returns the number of bytes that are contained in the multibyte character or Template:cpp if the first bytes pointed to by s do not form a valid multibyte character or Template:cpp if s is pointing at the null charcter Template:cpp.
If s is a null pointer, resets its internal conversion state to represent the initial shift state and returns Template:cpp if the current multibyte encoding is not state-dependent (does not use shift sequences) or a non-zero value if the current multibyte encoding is state-dependent (uses shift sequences).
