Museum

 lcs_get_table(PCI)             6 January 1993             lcs_get_table(PCI)


 Name

    lcs_get_table - get language character set conversion table

 Syntax


    #include <lcs.h>

    lcs_tbl lcs_get_table(table, lcspath_default)
    char *table, *lcspath_default;


 Description

    This function opens a translation table that the other language character
    set functions can use.  It returns NULL if the table is not available.
    The LCSPATH environment variable specifies the directory where the trans-
    lation tables are stored.  If the environment variable is not found,
    lcspathdefault is used.  The format of the file opened is
    $LCSPATH/table.lcs.  LCSPATH can contain multiple directories separated
    by semicolons.

 Return value

    On successful completion, an lcstbl is returned.  NULL is returned if
    the table is not available.  Error codes are returned in lcserrno.

 Example


       #include <lcs.h>
       #define LCSPATH_DEFAULT "c:\\pci\\lib;c:\\usr\\lib\\merge\\lcs"
       lcs_tbl input_table;
       char *input_tbl_name="pc437";        /* use DOS code page 437 */
               :
               :
       /* Set input table */
       if ((input_table = lcs_get_table(input_tbl_name,
                          LCSPATH_DEFAULT)) == NULL) {
               errorHandler();
       }
               :
               :


 See also

    lcsintro(PCI)