libpurple/protocols/gg/utils.h

   1 /* purple
   2  *
   3  * Purple is the legal property of its developers, whose names are too numerous
   4  * to list here.  Please refer to the COPYRIGHT file distributed with this
   5  * source distribution.
   6  *
   7  * Rewritten from scratch during Google Summer of Code 2012
   8  * by Tomek Wasilczyk (http://www.wasilczyk.pl).
   9  *
  10  * Previously implemented by:
  11  *  - Arkadiusz Miskiewicz <misiek@pld.org.pl> - first implementation (2001);
  12  *  - Bartosz Oler <bartosz@bzimage.us> - reimplemented during GSoC 2005;
  13  *  - Krzysztof Klinikowski <grommasher@gmail.com> - some parts (2009-2011).
  14  *
  15  * This program is free software; you can redistribute it and/or modify
  16  * it under the terms of the GNU General Public License as published by
  17  * the Free Software Foundation; either version 2 of the License, or
  18  * (at your option) any later version.
  19  *
  20  * This program is distributed in the hope that it will be useful,
  21  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  22  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23  * GNU General Public License for more details.
  24  *
  25  * You should have received a copy of the GNU General Public License
  26  * along with this program; if not, write to the Free Software
  27  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  28  */
  29
  30 #ifndef PURPLE_GG_UTILS_H
  31 #define PURPLE_GG_UTILS_H
  32
  33 #include <internal.h>
  34 #include <libgadu.h>
  35 #include <json-glib/json-glib.h>
  36
  37 /**
  38  * Converts stringified UIN to uin_t.
  39  *
  40  * @param str The string to convert.
  41  *
  42  * @return Converted UIN or 0 if an error occurred.
  43  */
  44 uin_t ggp_str_to_uin(const char *str);
  45
  46 /**
  47  * Stringifies UIN.
  48  *
  49  * @param uin UIN to stringify.
  50  *
  51  * @return Stringified UIN.
  52  */
  53 const char * ggp_uin_to_str(uin_t uin);
  54
  55 /**
  56  * Gets UIN for the account.
  57  *
  58  * @param gc The connection, in which account is connected.
  59  * @return UIN for this account.
  60  */
  61 uin_t ggp_get_my_uin(PurpleConnection *gc);
  62
  63 /**
  64  * Converts encoding of a given string from UTF-8 to CP1250.
  65  *
  66  * @param src Input string.
  67  *
  68  * @return Converted string (must be freed with g_free). If src is NULL,
  69  * then NULL is returned.
  70  */
  71 gchar * ggp_convert_to_cp1250(const gchar *src);
  72
  73 /**
  74  * Converts encoding of a given string from CP1250 to UTF-8.
  75  *
  76  * @param src Input string.
  77  *
  78  * @return Converted string (must be freed with g_free). If src is NULL,
  79  * then NULL is returned.
  80  */
  81 gchar * ggp_convert_from_cp1250(const gchar *src);
  82
  83 gboolean ggp_password_validate(const gchar *password);
  84
  85 gchar * ggp_utf8_strndup(const gchar *str, gsize n);
  86
  87 GSList * ggp_list_copy_to_slist_deep(GList *list, GCopyFunc func,
  88         gpointer user_data);
  89
  90 GList * ggp_strsplit_list(const gchar *string, const gchar *delimiter,
  91         gint max_tokens);
  92
  93 gchar * ggp_strjoin_list(const gchar *separator, GList *list);
  94
  95 const gchar * ggp_ipv4_to_str(uint32_t raw_ip);
  96
  97 GList * ggp_list_truncate(GList *list, guint length, GDestroyNotify free_func);
  98
  99 gchar * ggp_free_if_equal(gchar *str, const gchar *pattern);
 100
 101 const gchar * ggp_date_strftime(const gchar *format, time_t date);
 102
 103 time_t ggp_date_from_iso8601(const gchar *str);
 104
 105 uint64_t * ggp_uint64dup(uint64_t val);
 106
 107 gint ggp_int64_compare(gconstpointer a, gconstpointer b);
 108
 109 JsonParser * ggp_json_parse(const gchar *data);
 110
 111 #endif /* PURPLE_GG_UTILS_H */