中间件,开发工具,实时操作系统软件和支持服务,助您完成卓越的嵌入式设计
Home
Developer Resources

wcsncat

PDF Documents
More resources

wcsncat()

Concatenate two wide-character strings, up to a maximum length

Synopsis:

#include <wchar.h>

wchar_t * wcsncat( wchar_t * ws1,
                   const wchar_t * ws2
                   size_t n );

Arguments:

ws1, ws2
The wide-character strings that you want to concatenate.
n
The maximum number of wide characters that you want to add from the ws2 string.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcsncat() function appends a copy of the string pointed to by ws2, including the terminating NUL wide character, to the end of the string pointed to by ws1. The first character of ws2 overwrites the NUL wide character at the end of ws1. The function writes no more than n wide characters from ws2 and appends a NUL wide character to the result.

Returns:

The same pointer as ws1.

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

"String manipulation functions" and "Wide-character functions" in the summary of functions chapter.

 
©2013 QNX Software Systems Limited, a subsidiary of BlackBerry.   BlackBerry Logo