---
name: "mtext_character"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mtext_character"
---

# mtext\_character(3m17n)

## NAME

mtext\_character -

## SYNOPSIS

int **mtext\_character** (**MText** \* *mt*, int *from*, int *to*, int *c*)

## DESCRIPTION

Search a character in an M-text. 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()**\

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.