Museum

 lcs_set_options(PCI)           6 January 1993           lcs_set_options(PCI)


 Name

    lcs_set_options - sets language character set conversion table options


 Syntax


    #include <lcs.h>

    void lcs_set_options(mode, default_char, country)
    unsigned short mode;
    unsigned short default_char;
    short country;


 Description

    The mode argument is a bitmap of translation options:

    LCSMODENOMULTIPLE  Don't translate a character into multiple glyph.

    LCSMODESTOPXLAT    Stop translating when a character that cannot be
                          translated exactly is encountered.

    LCSMODEUSERCHAR    Use the user-specified defaultchar for translation
                          failures.

    LCSMODEUPPERCASE    Perform the lower-to-uppercase translation as well
                          as character set translation.

    LCSMODELOWERCASE    Perform the upper-to-lowercase translation as well
                          as character set translation.

    When an untranslatable character is encountered and the
    LCSMODESTOPXLAT bit is not set, a best single-byte translation is
    used.

    When both of the options LCSMODEUPPERCASE and LCSMODELOWERCASE are
    specified, the upper-to-lowercase translation is performed.

    The default mode is 0.

    The defaultchar argument is the character to use when an untranslatable
    character is encountered if the options LCSMODEUSERCHAR and
    LCSMODENOMULTIPLE are set. If the LCSMODENOMULTIPLE option is not
    set and the LCSMODEUSERCHAR option is set, an untranslatable character
    results in a multibyte character if one exists or in defaultchar if no
    multibyte character exists.

    The country option is used for country-specific modifications to the
    upper- and lowercase translations.  This should be a DOS country number.
    If the country number is not recognized by the system, no modifications
    are made.
    The default country is 1 (US).

 Example


       #include <lcs.h>
       /* use our own default character,
        * rather than '*'.
        * Also, don't allow multiple character
        * translations (e.g.: don't translate
        * the ISO 8859-1 three-quarters symbol
        * into the three byte '3/4').
        */
       short mode = LCS_MODE_USER_CHAR | LCS_MODE_NO_MULTIPLE;
       unsigned short default_char = '!';       /* use ! for default character */
       short country = 1;                       /* country code 1 is US */
               :
               :
       /* Now that we've got our tables,
        * set the options.
        */
       lcs_set_options(mode, default_char, country);
               :
               :


 See also

    lcsintro(PCI)