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

# mtext\_ncpy(3m17n)

## NAME

mtext\_ncpy -

## SYNOPSIS

**MText**\* **mtext\_ncpy** (**MText** \* *mt1*, **MText** \* *mt2*, int *n*)

## DESCRIPTION

Copy the first some characters in an M-text to another. 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()**\

## 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\>.