GIFunctionInfo

## GIFunctionInfo GIFunctionInfo — Struct representing a function |

## Functions

#define | GI_IS_FUNCTION_INFO()
GIFunctionInfoFlags | g_function_info_get_flags ()
GIPropertyInfo * | g_function_info_get_property ()
const gchar * | g_function_info_get_symbol ()
GIVFuncInfo * | g_function_info_get_vfunc ()
gboolean | g_function_info_invoke ()
GQuark | g_invoke_error_quark ()

## Types and Values

typedef | GIFunctionInfo
enum | GIFunctionInfoFlags
#define | G_INVOKE_ERROR
enum | GInvokeError

## Description

GIFunctionInfo represents a function, method or constructor. To find out what kind of entity a GIFunctionInfo represents, call `g_function_info_get_flags()`.

See also GICallableInfo for information on how to retreive arguments and other metadata.

## Struct hierarchy

      GIBaseInfo
       +----GICallableInfo
             +----GIFunctionInfo
             +----GISignalInfo
             +----GIVFuncInfo

## Functions

### GI_IS_FUNCTION_INFO()

    #define             GI_IS_FUNCTION_INFO(info)

Checks if `info` is a GIFunctionInfo.

#### Parameters

info | an info structure |

### g_function_info_get_flags ()

    GIFunctionInfoFlags
    g_function_info_get_flags (GIFunctionInfo *info);

Obtain the GIFunctionInfoFlags for the `info` .

#### Parameters

info | a GIFunctionInfo |

#### Returns

the flags

### g_function_info_get_property ()

    GIPropertyInfo *
    g_function_info_get_property (GIFunctionInfo *info);

Obtain the property associated with this GIFunctionInfo. Only GIFunctionInfo with the flag `GI_FUNCTION_IS_GETTER` or `GI_FUNCTION_IS_SETTER` have a property set. For other cases, `NULL` will be returned.

#### Parameters

info | a GIFunctionInfo |

#### Returns

the property or `NULL` if not set. Free it with `g_base_info_unref()` when done.

[transfer full]

### g_function_info_get_symbol ()

    const gchar *
    g_function_info_get_symbol (GIFunctionInfo *info);

Obtain the symbol of the function. The symbol is the name of the exported function, suitable to be used as an argument to `g_module_symbol()`.

#### Parameters

info | a GIFunctionInfo |

#### Returns

the symbol

### g_function_info_get_vfunc ()

    GIVFuncInfo *
    g_function_info_get_vfunc (GIFunctionInfo *info);

Obtain the virtual function associated with this GIFunctionInfo. Only GIFunctionInfo with the flag `GI_FUNCTION_WRAPS_VFUNC` has a virtual function set. For other cases, `NULL` will be returned.

#### Parameters

info | a GIFunctionInfo |

#### Returns

the virtual function or `NULL` if not set. Free it by calling `g_base_info_unref()` when done.

[transfer full]

### g_function_info_invoke ()

    gboolean
    g_function_info_invoke (GIFunctionInfo *info,
                            const GIArgument *in_args,
                            int n_in_args,
                            const GIArgument *out_args,
                            int n_out_args,
                            GIArgument *return_value,
                            GError **error);

Invokes the function described in `info` with the given arguments. Note that inout parameters must appear in both argument lists. This function uses `dlsym()` to obtain a pointer to the function, so the library or shared object containing the described function must either be linked to the caller, or must have been `g_module_symbol()`ed before calling this function.

[skip]

#### Parameters

info | a GIFunctionInfo describing the function to invoke |
in_args | an array of GIArguments, one for each in parameter of `info` . If there are no in parameter, `in_args` can be `NULL`. | [array length=n_in_args]
n_in_args | the length of the `in_args` array |
out_args | an array of GIArguments, one for each out parameter of `info` . If there are no out parameters, `out_args` may be `NULL`. | [array length=n_out_args]
n_out_args | the length of the `out_args` array |
return_value | return location for the return value of the function. If the function returns void, `return_value` may be `NULL` |
error | return location for detailed error information, or `NULL` |

#### Returns

`TRUE` if the function has been invoked, `FALSE` if an error occurred.

### g_invoke_error_quark ()

    GQuark
    g_invoke_error_quark (void);

TODO

#### Returns

TODO

## Types and Values

### GIFunctionInfo

Represents a function, eg arguments and return value.

### enum GIFunctionInfoFlags

Flags for a GIFunctionInfo struct.

#### Members

GI_FUNCTION_IS_METHOD | is a method. |
GI_FUNCTION_IS_CONSTRUCTOR | is a constructor. |
GI_FUNCTION_IS_GETTER | is a getter of a GIPropertyInfo. |
GI_FUNCTION_IS_SETTER | is a setter of a GIPropertyInfo. |
GI_FUNCTION_WRAPS_VFUNC | represents a virtual function. |
GI_FUNCTION_THROWS | the function may throw an error. |

### G_INVOKE_ERROR

    #define G_INVOKE_ERROR (g_invoke_error_quark ())

TODO

### enum GInvokeError

An error occuring while invoking a function via `g_function_info_invoke()`.

#### Members

G_INVOKE_ERROR_FAILED | invokation failed, unknown error. |
G_INVOKE_ERROR_SYMBOL_NOT_FOUND | symbol couldn't be found in any of the libraries associated with the typelib of the function. |
G_INVOKE_ERROR_ARGUMENT_MISMATCH | the arguments provided didn't match the expected arguments for the functions type signature. |