Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-99A8BF10-6B24-456F-8FAB-BBAC95A11D6A
Visible to Intel only — GUID: GUID-99A8BF10-6B24-456F-8FAB-BBAC95A11D6A
MBStrLead
NLS Function: Performs a context-sensitive test to determine whether a given character byte in a string is a multibyte-character lead byte. This routine is only available for Windows.
Module
USE IFNLS
result = MBStrLead (string,position)
string |
(Input) Character*(*). Is a string containing the character byte to be tested for lead status. |
position |
(Input) INTEGER(4). Is the position in string of the character byte in the string to be tested. |
Results
The result type is LOGICAL(4). The result is .TRUE. if the character byte in position of string is a lead byte; otherwise, .FALSE..
MBStrLead is passed a whole string and can identify any byte within the string as a lead or trail byte because it performs a context-sensitive test, scanning all the way back to the beginning of a string if necessary to establish context.
MBLead is passed only one character at a time and must start on a lead byte and step through a string one character at a time to establish context for the character. So, MBStrLead can be much slower than MBLead (up to n times slower, where n is the length of the string).