Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All


Visual Studio 6.0

unsigned char *_mbsnbcat( unsigned char *dest, const unsigned char *src, size_t count );

Routine Required Header Compatibility
_mbsnbcat <mbstring.h> Win 95, Win NT

For additional compatibility information, see Compatibility in the Introduction.


LIBC.LIB Single thread static library, retail version
LIBCMT.LIB Multithread static library, retail version
MSVCRT.LIB Import library for MSVCRT.DLL, retail version

Return Value

_mbsnbcat returns a pointer to the destination string. No return value is reserved to indicate an error.



Null-terminated multibyte-character destination string


Null-terminated multibyte-character source string


Number of bytes from src to append to dest


The _mbsnbcat function appends, at most, the first count bytes of src to dest. If the byte immediately preceding the null character in dest is a lead byte, the initial byte of src overwrites this lead byte. Otherwise the initial byte of src overwrites the terminating null character of dest. If a null byte appears in src before count bytes are appended, _mbsnbcat appends all bytes from src, up to the null character. If count is greater than the length of src, the length of src is used in place of count. The resulting string is terminated with a null character. If copying takes place between strings that overlap, the behavior is undefined.

Generic-Text Routine Mappings

TCHAR.H Routine _UNICODE & _MBCS Not Defined _MBCS Defined _UNICODE Defined
_tcsncat strncat _mbsnbcat wcsncat

String Manipulation Routines

See Also   _mbsnbcmp, _mbsnbcnt, _mbsnccnt, _mbsnbcpy, _mbsnbicmp, _mbsnbset, strncat

© 2015 Microsoft