1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.2.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>STD_ConcatenateLString</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">STD_ConcatenateLString<img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
15<h2>Syntax</h2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/std.h&gt;
18
19int STD_ConcatenateLString( char* str1, const char* str2, int size );
20
21int STD_StrLCat( char* str1, const char* str2, int size );
22</CODE></PRE></dd>
23</dl>
24
25<h2>Arguments</h2>
26<table border="1" width="100%">
27  <tbody>
28    <TR>
29      <TD width="200"><EM><STRONG><FONT face="Courier New">str1</FONT></STRONG></EM></TD>
30      <TD width="800">Specifies the pointer to the concatenation string destination.</TD>
31    </TR>
32    <TR>
33      <TD width="200"><EM><STRONG><FONT face="Courier New">str2</FONT></STRONG></EM></TD>
34      <TD width="800">Specifies the pointer to the concatenation string source.</TD>
35    </TR>
36    <TR>
37      <TD width="200"><EM><STRONG><FONT face="Courier New">size</FONT></STRONG></EM></TD>
38      <TD width="800">Specifies the size of the buffer indicated by str1.</TD>
39    </TR>
40  </tbody>
41</table>
42
43<h2>Return Values</h2>
44<p>
45Returns the sum of the string lengths of str1 and str2. The return value will not be affected by the actual size that was copied.
46</p>
47
48<H2>Description</H2>
49<P>
50Adds a maximum of (size - <a href="STD_GetStringLength.html"><code>STD_GetStringLength</code></a>(str1) - 1) bytes from str2 to the end of str1, and terminates the result with the NUL character. It carries out the same operation as the C standard function <CODE>strlcat()</CODE>.</P>
51<p><CODE>STD_StrLCat()</CODE> is defined as another name for <CODE>STD_ConcatenateLString()</CODE>.</p>
52
53<h2>See Also</h2>
54
55<H2>Revision History</H2>
56<P>2007/12/10 Initial version.</P>
57<hr><p>CONFIDENTIAL</p></body>
58</html>
59