Method

ValentContextnew

unstable since: 1.0

Declaration [src]

ValentContext*
valent_context_new (
  ValentContext* parent,
  const char* domain,
  const char* id
)

Description [src]

Create a new ValentContext.

If given, parent will be taken into consideration when building paths.

If given, domain should be an identifier describing the scope of the contexts that will share it.

If given, id should be an identifier that is at least unique to domain, even if domain is NULL.

Available since: 1.0

Parameters

domain

Type: const char*

A domain.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
id

Type: const char*

A unique identifier.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.

Return value

Type: ValentContext

A new ValentContext.

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