mtext_ncat(3) Append a part of an M-text to another.

SYNOPSIS

MText* mtext_ncat (MText * mt1, MText * mt2, int n)

DESCRIPTION

Append a part of an M-text to another. 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

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