[Toc][Index]

DosCaseMap


Bindings:  C, MASM 

This call performs case mapping on a string of binary values that 
represent ASCII characters. 
 DosCaseMap    (Length, Country, BinaryString) 
 
 Length (USHORT) - input 
    Length of the string of binary values to be case mapped. 
 Country (PCOUNTRYCODE) - input/output 
    Address of the country information structure: 
    country (USHORT) 
       Country code identifier is a binary value of the selected country 
       code. 0 is the default country code. 
    codepage (USHORT) 
       Code page identifier is a binary value of the selected code page. 0 
       is the code page of the current process. 
 BinaryString (PCHAR) - input/output 
    Address of a string of binary characters to be case mapped.  They are 
    case mapped in place so the results appear in BinaryString and the 
    input is destroyed. 
 rc (USHORT) - return 
    Return code descriptions are: 
    0         NO_ERROR 
    396       ERROR_NLS_NO_COUNTRY_FILE 
    397       ERROR_NLS_OPEN_FAILED 
    398       ERROR_NO_COUNTRY_OR_CODEPAGE 
    399       ERROR_NLS_TABLE_TRUNCATED 
 
 Remarks 
 DosCaseMap is mainly used to map a lower case character string to an 
 upper case character string.  Unless the user replaces the country 
 information file, DosCaseMap only does the conversion from lower case to 
 upper case. 
 The case map information is taken from the country information file. See 
 the COUNTRY statement in the IBM Operating System/2 Version 1.2 Command 
 Reference for information on how to specify the country information file. 
 
 If countrycode is 0, the case mapping is performed using the information 
 for the country specified in the COUNTRY statement in CONFIG.SYS. 
 If countrycode is not 0, the case mapping is performed using the 
 information for that country. 
 If the code page identifier is 0, the case mapping is performed using the 
 information for the current process code page. Refer to DosSetCp and the 
 CHCP command in the IBM Operating System/2 Version 1.2 Command Reference 
 for information on setting the process code page.  If codepage is not 0, 
 the case mapping is performed using the information for that code page. 
 The returned country dependent information may be for the default country 
 and current process code page or for a specific country and code page. 

Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs