glcStringType(3G)

NAME
     glcStringType - assign a value to GLC_STRING_TYPE


C SPECIFICATION
     void glcStringType( GLCenum inStringType )


PARAMETERS
     inStringType  Value to assign to GLC_STRING_TYPE.

DESCRIPTION
     glcStringType assigns the value in inStringType to the variable
     GLC_STRING_TYPE. GLC supports the string types GLC_UCS1, GLC_UCS2, and
     GLC_UCS4.

     Every character string used in the GLC API is represented as a zero-
     terminated array, unless otherwise specified.  The value of the variable
     GLC_GLC_STRING_TYPE determines the interpretation of the array. The
     values GLC_UCS1, GLC_UCS2, and GLC_UCS4 specify that each array element
     is a UCS code of type GL_ubyte, GL_ushort, or GL_int, respectively. The
     initial value of GLC_STRING_TYPE is GLC_UCS1.

     Some GLC commands return strings. The return value of these commands is a
     pointer to a string return buffer in the issuing thread's current GLC
     context. This pointer is valid until the next GLC command is issued. The
     pointer may be used as a parameter to the next GLC command. The client
     must copy the returned string to a client-provided buffer if the value of
     the string is needed after the next GLC command is issued.

     The value of a character code in a returned string may exceed the range
     of the character encoding selected by GLC_STRING_TYPE. In this case, the
     returned character is converted to a character sequence \<hexcode>, where
     \ is the charcter REVERSE SOLIDUS (U+5C), < is the character LESS-THAN
     SIGN (U+3C), > is the character GREATER-THAN SIGN (U+3E), and hexcode is
     the original character code represented as a sequence of hexadecimal
     digits. The sequence has no leading zeros, and alphabetic digits are in
     upper case.

ERRORS
     GLC_STATE_ERROR is generated if the issuing thread has no current GLC
     context.

ASSOCIATED GETS
     glcGeti with argument GLC_STRING_TYPE