~ubuntu-branches/ubuntu/quantal/folks/quantal

« back to all changes in this revision

Viewing changes to folks/name-details.c

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-09-12 09:48:10 UTC
  • mfrom: (1.6.2)
  • Revision ID: package-import@ubuntu.com-20120912094810-6zlx8889hcovxj7p
Tags: 0.7.4.1-0ubuntu1
* New upstream bugfix release
* debian/control:
  - Bump build-depends on libglib2.0-dev, valac-0.18, libvala-0.18-dev
* debian/libfolks-eds25.symbols:
* debian/libfolks25.symbols:
  - Updated

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/* name-details.c generated by valac 0.17.3, the Vala compiler
 
1
/* name-details.c generated by valac 0.17.6.5-65f99, the Vala compiler
2
2
 * generated from name-details.vala, do not modify */
3
3
 
4
4
/*
76
76
typedef enum  {
77
77
        FOLKS_PROPERTY_ERROR_NOT_WRITEABLE,
78
78
        FOLKS_PROPERTY_ERROR_INVALID_VALUE,
79
 
        FOLKS_PROPERTY_ERROR_UNKNOWN_ERROR
 
79
        FOLKS_PROPERTY_ERROR_UNKNOWN_ERROR,
 
80
        FOLKS_PROPERTY_ERROR_UNAVAILABLE
80
81
} FolksPropertyError;
81
82
#define FOLKS_PROPERTY_ERROR folks_property_error_quark ()
82
83
struct _FolksNameDetailsIface {
192
193
/**
193
194
   * Create a StructuredName.
194
195
   *
195
 
   * You can pass `null` if a component is not set.
 
196
   * You can pass ``null`` if a component is not set.
196
197
   *
197
198
   * @param family_name the family (last) name
198
199
   * @param given_name the given (first) name
230
231
   *
231
232
   * Shorthand for the common case of just having the family and given
232
233
   * name of a contact. It's equivalent to calling
233
 
   * {@link StructuredName.StructuredName} and passing `null` for all
 
234
   * {@link StructuredName.StructuredName} and passing ``null`` for all
234
235
   * the other components.
235
236
   *
236
237
   * @param family_name the family (last) name
258
259
/**
259
260
   * Whether none of the components is set.
260
261
   *
261
 
   * @return `true` if all the components are the empty string, `false`
 
262
   * @return ``true`` if all the components are the empty string, ``false``
262
263
   * otherwise.
263
264
   *
264
265
   * @since 0.3.5
317
318
   * Whether two StructuredNames are the same.
318
319
   *
319
320
   * @param other the other structured name to compare with
320
 
   * @return `true` if all the components are the same, `false`
 
321
   * @return ``true`` if all the components are the same, ``false``
321
322
   * otherwise.
322
323
   *
323
324
   * @since 0.5.0
687
688
 
688
689
 
689
690
/**
690
 
 * Object for a full name split in its constituent parts (given name,
 
691
 * Structured name representation for human names.
 
692
 *
 
693
 * Represents a full name split in its constituent parts (given name,
691
694
 * family name, etc.). This structure corresponds to the "N" field in
692
 
 * VCards.  The parts of the name are never null, an empty string
 
695
 * vCards. The parts of the name are never ``null``: an empty string
693
696
 * indicates that a property is not set.
694
697
 *
695
698
 * @since 0.3.5
784
787
        _data_->self = _tmp0_;
785
788
        _tmp1_ = name;
786
789
        _tmp2_ = _g_object_ref0 (_tmp1_);
 
790
        _g_object_unref0 (_data_->name);
787
791
        _data_->name = _tmp2_;
788
792
        folks_name_details_real_change_structured_name_co (_data_);
789
793
}
806
810
   * notification and will only return once the name has been written to the
807
811
   * relevant backing store (or the operation's failed).
808
812
   *
809
 
   * @param name the structured name (`null` to unset it)
 
813
   * @param name the structured name (``null`` to unset it)
810
814
   * @throws PropertyError if setting the structured name failed
811
815
   * @since 0.6.2
812
816
   */
878
882
        _data_->self = _tmp0_;
879
883
        _tmp1_ = full_name;
880
884
        _tmp2_ = g_strdup (_tmp1_);
 
885
        _g_free0 (_data_->full_name);
881
886
        _data_->full_name = _tmp2_;
882
887
        folks_name_details_real_change_full_name_co (_data_);
883
888
}
972
977
        _data_->self = _tmp0_;
973
978
        _tmp1_ = nickname;
974
979
        _tmp2_ = g_strdup (_tmp1_);
 
980
        _g_free0 (_data_->nickname);
975
981
        _data_->nickname = _tmp2_;
976
982
        folks_name_details_real_change_nickname_co (_data_);
977
983
}
1089
1095
                   * The contact name split in its constituent parts.
1090
1096
                   *
1091
1097
                   * Note that most of the time the structured name is not set (i.e.
1092
 
                   * it's `null`) or just some of the components are set.
 
1098
                   * it's ``null``) or just some of the components are set.
1093
1099
                   * The components are immutable. To get notification of changes of
1094
 
                   * the structured name, you just have to connect to the `notify` signal
 
1100
                   * the structured name, you just have to connect to the ``notify`` signal
1095
1101
                   * of this property.
1096
1102
                   *
1097
1103
                   * @since 0.3.5
1107
1113
                   * The full name could or could not contain additional names (like a
1108
1114
                   * middle name), prefixes or suffixes.
1109
1115
                   *
1110
 
                   * The full name must not be `null`: the empty string represents an unset full
1111
 
                   * name.
 
1116
                   * The full name must not be ``null``: the empty string represents an unset
 
1117
                   * full name.
1112
1118
                   *
1113
1119
                   * @since 0.3.5
1114
1120
                   */
1124
1130
                   * address book when updating the information a contact has specified about
1125
1131
                   * themselves.
1126
1132
                   *
1127
 
                   * The nickname must not be `null`: the empty string represents an unset
 
1133
                   * The nickname must not be ``null``: the empty string represents an unset
1128
1134
                   * nickname.
1129
1135
                   *
1130
1136
                   * @since 0.3.5