# STD_ConcatenateLString

## Syntax

      #include <nitro/std.h>

      int STD_ConcatenateLString( char* str1, const char* str2, int size );

      int STD_StrLCat( char* str1, const char* str2, int size );

## Arguments

str1 | Specifies the pointer to the concatenation string destination.
str2 | Specifies the pointer to the concatenation string source.
size | Specifies the size of the buffer indicated by str1.

## Return Values

Returns the sum of the string lengths of str1 and str2. The return value will not be affected by the actual size that was copied.

## Description

Adds a maximum of (size - `STD_GetStringLength`(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 `strlcat()`.

`STD_StrLCat()` is defined as another name for `STD_ConcatenateLString()`.

## See Also

## Revision History

2007/12/10 Initial version.

CONFIDENTIAL