Intel® Fortran Libraries Reference

Descriptions of the Library Routines 2unicodestr(Input) INTEGER(2). Array of integers holding the Unicode string to be translated.mbstr(Output) Character*(*). Translation of Unicode string into multibyte character string from thecurrent codepage.flags(Optional; input) INTEGER(4). If specified, argument to modify the string conversion. If flags isomitted, no extra checking of the conversion takes place. Available values (defined inIFNLS.F90) are:• NLS$CompositeCheck: Convert composite characters to precomposed.• NLS$SepChars: Generate separate characters.• NLS$DiscardDns: Discard nonspacing characters.• NLS$DefaultChars: Replace exceptions with default character.The last three flags (NLS$SepChars, NLS$DiscardDns, and NLS$DefaultChars) are mutuallyexclusive and can be used only if NLS$CompositeCheck is set, in which case one (and only one)of them is combined with NLS$CompositeCheck using an inclusive OR (IOR or OR). These flagsdetermine what translation to make when there is no precomposed mapping for a basecharacter/nonspace character combination in the Unicode wide character string. The default(IOR(NLS$CompositeCheck, NLS$SepChars)) is to generate separate characters.Results:The result type is INTEGER(4). If no error occurs, returns the number of bytes written to mbstr(bytes are counted, not characters), or the number of bytes required to hold the output string ifmbstr has zero length. If mbstr is longer than the translation, it is blank-padded. If mbstr is zerolength, the function returns the number of bytes required to hold the translation and nothing iswritten to mbstr.If an error occurs, one of the following negative values is returned:• NLS$ErrorInsufficentBuffer: The mbstr argument is too small, but not zero length so that theneeded number of bytes is returned.• NLS$ErrorInvalidFlags: The flags argument has an illegal value.CompatibilityCONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIBSee Also: “MBConvertMBToUnicode”2-203