Intel® Fortran Libraries Reference

2 Intel Fortran Libraries Reference• NLS$UseGlyphChars: Use glyph characters instead of control characters.• NLS$ErrorOnInvalidChars: Returns –1 if an invalid input character is encountered.The flags NLS$Precomposed and NLS$Composite are mutually exclusive. You can combineNLS$UseGlyphChars with either NLS$Precomposed or NLS$Composite using an inclusive OR(IOR or OR).Results:The result type is INTEGER(4). If no error occurs, the result is the number of bytes written tounicodestr (bytes are counted, not characters), or the number of bytes required to hold the outputstring if unicodestr has zero size. If the unicodestr array is bigger than needed to hold thetranslation, the extra elements are set to space characters. If unicodestr has zero size, the functionreturns the number of bytes required to hold the translation and nothing is written to unicodestr.If an error occurs, one of the following negative values is returned:• NLS$ErrorInsufficentBuffer: The unicodestr argument is too small, but not zero size so thatthe needed number of bytes would be returned.• NLS$ErrorInvalidFlags: The flags argument has an illegal value.• NLS$ErrorInvalidCharacter: A character with no Unicode translation was encountered inmbstr. This error can occur only if the NLS$InvalidCharsError flag was used in flags.NOTE. By default, or if flags is set to NLS$Precomposed, the functionMBConvertMBToUnicode attempts to translate the multibyte codepage stringto a precomposed Unicode string. If a precomposed form does not exist, thefunction attempts to translate the codepage string to a composite form.CompatibilityCONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIBSee Also: “MBConvertUnicodeToMB”MBConvertUnicodeToMBNLS Function: Converts a Unicode string to a multibyte-character string from the currentcodepage. This function is only available on Windows* systems.Module: USE IFNLSSyntaxresult = MBConvertUnicodeToMB (unicodestr, mbstr [, flags])2-202