Function

Pango.parse_enum

Declaration [src]

gboolean
pango_parse_enum (
  GType type,
  const char* str,
  int* value,
  gboolean warn,
  char** possible_values
)

Description [src]

Parses an enum type and stores the result in value.

If str does not match the nick name of any of the possible values for the enum and is not an integer, FALSE is returned, a warning is issued if warn is TRUE, and a string representing the list of possible values is stored in possible_values. The list is slash-separated, eg. “none/start/middle/end”. If failed and possible_values is not NULL, returned string should be freed using g_free().

Available since:

1.16

Parameters

`type`	`GType`
	enum type to parse, eg. `PANGO_TYPE_ELLIPSIZE_MODE`.
`str`	`const char*`
	string to parse. May be `NULL`.
	Can be `NULL`
	The data is owned by the caller of the function
	The string is a NUL terminated UTF-8 string
`value`	`int*`
	integer to store the result in, or `NULL`.
	Direction: out
	The called function takes ownership of the data, and is responsible for freeing it
`warn`	`gboolean`
	if `TRUE`, issue a `g_warning()` on bad input.
`possible_values`	`char**`
	place to store list of possible values on failure, or `NULL`.
	Direction: out
	The called function takes ownership of the data, and is responsible for freeing it
	The string is a NUL terminated UTF-8 string

Return value

Returns: `gboolean`
`TRUE` if `str` was successfully parsed.