• Home
  • History
  • Annotate
  • Line#
  • Navigate
  • Raw
  • Download
  • only in /asuswrt-rt-n18u-9.0.0.4.380.2695/release/src-rt-6.x.4708/toolchains/hndtools-armeabi-2013.11/share/doc/arm-arm-none-eabi/html/libc/
1<html lang="en">
2<head>
3<title>wcscat - Untitled</title>
4<meta http-equiv="Content-Type" content="text/html">
5<meta name="description" content="Untitled">
6<meta name="generator" content="makeinfo 4.13">
7<link title="Top" rel="start" href="index.html#Top">
8<link rel="up" href="Wchar-strings.html#Wchar-strings" title="Wchar strings">
9<link rel="prev" href="wmemset.html#wmemset" title="wmemset">
10<link rel="next" href="wcschr.html#wcschr" title="wcschr">
11<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12<meta http-equiv="Content-Style-Type" content="text/css">
13<style type="text/css"><!--
14  pre.display { font-family:inherit }
15  pre.format  { font-family:inherit }
16  pre.smalldisplay { font-family:inherit; font-size:smaller }
17  pre.smallformat  { font-family:inherit; font-size:smaller }
18  pre.smallexample { font-size:smaller }
19  pre.smalllisp    { font-size:smaller }
20  span.sc    { font-variant:small-caps }
21  span.roman { font-family:serif; font-weight:normal; } 
22  span.sansserif { font-family:sans-serif; font-weight:normal; } 
23--></style>
24<link rel="stylesheet" type="text/css" href="../cs.css">
25</head>
26<body>
27<div class="node">
28<a name="wcscat"></a>
29<p>
30Next:&nbsp;<a rel="next" accesskey="n" href="wcschr.html#wcschr">wcschr</a>,
31Previous:&nbsp;<a rel="previous" accesskey="p" href="wmemset.html#wmemset">wmemset</a>,
32Up:&nbsp;<a rel="up" accesskey="u" href="Wchar-strings.html#Wchar-strings">Wchar strings</a>
33<hr>
34</div>
35
36<h3 class="section">6.6 <code>wcscat</code>&mdash;concatenate two wide-character strings</h3>
37
38<p><a name="index-wcscat-415"></a><strong>Synopsis</strong>
39<pre class="example">     #include &lt;wchar.h&gt;
40     wchar_t *wcscat(wchar_t *<var>s1</var>, const wchar_t *<var>s2</var>);
41     
42</pre>
43   <p><strong>Description</strong><br>
44The <code>wcscat</code> function appends a copy of the wide-character string
45pointed to by <var>s2</var> (including the terminating null wide-character
46code) to the end of the wide-character string pointed to by <var>s1</var>. 
47The initial wide-character code of <var>s2</var> overwrites the null
48wide-character code at the end of <var>s1</var>. If copying takes place between
49objects that overlap, the behaviour is undefined.
50
51   <p><br>
52<strong>Returns</strong><br>
53The <code>wcscat</code> function returns <var>s1</var>;
54no return value is reserved to indicate an error.
55
56   <p><br>
57<strong>Portability</strong><br>
58<code>wcscat</code> is ISO/IEC 9899/AMD1:1995 (ISO C).
59
60   <p>No supporting OS subroutines are required.
61
62   <p><br>
63
64   </body></html>
65
66