Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <mbstring.h>
    int _ismbcl1( unsigned int ch );

Description:
    The _ismbcl1 function tests if the argument ch is a JIS (Japan
    Industrial Standard) level 1 double-byte character code.  These are any
    valid double-byte characters for which the following expression is true:


         0x889F <= ch <= 0x9872

    The _ismbcl1 function tests if the argument is a valid double-byte
    character (i.e., it checks that the lower byte is not in the ranges 0x00
    - 0x3F, 0x7F, or 0xFD - 0xFF).

    Note:  JIS establishes two levels of the Kanji double-byte character
    set.  One is called double-byte Kanji code set level 1 and the other is
    called double-byte Kanji code set level 2.  Usually Japanese personal
    computers have font ROM/RAM support for both levels.

    Valid double-byte characters are those in which the first byte falls in
    the range 0x81 - 0x9F or 0xE0 - 0xFC and whose second byte falls in the
    range 0x40 - 0x7E or 0x80 - 0xFC.

Returns:
    The _ismbcl1 function returns a non-zero value when the argument is a
    member of this set of characters; otherwise, zero is returned.


Example:
    #include <stdio.h>
    #include <mbctype.h>
    #include <mbstring.h>

    unsigned int chars[] = {
        'A',
        0x8140, /* double-byte space */
        0x8143, /* double-byte , */
        0x8260, /* double-byte A */
        0x829F, /* double-byte Hiragana */
        0x8340, /* double-byte Katakana */
        0x837F, /* illegal double-byte character */
        0x889E, /* double-byte L0 character */
        0x889F, /* double-byte L1 character */
        0x989F, /* double-byte L2 character */
        0xA6    /* single-byte Katakana */
    };

    #define SIZE sizeof( chars ) / sizeof( unsigned int )

    void main()
      {
        int   i;

        _setmbcp( 932 );
        for( i = 0; i < SIZE; i++ ) {
          printf( "%#6.4x is %sa valid "
                "JIS L1 character\n",
                chars[i],
                ( _ismbcl1( chars[i] ) ) ? "" : "not " );
        }
      }

    produces the following:

    0x0041 is not a valid JIS L1 character
    0x8140 is not a valid JIS L1 character
    0x8143 is not a valid JIS L1 character
    0x8260 is not a valid JIS L1 character
    0x829f is not a valid JIS L1 character
    0x8340 is not a valid JIS L1 character
    0x837f is not a valid JIS L1 character
    0x889e is not a valid JIS L1 character
    0x889f is a valid JIS L1 character
    0x989f is not a valid JIS L1 character
    0x00a6 is not a valid JIS L1 character

Classification:
    WATCOM

Systems:
    DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    _getmbcp, _ismbcalnum, _ismbcalpha, _ismbccntrl, _ismbcdigit,
    _ismbcgraph, _ismbchira, _ismbckata, _ismbcl0, _ismbcl2, _ismbclegal,
    _ismbclower, _ismbcprint, _ismbcpunct, _ismbcspace, _ismbcsymbol,
    _ismbcupper, _ismbcxdigit, _mbbtype, _setmbcp