Function

GdkAtomintern_static_string

since: 2.10

Declaration [src]

GdkAtom
gdk_atom_intern_static_string (
  const gchar* atom_name
)

Description [src]

Finds or creates an atom corresponding to a given string.

Note that this function is identical to gdk_atom_intern() except that if a new GdkAtom is created the string itself is used rather than a copy. This saves memory, but can only be used if the string will always exist. It can be used with statically allocated strings in the main program, but not with statically allocated memory in dynamically loaded modules, if you expect to ever unload the module again (e.g. do not use this function in GTK+ theme engines).

Available since: 2.10

Parameters

atom_name

Type: const gchar*

A static string.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

Return value

Type: GdkAtom

The atom corresponding to atom_name.