[svn r362] Some fixes in the GIOWatcher clean-ups, and changed the API version number.
4 * @file gmyth/gmyth_stringlist.c
6 * @brief <p> This component contains functions for dealing with the stringlist
7 * format of the mythprotocol.
9 * Copyright (C) 2006 INdT - Instituto Nokia de Tecnologia.
10 * @author Hallyson Luiz de Morais Melo <hallyson.melo@indt.org.br>
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU Lesser General Public License
25 * along with this program; if not, write to the Free Software
26 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
33 #include "gmyth_stringlist.h"
35 #include "gmyth_debug.h"
37 static void gmyth_string_list_class_init (GMythStringListClass *klass);
38 static void gmyth_string_list_init (GMythStringList *object);
40 static void gmyth_string_list_dispose (GObject *object);
41 static void gmyth_string_list_finalize (GObject *object);
43 G_DEFINE_TYPE(GMythStringList, gmyth_string_list, G_TYPE_OBJECT)
46 gmyth_string_list_class_init (GMythStringListClass *klass)
48 GObjectClass *gobject_class;
50 gobject_class = (GObjectClass *) klass;
52 gobject_class->dispose = gmyth_string_list_dispose;
53 gobject_class->finalize = gmyth_string_list_finalize;
57 gmyth_string_list_init (GMythStringList *gmyth_string_list)
59 gmyth_string_list->glist = NULL;
63 gmyth_string_list_dispose (GObject *object)
65 GMythStringList *gmyth_string_list = GMYTH_STRING_LIST(object);
67 if (gmyth_string_list->glist)
68 gmyth_string_list_clear_all(gmyth_string_list);
70 G_OBJECT_CLASS (gmyth_string_list_parent_class)->dispose (object);
74 gmyth_string_list_finalize (GObject *object)
76 //GMythStringList *gmyth_string_list = GMYTH_STRING_LIST(object);
78 g_signal_handlers_destroy (object);
80 G_OBJECT_CLASS (gmyth_string_list_parent_class)->finalize (object);
83 /** Creates a new instance of GStringList.
85 * @return a new instance of GStringList.
88 gmyth_string_list_new ()
90 GMythStringList *gmyth_string_list = GMYTH_STRING_LIST (g_object_new (GMYTH_STRING_LIST_TYPE, NULL));
91 return gmyth_string_list;
94 /** Appends a guint64 to the string list.
96 * @param strlist The GMythStringList instance.
97 * @param value The guint64 to be appended.
99 * @return The appended guint64 converted to a GString object.
102 gmyth_string_list_append_int ( GMythStringList *strlist, const gint value )
104 GString *tmp_str = g_string_new ("");
106 g_string_printf (tmp_str, "%d", value);
108 gmyth_string_list_append_string (strlist, tmp_str);
113 /** Appends a guint64 to the string list.
115 * @param strlist The GMythStringList instance.
116 * @param value The guint64 to be appended.
118 * @return The appended guint64 converted to a GString object.
121 gmyth_string_list_append_uint64 ( GMythStringList *strlist, const guint64 value)
123 GString *tmp_str1 = g_string_new ("");
124 GString *tmp_str2 = g_string_new ("");
125 gmyth_debug ( "value = %llu.\n", value);
127 gulong l2 = ( (guint64)value & 0xffffffff );
128 gulong l1 = ( (guint64)value >> 32 );
130 /* high order part of guint64 value */
131 g_string_printf (tmp_str1, "%lu", l1);
133 gmyth_debug( "[%s] uint64 (high) = %s\n", __FUNCTION__, tmp_str1->str );
135 //gmyth_string_list_append_string (strlist, tmp_str1);
136 strlist->glist = g_list_append( strlist->glist, tmp_str1 );
138 /* low order part of guint64 value */
139 g_string_printf (tmp_str2, "%lu", l2);
141 gmyth_debug( "[%s] uint64 (low) = %s\n", __FUNCTION__, tmp_str2->str );
143 strlist->glist = g_list_append( strlist->glist, tmp_str2 );
145 //gmyth_string_list_append_string (strlist, tmp_str2);
150 /** Appends a gint64 to the string list.
152 * @param strlist The GMythStringList instance.
153 * @param value The gint64 to be appended.
155 * @return The appended gint64 converted to a GString object.
158 gmyth_string_list_append_int64 ( GMythStringList *strlist, const gint64 value)
160 GString *tmp_str1 = g_string_new ("");
161 GString *tmp_str2 = g_string_new ("");
162 gmyth_debug ( "value = %lld.\n", value );
164 glong l2 = ( (gint64)value & 0xffffffff );
165 glong l1 = ( (gint64)value >> 32 );
167 /* high order part of gint64 value */
168 g_string_printf (tmp_str1, "%ld", l1);
170 gmyth_debug( "[%s] int64 (high) = %s\n", __FUNCTION__, tmp_str1->str );
172 //gmyth_string_list_append_string (strlist, tmp_str1);
173 strlist->glist = g_list_append( strlist->glist, tmp_str1 );
175 /* low order part of gint64 value */
176 g_string_printf (tmp_str2, "%ld", l2);
178 gmyth_debug( "[%s] int64 (low) = %s\n", __FUNCTION__, tmp_str2->str );
180 strlist->glist = g_list_append( strlist->glist, tmp_str2 );
185 /** Appends a char array to the string list.
187 * @param strlist The GMythStringList instance.
188 * @param value The char array to be appended.
190 * @return The appended char array converted to a GString object.
193 gmyth_string_list_append_char_array ( GMythStringList *strlist, const gchar* value )
195 GString *tmp_str = NULL;
197 g_return_val_if_fail( strlist != NULL, NULL );
199 tmp_str = g_string_new (value);
201 g_return_val_if_fail( tmp_str != NULL, NULL );
203 gmyth_string_list_append_string (strlist, tmp_str);
208 /** Appends a string to the string list.
210 * @param strlist The GMythStringList instance.
211 * @param value The string to be appended.
213 * @return The appended string itself.
216 gmyth_string_list_append_string ( GMythStringList *strlist, GString *value )
218 g_return_val_if_fail( strlist != NULL, NULL );
220 strlist->glist = g_list_append (strlist->glist, value);
225 /** Gets an integer value from the string list at the given position.
227 * @param strlist The GMythStringList instance.
228 * @param index the integer position in the list, starting with zero.
229 * @return The integer value.
232 gmyth_string_list_get_int ( GMythStringList *strlist, const gint index )
234 //TODO: Create static method check_index()
235 GString *tmp_str = NULL;
237 g_return_val_if_fail( strlist != NULL, 0 );
239 tmp_str = (GString *) g_list_nth_data (strlist->glist, index);
241 g_return_val_if_fail( tmp_str != NULL && tmp_str->str != NULL, 0 );
243 return (gint) ( /* 0x00000000ffffffffL & (gint64)*/g_ascii_strtoull ( tmp_str->str, NULL, 10 ) );
246 /** Gets a guint64 value from the string list at the given position.
247 * According to the Mythtv protocol, the 64 bits value is formed by
250 * @param strlist The GMythStringList instance.
251 * @param index the index of the first string forming the 64 bits value.
252 * Index starts with zero.
253 * @return The guint64 value.
256 gmyth_string_list_get_uint64 ( GMythStringList *strlist, const gint index )
258 //TODO: Create static method check_index()
259 guint64 ret_value = 0;
262 g_return_val_if_fail( strlist != NULL, 0 );
264 const GString *tmp_str1 = (GString *) g_list_nth_data (strlist->glist, index);
265 const GString *tmp_str2 = (GString *) g_list_nth_data (strlist->glist, index+1);
267 if ( tmp_str1 != NULL )
268 gmyth_debug ( "[%s] seek high bytes = %s\n", __FUNCTION__, tmp_str1->str );
269 if ( tmp_str2 == NULL || strlen( tmp_str2->str ) > 0 ) {
271 gmyth_debug ( "[%s] seek low bytes = %s\n", __FUNCTION__, tmp_str2->str );
274 guint64 l1 = ( (guint64)g_ascii_strtoull (tmp_str1->str, NULL, 10) /*& 0xffffffff*/ );
275 if ( tmp_str2 != NULL && tmp_str2->str != NULL && strlen(tmp_str2->str) > 0 ) {
276 l2 = ( (guint64)g_ascii_strtoull (tmp_str2->str, NULL, 10) /*& 0xffffffff*/ );
282 gmyth_debug ( "[%s]\t[l1 == %llu, l2 == %llu]\n", __FUNCTION__, l1, l2 );
284 ret_value = ((guint64)(l2) /*& 0xffffffff*/) | ((guint64)l1 << 32);
286 gmyth_debug( "[%s] returning uint64 value = %llu\n", __FUNCTION__, ret_value );
291 /** Gets a gint64 value from the string list at the given position.
292 * According to the Mythtv protocol, the 64 bits value is formed by
295 * @param strlist The GMythStringList instance.
296 * @param index the index of the first string forming the 64 bits value.
297 * Index starts with zero.
298 * @return The gint64 value.
301 gmyth_string_list_get_int64 ( GMythStringList *strlist, const gint index )
303 //TODO: Create static method check_index()
304 gint64 ret_value = 0;
307 g_return_val_if_fail( strlist != NULL, 0 );
309 const GString *tmp_str1 = (GString *) g_list_nth_data (strlist->glist, index);
310 const GString *tmp_str2 = (GString *) g_list_nth_data (strlist->glist, index+1);
312 if ( tmp_str1 != NULL )
313 gmyth_debug ( "[%s] seek high bytes = %s\n", __FUNCTION__, tmp_str1->str );
314 if ( tmp_str2 == NULL || strlen( tmp_str2->str ) > 0 ) {
316 gmyth_debug ( "[%s] seek low bytes = %s\n", __FUNCTION__, tmp_str2->str );
319 gint64 l1 = ( (guint64)g_ascii_strtoull (tmp_str1->str, NULL, 10) /*& 0xffffffff*/ );
320 if ( tmp_str2 != NULL && tmp_str2->str != NULL && strlen(tmp_str2->str) > 0 ) {
321 l2 = ( (gint64)g_ascii_strtoull (tmp_str2->str, NULL, 10) /*& 0xffffffff*/ );
327 gmyth_debug ( "[%s]\t[l1 == %lld, l2 == %lld]\n", __FUNCTION__, l1, l2 );
329 ret_value = ((gint64)(l2) /*& 0xffffffff*/) | ((gint64)l1 << 32);
331 gmyth_debug( "[%s] returning int64 value = %lld\n", __FUNCTION__, ret_value );
337 /** Gets a string from the string list at the given position.
339 * @param strlist The GMythStringList instance.
340 * @param index the string position in the list, starting with zero.
341 * @return A pointer to the string data.
344 gmyth_string_list_get_string ( GMythStringList *strlist, const gint index )
346 if (!strlist || !(strlist->glist)) {
347 g_warning ("%s received Null arguments", __FUNCTION__);
351 return (GString *) g_list_nth_data (strlist->glist, index);
357 gmyth_string_list_clear_element( GString *str_elem, void *data_aux )
359 if ( str_elem != NULL ) {
360 g_string_free( str_elem, TRUE );
365 /** Removes all strings from the string list.
367 * @param strlist The GMythStringList instance.
370 gmyth_string_list_clear_all ( GMythStringList *strlist )
372 if ( strlist != NULL && strlist->glist ) {
373 //g_list_foreach( strlist->glist, (GFunc)gmyth_string_list_clear_element, NULL );
374 g_list_free (strlist->glist);
375 strlist->glist = NULL;
379 /** Retrieves the number of elements in the string list.
381 * @param strlist The GMythStringList instance.
382 * @return the string list length.
385 gmyth_string_list_length ( GMythStringList *strlist )
387 g_return_val_if_fail( strlist != NULL && strlist->glist != NULL, 0 );
389 return g_list_length (strlist->glist);