unincat

Copies the specified number of characters from one string to the end of another string.

Library:LibC
Service:Characters and Strings

Syntax

  #include <unilib.h> 
   
  unicode_t *unincat (
     unicode_t         *tgt,
     const unicode_t   *src,
     size_t             n);

Parameters

tgt

(OUT) Points to the original string.

src

(IN) Points to the string to be appended.

n

(IN) Specifies the maximum number of characters to be appended.

Return Values

Returns a pointer to the concatenated string.

Remarks

The unincat function copies at most n characters of src string to the end of the tgt string, and then appends a null-terminating character. The maximum length of the resulting string is:

    unilen(tgt)+ n

The unincat function corresponds to the strncat function.

See Also