{% extends "base.html" %} {% block title %}{{ namespace.name }}.{{ class.name }}.{{ type_func.name }}{% endblock %} {% block meta_other %} {% endblock %} {% block sidebar %}
Type
Functions
{% endblock %} {% block content %}

Function

{{ namespace.name }}{{ class.name }}{{ type_func.name }}

{%- if CONFIG.is_unstable(type_func.available_since) -%} unstable  {%- endif %} {%- if type_func.deprecated_since -%} deprecated: {{ type_func.deprecated_since.version }}  {%- endif -%} {%- if type_func.available_since -%} since: {{ type_func.available_since }} {%- endif -%}

Declaration {% if CONFIG.source_location_url and type_func.source_location %} [src] {% endif %}

{{ type_func.c_decl }}

Description {% if CONFIG.source_location_url and type_func.docs_location %} [src] {% endif %}

{{ type_func.description }}
{% if type_func.stability -%}

Stability: {{ type_func.stability }}

{%- endif %} {% if type_func.available_since -%}

Available since: {{ type_func.available_since }}

{%- endif %} {% if type_func.deprecated_since -%}
{%- if type_func.deprecated_since.message -%}

Deprecated since: {{ type_func.deprecated_since.version }}

{{ type_func.deprecated_since.message }} {%- else -%}

Deprecated since: {{ type_func.deprecated_since.version }}. Do not use in newly written code

{%- endif -%}
{%- endif %} {% if not type_func.introspectable -%}

This function is not directly available to language bindings.

{%- endif %} {% if type_func.shadows -%}

This method is renamed to {{type_func.shadows_symbol}}() in language bindings

{%- endif %} {% if type_func.shadowed_by -%}

The implementation of this method is provided by {{type_func.shadowed_by_symbol}}() in language bindings

{%- endif %}
{% if type_func.attributes %}
{% for (key, value) in type_func.attributes.items() %} {% endfor %}
{{ key|escape }}{{ value|escape }}
{% endif %}
{% if type_func.arguments|length != 0 %}

Parameters

{% for arg in type_func.arguments %}
{{ arg.name }}

Type:  {%- if arg.is_array -%}An array of {%- endif -%} {%- if arg.is_list -%}A list of {%- endif -%} {%- if arg.link -%} {{ arg.link|safe }} {%- else -%} {{ arg.type_cname }} {%- endif -%}

{{ arg.description|safe }}

{% if arg.direction != "in" %}{% endif %} {% if arg.direction == "in" and arg.is_pointer and arg.nullable %}{% endif %} {% if arg.direction == "out" and arg.is_pointer and arg.nullable %}{% endif %} {% if arg.optional %}{% endif %} {% if arg.is_array and arg.zero_terminated %}{% endif %} {% if arg.is_array and arg.fixed_size > 0 %}{% endif %} {% if arg.is_array and arg.len_arg %}{% endif %} {% if arg.is_pointer %}{% endif %} {% if arg.string_note %}{% endif %}
{{ arg.direction_note }}
The argument can be NULL.
The argument can be set to NULL by the function.
The argument can be NULL.
The array must be NULL-terminated.
The array must have {{ arg.fixed_size }} elements.
The length of the array is specified in the {{ arg.len_arg }} argument.
{{ arg.transfer_note }}
{{ arg.string_note }}
{% endfor %} {% if type_func.throws %}
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will left initialized to NULL by the function if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
{% endif %}
{% endif %} {% if type_func.return_value %}

Return value

Type:  {%- if type_func.return_value.is_array -%}An array of {%- endif -%} {%- if type_func.return_value.is_list -%}A list of {%- endif -%} {%- if type_func.return_value.is_list_model -%}A list model of {%- endif -%} {%- if type_func.return_value.link -%} {{ type_func.return_value.link|safe }} {%- else -%} {{ type_func.return_value.type_cname }} {%- endif -%}

{{ type_func.return_value.description|safe }}

{% if type_func.return_value.is_array and type_func.return_value.zero_terminated %}{% endif %} {% if type_func.return_value.is_array and type_func.return_value.fixed_size > 0 %}{% endif %} {% if type_func.return_value.is_array and type_func.return_value.len_arg %}{% endif %} {% if type_func.return_value.is_pointer %}{% endif %} {% if type_func.return_value.is_pointer and type_func.return_value.nullable %}{% endif %} {% if type_func.return_value.string_note %}{% endif %}
The array is NULL-terminated.
The array has {{ type_func.return_value.fixed_size }} elements.
The length of the array is in the {{ type_func.return_value.len_arg }} argument.
{{ type_func.return_value.transfer_note }}
The return value can be NULL.
{{ type_func.return_value.string_note }}
{% endif %}
{% endblock %}