add a missing AVAILABLE_IN_2_36 annotation
[platform/upstream/glib.git] / gio / gapplicationcommandline.h
1 /* GIO - GLib Input, Output and Streaming Library
2  *
3  * Copyright © 2010 Codethink Limited
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU Lesser General Public License as published
7  * by the Free Software Foundation; either version 2 of the licence or (at
8  * your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Authors: Ryan Lortie <desrt@desrt.ca>
21  */
22
23 #ifndef __G_APPLICATION_COMMAND_LINE_H__
24 #define __G_APPLICATION_COMMAND_LINE_H__
25
26 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
27 #error "Only <gio/gio.h> can be included directly."
28 #endif
29
30 #include <gio/giotypes.h>
31
32 G_BEGIN_DECLS
33
34 #define G_TYPE_APPLICATION_COMMAND_LINE                     (g_application_command_line_get_type ())
35 #define G_APPLICATION_COMMAND_LINE(inst)                    (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
36                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
37                                                              GApplicationCommandLine))
38 #define G_APPLICATION_COMMAND_LINE_CLASS(class)             (G_TYPE_CHECK_CLASS_CAST ((class),                       \
39                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
40                                                              GApplicationCommandLineClass))
41 #define G_IS_APPLICATION_COMMAND_LINE(inst)                 (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
42                                                              G_TYPE_APPLICATION_COMMAND_LINE))
43 #define G_IS_APPLICATION_COMMAND_LINE_CLASS(class)          (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
44                                                              G_TYPE_APPLICATION_COMMAND_LINE))
45 #define G_APPLICATION_COMMAND_LINE_GET_CLASS(inst)          (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
46                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
47                                                              GApplicationCommandLineClass))
48
49 typedef struct _GApplicationCommandLinePrivate               GApplicationCommandLinePrivate;
50 typedef struct _GApplicationCommandLineClass                 GApplicationCommandLineClass;
51
52 struct _GApplicationCommandLine
53 {
54   /*< private >*/
55   GObject parent_instance;
56
57   GApplicationCommandLinePrivate *priv;
58 };
59
60 struct _GApplicationCommandLineClass
61 {
62   /*< private >*/
63   GObjectClass parent_class;
64
65   void                  (* print_literal)       (GApplicationCommandLine *cmdline,
66                                                  const gchar             *message);
67   void                  (* printerr_literal)    (GApplicationCommandLine *cmdline,
68                                                  const gchar             *message);
69   GInputStream *        (* get_stdin)           (GApplicationCommandLine *cmdline);
70
71   gpointer padding[11];
72 };
73
74 GLIB_AVAILABLE_IN_ALL
75 GType                   g_application_command_line_get_type             (void) G_GNUC_CONST;
76
77 GLIB_AVAILABLE_IN_ALL
78 gchar **                g_application_command_line_get_arguments        (GApplicationCommandLine   *cmdline,
79                                                                          int                       *argc);
80
81 GLIB_AVAILABLE_IN_2_36
82 GInputStream *          g_application_command_line_get_stdin            (GApplicationCommandLine   *cmdline);
83
84 GLIB_AVAILABLE_IN_ALL
85 const gchar * const *   g_application_command_line_get_environ          (GApplicationCommandLine   *cmdline);
86
87 GLIB_AVAILABLE_IN_ALL
88 const gchar *           g_application_command_line_getenv               (GApplicationCommandLine   *cmdline,
89                                                                          const gchar               *name);
90
91 GLIB_AVAILABLE_IN_ALL
92 const gchar *           g_application_command_line_get_cwd              (GApplicationCommandLine   *cmdline);
93
94 GLIB_AVAILABLE_IN_ALL
95 gboolean                g_application_command_line_get_is_remote        (GApplicationCommandLine   *cmdline);
96
97 GLIB_AVAILABLE_IN_ALL
98 void                    g_application_command_line_print                (GApplicationCommandLine   *cmdline,
99                                                                          const gchar               *format,
100                                                                          ...) G_GNUC_PRINTF(2, 3);
101 GLIB_AVAILABLE_IN_ALL
102 void                    g_application_command_line_printerr             (GApplicationCommandLine   *cmdline,
103                                                                          const gchar               *format,
104                                                                          ...) G_GNUC_PRINTF(2, 3);
105
106 GLIB_AVAILABLE_IN_ALL
107 int                     g_application_command_line_get_exit_status      (GApplicationCommandLine   *cmdline);
108 GLIB_AVAILABLE_IN_ALL
109 void                    g_application_command_line_set_exit_status      (GApplicationCommandLine   *cmdline,
110                                                                          int                        exit_status);
111
112 GLIB_AVAILABLE_IN_ALL
113 GVariant *              g_application_command_line_get_platform_data    (GApplicationCommandLine   *cmdline);
114
115 GLIB_AVAILABLE_IN_2_36
116 GFile *                 g_application_command_line_create_file_for_arg  (GApplicationCommandLine   *cmdline,
117                                                                          const gchar               *arg);
118
119 G_END_DECLS
120
121 #endif /* __G_APPLICATION_COMMAND_LINE_H__ */