Function

Gimputf8_strtrim

Declaration [src]

gchar*
gimp_utf8_strtrim (
  const gchar* str,
  gint max_chars
)

Description [src]

Creates a (possibly trimmed) copy of str. The string is cut if it exceeds max_chars characters or on the first newline. The fact that the string was trimmed is indicated by appending an ellipsis.

Parameters

str

Type: const gchar*

An UTF-8 encoded string (or NULL)

The argument can be NULL.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

max_chars

Type: gint

The maximum number of characters before the string get trimmed.

Return value

Type: gchar*

A (possibly trimmed) copy of str which should be freed using g_free() when it is not needed any longer.

The caller of the function takes ownership of the data, and is responsible for freeing it.

The value is a NUL terminated UTF-8 string.