Gimp.utf8_strtrim
Description: Reference for Gimp.utf8_strtrim

### 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.