Declaration [src]

purple_group_new (
  const char* name

Description [src]

Creates a new group

You can’t have more than one group with the same name. Sorry. If you pass this the name of a group that already exists, it will return that group.


name const char*

The name of the new group.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.

Return value

Returns: PurpleGroup

A new group struct.

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