Method

GioApplicationCommandLinegetenv

since: 2.28

Declaration

const gchar*
g_application_command_line_getenv (
  GApplicationCommandLine* cmdline,
  const gchar* name
)

Description

Gets the value of a particular environment variable of the command line invocation, as would be returned by g_getenv(). The strings may contain non-utf8 data.

The remote application usually does not send an environment. Use G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag set it is possible that the environment is still not available (due to invocation messages from other applications).

The return value should not be modified or freed and is valid for as long as cmdline exists.

Available since: 2.28

Parameters

name

Type: const gchar*

The environment variable to get.

The data is owned by the caller of the function.

The value is a file system path, using the OS encoding.

Return value

Type: const gchar*

The value of the variable, or NULL if unset or unsent.

The data is owned by the instance.

The return value can be NULL.

The value is a NUL terminated UTF-8 string.