Main Page | Modules | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

Text parsing functions
[GDI functions]

Data Structures

Functions

Detailed Description

MiniGUI uses logical font to output text, also uses logical font to parsing the multi-byte characters and words in the text.

Function Documentation

int GUIAPI GetFirstMCharLen (  PLOGFONT  log_font,
const char *  mstr,
int  len
) 
 

Retrives the length of the first multi-byte character in a string.

This function retrives and returns the length of the first multi-byte character in the string mstr which is len bytes long.

Parameters:
log_font The logical font used to parse the multi-byte string.
mstr The multi-byte string.
len The length of the string.
Returns:
The length of the first multi-byte character.
See also:
GetFirstWord

int GUIAPI GetFirstWord (  PLOGFONT  log_font,
const char *  mstr,
int  len,
WORDINFO *  word_info
) 
 

Retrives the length and info of the first multi-byte word in a string.

This function retrives the information of the first multi-byte character in the string mstr which is len bytes long, and returns it through word_info. It also returns the full length of the word including the delimiters after the word.

Parameters:
log_font The logical font used to parse the multi-byte string.
mstr The multi-byte string.
len The length of the string.
word_info The pointer to a WORDINFO structure used to return the word information.
Returns:
The length of the first multi-byte word.
See also:
GetFirstMCharLen, WORDINFO

int GUIAPI GetTabbedTextExtentPoint (  HDC  hdc,
const char *  text,
int  len,
int  max_extent,
int *  fit_chars,
int *  pos_chars,
int *  dx_chars,
SIZE *  size
) 
 

Computes the extent of a string when output the formatted string in a limited space.

int GUIAPI GetTextExtentPoint (  HDC  hdc,
const char *  text,
int  len,
int  max_extent,
int *  fit_chars,
int *  pos_chars,
int *  dx_chars,
SIZE *  size
) 
 

Computes the extent of a string when output the string in a limited space.

This function computes the extent of the specified string of text text which is len bytes long when output the text in a limited space (max_extent wide). If pos_chars and dx_chars are not NULL, this function will return the positions of each character in the text, and the output position of each character. This function returns the text extent in a SIZE struct pointed to by size, and the width of text as return value.

Parameters:
hdc The device context.
text The multi-byte string.
len The length of the string.
max_extent The width of the limited space.
fit_chars The number of the characters actually outputed.
pos_chars The positions of each character in the text will be returned through this pointer.
dx_chars The output positions of each character in the text will be returned through this pointer.
size The output extent of the text in the limited space will be returned through this pointer.
Returns:
The number of the characters which can be fit to the limited space.
See also:
GetFirstMCharLen, GetFirstWord

int GUIAPI GetTextMCharInfo (  PLOGFONT  log_font,
const char *  mstr,
int  len,
int *  pos_chars
) 
 

Retrives positions of multi-byte characters in a string.

This function retrives position of multi-byte characters in the string mstr which is len bytes long. It returns the positions of characters in the string in an integer array pointed to by pos_chars.

Parameters:
log_font The logical font used to parse the multi-byte string.
mstr The multi-byte string.
len The length of the string.
pos_chars The position of characters will be returned through this array if it is not NULL.
Returns:
The number of characters in the multi-byte string.
See also:
GetTextWordInfo

int GUIAPI GetTextWordInfo (  PLOGFONT  log_font,
const char *  mstr,
int  len,
int *  pos_words,
WORDINFO *  info_words
) 
 

Retrives information of multi-byte words in a string.

This function retrives information of multi-byte words in the string mstr which is len bytes long. It returns the positions of words in the string in an integer array pointed to by pos_words if the pointer is not NULL. This function also returns the information of words in a WORDINFO struct array pointed to by info_words when the pointer is not NULL.

Parameters:
log_font The logical font used to parse the multi-byte string.
mstr The multi-byte string.
len The length of the string.
pos_words The position of words will be returned through this array if it is not NULL.
info_words The words' information will be returned through this array if it is not NULL.
Returns:
The number of words in the multi-byte string.
See also:
GetTextMCharInfo, WORDINFO

int GUIAPI MB2WC (  PLOGFONT  log_font,
wchar_t *  dest,
const unsigned char *  mstr,
int  n
) 
 

Converts a multibyte character to a wide character in UCS according to the charset/encoding of the logical font.

Parameters:
log_font The logical font.
dest The buffer used to store the wide character; can be NULL.
mstr The pointer to the multi-byte character.
n The length of the multi-byte character.
Returns:
If mchar is not NULL, the function returns the number of consumed bytes starting at mchar, or 0 if s points to a null byte, or -1 upon failure.
See also:
WC2MB, mbtowc

int GUIAPI MBS2WCS (  PLOGFONT  log_font,
wchar_t *  dest,
const unsigned char *  mstr,
int  mstr_len,
int  n
) 
 

Converts a multibyte string to a wide character string in UC16 according to the charset/encoding of the logical font.

This function is a MiniGUI version of ISO/ANSI mbstowcs function. It converts a multibyte string to a wide character string in UC16. The behaviour of mbstowcs depends on the LC_CTYPE category of the current locale, while MBS2WCS depends on the charset/encoding of MiniGUI logical font.

Parameters:
log_font The logical font.
dest The buffer used to store the converted wide character string.
mstr The pointer to multibyte string.
mstr_len The length of the multibyte string in bytes.
n The length of the buffer in wide characters.
Returns:
The function returns the number of wide characters that make up the converted part of the wide character string, not including the terminating null wide character. If an invalid multibyte sequence was encountered, -1 is returned.
See also:
WCS2MBS, mbstowcs

int GUIAPI WC2MB (  PLOGFONT  log_font,
unsigned char *  s,
wchar_t  wc
) 
 

Converts a wide character in UCS to a multibyte character according to the charset/encoding of the logical font.

Parameters:
log_font The logical font.
s The buffer used to store the converted multibyte characters.
wc The wide character.
Returns:
If s is not NULL, the function returns the number of bytes that have been written to the byte array at s. If wc can not be represented as a multibyte sequence (according to the current logfont), -1 is returned.
See also:
WC2MB, mbtowc

int GUIAPI WCS2MBS (  PLOGFONT  log_font,
unsigned char *  dest,
const wchar_t *  wcs,
int  wcs_len,
int  n
) 
 

Converts a wide character string in UC16 to a multibyte string according to the charset/encoding of the logical font.

This function is a MiniGUI version of ISO/ANSI wcstombs function. It converts a wide character string in UC16 to a multibyte string. The behaviour of wcstombs depends on the LC_CTYPE category of the current locale, while WCS2MBS depends on the charset/encoding of MiniGUI logical font.

Parameters:
log_font The logical font.
dest The buffer used to store the converted multibyte string.
wcs The pointer to the wide character string.
wcs_len The number of the wide characters in wcs.
n The length of the dest in bytes.
Returns:
The function returns the number of bytes that make up the converted part of multibyte sequence, not including the terminating null byte. If a wide character was encountered which could not be converted, -1 is returned.
See also:
MBS2WCS, wcstombs

Generated on Mon Jun 26 13:54:31 2006 for MiniGUI V1.6.9 API Reference by  doxygen 1.4.2