TelepathyGLib.ContactInfoField

Fields

Name

Type

Access

Description

field_name

str

r/w

The name of the field; this is the lowercased name of a vCard field. For example, a field representing a contact’s address would be named “adr”.

field_value

[str]

r/w

For unstructured vCard fields (such as ‘fn’, a formatted name field), a single-element array containing the field’s value. For structured fields (such as ‘adr’, an address field), an array corresponding to the semicolon-separated elements of the field (with empty strings for empty elements).

parameters

[str]

r/w

A list of vCard type parameters applicable to this field, with their values. The type parameter names, and any values that are case-insensitive in vCard, MUST be in lower case. For example, a contact’s preferred home address would have parameters ‘type=home’ and ‘type=pref’.

priv

object

r

Methods

class

new (field_name, parameters, field_value)

Details

class TelepathyGLib.ContactInfoField

A structure representing an information about a contact. Similar to a vCard field.

New in version 0.11.7.

classmethod new(field_name, parameters, field_value)
Parameters:
  • field_name (str) – The name of the field; this is the lowercased name of a vCard field. For example, a field representing a contact’s address would be named “adr”.

  • parameters ([str]) – A list of vCard type parameters applicable to this field, with their values. The type parameter names, and any values that are case-insensitive in vCard, MUST be in lower case. For example, a contact’s preferred home address would have parameters ‘type=home’ and ‘type=pref’.

  • field_value ([str]) – For unstructured vCard fields (such as ‘fn’, a formatted name field), a single-element array containing the field’s value. For structured fields (such as ‘adr’, an address field), an array corresponding to the semicolon-separated elements of the field (with empty strings for empty elements).

Returns:

a newly allocated TelepathyGLib.ContactInfoField, free it with tp_contact_info_field_free()

Return type:

TelepathyGLib.ContactInfoField

Returns: says it all

New in version 0.11.7.