utf8cat

Appends a copy of one string to the end of a second string.

Library:LibC
Service:Characters and Strings

Syntax

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

Parameters

tgt

(OUT) Points to the string to which to append a copy of another string.

src

(IN) Points to the string to be copied.

Return Values

Returns the value of tgt.

Remarks

The utf8cat function appends a copy of the string pointed to by src (including the null-terminating character) to the end of the string pointed to by tgt. The first character of src overwrites the null-terminating character at the end of tgt.

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

See Also

utf8ncat