File: glib-messages.ads

package info (click to toggle)
libgtkada2 2.8.1-6lenny3
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 13,496 kB
  • ctags: 3,886
  • sloc: ada: 103,189; ansic: 45,411; perl: 5,500; sh: 2,812; makefile: 1,169; xml: 19
file content (108 lines) | stat: -rw-r--r-- 4,145 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
-----------------------------------------------------------------------
--               GtkAda - Ada95 binding for Gtk+/Gnome               --
--                                                                   --
--                   Copyright (C) 2003 ACT-Europe                   --
--                                                                   --
-- This library is free software; you can redistribute it and/or     --
-- modify it under the terms of the GNU General Public               --
-- License as published by the Free Software Foundation; either      --
-- version 2 of the License, or (at your option) any later version.  --
--                                                                   --
-- This library is distributed in the hope that it will be useful,   --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of    --
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU --
-- General Public License for more details.                          --
--                                                                   --
-- You should have received a copy of the GNU General Public         --
-- License along with this library; if not, write to the             --
-- Free Software Foundation, Inc., 59 Temple Place - Suite 330,      --
-- Boston, MA 02111-1307, USA.                                       --
--                                                                   --
-----------------------------------------------------------------------

--  <description>
--  This package provides low level routines for enabling, disabling
--  and modifying the way log messages are handled in glib/gdk/gtk.
--  </description>
--  <group>Glib, the general-purpose library</group>

package Glib.Messages is
   pragma Preelaborate;

   type Log_Level_Flags is mod 2 ** 32;
   --  log levels and flags.

   ---------------
   -- log flags --
   ---------------

   Log_Flag_Recursion : constant Log_Level_Flags := 2 ** 0;
   Log_Flag_Fatal     : constant Log_Level_Flags := 2 ** 1;

   ----------------
   -- log levels --
   ----------------

   Log_Level_Error    : constant Log_Level_Flags := 2 ** 2;
   --  always fatal

   Log_Level_Critical : constant Log_Level_Flags := 2 ** 3;
   Log_Level_Warning  : constant Log_Level_Flags := 2 ** 4;
   Log_Level_Message  : constant Log_Level_Flags := 2 ** 5;
   Log_Level_Info     : constant Log_Level_Flags := 2 ** 6;
   Log_Level_Debug    : constant Log_Level_Flags := 2 ** 7;

   Log_Level_Mask     : constant Log_Level_Flags :=
     not (Log_Flag_Recursion or Log_Flag_Fatal);

   Log_Fatal_Mask     : constant Log_Level_Flags :=
     Log_Flag_Recursion or Log_Level_Error;
   --  log levels that are considered fatal by default

   type Log_Function is access procedure
     (Log_Domain : String;
      Log_Level  : Log_Level_Flags;
      Message    : UTF8_String);

   type Log_Handler_Id is new Guint;

   --  Logging mechanism

   function Log_Set_Handler
     (Log_Domain : String;
      Log_Levels : Log_Level_Flags;
      Log_Func   : Log_Function) return Log_Handler_Id;
   --  Set a log function for the given log levels, and return its id.

   procedure Log_Remove_Handler
     (Log_Domain : String;
      Handler_Id : Log_Handler_Id);
   --  Unset a given handler.

   procedure Log_Default_Handler
     (Log_Domain : String;
      Log_Levels : Log_Level_Flags;
      Message    : UTF8_String);
   --  The default log handler.
   --  Can be called e.g. within a user defined log handler.

   procedure Log
     (Log_Domain : String;
      Log_Levels : Log_Level_Flags;
      Message    : UTF8_String);
   --  Log a message through the glib logging facility.

   function Log_Set_Fatal_Mask
     (Log_Domain : String;
      Fatal_Mask : Log_Level_Flags) return Log_Level_Flags;
   --  Set the level at which messages are considered fatal for a given domain.

   function Log_Set_Always_Fatal
     (Fatal_Mask : Log_Level_Flags) return Log_Level_Flags;
   --  Set the level at which messages are considered fatal for any domain.

private

   pragma Import (C, Log_Set_Always_Fatal, "g_log_set_always_fatal");

end Glib.Messages;