359
359
This method must be called exactly once before using <em class="parameter"><code>self</code></em>. Note that
360
360
some constructors will do this for you.
363
To create a model with three columns; a 32 bit integer, a string,
364
and lastly an array of strings, you would do:
366
<div class="informalexample"><pre class="programlisting">
368
model = dee_sequence_model_new ();
369
dee_model_set_schema (model, "i", "s", "as", NULL);
362
373
<div class="variablelist"><table border="0">
363
374
<col align="left" valign="top">
406
417
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const *column_schemas</code></em>,
407
418
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> num_columns</code></em>);</pre>
420
Set the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> types and the number of columns used by <em class="parameter"><code>self</code></em>.
421
This method must be called exactly once before using <em class="parameter"><code>self</code></em>. Note that
422
some constructors will do this for you.
410
424
<div class="variablelist"><table border="0">
411
425
<col align="left" valign="top">
414
428
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
429
<td>The <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a> to set the column layout for
419
433
<td><p><span class="term"><em class="parameter"><code>column_schemas</code></em> :</span></p></td>
434
<td> A list of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> type strings terminated by a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_columns zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym> utf8]</span>
424
438
<td><p><span class="term"><em class="parameter"><code>num_columns</code></em> :</span></p></td>
439
<td>an integer specifying the array length for <em class="parameter"><code>VarArgs</code></em>
449
463
<td><p><span class="term"><em class="parameter"><code>num_columns</code></em> :</span></p></td>
450
<td>Address of an integer in which to store the number of
451
columns in <em class="parameter"><code>self</code></em>. Or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore the array length.
464
<td> Address of an integer in which to store the
465
number of columns in <em class="parameter"><code>self</code></em>. Or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore the array length. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
455
469
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456
<td> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> type strings. The length of
470
<td> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
471
array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> type strings. The length of
457
472
the returned array is written to <em class="parameter"><code>num_columns</code></em>. The returned array
458
should not be freed or modified. It is owned by the model.
473
should not be freed or modified. It is owned by the model. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym> utf8]</span>
561
576
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
562
577
Any basic variant type is passed as the standard C type while
563
578
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
564
references will be consumed.
579
references will be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
580
type column will be converted to the empty string.
568
584
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
569
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
585
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
609
625
Like <a class="link" href="DeeModel.html#dee-model-append" title="dee_model_append ()"><code class="function">dee_model_append()</code></a> but intended for language bindings or
610
626
situations where you work with models on a meta level and may not have
611
a priori knowledge of the column schemas of the models. See also
627
a prior knowledge of the column schemas of the models. See also
612
628
<a class="link" href="DeeModel.html#dee-model-build-row" title="dee_model_build_row ()"><code class="function">dee_model_build_row()</code></a>.
614
630
<div class="variablelist"><table border="0">
623
639
<td><p><span class="term"><em class="parameter"><code>row_members</code></em> :</span></p></td>
624
<td>An array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of
625
the column schemas of <em class="parameter"><code>self</code></em>. If any of the variants have
626
floating references they will be consumed
640
<td> An array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type
641
signature matching those of the column schemas of <em class="parameter"><code>self</code></em>.
642
If any of the variants have floating references they will be
643
consumed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
630
647
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
631
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
648
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
643
660
Creates and prepends a new row to the beginning of a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>, setting the
644
661
row values upon creation.
663
<div class="variablelist"><table border="0">
664
<col align="left" valign="top">
667
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
668
<td>a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>
672
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
673
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
674
Any basic variant type is passed as the standard C type while
675
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
676
references will be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
677
type column will be converted to the empty string.
681
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
682
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
651
686
<div class="informalexample"><pre class="programlisting">
654
689
dee_model_set_schema (model, "i", "s", NULL);
655
690
dee_model_prepend (model, 10, "Rooney");
659
<div class="variablelist"><table border="0">
660
<col align="left" valign="top">
663
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
664
<td>a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>
668
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
669
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
670
Any basic variant type is passed as the standard C type while
671
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
672
references will be consumed.
676
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
691
</pre></div>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
731
745
<td><p><span class="term"><em class="parameter"><code>row_members</code></em> :</span></p></td>
732
<td>An array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of
747
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of
733
748
the column schemas of <em class="parameter"><code>self</code></em>. If any of the variants have
734
floating references they will be consumed
749
floating references they will be consumed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
738
753
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
739
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
754
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
772
787
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
773
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
788
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
774
789
Any basic variant type is passed as the standard C type while
775
790
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
776
references will be consumed.
791
references will be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
792
type column will be converted to the empty string.
780
796
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
781
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
797
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
847
863
<td><p><span class="term"><em class="parameter"><code>row_members</code></em> :</span></p></td>
848
<td>An array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of
865
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of
849
866
the column schemas of <em class="parameter"><code>self</code></em>. If any of the variants have
850
floating references they will be consumed
867
floating references they will be consumed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated]</span>
854
871
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
855
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
872
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
907
924
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
908
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
925
<td>A list of values matching the column schemas of <em class="parameter"><code>self</code></em>.
909
926
Any basic variant type is passed as the standard C type while
910
927
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
911
references will be consumed.
928
references will be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
929
type column will be converted to the empty string.
915
933
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
916
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
934
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
926
944
<em class="parameter"><code><a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> *iter</code></em>,
927
945
<em class="parameter"><code><span class="type">va_list</span> *args</code></em>);</pre>
929
As <a class="link" href="DeeModel.html#dee-model-insert-before" title="dee_model_insert_before ()"><code class="function">dee_model_insert_before()</code></a>, but intended for language bindings.
931
948
<div class="variablelist"><table border="0">
932
949
<col align="left" valign="top">
935
952
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
936
<td>a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>
940
957
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
941
<td>An iter pointing to the row before which to insert the new one
945
962
<td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
946
<td>See <a class="link" href="DeeModel.html#dee-model-insert-before" title="dee_model_insert_before ()"><code class="function">dee_model_insert_before()</code></a>
950
967
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
951
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
983
1000
<td><p><span class="term"><em class="parameter"><code>row_members</code></em> :</span></p></td>
1002
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariants</span></a> with type signature matching those of the
1003
column schemas of <em class="parameter"><code>self</code></em>. If any of the variants have floating
1004
references they will be consumed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated]</span>
988
1008
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
989
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row
1009
<td> A <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the new row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1078
1098
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1079
<td>A list of values to set matching the column schemas
1099
<td>A list of values to set matching the column schemas.
1100
Any basic variant type is passed as the standard C type while
1101
any other type must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. Any floating
1102
references will be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
1103
type column will be converted to the empty string.
1089
1113
<em class="parameter"><code><a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> *iter</code></em>,
1090
1114
<em class="parameter"><code><span class="type">va_list</span> *args</code></em>);</pre>
1092
See <a class="link" href="DeeModel.html#dee-model-set" title="dee_model_set ()"><code class="function">dee_model_set()</code></a>. This version takes a va_list for language bindings.
1094
1117
<div class="variablelist"><table border="0">
1095
1118
<col align="left" valign="top">
1098
1121
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1099
<td>a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>
1103
1126
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1104
<td>a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a>
1108
1131
<td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1109
<td>a list of column/value location pairs, terminated by -1
1150
1173
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1151
<td>new value for cell. If <em class="parameter"><code>value</code></em> is a floating reference the model
1174
<td>New value for cell. If <em class="parameter"><code>value</code></em> is a floating reference the model
1152
1175
will assume ownership of the variant
1183
1206
<td><p><span class="term"><em class="parameter"><code>row_members</code></em> :</span></p></td>
1184
<td>And array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>s with type signature matching
1208
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>s with type signature matching
1185
1209
those from the model schema. If any of the variants have
1186
floating references these will be consumed
1210
floating references these will be consumed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span>
1256
1280
<em class="parameter"><code><a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> *iter</code></em>,
1257
1281
<em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
1259
See #<a class="link" href="DeeModel.html#dee-model-get" title="dee_model_get ()"><code class="function">dee_model_get()</code></a>. This version takes a va_list for language bindings.
1261
1284
<div class="variablelist"><table border="0">
1262
1285
<col align="left" valign="top">
1265
1288
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1266
<td>a <a class="link" href="DeeModel.html" title="DeeModel"><span class="type">DeeModel</span></a>
1270
1293
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1271
<td>a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a>
1275
1298
<td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1276
<td>a list of column/return location pairs, terminated by -1
1302
1325
<td><p><span class="term"><em class="parameter"><code>out_row_members</code></em> :</span></p></td>
1303
<td>An array of variants with a length bigger than or equal to
1327
of variants with a length bigger than or equal to
1304
1328
the number of columns in <em class="parameter"><code>self</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If you pass
1305
1329
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> here a new array will be allocated for you. The
1306
returned variants will have a non-floating reference
1330
returned variants will have a non-floating reference. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1345
1369
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1346
<td> A, guaranteed non-floating, reference to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing
1347
the row data. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.
1370
<td> A, guaranteed non-floating, reference to a
1371
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> containing the row data. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1456
1480
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1457
1481
<td> if <em class="parameter"><code>iter</code></em> and <em class="parameter"><code>column</code></em> are valid, the boolean stored at <em class="parameter"><code>column</code></em>.
1458
Otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1482
Otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1910
1934
Basic variant types are passed directly while any other
1911
1935
types must be boxed in a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>. It's important to note that
1912
1936
any floating references on variants passed to this method will be
1913
<span class="emphasis"><em>not</em></span> be consumed.
1937
<span class="emphasis"><em>not</em></span> be consumed. A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a string
1938
type column will be converted to the empty string.
1917
1942
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1918
1943
<td> If <em class="parameter"><code>out_row_members</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> a newly allocated array of variants
1919
will be returned, otherwise it will be reused. The variants in the
1920
array may or may not have floating references, which means the
1944
will be returned and the array must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
1945
If <em class="parameter"><code>out_row_members</code></em> is non<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it will be reused, and variants in
1946
the array may or may not have floating references, which means the
1921
1947
caller must make sure that <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-ref-sink"><code class="function">g_variant_ref_sink()</code></a> and
1922
1948
<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> are called on them.
1933
1959
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> **out_row_members</code></em>,
1934
1960
<em class="parameter"><code><span class="type">va_list</span> *args</code></em>);</pre>
1936
Like <a class="link" href="DeeModel.html#dee-model-build-row" title="dee_model_build_row ()"><code class="function">dee_model_build_row()</code></a> but intended for language bindings.
1938
1963
<div class="variablelist"><table border="0">
1939
1964
<col align="left" valign="top">
1942
1967
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1943
<td>The model to build a row for
1947
1972
<td><p><span class="term"><em class="parameter"><code>out_row_members</code></em> :</span></p></td>
1948
<td>An array to write the values to or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to allocate
1953
1977
<td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1954
<td>A <code class="literal">va_list</code> of arguments as described in <a class="link" href="DeeModel.html#dee-model-build-row" title="dee_model_build_row ()"><code class="function">dee_model_build_row()</code></a>
1958
1982
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1959
<td> See <a class="link" href="DeeModel.html#dee-model-build-row" title="dee_model_build_row ()"><code class="function">dee_model_build_row()</code></a>
1985
2009
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1986
<td>a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the newly added row
2010
<td> a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the newly added row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2014
2038
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2015
<td>a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the changed row
2039
<td> a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the changed row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2044
2068
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2045
<td>a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the removed row
2069
<td> a <a class="link" href="DeeModel.html#DeeModelIter" title="DeeModelIter"><span class="type">DeeModelIter</span></a> pointing to the removed row. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>