GLib.strlcat (original) (raw)

Function

GLibstrlcat

Declaration [src]

gsize
g_strlcat (
  gchar* dest,
  const gchar* src,
  gsize dest_size
)

Description [src]

Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise. Appends nul-terminated src string to dest, guaranteeing nul-termination for dest. The total size of dest won’t exceed dest_size.

At most dest_size - 1 characters will be copied. Unlike strncat(),dest_size is the full size of dest, not the space left over. This function does not allocate memory. It always nul-terminates (unlessdest_size == 0 or there were no nul characters in the dest_sizecharacters of dest to start with).

Caveat: this is supposedly a more secure alternative to strcat() orstrncat(), but for real security g_strconcat() is harder to mess up.

Parameters

dest

Type: gchar*

Destination buffer, already containing one nul-terminated string.

src

Type: const gchar*

Source buffer.

dest_size

Type: gsize

Length of dest buffer in bytes (not length of existing string inside dest).

Return value

Type: gsize

Size of attempted result, which is MIN (dest_size, strlen (original dest)) + strlen (src), so if retval >= dest_size, truncation occurred.