TpContactSearchResult: telepathy-glib API Reference Manual

## TpContactSearchResult TpContactSearchResult — a result of a contact search |

## Functions

TpContactInfoField * | tp_contact_search_result_get_field ()
GList * | tp_contact_search_result_get_fields ()
GList * | tp_contact_search_result_dup_fields ()
const gchar * | tp_contact_search_result_get_identifier ()

## Properties

char * | identifier | Read / Write / Construct Only

## Types and Values

struct | TpContactSearchResult
struct | TpContactSearchResultClass

## Object Hierarchy

        GObject
        ╰── TpContactSearchResult

## Includes

    #include <telepathy-glib/telepathy-glib.h>

## Description

TpContactSearchResult objects represent results for TpContactSearch.

## Functions

### tp_contact_search_result_get_field ()

    TpContactInfoField *
    tp_contact_search_result_get_field (TpContactSearchResult *self,
                                        const gchar *field);

#### Parameters

self | a TpContactSearchResult |
field | the name of the field |

#### Returns

the specified field, or `NULL` if the result doesn't have it.

[transfer none]

Since: 0.13.11

### tp_contact_search_result_get_fields ()

    GList *
    tp_contact_search_result_get_fields (TpContactSearchResult *self);

`tp_contact_search_result_get_fields` is deprecated and should not be used in newly-written code.

Since 0.19.9. New code should use `tp_contact_search_result_dup_fields()` instead.

#### Parameters

self | a search result |

#### Returns

a GList of TpContactInfoField for the specified contact. You should free it when you're done with `g_list_free()`.

[transfer container][element-type TelepathyGLib.ContactInfoField]

### tp_contact_search_result_dup_fields ()

    GList *
    tp_contact_search_result_dup_fields (TpContactSearchResult *self);

#### Parameters

self | a search result |

#### Returns

a GList of TpContactInfoField for the specified contact. You should free it when you're done with `tp_contact_info_list_free()`.

[transfer full][element-type TelepathyGLib.ContactInfoField]

Since: 0.19.9

### tp_contact_search_result_get_identifier ()

    const gchar *
    tp_contact_search_result_get_identifier
                                   (TpContactSearchResult *self);

#### Parameters

self | a TpContactSearchResult |

#### Returns

the contact identifier.

Since: 0.13.11

## Types and Values

### struct TpContactSearchResult

    struct TpContactSearchResult;

An object representing the results of a Telepathy contact search channel. There are no interesting public struct fields.

Since: 0.13.11

### struct TpContactSearchResultClass

    struct TpContactSearchResultClass {
    };

The class of a TpContactSearchResult.

Since: 0.13.11

## Property Details

### The `“identifier”` property

      “identifier”               char *

The contact identifier.

Owner: TpContactSearchResult

Flags: Read / Write / Construct Only

Default value: NULL

## See Also

TpContactSearch