src/util.h

   1 /*
   2  * Copyright (c) 2007, 2008, 2009, Czirkos Zoltan <cirix@fw.hu>
   3  *
   4  * Permission to use, copy, modify, and distribute this software for any
   5  * purpose with or without fee is hereby granted, provided that the above
   6  * copyright notice and this permission notice appear in all copies.
   7  *
   8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15  */
  16 #ifndef _GD_UTIL_H
  17 #define _GD_UTIL_H
  18
  19 #include <glib.h>
  20
  21 /*******************************************
  22  *
  23  * ERROR HANDLING
  24  *
  25  */
  26 typedef struct _gd_error_message {
  27     GLogLevelFlags flags;
  28     char *message;
  29 } GdErrorMessage;
  30
  31 extern GList *gd_errors;
  32
  33 /* error handling */
  34 void gd_error_set_context(const char *format, ...);
  35 void gd_clear_error_flag();
  36 void gd_install_log_handler();
  37 gboolean gd_has_new_error();
  38 void gd_clear_errors();
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48 /* returns a static string which contains the utf8 representation of the filename in system encoding*/
  49 const char *gd_filename_to_utf8(const char *filename);
  50
  51 /* tries to find a file in the gdash installation and returns a path (owned by this function, not to be g_free()d) */
  52 const char *gd_find_file(const char *filename);
  53
  54 /* wrap a text to specified width */
  55 char *gd_wrap_text(const char *orig, int width);
  56 /* count lines in text (number of \n's + 1) */
  57 int gd_lines_in_text(const char *text);
  58
  59 /* return current date in 2008-12-04 format */
  60 const char *gd_get_current_date();
  61 /* return current date in 2008-12-04 12:34 format */
  62 const char *gd_get_current_date_time();
  63 /* clamp integer into range */
  64 int gd_clamp(int val, int min, int max);
  65 #endif
  66