utf8ncat

Appends a specified number of characters of one string to another string.

Library:LibC
Service:Characters and Strings

Syntax

  #include <utf8.h>
   
  utf8_t *utf8ncat (
     utf8_t        *tgt,   
     const utf8_t  *src,   
     size_t         n);
  

Parameters

tgt

(OUT) Points to the string to which to append the characters.

src

(IN) Points to the string containing the characters to be appended to the string pointed to by tgt.

n

(IN) Specifies the maximum number of characters to append.

Return Values

Returns the value of tgt.

Remarks

The first character of src overwrites the null-terminating character at the end of tgt. A null-terminating character is always appended to the result.

The utf8ncat function works the same as its ANSI/ISO equivalent, strncat, except that utf8ncat works on strings containing UTF-8 characters, which can be composed of one or two bytes. UTF-8 characters may require up to six bytes total, but NetWare does not generate such characters.

See Also

utf8cat