char2ops.h

/* char2ops.h */
/* $Id: char2ops.h,v 1.1 2000/02/11 12:55:22 vlad Exp $ */
#ifndef __char2ops_h
#define __char2ops_h

/* wchar_t definition */
#include <stddef.h>
#include <stdlib.h> /* mb & wc functions */
#include <string.h>

#include <mix/Types.h>
#include <mix/trans.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */



/***********************************************************************
 * Two-byte character macros
 ***********************************************************************/

/* Convert two bytes to Char2 type */
#define to_c2(Lead,Tail)    ((((Lead)&0xffU)<<8)+((Tail)&0xffU))

/* Convert Char2 type to lead and tail bytes */
#define c2_lead(C)      (((C)>>8)&0xffU)
#define c2_tail(C)      ((C)&0xffU)

/* Convert Char2 to wchar_t */
#define c2_to_wc(C)     ((wchar_t)(C))

/* Convert wchar_t to Char2 */
#define wc_to_c2(WC)        ((WC)&0xffffU)


/***********************************************************************
 * Wide char, two-byte char and multibyte strings services.
 ***********************************************************************/

/* Return number of symbols in wcstr (wide char string) */
int     wcs_symbols (const wchar_t* wcstr);

/* Return number of symbols in c2str (Char2 string) */
int     c2s_symbols (const Char2* c2str);

/* Return exact number of true symbols in mbstr (multibyte string) */
int     mbs_symbols (const char* mbstr);

/* Return approximate number of chars needed for multibyte string
   representation (+ EOL) */
#define     wcs_to_mbstrlen (const wchar_t* wcstr)  \
            (1 + sizeof(wchar_t) * wcs_symbols(wcstr))

/* Return approximate number of chars needed for multibyte string
   representation (+ EOL) */
#define     c2s_to_mbstrlen (const Char2* c2str)    \
            (1 + sizeof(Char_2) * c2s_symbols(c2str))


/* Next convertion functions allocates memory by malloc() if target
   pointer (last argument) is NULL. */

/* Convert wchar_t string to Char2* string of expected size */
Char2*      wcs_to_c2s (const wchar_t* wcstr, Char2* c2str);

/* Convert Char2* string to wchar_t string of expected size */
wchar_t*    c2s_to_wcs (const Char2* c2str, wchar_t* wcstr);

/* Convert multibyte string to Char2* string of expected size,
   meaning that multibyte string is given in mbenc encoding. */
Char2*      mbs_to_c2s (TextEncoding mbenc, const char* mbstr,
                Char2* c2str);

/* Convert multibyte string to wchar_t string of expected size,
   meaning that multibyte string is given in mbenc encoding. */
wchar_t*    mbs_to_wcs (TextEncoding mbenc, const char* mbstr,
                wchar_t* wcstr);


#ifdef __cplusplus
};
#endif /* __cplusplus */

#endif /* char2ops.h */