int mtext_line_break |
( |
MText * |
mt, |
|
|
int |
pos, |
|
|
int |
option, |
|
|
int * |
after | |
|
) |
| | |
|
|
|
The mtext() function allocates a new M-text of length 0 and returns a pointer to it. The allocated M-text will not be freed unless the user explicitly does so with the m17n_object_unref() function.
- See Also:
- m17n_object_unref()
|
MText* mtext_from_data |
( |
const void * |
data, |
|
|
int |
nitems, |
|
|
enum MTextFormat |
format | |
|
) |
| | |
|
The mtext_from_data() function allocates a new M-text whose character sequence is specified by array data of nitems elements. format specifies the format of data.
When format is either MTEXT_FORMAT_US_ASCII or MTEXT_FORMAT_UTF_8, the contents of data must be of the type unsigned char , and nitems counts by byte.
When format is either MTEXT_FORMAT_UTF_16LE or MTEXT_FORMAT_UTF_16BE, the contents of data must be of the type unsigned short , and nitems counts by unsigned short.
When format is either MTEXT_FORMAT_UTF_32LE or MTEXT_FORMAT_UTF_32BE, the contents of data must be of the type unsigned , and nitems counts by unsigned.
The character sequence of the M-text is not modifiable. The contents of data must not be modified while the M-text is alive.
The allocated M-text will not be freed unless the user explicitly does so with the m17n_object_unref() function. Even in that case, data is not freed.
- Return value:
- If the operation was successful, mtext_from_data() returns a pointer to the allocated M-text. Otherwise it returns
NULL and assigns an error code to the external variable merror_code.
- Errors:
MERROR_MTEXT
|
void* mtext_data |
( |
MText * |
mt, |
|
|
enum MTextFormat * |
fmt, |
|
|
int * |
nunits, |
|
|
int * |
pos_idx, |
|
|
int * |
unit_idx | |
|
) |
| | |
|
The mtext_data() function returns a pointer to the text data of M-text mt. If fmt is not NULL, the format of the text data is stored in it. If nunits is not NULL, the number of units of the text data is stored in it.
If pos_idx is not NULL and it points to a non-negative number, what it points to is a character position. In this case, the return value is a pointer to the text data of a character at that position.
Otherwise, if unit_idx is not NULL, it points to a unit position. In this case, the return value is a pointer to the text data of a character containing that unit.
The character position and unit position of the return value are stored in pos_idx and unit_dix respectively if they are not NULL.
-
If the format of the text data is MTEXT_FORMAT_US_ASCII or MTEXT_FORMAT_UTF_8, one unit is unsigned char.
-
If the format is MTEXT_FORMAT_UTF_16LE or MTEXT_FORMAT_UTF_16BE, one unit is unsigned short.
-
If the format is MTEXT_FORMAT_UTF_32LE or MTEXT_FORMAT_UTF_32BE, one unit is unsigned int.
|
int mtext_len |
( |
MText * |
mt |
) |
|
|
The mtext_len() function returns the number of characters in M-text mt. |
int mtext_ref_char |
( |
MText * |
mt, |
|
|
int |
pos | |
|
) |
| | |
|
The mtext_ref_char() function returns the character at pos in M-text mt. If an error is detected, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
|
int mtext_set_char |
( |
MText * |
mt, |
|
|
int |
pos, |
|
|
int |
c | |
|
) |
| | |
|
The mtext_set_char() function sets character c, which has no text properties, at pos in M-text mt.
- Return value:
- If the operation was successful, mtext_set_char() returns 0. Otherwise it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
|
|
The mtext_cat_char() function appends character c, which has no text properties, to the end of M-text mt.
- Return value:
- This function returns a pointer to the resulting M-text mt. If c is an invalid character, it returns
NULL .
- See Also:
- mtext_cat(), mtext_ncat()
|
|
The mtext_dup() function creates a copy of M-text mt while inheriting all the text properties of mt.
- Return value:
- This function returns a pointer to the created copy.
- See Also:
- mtext_duplicate()
|
|
The mtext_cat() function appends M-text mt2 to the end of M-text mt1 while inheriting all the text properties. mt2 itself is not modified.
- Return value:
- This function returns a pointer to the resulting M-text mt1.
- See Also:
- mtext_ncat(), mtext_cat_char()
|
|
The mtext_ncat() function appends the first n characters of M-text mt2 to the end of M-text mt1 while inheriting all the text properties. If the length of mt2 is less than n, all characters are copied. mt2 is not modified.
- Return value:
- If the operation was successful, mtext_ncat() returns a pointer to the resulting M-text mt1. If an error is detected, it returns
NULL and assigns an error code to the global variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_cat(), mtext_cat_char()
|
|
The mtext_cpy() function copies M-text mt2 to M-text mt1 while inheriting all the text properties. The old text in mt1 is overwritten and the length of mt1 is extended if necessary. mt2 is not modified.
- Return value:
- This function returns a pointer to the resulting M-text mt1.
- See Also:
- mtext_ncpy(), mtext_copy()
|
|
The mtext_ncpy() function copies the first n characters of M-text mt2 to M-text mt1 while inheriting all the text properties. If the length of mt2 is less than n, all characters of mt2 are copied. The old text in mt1 is overwritten and the length of mt1 is extended if necessary. mt2 is not modified.
- Return value:
- If the operation was successful, mtext_ncpy() returns a pointer to the resulting M-text mt1. If an error is detected, it returns
NULL and assigns an error code to the global variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_cpy(), mtext_copy()
|
MText* mtext_duplicate |
( |
MText * |
mt, |
|
|
int |
from, |
|
|
int |
to | |
|
) |
| | |
|
The mtext_duplicate() function creates a copy of sub-text of M-text mt, starting at from (inclusive) and ending at to (exclusive) while inheriting all the text properties of mt. mt itself is not modified.
- Return value: If the operation was successful, mtext_duplicate()
- returns a pointer to the created M-text. If an error is detected, it returns NULL and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_dup()
|
|
The mtext_copy() function copies the text between from (inclusive) and to (exclusive) in M-text mt2 to the region starting at pos in M-text mt1 while inheriting the text properties. The old text in mt1 is overwritten and the length of mt1 is extended if necessary. mt2 is not modified.
- Return value:
- If the operation was successful, mtext_copy() returns a pointer to the modified mt1. Otherwise, it returns
NULL and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_cpy(), mtext_ncpy()
|
int mtext_del |
( |
MText * |
mt, |
|
|
int |
from, |
|
|
int |
to | |
|
) |
| | |
|
The mtext_del() function deletes the characters in the range from (inclusive) and to (exclusive) from M-text mt destructively. As a result, the length of mt shrinks by (to - from) characters.
- Return value:
- If the operation was successful, mtext_del() returns 0. Otherwise, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_ins()
|
int mtext_ins |
( |
MText * |
mt1, |
|
|
int |
pos, |
|
|
MText * |
mt2 | |
|
) |
| | |
|
The mtext_ins() function inserts M-text mt2 into M-text mt1, at position pos. As a result, mt1 is lengthen by the length of mt2. On insertion, all the text properties of mt2 are inherited. The original mt2 is not modified.
- Return value:
- If the operation was successful, mtext_ins() returns 0. Otherwise, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE , MERROR_MTEXT
- See Also:
- mtext_del() , mtext_insert()
|
int mtext_insert |
( |
MText * |
mt1, |
|
|
int |
pos, |
|
|
MText * |
mt2, |
|
|
int |
from, |
|
|
int |
to | |
|
) |
| | |
|
The mtext_insert() function inserts sub-text of M-text mt2 between from (inclusive) and to (exclusive) into M-text mt1, at position pos. As a result, mt1 is lengthen by (to - from). On insertion, all the text properties of the sub-text of mt2 are inherited.
- Return value: If the operation was successful, mtext_insert() returns
- 0. Otherwise, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_MTEXT , MERROR_RANGE
- See Also:
- mtext_ins()
|
int mtext_ins_char |
( |
MText * |
mt, |
|
|
int |
pos, |
|
|
int |
c, |
|
|
int |
n | |
|
) |
| | |
|
The mtext_ins_char() function inserts n copies of character c into M-text mt at position pos. As a result, mt is lengthen by n.
- Return value:
- If the operation was successful, mtext_ins() returns 0. Otherwise, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
- See Also:
- mtext_ins, mtext_del()
|
int mtext_replace |
( |
MText * |
mt1, |
|
|
int |
from1, |
|
|
int |
to1, |
|
|
MText * |
mt2, |
|
|
int |
from2, |
|
|
int |
to2 | |
|
) |
| | |
|
The mtext_replace() function replaces sub-text of M-text mt1 between from1 (inclusive) and to1 (exclusive) with the sub-text of M-text mt2 between from2 (inclusive) and to2 (exclusive). The new sub-text inherits text properties of the old sub-text.
- Return value: If the operation was successful, mtext_replace() returns
- 0. Otherwise, it returns -1 and assigns an error code to the external variable merror_code.
- Errors:
MERROR_MTEXT , MERROR_RANGE
- See Also:
- mtext_insert()
|
int mtext_character |
( |
MText * |
mt, |
|
|
int |
from, |
|
|
int |
to, |
|
|
int |
c | |
|
) |
| | |
|
The mtext_character() function searches M-text mt for character c. If from is less than to, the search begins at position from and goes forward but does not exceed (to - 1). Otherwise, the search begins at position (from - 1) and goes backward but does not exceed to. An invalid position specification is regarded as both from and to being 0.
- Return value:
- If c is found, mtext_character() returns the position of its first occurrence. Otherwise it returns -1 without changing the external variable merror_code. If an error is detected, it returns -1 and assigns an error code to the external variable merror_code.
- See Also:
- mtext_chr(), mtext_rchr()
|
int mtext_chr |
( |
MText * |
mt, |
|
|
int |
c | |
|
) |
| | |
|
The mtext_chr() function searches M-text mt for character c. The search starts from the beginning of mt and goes toward the end.
- Return value:
- If c is found, mtext_chr() returns its position; otherwise it returns -1.
- Errors:
MERROR_RANGE
- See Also:
- mtext_rchr(), mtext_character()
|
int mtext_rchr |
( |
MText * |
mt, |
|
|
int |
c | |
|
) |
| | |
|
The mtext_rchr() function searches M-text mt for character c. The search starts from the end of mt and goes backwardly toward the beginning.
- Return value:
- If c is found, mtext_rchr() returns its position; otherwise it returns -1.
- Errors:
MERROR_RANGE
- See Also:
- mtext_chr(), mtext_character()
|
int mtext_ncmp |
( |
MText * |
mt1, |
|
|
MText * |
mt2, |
|
|
int |
n | |
|
) |
| | |
|
The mtext_ncmp() function is similar to mtext_cmp(), but compares at most n characters from the beginning.
- Return value:
- This function returns 1, 0, or -1 if mt1 is found greater than, equal to, or less than mt2, respectively.
- See Also:
- mtext_cmp(), mtext_casecmp(), mtext_ncasecmp() mtext_compare(), mtext_case_compare()
|
int mtext_compare |
( |
MText * |
mt1, |
|
|
int |
from1, |
|
|
int |
to1, |
|
|
MText * |
mt2, |
|
|
int |
from2, |
|
|
int |
to2 | |
|
) |
| | |
|
The mtext_compare() function compares two M-texts mt1 and mt2, character-by-character. The compared regions are between from1 and to1 in mt1 and from2 to to2 in MT2. from1 and from2 are inclusive, to1 and to2 are exclusive. from1 being equal to to1 (or from2 being equal to to2) means an M-text of length zero. An invalid region specification is regarded as both from1 and to1 (or from2 and to2) being 0.
- Return value:
- This function returns 1, 0, or -1 if mt1 is found greater than, equal to, or less than mt2, respectively. Comparison is based on character codes.
- See Also:
- mtext_cmp(), mtext_ncmp(), mtext_casecmp(), mtext_ncasecmp(), mtext_case_compare()
|
|
The mtext_spn() function returns the length of the initial segment of M-text mt1 that consists entirely of characters in M-text mt2.
- See Also:
- mtext_cspn()
|
|
The mtext_cspn() returns the length of the initial segment of M-text mt1 that consists entirely of characters not in M-text mt2.
- See Also:
- mtext_spn()
|
|
The mtext_pbrk() function locates the first occurrence in M-text mt1 of any of the characters in M-text mt2.
- Return value:
- This function returns the position in mt1 of the found character. If no such character is found, it returns -1.
|
|
The mtext_tok() function searches a token that firstly occurs after position pos in M-text mt. Here, a token means a substring each of which does not appear in M-text delim. Note that the type of pos is not int but pointer to int .
- Return value:
- If a token is found, mtext_tok() copies the corresponding part of mt and returns a pointer to the copy. In this case, pos is set to the end of the found token. If no token is found, it returns
NULL without changing the external variable merror_code. If an error is detected, it returns NULL and assigns an error code to the external variable merror_code.
- Errors:
MERROR_RANGE
|
int mtext_text |
( |
MText * |
mt1, |
|
|
int |
pos, |
|
|
MText * |
mt2 | |
|
) |
| | |
|
The mtext_text() function finds the first occurrence of M-text mt2 in M-text mt1 after the position pos while ignoring difference of the text properties.
- Return value:
- If mt2 is found in mt1, mtext_text() returns the position of it first occurrence. Otherwise it returns -1. If mt2 is empty, it returns 0.
|
int mtext_search |
( |
MText * |
mt1, |
|
|
int |
from, |
|
|
int |
to, |
|
|
MText * |
mt2 | |
|
) |
| | |
|
The mtext_search() function searches for the first occurrence of M-text mt2 in M-text mt1 in the region from and to while ignoring difference of the text properties. If from is less than to, the forward search starts from from, otherwise the backward search starts from to.
- Return value:
- If mt2 is found in mt1, mtext_search() returns the position of the first occurrence. Otherwise it returns -1. If mt2 is empty, it returns 0.
|
int mtext_ncasecmp |
( |
MText * |
mt1, |
|
|
MText * |
mt2, |
|
|
int |
n | |
|
) |
| | |
|
The mtext_ncasecmp() function is similar to mtext_casecmp(), but compares at most n characters from the beginning.
- Return value:
- This function returns 1, 0, or -1 if mt1 is found greater than, equal to, or less than mt2, respectively.
- See Also:
- mtext_cmp(), mtext_casecmp(), mtext_casecmp() mtext_compare(), mtext_case_compare()
|
int mtext_case_compare |
( |
MText * |
mt1, |
|
|
int |
from1, |
|
|
int |
to1, |
|
|
MText * |
mt2, |
|
|
int |
from2, |
|
|
int |
to2 | |
|
) |
| | |
|
The mtext_case_compare() function compares two M-texts mt1 and mt2, character-by-character, ignoring cases. The compared regions are between from1 and to1 in mt1 and from2 to to2 in MT2. from1 and from2 are inclusive, to1 and to2 are exclusive. from1 being equal to to1 (or from2 being equal to to2) means an M-text of length zero. An invalid region specification is regarded as both from1 and to1 (or from2 and to2) being 0.
- Return value:
- This function returns 1, 0, or -1 if mt1 is found greater than, equal to, or less than mt2, respectively. Comparison is based on character codes.
- See Also:
- mtext_cmp(), mtext_ncmp(), mtext_casecmp(), mtext_ncasecmp(), mtext_compare()
|
int mtext_lowercase |
( |
MText * |
mt |
) |
|
|
The mtext_lowercase() function destructively converts each character in M-text mt to lowercase. Adjacent characters in mt may affect the case conversion. If the Mlanguage text property is attached to mt, it may also affect the conversion. The length of mt may change. Characters that cannot be converted to lowercase is left unchanged. All the text properties are inherited.
- Return value:
- This function returns the length of the updated mt.
- See Also: mtext_titlecase(), mtext_uppercase()
|
int mtext_titlecase |
( |
MText * |
mt |
) |
|
|
The mtext_titlecase() function destructively converts the first character with the cased property in M-text mt to titlecase and the others to lowercase. The length of mt may change. If the character cannot be converted to titlecase, it is left unchanged. All the text properties are inherited.
- Return value:
- This function returns the length of the updated mt.
- See Also: mtext_lowercase(), mtext_uppercase()
|
int mtext_uppercase |
( |
MText * |
mt |
) |
|
|
The mtext_uppercase() function destructively converts each character in M-text mt to uppercase. Adjacent characters in mt may affect the case conversion. If the Mlanguage text property is attached to mt, it may also affect the conversion. The length of mt may change. Characters that cannot be converted to uppercase is left unchanged. All the text properties are inherited.
- Return value:
- This function returns the length of the updated mt.
- See Also: mtext_lowercase(), mtext_titlecase()
|
|