lstrcpyn
The lstrcpyn
function copies a specified number of characters from a source string into a
buffer.
LPTSTR lstrcpyn(
|
LPTSTR lpString1, |
// address of
target buffer |
|
LPCTSTR lpString2, |
// address of
source string |
|
int iMaxLength |
// number of bytes
or characters to copy |
|
); |
|
Parameters
lpString1
Points to a
buffer into which the function copies characters. The buffer must be large
enough to contain the number of bytes (ANSI version) or characters (Unicode
version) specified by iMaxLength, including room for a terminating null
character.
lpString2
Points to a
null-terminated string from which the function copies characters.
iMaxLength
Specifies the
number bytes (ANSI version) or characters (Unicode version) to be copied from
the string pointed to by lpString2 into the buffer pointed to by lpString1,
including a terminating null character.
Return Values
If the
function succeeds, the return value is a pointer to the buffer.
If the
function fails, the return value is NULL. To get extended error information,
call GetLastError.
Remarks
Note that the
buffer pointed to by lpString1 must be large enough to include a
terminating null character, and the string length value specified by iMaxLength
includes room for a terminating null character. Thus, the following code
TCHAR chBuffer[512] ;
lstrcpyn(chBuffer, "abcdefghijklmnop", 4) ;
... copies
the string "abc", followed by a terminating null character, to
chBuffer.
See Also