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_CopyLStringZeroFill</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">STD_CopyLStringZeroFill<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_CopyLStringZeroFill( char* destp, const char* srcp, int n );
20</CODE></PRE></dd>
21</dl>
22
23<h2>Arguments</h2>
24<table border="1" width="100%">
25  <tbody>
26    <TR>
27<TD width="200"><SPAN class="argument">destp</SPAN></TD>
28<TD width="800">Pointer to a copy destination.</TD>
29    </TR>
30    <TR>
31<TD width="200"><SPAN class="argument">srcp</SPAN></TD>
32<TD width="800">Pointer to the copy source.</TD>
33    </TR>
34    <TR>
35<TD width="200"><SPAN class="argument">n</SPAN></TD>
36<TD width="800">Size of the write buffer of the copy destination.</TD>
37    </TR>
38  </tbody>
39</table>
40
41<h2>Return Values</h2>
42<p>
43Returns the copy target string pointer.
44</p>
45
46<H2>Description</H2>
47<P>
48Copies (<SPAN class="argument">n</SPAN>-1) characters from the string <SPAN class="argument">srcp</SPAN> to the string <SPAN class="argument">destp</SPAN>.<BR>You must designate a value lower than or equal to the buffer size of the copy destination in the argument <SPAN class="argument">n</SPAN>.</P>
49
50<P>
51The <CODE>STD_CopyLStringZeroFill</CODE> function fills the remainder with a zero when the copy source buffer size is smaller than the size to be copied.<BR>A <CODE>NULL</CODE> will always be copied to the end of the copy destination string.
52</P>
53<P>
54<FONT color="red">Caution:</FONT> This function name includes an 'L', but it behaves differently from the standard <CODE>strlcpy</CODE> function. The same behavior as the <CODE>strlcpy</CODE> function is provided by the <A href="STD_CopyLString.html"><CODE>STD_CopyLString</CODE></A> function.
55</P>
56<h2>See Also</h2>
57<p><A href="STD_CopyString.html"><CODE>STD_CopyString</CODE></A><BR> <A href="STD_CopyLString.html"><CODE>STD_CopyLString</CODE></A></p>
58
59<H2>Revision History</H2>
60<P>
612006/06/06 Migrated from the old <CODE>STD_CopyLString</CODE>.
62</P>
63<hr><p>CONFIDENTIAL</p></body>
64</html>
65