Function

GLibfind_program_in_path

Declaration

gchar*
g_find_program_in_path (
  const gchar* program
)

Description

Locates the first executable named program in the user’s path, in the same way that execvp() would locate it. Returns an allocated string with the absolute path name, or NULL if the program is not found in the path. If program is already an absolute path, returns a copy of program if program exists and is executable, and NULL otherwise.

On Windows, if program does not have a file type suffix, tries with the suffixes .exe, .cmd, .bat and .com, and the suffixes in the PATHEXT environment variable.

On Windows, it looks for the file in the same way as CreateProcess() would. This means first in the directory where the executing program was loaded from, then in the current directory, then in the Windows 32-bit system directory, then in the Windows directory, and finally in the directories in the PATH environment variable. If the program is found, the return value contains the full name including the type suffix.

Parameters

program

Type: const gchar*

A program name in the GLib file name encoding.

The data is owned by the caller of the function.

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

Return value

Type: gchar*

A newly-allocated string with the absolute path, or NULL.

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

The return value can be NULL.

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