?????????? ????????? - ??????????????? - /home/agenciai/public_html/cd38d8/glib-2.0.tar
???????
include/glibconfig.h 0000644 00000013005 15125126760 0010447 0 ustar 00 /* glibconfig.h * * This is a generated file. Please modify 'glibconfig.h.in' */ #ifndef __GLIBCONFIG_H__ #define __GLIBCONFIG_H__ #include <glib/gmacros.h> #include <limits.h> #include <float.h> #define GLIB_HAVE_ALLOCA_H /* Specifies that GLib's g_print*() functions wrap the * system printf functions. This is useful to know, for example, * when using glibc's register_printf_function(). */ #define GLIB_USING_SYSTEM_PRINTF /* #undef GLIB_STATIC_COMPILATION */ /* #undef GOBJECT_STATIC_COMPILATION */ G_BEGIN_DECLS #define G_MINFLOAT FLT_MIN #define G_MAXFLOAT FLT_MAX #define G_MINDOUBLE DBL_MIN #define G_MAXDOUBLE DBL_MAX #define G_MINSHORT SHRT_MIN #define G_MAXSHORT SHRT_MAX #define G_MAXUSHORT USHRT_MAX #define G_MININT INT_MIN #define G_MAXINT INT_MAX #define G_MAXUINT UINT_MAX #define G_MINLONG LONG_MIN #define G_MAXLONG LONG_MAX #define G_MAXULONG ULONG_MAX typedef signed char gint8; typedef unsigned char guint8; typedef signed short gint16; typedef unsigned short guint16; #define G_GINT16_MODIFIER "h" #define G_GINT16_FORMAT "hi" #define G_GUINT16_FORMAT "hu" typedef signed int gint32; typedef unsigned int guint32; #define G_GINT32_MODIFIER "" #define G_GINT32_FORMAT "i" #define G_GUINT32_FORMAT "u" #define G_HAVE_GINT64 1 /* deprecated, always true */ typedef signed long gint64; typedef unsigned long guint64; #define G_GINT64_CONSTANT(val) (val##L) #define G_GUINT64_CONSTANT(val) (val##UL) #define G_GINT64_MODIFIER "l" #define G_GINT64_FORMAT "li" #define G_GUINT64_FORMAT "lu" #define GLIB_SIZEOF_VOID_P 8 #define GLIB_SIZEOF_LONG 8 #define GLIB_SIZEOF_SIZE_T 8 #define GLIB_SIZEOF_SSIZE_T 8 typedef signed long gssize; typedef unsigned long gsize; #define G_GSIZE_MODIFIER "l" #define G_GSSIZE_MODIFIER "l" #define G_GSIZE_FORMAT "lu" #define G_GSSIZE_FORMAT "li" #define G_MAXSIZE G_MAXULONG #define G_MINSSIZE G_MINLONG #define G_MAXSSIZE G_MAXLONG typedef gint64 goffset; #define G_MINOFFSET G_MININT64 #define G_MAXOFFSET G_MAXINT64 #define G_GOFFSET_MODIFIER G_GINT64_MODIFIER #define G_GOFFSET_FORMAT G_GINT64_FORMAT #define G_GOFFSET_CONSTANT(val) G_GINT64_CONSTANT(val) #define G_POLLFD_FORMAT "%d" #define GPOINTER_TO_INT(p) ((gint) (glong) (p)) #define GPOINTER_TO_UINT(p) ((guint) (gulong) (p)) #define GINT_TO_POINTER(i) ((gpointer) (glong) (i)) #define GUINT_TO_POINTER(u) ((gpointer) (gulong) (u)) typedef signed long gintptr; typedef unsigned long guintptr; #define G_GINTPTR_MODIFIER "l" #define G_GINTPTR_FORMAT "li" #define G_GUINTPTR_FORMAT "lu" #define GLIB_MAJOR_VERSION 2 #define GLIB_MINOR_VERSION 68 #define GLIB_MICRO_VERSION 4 #define G_OS_UNIX #define G_VA_COPY va_copy #define G_VA_COPY_AS_ARRAY 1 #ifndef __cplusplus # define G_HAVE_ISO_VARARGS 1 #endif #ifdef __cplusplus # define G_HAVE_ISO_VARARGS 1 #endif /* gcc-2.95.x supports both gnu style and ISO varargs, but if -ansi * is passed ISO vararg support is turned off, and there is no work * around to turn it on, so we unconditionally turn it off. */ #if __GNUC__ == 2 && __GNUC_MINOR__ == 95 # undef G_HAVE_ISO_VARARGS #endif #define G_HAVE_GROWING_STACK 0 #define G_HAVE_GNUC_VISIBILITY 1 #ifndef _MSC_VER # define G_HAVE_GNUC_VARARGS 1 #endif #if defined(__SUNPRO_C) && (__SUNPRO_C >= 0x590) #define G_GNUC_INTERNAL __attribute__((visibility("hidden"))) #elif defined(__SUNPRO_C) && (__SUNPRO_C >= 0x550) #define G_GNUC_INTERNAL __hidden #elif defined (__GNUC__) && defined (G_HAVE_GNUC_VISIBILITY) #define G_GNUC_INTERNAL __attribute__((visibility("hidden"))) #else #define G_GNUC_INTERNAL #endif #define G_THREADS_ENABLED #define G_THREADS_IMPL_POSIX #define G_ATOMIC_LOCK_FREE #define GINT16_TO_LE(val) ((gint16) (val)) #define GUINT16_TO_LE(val) ((guint16) (val)) #define GINT16_TO_BE(val) ((gint16) GUINT16_SWAP_LE_BE (val)) #define GUINT16_TO_BE(val) (GUINT16_SWAP_LE_BE (val)) #define GINT32_TO_LE(val) ((gint32) (val)) #define GUINT32_TO_LE(val) ((guint32) (val)) #define GINT32_TO_BE(val) ((gint32) GUINT32_SWAP_LE_BE (val)) #define GUINT32_TO_BE(val) (GUINT32_SWAP_LE_BE (val)) #define GINT64_TO_LE(val) ((gint64) (val)) #define GUINT64_TO_LE(val) ((guint64) (val)) #define GINT64_TO_BE(val) ((gint64) GUINT64_SWAP_LE_BE (val)) #define GUINT64_TO_BE(val) (GUINT64_SWAP_LE_BE (val)) #define GLONG_TO_LE(val) ((glong) GINT64_TO_LE (val)) #define GULONG_TO_LE(val) ((gulong) GUINT64_TO_LE (val)) #define GLONG_TO_BE(val) ((glong) GINT64_TO_BE (val)) #define GULONG_TO_BE(val) ((gulong) GUINT64_TO_BE (val)) #define GINT_TO_LE(val) ((gint) GINT32_TO_LE (val)) #define GUINT_TO_LE(val) ((guint) GUINT32_TO_LE (val)) #define GINT_TO_BE(val) ((gint) GINT32_TO_BE (val)) #define GUINT_TO_BE(val) ((guint) GUINT32_TO_BE (val)) #define GSIZE_TO_LE(val) ((gsize) GUINT64_TO_LE (val)) #define GSSIZE_TO_LE(val) ((gssize) GINT64_TO_LE (val)) #define GSIZE_TO_BE(val) ((gsize) GUINT64_TO_BE (val)) #define GSSIZE_TO_BE(val) ((gssize) GINT64_TO_BE (val)) #define G_BYTE_ORDER G_LITTLE_ENDIAN #define GLIB_SYSDEF_POLLIN =1 #define GLIB_SYSDEF_POLLOUT =4 #define GLIB_SYSDEF_POLLPRI =2 #define GLIB_SYSDEF_POLLHUP =16 #define GLIB_SYSDEF_POLLERR =8 #define GLIB_SYSDEF_POLLNVAL =32 #define G_MODULE_SUFFIX "so" typedef int GPid; #define G_PID_FORMAT "i" #define GLIB_SYSDEF_AF_UNIX 1 #define GLIB_SYSDEF_AF_INET 2 #define GLIB_SYSDEF_AF_INET6 10 #define GLIB_SYSDEF_MSG_OOB 1 #define GLIB_SYSDEF_MSG_PEEK 2 #define GLIB_SYSDEF_MSG_DONTROUTE 4 #define G_DIR_SEPARATOR '/' #define G_DIR_SEPARATOR_S "/" #define G_SEARCHPATH_SEPARATOR ':' #define G_SEARCHPATH_SEPARATOR_S ":" G_END_DECLS #endif /* __GLIBCONFIG_H__ */ valgrind/glib.supp 0000644 00000042126 15125157507 0010215 0 ustar 00 # GLib Valgrind suppressions file # # This provides a list of suppressions for all of GLib (including GIO), for all # Valgrind tools (memcheck, drd, helgrind, etc.) for the false positives and # deliberate one-time leaks which GLib causes to be reported when running under # Valgrind. # # When running an application which links to GLib under Valgrind, you can pass # this suppression file to Valgrind using --suppressions=/path/to/glib-2.0.supp. # # http://valgrind.org/docs/manual/manual-core.html#manual-core.suppress # # Note that there is currently no way for Valgrind to load this automatically # (https://bugs.kde.org/show_bug.cgi?id=160905), so the best GLib can currently # do is to install this file as part of its development package. # # This file should be updated if GLib introduces a new deliberate one-time leak, # or another false race positive in Valgrind: please file bugs at: # # https://gitlab.gnome.org/GNOME/glib/issues/new { gnutls-init-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:gtls_gnutls_init } { gnutls-init-realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:gtls_gnutls_init } { g-tls-backend-gnutls-init Memcheck:Leak match-leak-kinds:reachable fun:g_once_impl fun:g_tls_backend_gnutls_init } { p11-tokens-init Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:create_tokens_inlock fun:initialize_module_inlock_reentrant } # One-time allocation from libc for getpwnam() results { g-local-vfs-getpwnam Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:getpwnam fun:g_local_vfs_parse_name } { glib-init-malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_quark_init } { glib-init-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_quark_init } { gobject-init-malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:gobject_init* } { gobject-init-realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:gobject_init* } { gobject-init-calloc Memcheck:Leak match-leak-kinds:possible,reachable fun:calloc ... fun:gobject_init* } { g-type-register-dynamic Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_type_register_dynamic } { g-type-register-static Memcheck:Leak match-leak-kinds:possible,reachable fun:malloc ... fun:g_type_register_static } { g-type-register-static-realloc Memcheck:Leak match-leak-kinds:possible,reachable fun:realloc ... fun:g_type_register_static } { g-type-register-static-calloc Memcheck:Leak match-leak-kinds:possible,reachable fun:calloc ... fun:g_type_register_static } { g-type-register-fundamental Memcheck:Leak match-leak-kinds:possible,reachable fun:malloc ... fun:g_type_register_fundamental } { g-type-register-fundamental-calloc Memcheck:Leak match-leak-kinds:possible,reachable fun:calloc ... fun:g_type_register_fundamental } { g-type-add-interface-dynamic Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_type_add_interface_dynamic } { g-type-add-interface-static Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_type_add_interface_static } { g-type-add-interface-static-realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:g_type_add_interface_static } { g-type-add-interface-static-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_type_add_interface_static } { g-test-rand-init Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_rand_new_with_seed_array fun:test_run_seed ... fun:g_test_run } { g-rand-init2 Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_rand_new_with_seed_array ... fun:get_global_random } { g-quark-table-new Memcheck:Leak match-leak-kinds:reachable fun:g_hash_table_new ... fun:quark_new } { g-quark-table-resize Memcheck:Leak match-leak-kinds:reachable ... fun:g_hash_table_resize ... fun:quark_new } { g-type-interface-init Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:type_iface_vtable_base_init_Wm } { g-type-class-init-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:type_class_init_Wm } { g-type-class-init Memcheck:Leak match-leak-kinds:reachable fun:g_type_create_instance ... fun:type_class_init_Wm } { g-object-do-class-init-signals Memcheck:Leak match-leak-kinds:reachable ... fun:g_signal_new ... fun:type_class_init_Wm } { g-type-prerequisites Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:type_iface_add_prerequisite_W } { g-type-add-interface-check Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_type_add_interface_check ... fun:type_class_init_Wm } { g-type-add-interface-check-realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:g_type_add_interface_check ... fun:type_class_init_Wm } { g-object-class-install-property Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:validate_and_install_class_property ... fun:type_class_init_Wm } { g-param-spec-pool-new Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_param_spec_pool_new ... fun:type_class_init_Wm } # weak_locations_lock in gobject.c { g-weak-ref-lock Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_rw_lock_get_impl ... fun:g_weak_ref_set } { g-object-base-class-init-construct-pproperties Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_slist_copy fun:g_object_base_class_init fun:type_class_init_Wm } { g-type-class-ref Memcheck:Leak fun:calloc ... fun:type_class_init_Wm ... fun:g_type_class_ref } { g-type-class-ref-inlined Memcheck:Leak fun:calloc ... fun:UnknownInlinedFun ... fun:g_type_class_ref } { g-io-module-default-singleton-malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_type_create_instance ... fun:_g_io_module_get_default } { g-io-module-default-singleton-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_type_create_instance ... fun:_g_io_module_get_default } # This one seems to show up sometimes with g_type_create_instance() at the top # of the stack, as well. { g-io-module-default-singleton Memcheck:Leak match-leak-kinds:reachable fun:g_type_create_instance ... fun:_g_io_module_get_default } { g-io-module-default-singleton-module Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_module_open ... fun:_g_io_module_get_default } { g-io-module-default-singleton-name Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_strdup ... fun:_g_io_module_get_default* } { g-io-module-default-singleton-weak-ref Memcheck:Leak fun:calloc ... fun:_g_io_module_get_default } { g-get-language-names-malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_get_language_names } { g-get-language-names-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_get_language_names } { g-get-language_names-with-category-malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_get_language_names_with_category } { g-get-language_names-with-category-calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_get_language_names_with_category } { g-get-language_names-with-category-realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:g_get_language_names_with_category } { g-static-mutex Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_static_mutex_get_mutex_impl } { g-system-thread-init Memcheck:Leak match-leak-kinds:possible,reachable fun:calloc ... fun:g_system_thread_new } { g-system-thread-init-malloc Memcheck:Leak match-leak-kinds:possible,reachable fun:malloc ... fun:g_system_thread_new } { g-task-thread-pool-init Memcheck:Leak match-leak-kinds:possible,reachable,definite fun:malloc ... fun:g_thread_new ... fun:g_task_thread_pool_init } { g-io-module-default-proxy-resolver-gnome Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_proxy_resolver_gnome_init ... fun:_g_io_module_get_default } # One-time getaddrinfo() configuration loading { g-threaded-resolver-getaddrinfo-config Memcheck:Leak match-leak-kinds:reachable,definite fun:malloc ... fun:__resolv_conf_allocate ... fun:getaddrinfo fun:do_lookup_by_name } # memcheck checks that the third argument to ioctl() is a valid pointer, but # some ioctls use that argument as an integer { ioctl-with-non-pointer-param Memcheck:Param ioctl(generic) fun:ioctl fun:btrfs_reflink_with_progress } { g-private-get drd:ConflictingAccess fun:g_private_get } { g-private-get-helgrind Helgrind:Race fun:g_private_get } { g-private-set drd:ConflictingAccess fun:g_private_set } { g-private-set-helgrind Helgrind:Race fun:g_private_set } { g-type-construct-free drd:ConflictingAccess fun:g_type_free_instance } { g-type-construct-free-helgrind Helgrind:Race fun:g_type_free_instance } { g-variant-unref drd:ConflictingAccess fun:g_variant_unref } { g-variant-unref-helgrind Helgrind:Race fun:g_variant_unref } { g-unix-signals-main drd:ConflictingAccess fun:_g_main_create_unix_signal_watch } { g-unix-signals-dispatch drd:ConflictingAccess ... fun:dispatch_unix_signals* } { g-unix-signals-dispatch-helgrind Helgrind:Race ... fun:dispatch_unix_signals* } { g-unix-signals-other drd:ConflictingAccess fun:g_unix_signal_watch* } { g-unix-signals-other-helgrind Helgrind:Race fun:g_unix_signal_watch* } { g-unix-signals-handler drd:ConflictingAccess fun:g_unix_signal_handler* } { g-unix-signals-handler-helgrind Helgrind:Race fun:g_unix_signal_handler* } { g-unix-signals-worker drd:ConflictingAccess fun:glib_worker_main } { g-unix-signals-worker-helgrind Helgrind:Race fun:glib_worker_main } { g-wakeup-acknowledge drd:ConflictingAccess fun:read fun:g_wakeup_acknowledge } { g-type-fundamental drd:ConflictingAccess fun:g_type_fundamental } { g-type-fundamental-helgrind Helgrind:Race fun:g_type_fundamental } { g-type-class-peek-static drd:ConflictingAccess fun:g_type_class_peek_static } { g-type-class-peek-static-helgrind Helgrind:Race fun:g_type_class_peek_static } { g-type-is-a drd:ConflictingAccess ... fun:g_type_is_a } { g-type-is-a-helgrind Helgrind:Race ... fun:g_type_is_a } { g-inet-address-get-type drd:ConflictingAccess fun:g_inet_address_get_type } { g-inet-address-get-type-helgrind Helgrind:Race fun:g_inet_address_get_type } # From: https://github.com/fredericgermain/valgrind/blob/master/glibc-2.X-drd.supp { drd-libc-stdio drd:ConflictingAccess obj:*/lib*/libc-* } { drd-libc-recv drd:ConflictingAccess fun:recv } { drd-libc-send drd:ConflictingAccess fun:send } # GSources do an opportunistic ref count check { g-source-set-ready-time drd:ConflictingAccess fun:g_source_set_ready_time } { g-source-set-ready-time-helgrind Helgrind:Race fun:g_source_set_ready_time } { g-source-iter-next Helgrind:Race fun:g_source_iter_next fun:g_main_context_* fun:g_main_context_iterate } { g-object-instance-private drd:ConflictingAccess fun:*_get_instance_private } { g-object-instance-private-helgrind Helgrind:Race fun:*_get_instance_private } # GLib legitimately calls pthread_cond_signal without a mutex held { g-task-thread-complete drd:CondErr ... fun:g_cond_signal fun:g_task_thread_complete } { g-task-thread-complete Helgrind:Misc ... fun:g_cond_signal fun:g_task_thread_complete } # False positive, but I can't explain how (FIXME) { g-task-cond Helgrind:Misc ... fun:g_cond_clear fun:g_task_finalize } # Real race, but is_cancelled() is an opportunistic function anyway { g-cancellable-is-cancelled Helgrind:Race fun:g_cancellable_is_cancelled } # False positive { g-main-context-cond Helgrind:Misc ... fun:g_cond_clear fun:g_main_context_unref } # False positives { g-source-unlocked Helgrind:Race fun:g_source_*_unlocked } { g-source-internal Helgrind:Race fun:g_source_*_internal } # False positive { g_object_real_dispose Helgrind:Race fun:g_object_real_dispose } # False positive { g_object_new_valist Helgrind:Race ... fun:g_object_new_valist } # g_set_user_dirs() deliberately leaks the previous cached g_get_user_*() values. # These will not all be reachable on exit. { g_set_user_dirs_str Memcheck:Leak match-leak-kinds:definite,reachable fun:malloc ... fun:set_str_if_different fun:g_set_user_dirs } # g_set_user_dirs() deliberately leaks the previous cached g_get_user_*() values. # These will not all be reachable on exit. { g_set_user_dirs_strv Memcheck:Leak match-leak-kinds:definite,reachable fun:malloc ... fun:set_strv_if_different fun:g_set_user_dirs } # g_get_system_data_dirs() caches a one-time allocation { g_get_system_data_dirs Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_build_system_data_dirs fun:g_get_system_data_dirs } # g_get_user_data_dir() caches a one-time allocation { g_get_user_data_dir Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:g_build_user_data_dir fun:g_get_user_data_dir } # gdesktopappinfo.c caches a one-time allocation global table of @desktop_file_dirs. { desktop_file_dirs_malloc Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:desktop_file_dirs_lock } # gdesktopappinfo.c caches a one-time allocation global table of @desktop_file_dirs. { desktop_file_dirs_realloc Memcheck:Leak match-leak-kinds:reachable fun:realloc ... fun:desktop_file_dirs_lock } # gdesktopappinfo.c caches a one-time allocation global table of @desktop_file_dirs. { desktop_file_dir_unindexed_setup_search Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:desktop_file_dir_unindexed_setup_search fun:desktop_file_dir_unindexed_setup_search } # g_io_extension_point_register() caches a one-time allocation global table of @extension_points. { g_io_extension_point_register Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_io_extension_point_register } # g_strerror() caches a one-time allocation global table of @errors. { g_strerror Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_locale_to_utf8 fun:g_strerror } # g_socket_connection_factory_register_type() caches a one-time allocation global table of @connection_types. { g_socket_connection_factory_register_type Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_socket_connection_factory_register_type } # g_dbus_error_quark() never unregisters itself as a GDBusError domain, as it’s always available { g_dbus_error_quark Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_dbus_error_register_error_domain fun:g_dbus_error_quark } # g_win32_registry_get_os_dirs_w*() caches an array of strings that is allocated only once. { g_win32_registry_get_os_dirs Memcheck:Leak match-leak-kinds:reachable,definite fun:malloc ... fun:g_win32_registry_get_os_dirs* } # Thread-private data allocated once per thread { g_private_set_alloc0 Memcheck:Leak match-leak-kinds:definite,reachable fun:malloc ... fun:g_private_set_alloc0 } { g_private_set_alloc0-calloc Memcheck:Leak match-leak-kinds:definite,reachable fun:calloc ... fun:g_private_set_alloc0 } # Keys for thread-private data { g_private_key Memcheck:Leak match-leak-kinds:reachable fun:malloc fun:g_private_impl_new } # Thread-private GMainContext stack { g_main_context_push_thread_default Memcheck:Leak match-leak-kinds:definite,reachable fun:malloc ... fun:g_queue_new fun:g_main_context_push_thread_default } # One-time allocations for #GFileInfo attribute cache { g_file_info_attribute_cache Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:ensure_attribute_hash ... fun:g_file_* } { g_file_info_attribute_cache2 Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:ensure_attribute_hash ... fun:g_file_* } { g_file_info_attribute_cache3 Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:lookup_namespace ... fun:g_file_* } { g_file_info_attribute_cache4 Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:lookup_namespace ... fun:g_file_* } # Cached charset { g_get_charset Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_get_charset } { g_get_charset_calloc Memcheck:Leak match-leak-kinds:reachable fun:calloc ... fun:g_get_charset } # Global unused thread queue { g_thread_pool_unused_thread_queue Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_async_queue_new_full ... fun:g_thread_pool_new } # One-time program name storage { g_set_prgname Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_set_prgname } # Error domains hash { g_error_init Memcheck:Leak match-leak-kinds: reachable fun:malloc ... fun:g_hash_table_new_full fun:g_error_init } # Error domain static registration { g_error_domain_register_static Memcheck:Leak match-leak-kinds: reachable fun:malloc ... fun:g_hash_table_insert fun:error_domain_register fun:g_error_domain_register_static } { new_quark Memcheck:Leak match-leak-kinds:reachable fun:malloc ... fun:g_hash_table_insert fun:quark_new } gdb/__pycache__/glib_gdb.cpython-39.opt-1.pyc 0000644 00000021572 15125157507 0014650 0 ustar 00 a ]x a� � @ s� d dl Z d dlZejd dkr"eZdd� Zdd� ZG dd� d�ZG d d � d �ZG d d � d �Z G d d� d�Z dd� Z dd� Z G dd� de j �Ze� dS )� N� c C s t �� �| �S �N)�gdbZselected_frameZread_var)Zsymname� r �#/usr/share/glib-2.0/gdb/glib_gdb.py�read_global_var s r c C s� | d u r d S t | �} | dkr d S ztd�}t td��}W nB tyz ztd�}t td��}W n tyt Y Y d S 0 Y n0 | |k r�|| �� S d S )Nr ZquarksZ quark_seq_idZg_quarksZg_quark_seq_id)�longr � Exception�string)Zquark�valZmax_qr r r �g_quark_to_string s" r c @ s e Zd ZdZdd� Zdd� ZdS )�GListNodePrinterzPrints a GList nodec C s || _ d S r �r ��selfr r r r �__init__% s zGListNodePrinter.__init__c C s, dt | jd �t| jd �t| jd �f S )Nz {data=%s, next=0x%x, prev=0x%x}�data�next�prev��strr r �r r r r � to_string( s �zGListNodePrinter.to_stringN��__name__� __module__� __qualname__�__doc__r r r r r r r " s r c @ s e Zd ZdZdd� Zdd� ZdS )�GSListNodePrinterzPrints a GSList nodec C s || _ d S r r r r r r r 3 s zGSListNodePrinter.__init__c C s dt | jd �t| jd �f S )Nz{data=%s, next=0x%x}r r r r r r r r 6 s zGSListNodePrinter.to_stringNr r r r r r 0 s r c @ s> e Zd ZdZG dd� d�Zdd� Zdd� Zdd � Zd d � Zd S ) � GListPrinterzPrints a GListc @ s( e Zd Zdd� Zdd� Zdd� ZeZdS )zGListPrinter._iteratorc C s || _ || _d| _d S )Nr )�link�listtype�count)r �headr! r r r r > s z GListPrinter._iterator.__init__c C s | S r r r r r r �__iter__C s z GListPrinter._iterator.__iter__c C sB | j dkrt�| j d }| j d | _ | j}| jd | _d| |fS )Nr r r � z[%d])r � StopIterationr" )r r r" r r r r F s zGListPrinter._iterator.nextN)r r r r r$ r �__next__r r r r � _iterator= s r( c C s || _ || _d S r )r r! )r r r! r r r r Q s zGListPrinter.__init__c C s | � | j| j�S r )r( r r! r r r r �childrenU s zGListPrinter.childrenc C s dt | j� S �Nz0x%x�r r r r r r r X s zGListPrinter.to_stringc C s dS )NZarrayr r r r r � display_hint[ s zGListPrinter.display_hintN� r r r r r( r r) r r, r r r r r : s r c @ s> e Zd ZdZG dd� d�Zdd� Zdd� Zdd � Zd d � Zd S ) � GHashPrinterzPrints a GHashTablec @ s6 e Zd ZG dd� d�Zdd� Zdd� Zdd� ZeZd S ) zGHashPrinter._iteratorc @ s e Zd Zdd� Zdd� ZdS )z%GHashPrinter._iterator._pointer_arrayc C s< || _ t�d�| _| j r | jnt�d�}|�|�� �| _d S )NZgpointerZguint)� _big_itemsr � lookup_type�_gpointer_type�cast�pointer�_items)r ZptrZ big_itemsZ item_typer r r r d s �z.GHashPrinter._iterator._pointer_array.__init__c C s | j | }| js |�| j�}|S r )r4 r/ r2 r1 )r �itemr r r � __getitem__m s z1GHashPrinter._iterator._pointer_array.__getitem__N)r r r r r6 r r r r �_pointer_arrayc s r7 c C sd || _ |dkrN| �|d |d �| _| �|d |d �| _|d | _|d | _d| _|| _d | _d S )Nr �keysZ have_big_keys�valuesZhave_big_values�hashes�size) �htr7 r8 r9 r: r; �pos�keys_are_strings�value)r r< r> r r r r u s z GHashPrinter._iterator.__init__c C s | S r r r r r r r$ � s z GHashPrinter._iterator.__iter__c C s� | j dkrt�| jd ur(| j}d | _|S t| j�t| j�k r�t| j| j �dkr�| j| j }| j| j }| j r�|� t � d�� � �}d| j |f| _d| j |f}| jd7 _|S | jd7 _q(t�d S )Nr � �charz[%dv]z[%dk]r% )r< r& r? r r= r; r: r8 r9 r> r2 r r0 r3 )r �v�keyr r r r r � s$ zGHashPrinter._iterator.nextN)r r r r7 r r$ r r' r r r r r( b s r( c C sZ || _ d| _z td�}W n ty. d }Y n0 | j dkrV|d urV| j d |krVd| _d S )NFZ g_str_hashr Z hash_funcT)r r> r r )r r Z string_hashr r r r � s �� �zGHashPrinter.__init__c C s | � | j| j�S r )r( r r> r r r r r) � s zGHashPrinter.childrenc C s dt | j� S r* r+ r r r r r � s zGHashPrinter.to_stringc C s dS )N�mapr r r r r r, � s zGHashPrinter.display_hintNr- r r r r r. _ s =r. c C s� | j �� }|jtjkr |�� }|jtjkrt|�� �� }t|�}|dkrPt| d�S |dkrbt| d�S |dkr�t | �S n*t|�}|dkr�t | �S |dkr�t| d�S d S )N�GList�GSListZ GHashTablezGSList *) �type� unqualified�coder Z TYPE_CODE_REF�target� TYPE_CODE_PTRr r r. r )r rG �tr r r �pretty_printer_lookup� s$ rM c C s | d u r t } | j�t� d S r )r Zpretty_printers�appendrM )�objr r r �register� s rP c sX e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z � Z S )�ForeachCommandzForeach on listc s t t| ��dtjtj� d S )NZgforeach)�superrQ r r Z COMMAND_DATAZCOMPLETE_SYMBOLr �� __class__r r r � s �zForeachCommand.__init__c C s |d � � sdS dS )Nr FT)�isalpha)r �namer r r � valid_name� s zForeachCommand.valid_namec C s |� d�}|dkrtd��|d |� }| �|�s8td��|t|�k rZ|| �� rZ|d }q8|||d � dkrvtd��|d }|t|�k r�|| �� r�|d }q~|� d |�}|d kr�td ��|||� }|d }|t|�k r�|| �� r�|d }q�||d � }|||fS ) N� r zNo var specifiedzInvalid variable namer% r@ �inzInvalid syntax, missing in�:���z Invalid syntax, missing colon)�findr rW �len�isspace)r �arg�i�var�colonr �commandr r r � parse_args� s, zForeachCommand.parse_argsc C s@ |� t�d��� �}t|�}d||f }t�|� t�|� d S )NZvoidzset $%s = (void *)0x%x )r2 r r0 r3 r Zexecute)r r_ r5 rc Zto_evalr r r �do_iter s zForeachCommand.do_iterc C s@ |� t�d��� �}t|�dkr<| �||d |� |d }qd S )NrF r r r �r2 r r0 r3 r re �r r_ � containerrc Z list_elementr r r �slist_iterator s z ForeachCommand.slist_iteratorc C s@ |� t�d��� �}t|�dkr<| �||d |� |d }qd S )NrE r r r rf rg r r r � list_iterator s z ForeachCommand.list_iteratorc C s\ |j �� }|jtjkrF|�� �� }t|�}|dkr8| jS |dkrF| jS t dt|j � ��d S )NrF rE zInvalid container type %s) rG rH rI r rK rJ r ri rj r )r rh rL r r r � pick_iterator s z ForeachCommand.pick_iteratorc C s4 | � |�\}}}t�|�}| �|�}||||� d S r )rd r Zparse_and_evalrk )r r_ Zfrom_ttyra rh rc �funcr r r �invoke% s zForeachCommand.invoke) r r r r r rW rd re ri rj rk rm � __classcell__r r rS r rQ � s ! rQ )r �sys� version_info�intr r r r r r r. rM rP ZCommandrQ r r r r �<module> s %XS gdb/__pycache__/gobject_gdb.cpython-39.opt-1.pyc 0000644 00000022522 15125157507 0015344 0 ustar 00 a ]x a|' � @ s d dl Z d dlZd dlZejd dkr,eZnd dlZejZzd dl Z dZ e j j Z W n e yh dZ Y n0 dd� Z dd� Zd d � Zd d � Zd d� ZG dd� d�Zdd� ZG dd� d�Zdd� Zdd� Zdd� Zdd � ZG d d � d e �ZG d d � d �ZG d!d"� d"e�Z d#d$� Z dS )%� N� TFc C s t �� �| �S �N)�gdbZselected_frame�read_var)Zsymname� r �&/usr/share/glib-2.0/gdb/gobject_gdb.py�read_global_var s r c C sL dd� }t | �} | | d }|dkr@t�|��t�d��� �}n||�}|S )Nc S s. | dkr d S t d�}|d u r d S || d? jS )Nr Z static_fundamental_type_nodes� )r �address)�typenode�valr r r �lookup_fundamental_type s z3g_type_to_typenode.<locals>.lookup_fundamental_type� i� ZTypeNode)�longr ZValue�cast� lookup_type�pointer)�gtyper r r r r �g_type_to_typenode s r c C s" t | �}|d ur t�|d �S d S )N�qname)r �glib_gdb�g_quark_to_string)r r r r r �g_type_to_name- s r c s2 � fdd�� | j }|jtjkr"dS |�� }� |�S )Nc s` t | �dkrdS | jtjkr&| �� } q| jtjkr6dS | �� }t|�dk rNdS |d }� |j�S )N� GTypeInstanceTF� r ) �str�coder ZTYPE_CODE_TYPEDEF�targetZTYPE_CODE_STRUCT�fields�len�type)r r Z first_field��is_g_type_instance_helperr r r" 5 s z5is_g_type_instance.<locals>.is_g_type_instance_helperF)r r r � TYPE_CODE_PTRr �r r r r! r �is_g_type_instance4 s r% c C sV t | �dkrRz2| �t�d��� �}|d }|d }t|�}|W S tyP Y n0 d S )Nr r Zg_class�g_type)r r r r r r � RuntimeError)�instance�inst�klassr �namer r r �g_type_name_from_instanceM s r, c @ s e Zd ZdZdd� Zdd� ZdS )�GTypePrettyPrinterz Prints a GType instance pointerc C s || _ d S r �r )�selfr r r r �__init__] s zGTypePrettyPrinter.__init__c C s. t | j�}|r dt| j�|f S dt| j� S )Nz 0x%x [%s]�0x%x)r, r r )r/ r+ r r r � to_string` s z GTypePrettyPrinter.to_stringN��__name__� __module__� __qualname__�__doc__r0 r2 r r r r r- Z s r- c C s& | j }|jtjkrdS t|�� �dkS )NFZ GTypeClass)r r r r# r r r$ r r r �is_g_type_class_instanceg s r8 c @ s" e Zd ZdZddd�Zdd� ZdS ) �GTypeHandlePrettyPrinterzPrints a GType instance� c C s || _ || _d S r )r �hint)r/ r r; r r r r0 q s z!GTypeHandlePrettyPrinter.__init__c C s� t | j�}|d ur�t�|d �}dt| j�| j|f }tdt|d ��D ]8}t |d | �}|rpt�|d �}nd}|d| 7 }qH|d S d t| j� S d S ) Nr z 0x%x [%s%sr Zn_supersZsupers�???�/�]r1 )r r r r r r; �range�int)r/ r r+ �s�i�noder r r r2 u s z"GTypeHandlePrettyPrinter.to_stringN)r: r3 r r r r r9 n s r9 c C s@ t | �rt| �S t| j�dkr&t| �S t| �r<t| d d�S d S )NZGTyper& zg_type: )r% r- r r r9 r8 r. r r r �pretty_printer_lookup� s rD c C sT | d u r d S t | �} | dkr d S td�}td�}t |�}| |k rP|| d �� S d S )Nr Zg_signal_nodesZg_n_signal_nodesr+ )r r �string)�idr Zmax_sr r r �get_signal_name� s rG c C s t | �� �S r )r �function)�framer r r � frame_name� s rJ c C s | � � �|�S r )Zinferior_framer )rI �varr r r � frame_var� s rL c @ s` e Zd Zdd� Zdd� Zddd�Zddd �Zd d � Zd d � Zdd� Z dd� Z dd� Z dd� Z dS )� SignalFramec C s$ t �| |d � |d | _|| _d S )N���)�FrameDecoratorr0 rI �frames)r/ rP r r r r0 � s zSignalFrame.__init__c C s dS )Nzsignal-emissionr �r/ r r r r+ � s zSignalFrame.nameNc C sP z6t ||�}|d u s|jr W d S |d ur2|�|� |W S tyJ Y d S 0 d S r )rL �is_optimized_out�append� ValueError�r/ rI r+ �array�vr r r r � s zSignalFrame.read_varc C sz z`t ||�}|d u s|jr W d S |�t�d��� �}|d ur\t|�r\|d urV|�|� |W S W d S tyt Y d S 0 d S )N�GObject) rL rR r r r r r, rS rT rU r r r � read_object� s zSignalFrame.read_objectc C s |d ur|� |� d S r )rS )r/ rV �objr r r rS � s zSignalFrame.appendc C s( t |�dkrdS d�ttt|���S d S )Nr r< z or )r �join�set�mapr )r/ rV r r r � or_join_array� s zSignalFrame.or_join_arrayc C s2 | � |d�}t�|�}|d ur*|d | S |S d S )N�detail�:)r r r )r/ rI �signalr_ r r r � get_detailed_signal_from_frame� s z*SignalFrame.get_detailed_signal_from_framec C st g }g }| j D �]B}t|�}|dkrf| �|d|� | �|d�}|rf|d �� }| �||�}| �||� |dkr�| �|d�}|r�|d d �t� d �� � �}| �||� | �|d �} t | �}|r�| �||�}| �||� |d ks�|d k�r(| �|d|� | �|d �} t | �}|�r(| �||�}| �||� |d kr| �|d|� | �|d|� �qTq| � |�}| � |�}d||f S )N�signal_emit_unlocked_Rr( rC r+ �g_signal_emitv�instance_and_paramsr Z v_pointerrX Z signal_id�g_signal_emit_valist� g_signal_emit�g_signal_emit_by_nameZdetailed_signalz <emit signal %s on instance %s>) rP rJ rY r rE rb rS r r �Typer rG r^ ) r/ Z instancesZsignalsrI r+ rC ra re r( rF r r r rH � sJ � zSignalFrame.functionc C s | j dd� S )Nr rN )rP rQ r r r �elided s zSignalFrame.elidedc C s |� d| �� d � d S )N� � )�writerH )r/ �streamZfullr r r �describe s zSignalFrame.describe)N)N) r4 r5 r6 r0 r+ r rY rS r^ rb rH rj ro r r r r rM � s -rM c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�GFrameDecoratorc C s g | _ || _d S r )�queue�iter)r/ rr r r r r0 s zGFrameDecorator.__init__c C s | S r r rQ r r r �__iter__ s zGFrameDecorator.__iter__c C sD t | j�dkr@zt| j�}| j�|� W q ty< Y d S 0 q d S )N� )r rq �nextrr rS � StopIteration)r/ �fr r r �fill s zGFrameDecorator.fillc C s8 t tt| j�d��D ] }t| j| �dkr| S qdS )Nr rc rN )r? �minr rq rJ )r/ rB r r r �find_signal_emission s z$GFrameDecorator.find_signal_emissionc C s� | � � t| j�dkrt�| �� }|dkr�|}|dkr8qnt| j|d �}|�d�dks`|dkrn|d }q.qnq.|d }|t| j�k r�t| j| �dv r�|d }qvq�qv| j||� }t|�g}|| j||�< | j�d�S )Nr r Z _marshal_Zg_closure_invoke)rd rf rg rh Z_g_closure_invoke_va) rx r rq rv rz rJ �findrM �pop)r/ Zemission�startZ prev_name�endZ signal_framesZ new_framesr r r ru & s* zGFrameDecorator.nextc C s | � � S r )ru rQ r r r �__next__L s zGFrameDecorator.__next__N) r4 r5 r6 r0 rs rx rz ru r r r r r rp s &rp c @ s e Zd ZdZdZdZdd� ZdS )� GFrameFilterZglibT�d c C s t |�S r )rp )r/ �iteratorr r r �filterU s zGFrameFilter.filterN)r4 r5 r6 r+ Zenabled�priorityr� r r r r r� P s r� c C s2 | d u r t } tr"t� }|| j|j< | j�t� d S r )r �HAVE_GDB_FRAMEDECORATORr� Z frame_filtersr+ Zpretty_printersrS rD )rZ r� r r r �registerY s r� ) r r �sys� version_infor@ r � itertools�imapr] Zgdb.FrameDecoratorr� rO � ImportErrorr r r r% r, r- r8 r9 rD rG rJ rL rM rp �objectr� r� r r r r �<module> s8 i@ gdb/__pycache__/glib_gdb.cpython-39.pyc 0000644 00000021572 15125157507 0013711 0 ustar 00 a ]x a� � @ s� d dl Z d dlZejd dkr"eZdd� Zdd� ZG dd� d�ZG d d � d �ZG d d � d �Z G d d� d�Z dd� Z dd� Z G dd� de j �Ze� dS )� N� c C s t �� �| �S �N)�gdbZselected_frameZread_var)Zsymname� r �#/usr/share/glib-2.0/gdb/glib_gdb.py�read_global_var s r c C s� | d u r d S t | �} | dkr d S ztd�}t td��}W nB tyz ztd�}t td��}W n tyt Y Y d S 0 Y n0 | |k r�|| �� S d S )Nr ZquarksZ quark_seq_idZg_quarksZg_quark_seq_id)�longr � Exception�string)Zquark�valZmax_qr r r �g_quark_to_string s" r c @ s e Zd ZdZdd� Zdd� ZdS )�GListNodePrinterzPrints a GList nodec C s || _ d S r �r ��selfr r r r �__init__% s zGListNodePrinter.__init__c C s, dt | jd �t| jd �t| jd �f S )Nz {data=%s, next=0x%x, prev=0x%x}�data�next�prev��strr r �r r r r � to_string( s �zGListNodePrinter.to_stringN��__name__� __module__� __qualname__�__doc__r r r r r r r " s r c @ s e Zd ZdZdd� Zdd� ZdS )�GSListNodePrinterzPrints a GSList nodec C s || _ d S r r r r r r r 3 s zGSListNodePrinter.__init__c C s dt | jd �t| jd �f S )Nz{data=%s, next=0x%x}r r r r r r r r 6 s zGSListNodePrinter.to_stringNr r r r r r 0 s r c @ s> e Zd ZdZG dd� d�Zdd� Zdd� Zdd � Zd d � Zd S ) � GListPrinterzPrints a GListc @ s( e Zd Zdd� Zdd� Zdd� ZeZdS )zGListPrinter._iteratorc C s || _ || _d| _d S )Nr )�link�listtype�count)r �headr! r r r r > s z GListPrinter._iterator.__init__c C s | S r r r r r r �__iter__C s z GListPrinter._iterator.__iter__c C sB | j dkrt�| j d }| j d | _ | j}| jd | _d| |fS )Nr r r � z[%d])r � StopIterationr" )r r r" r r r r F s zGListPrinter._iterator.nextN)r r r r r$ r �__next__r r r r � _iterator= s r( c C s || _ || _d S r )r r! )r r r! r r r r Q s zGListPrinter.__init__c C s | � | j| j�S r )r( r r! r r r r �childrenU s zGListPrinter.childrenc C s dt | j� S �Nz0x%x�r r r r r r r X s zGListPrinter.to_stringc C s dS )NZarrayr r r r r � display_hint[ s zGListPrinter.display_hintN� r r r r r( r r) r r, r r r r r : s r c @ s> e Zd ZdZG dd� d�Zdd� Zdd� Zdd � Zd d � Zd S ) � GHashPrinterzPrints a GHashTablec @ s6 e Zd ZG dd� d�Zdd� Zdd� Zdd� ZeZd S ) zGHashPrinter._iteratorc @ s e Zd Zdd� Zdd� ZdS )z%GHashPrinter._iterator._pointer_arrayc C s< || _ t�d�| _| j r | jnt�d�}|�|�� �| _d S )NZgpointerZguint)� _big_itemsr � lookup_type�_gpointer_type�cast�pointer�_items)r ZptrZ big_itemsZ item_typer r r r d s �z.GHashPrinter._iterator._pointer_array.__init__c C s | j | }| js |�| j�}|S r )r4 r/ r2 r1 )r �itemr r r � __getitem__m s z1GHashPrinter._iterator._pointer_array.__getitem__N)r r r r r6 r r r r �_pointer_arrayc s r7 c C sd || _ |dkrN| �|d |d �| _| �|d |d �| _|d | _|d | _d| _|| _d | _d S )Nr �keysZ have_big_keys�valuesZhave_big_values�hashes�size) �htr7 r8 r9 r: r; �pos�keys_are_strings�value)r r< r> r r r r u s z GHashPrinter._iterator.__init__c C s | S r r r r r r r$ � s z GHashPrinter._iterator.__iter__c C s� | j dkrt�| jd ur(| j}d | _|S t| j�t| j�k r�t| j| j �dkr�| j| j }| j| j }| j r�|� t � d�� � �}d| j |f| _d| j |f}| jd7 _|S | jd7 _q(t�d S )Nr � �charz[%dv]z[%dk]r% )r< r& r? r r= r; r: r8 r9 r> r2 r r0 r3 )r �v�keyr r r r r � s$ zGHashPrinter._iterator.nextN)r r r r7 r r$ r r' r r r r r( b s r( c C sZ || _ d| _z td�}W n ty. d }Y n0 | j dkrV|d urV| j d |krVd| _d S )NFZ g_str_hashr Z hash_funcT)r r> r r )r r Z string_hashr r r r � s �� �zGHashPrinter.__init__c C s | � | j| j�S r )r( r r> r r r r r) � s zGHashPrinter.childrenc C s dt | j� S r* r+ r r r r r � s zGHashPrinter.to_stringc C s dS )N�mapr r r r r r, � s zGHashPrinter.display_hintNr- r r r r r. _ s =r. c C s� | j �� }|jtjkr |�� }|jtjkrt|�� �� }t|�}|dkrPt| d�S |dkrbt| d�S |dkr�t | �S n*t|�}|dkr�t | �S |dkr�t| d�S d S )N�GList�GSListZ GHashTablezGSList *) �type� unqualified�coder Z TYPE_CODE_REF�target� TYPE_CODE_PTRr r r. r )r rG �tr r r �pretty_printer_lookup� s$ rM c C s | d u r t } | j�t� d S r )r Zpretty_printers�appendrM )�objr r r �register� s rP c sX e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z � Z S )�ForeachCommandzForeach on listc s t t| ��dtjtj� d S )NZgforeach)�superrQ r r Z COMMAND_DATAZCOMPLETE_SYMBOLr �� __class__r r r � s �zForeachCommand.__init__c C s |d � � sdS dS )Nr FT)�isalpha)r �namer r r � valid_name� s zForeachCommand.valid_namec C s |� d�}|dkrtd��|d |� }| �|�s8td��|t|�k rZ|| �� rZ|d }q8|||d � dkrvtd��|d }|t|�k r�|| �� r�|d }q~|� d |�}|d kr�td ��|||� }|d }|t|�k r�|| �� r�|d }q�||d � }|||fS ) N� r zNo var specifiedzInvalid variable namer% r@ �inzInvalid syntax, missing in�:���z Invalid syntax, missing colon)�findr rW �len�isspace)r �arg�i�var�colonr �commandr r r � parse_args� s, zForeachCommand.parse_argsc C s@ |� t�d��� �}t|�}d||f }t�|� t�|� d S )NZvoidzset $%s = (void *)0x%x )r2 r r0 r3 r Zexecute)r r_ r5 rc Zto_evalr r r �do_iter s zForeachCommand.do_iterc C s@ |� t�d��� �}t|�dkr<| �||d |� |d }qd S )NrF r r r �r2 r r0 r3 r re �r r_ � containerrc Z list_elementr r r �slist_iterator s z ForeachCommand.slist_iteratorc C s@ |� t�d��� �}t|�dkr<| �||d |� |d }qd S )NrE r r r rf rg r r r � list_iterator s z ForeachCommand.list_iteratorc C s\ |j �� }|jtjkrF|�� �� }t|�}|dkr8| jS |dkrF| jS t dt|j � ��d S )NrF rE zInvalid container type %s) rG rH rI r rK rJ r ri rj r )r rh rL r r r � pick_iterator s z ForeachCommand.pick_iteratorc C s4 | � |�\}}}t�|�}| �|�}||||� d S r )rd r Zparse_and_evalrk )r r_ Zfrom_ttyra rh rc �funcr r r �invoke% s zForeachCommand.invoke) r r r r r rW rd re ri rj rk rm � __classcell__r r rS r rQ � s ! rQ )r �sys� version_info�intr r r r r r r. rM rP ZCommandrQ r r r r �<module> s %XS gdb/__pycache__/gobject_gdb.cpython-39.pyc 0000644 00000022522 15125157507 0014405 0 ustar 00 a ]x a|' � @ s d dl Z d dlZd dlZejd dkr,eZnd dlZejZzd dl Z dZ e j j Z W n e yh dZ Y n0 dd� Z dd� Zd d � Zd d � Zd d� ZG dd� d�Zdd� ZG dd� d�Zdd� Zdd� Zdd� Zdd � ZG d d � d e �ZG d d � d �ZG d!d"� d"e�Z d#d$� Z dS )%� N� TFc C s t �� �| �S �N)�gdbZselected_frame�read_var)Zsymname� r �&/usr/share/glib-2.0/gdb/gobject_gdb.py�read_global_var s r c C sL dd� }t | �} | | d }|dkr@t�|��t�d��� �}n||�}|S )Nc S s. | dkr d S t d�}|d u r d S || d? jS )Nr Z static_fundamental_type_nodes� )r �address)�typenode�valr r r �lookup_fundamental_type s z3g_type_to_typenode.<locals>.lookup_fundamental_type� i� ZTypeNode)�longr ZValue�cast� lookup_type�pointer)�gtyper r r r r �g_type_to_typenode s r c C s" t | �}|d ur t�|d �S d S )N�qname)r �glib_gdb�g_quark_to_string)r r r r r �g_type_to_name- s r c s2 � fdd�� | j }|jtjkr"dS |�� }� |�S )Nc s` t | �dkrdS | jtjkr&| �� } q| jtjkr6dS | �� }t|�dk rNdS |d }� |j�S )N� GTypeInstanceTF� r ) �str�coder ZTYPE_CODE_TYPEDEF�targetZTYPE_CODE_STRUCT�fields�len�type)r r Z first_field��is_g_type_instance_helperr r r" 5 s z5is_g_type_instance.<locals>.is_g_type_instance_helperF)r r r � TYPE_CODE_PTRr �r r r r! r �is_g_type_instance4 s r% c C sV t | �dkrRz2| �t�d��� �}|d }|d }t|�}|W S tyP Y n0 d S )Nr r Zg_class�g_type)r r r r r r � RuntimeError)�instance�inst�klassr �namer r r �g_type_name_from_instanceM s r, c @ s e Zd ZdZdd� Zdd� ZdS )�GTypePrettyPrinterz Prints a GType instance pointerc C s || _ d S r �r )�selfr r r r �__init__] s zGTypePrettyPrinter.__init__c C s. t | j�}|r dt| j�|f S dt| j� S )Nz 0x%x [%s]�0x%x)r, r r )r/ r+ r r r � to_string` s z GTypePrettyPrinter.to_stringN��__name__� __module__� __qualname__�__doc__r0 r2 r r r r r- Z s r- c C s& | j }|jtjkrdS t|�� �dkS )NFZ GTypeClass)r r r r# r r r$ r r r �is_g_type_class_instanceg s r8 c @ s" e Zd ZdZddd�Zdd� ZdS ) �GTypeHandlePrettyPrinterzPrints a GType instance� c C s || _ || _d S r )r �hint)r/ r r; r r r r0 q s z!GTypeHandlePrettyPrinter.__init__c C s� t | j�}|d ur�t�|d �}dt| j�| j|f }tdt|d ��D ]8}t |d | �}|rpt�|d �}nd}|d| 7 }qH|d S d t| j� S d S ) Nr z 0x%x [%s%sr Zn_supersZsupers�???�/�]r1 )r r r r r r; �range�int)r/ r r+ �s�i�noder r r r2 u s z"GTypeHandlePrettyPrinter.to_stringN)r: r3 r r r r r9 n s r9 c C s@ t | �rt| �S t| j�dkr&t| �S t| �r<t| d d�S d S )NZGTyper& zg_type: )r% r- r r r9 r8 r. r r r �pretty_printer_lookup� s rD c C sT | d u r d S t | �} | dkr d S td�}td�}t |�}| |k rP|| d �� S d S )Nr Zg_signal_nodesZg_n_signal_nodesr+ )r r �string)�idr Zmax_sr r r �get_signal_name� s rG c C s t | �� �S r )r �function)�framer r r � frame_name� s rJ c C s | � � �|�S r )Zinferior_framer )rI �varr r r � frame_var� s rL c @ s` e Zd Zdd� Zdd� Zddd�Zddd �Zd d � Zd d � Zdd� Z dd� Z dd� Z dd� Z dS )� SignalFramec C s$ t �| |d � |d | _|| _d S )N���)�FrameDecoratorr0 rI �frames)r/ rP r r r r0 � s zSignalFrame.__init__c C s dS )Nzsignal-emissionr �r/ r r r r+ � s zSignalFrame.nameNc C sP z6t ||�}|d u s|jr W d S |d ur2|�|� |W S tyJ Y d S 0 d S r )rL �is_optimized_out�append� ValueError�r/ rI r+ �array�vr r r r � s zSignalFrame.read_varc C sz z`t ||�}|d u s|jr W d S |�t�d��� �}|d ur\t|�r\|d urV|�|� |W S W d S tyt Y d S 0 d S )N�GObject) rL rR r r r r r, rS rT rU r r r � read_object� s zSignalFrame.read_objectc C s |d ur|� |� d S r )rS )r/ rV �objr r r rS � s zSignalFrame.appendc C s( t |�dkrdS d�ttt|���S d S )Nr r< z or )r �join�set�mapr )r/ rV r r r � or_join_array� s zSignalFrame.or_join_arrayc C s2 | � |d�}t�|�}|d ur*|d | S |S d S )N�detail�:)r r r )r/ rI �signalr_ r r r � get_detailed_signal_from_frame� s z*SignalFrame.get_detailed_signal_from_framec C st g }g }| j D �]B}t|�}|dkrf| �|d|� | �|d�}|rf|d �� }| �||�}| �||� |dkr�| �|d�}|r�|d d �t� d �� � �}| �||� | �|d �} t | �}|r�| �||�}| �||� |d ks�|d k�r(| �|d|� | �|d �} t | �}|�r(| �||�}| �||� |d kr| �|d|� | �|d|� �qTq| � |�}| � |�}d||f S )N�signal_emit_unlocked_Rr( rC r+ �g_signal_emitv�instance_and_paramsr Z v_pointerrX Z signal_id�g_signal_emit_valist� g_signal_emit�g_signal_emit_by_nameZdetailed_signalz <emit signal %s on instance %s>) rP rJ rY r rE rb rS r r �Typer rG r^ ) r/ Z instancesZsignalsrI r+ rC ra re r( rF r r r rH � sJ � zSignalFrame.functionc C s | j dd� S )Nr rN )rP rQ r r r �elided s zSignalFrame.elidedc C s |� d| �� d � d S )N� � )�writerH )r/ �streamZfullr r r �describe s zSignalFrame.describe)N)N) r4 r5 r6 r0 r+ r rY rS r^ rb rH rj ro r r r r rM � s -rM c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�GFrameDecoratorc C s g | _ || _d S r )�queue�iter)r/ rr r r r r0 s zGFrameDecorator.__init__c C s | S r r rQ r r r �__iter__ s zGFrameDecorator.__iter__c C sD t | j�dkr@zt| j�}| j�|� W q ty< Y d S 0 q d S )N� )r rq �nextrr rS � StopIteration)r/ �fr r r �fill s zGFrameDecorator.fillc C s8 t tt| j�d��D ] }t| j| �dkr| S qdS )Nr rc rN )r? �minr rq rJ )r/ rB r r r �find_signal_emission s z$GFrameDecorator.find_signal_emissionc C s� | � � t| j�dkrt�| �� }|dkr�|}|dkr8qnt| j|d �}|�d�dks`|dkrn|d }q.qnq.|d }|t| j�k r�t| j| �dv r�|d }qvq�qv| j||� }t|�g}|| j||�< | j�d�S )Nr r Z _marshal_Zg_closure_invoke)rd rf rg rh Z_g_closure_invoke_va) rx r rq rv rz rJ �findrM �pop)r/ Zemission�startZ prev_name�endZ signal_framesZ new_framesr r r ru & s* zGFrameDecorator.nextc C s | � � S r )ru rQ r r r �__next__L s zGFrameDecorator.__next__N) r4 r5 r6 r0 rs rx rz ru r r r r r rp s &rp c @ s e Zd ZdZdZdZdd� ZdS )� GFrameFilterZglibT�d c C s t |�S r )rp )r/ �iteratorr r r �filterU s zGFrameFilter.filterN)r4 r5 r6 r+ Zenabled�priorityr� r r r r r� P s r� c C s2 | d u r t } tr"t� }|| j|j< | j�t� d S r )r �HAVE_GDB_FRAMEDECORATORr� Z frame_filtersr+ Zpretty_printersrS rD )rZ r� r r r �registerY s r� ) r r �sys� version_infor@ r � itertools�imapr] Zgdb.FrameDecoratorr� rO � ImportErrorr r r r% r, r- r8 r9 rD rG rJ rL rM rp �objectr� r� r r r r �<module> s8 i@ gdb/glib_gdb.py 0000644 00000020203 15125157507 0007410 0 ustar 00 import gdb import sys if sys.version_info[0] >= 3: long = int # This is not quite right, as local vars may override symname def read_global_var(symname): return gdb.selected_frame().read_var(symname) def g_quark_to_string(quark): if quark is None: return None quark = long(quark) if quark == 0: return None try: val = read_global_var("quarks") max_q = long(read_global_var("quark_seq_id")) except Exception: try: val = read_global_var("g_quarks") max_q = long(read_global_var("g_quark_seq_id")) except Exception: return None if quark < max_q: return val[quark].string() return None # We override the node printers too, so that node->next is not expanded class GListNodePrinter: "Prints a GList node" def __init__(self, val): self.val = val def to_string(self): return "{data=%s, next=0x%x, prev=0x%x}" % ( str(self.val["data"]), long(self.val["next"]), long(self.val["prev"]), ) class GSListNodePrinter: "Prints a GSList node" def __init__(self, val): self.val = val def to_string(self): return "{data=%s, next=0x%x}" % (str(self.val["data"]), long(self.val["next"])) class GListPrinter: "Prints a GList" class _iterator: def __init__(self, head, listtype): self.link = head self.listtype = listtype self.count = 0 def __iter__(self): return self def next(self): if self.link == 0: raise StopIteration data = self.link["data"] self.link = self.link["next"] count = self.count self.count = self.count + 1 return ("[%d]" % count, data) __next__ = next def __init__(self, val, listtype): self.val = val self.listtype = listtype def children(self): return self._iterator(self.val, self.listtype) def to_string(self): return "0x%x" % (long(self.val)) def display_hint(self): return "array" class GHashPrinter: "Prints a GHashTable" class _iterator: class _pointer_array: def __init__(self, ptr, big_items): self._big_items = big_items self._gpointer_type = gdb.lookup_type("gpointer") item_type = ( self._gpointer_type if self._big_items else gdb.lookup_type("guint") ) self._items = ptr.cast(item_type.pointer()) def __getitem__(self, item): item = self._items[item] if not self._big_items: item = item.cast(self._gpointer_type) return item def __init__(self, ht, keys_are_strings): self.ht = ht if ht != 0: self.keys = self._pointer_array(ht["keys"], ht["have_big_keys"]) self.values = self._pointer_array(ht["values"], ht["have_big_values"]) self.hashes = ht["hashes"] self.size = ht["size"] self.pos = 0 self.keys_are_strings = keys_are_strings self.value = None def __iter__(self): return self def next(self): if self.ht == 0: raise StopIteration if self.value is not None: v = self.value self.value = None return v while long(self.pos) < long(self.size): if long(self.hashes[self.pos]) >= 2: key = self.keys[self.pos] val = self.values[self.pos] if self.keys_are_strings: key = key.cast(gdb.lookup_type("char").pointer()) # Queue value for next result self.value = ("[%dv]" % (self.pos), val) # Increment pos and return key key = ("[%dk]" % (self.pos), key) self.pos += 1 return key self.pos += 1 raise StopIteration __next__ = next def __init__(self, val): self.val = val self.keys_are_strings = False try: string_hash = read_global_var("g_str_hash") except Exception: string_hash = None if ( self.val != 0 and string_hash is not None and self.val["hash_func"] == string_hash ): self.keys_are_strings = True def children(self): return self._iterator(self.val, self.keys_are_strings) def to_string(self): return "0x%x" % (long(self.val)) def display_hint(self): return "map" def pretty_printer_lookup(val): # None yet, want things like hash table and list type = val.type.unqualified() # If it points to a reference, get the reference. if type.code == gdb.TYPE_CODE_REF: type = type.target() if type.code == gdb.TYPE_CODE_PTR: type = type.target().unqualified() t = str(type) if t == "GList": return GListPrinter(val, "GList") if t == "GSList": return GListPrinter(val, "GSList") if t == "GHashTable": return GHashPrinter(val) else: t = str(type) if t == "GList": return GListNodePrinter(val) if t == "GSList *": return GListPrinter(val, "GSList") return None def register(obj): if obj is None: obj = gdb obj.pretty_printers.append(pretty_printer_lookup) class ForeachCommand(gdb.Command): """Foreach on list""" def __init__(self): super(ForeachCommand, self).__init__( "gforeach", gdb.COMMAND_DATA, gdb.COMPLETE_SYMBOL ) def valid_name(self, name): if not name[0].isalpha(): return False return True def parse_args(self, arg): i = arg.find(" ") if i <= 0: raise Exception("No var specified") var = arg[:i] if not self.valid_name(var): raise Exception("Invalid variable name") while i < len(arg) and arg[i].isspace(): i = i + 1 if arg[i : i + 2] != "in": raise Exception("Invalid syntax, missing in") i = i + 2 while i < len(arg) and arg[i].isspace(): i = i + 1 colon = arg.find(":", i) if colon == -1: raise Exception("Invalid syntax, missing colon") val = arg[i:colon] colon = colon + 1 while colon < len(arg) and arg[colon].isspace(): colon = colon + 1 command = arg[colon:] return (var, val, command) def do_iter(self, arg, item, command): item = item.cast(gdb.lookup_type("void").pointer()) item = long(item) to_eval = "set $%s = (void *)0x%x\n" % (arg, item) gdb.execute(to_eval) gdb.execute(command) def slist_iterator(self, arg, container, command): list_element = container.cast(gdb.lookup_type("GSList").pointer()) while long(list_element) != 0: self.do_iter(arg, list_element["data"], command) list_element = list_element["next"] def list_iterator(self, arg, container, command): list_element = container.cast(gdb.lookup_type("GList").pointer()) while long(list_element) != 0: self.do_iter(arg, list_element["data"], command) list_element = list_element["next"] def pick_iterator(self, container): t = container.type.unqualified() if t.code == gdb.TYPE_CODE_PTR: t = t.target().unqualified() t = str(t) if t == "GSList": return self.slist_iterator if t == "GList": return self.list_iterator raise Exception("Invalid container type %s" % (str(container.type))) def invoke(self, arg, from_tty): (var, container, command) = self.parse_args(arg) container = gdb.parse_and_eval(container) func = self.pick_iterator(container) func(var, container, command) ForeachCommand() gdb/gobject_gdb.py 0000644 00000023574 15125157507 0010126 0 ustar 00 import gdb import glib_gdb import sys if sys.version_info[0] >= 3: long = int else: import itertools map = itertools.imap # FrameDecorator is new in gdb 7.7, so we adapt to its absence. try: import gdb.FrameDecorator HAVE_GDB_FRAMEDECORATOR = True FrameDecorator = gdb.FrameDecorator.FrameDecorator except ImportError: HAVE_GDB_FRAMEDECORATOR = False # This is not quite right, as local vars may override symname def read_global_var(symname): return gdb.selected_frame().read_var(symname) def g_type_to_typenode(gtype): def lookup_fundamental_type(typenode): if typenode == 0: return None val = read_global_var("static_fundamental_type_nodes") if val is None: return None return val[typenode >> 2].address gtype = long(gtype) typenode = gtype - gtype % 4 if typenode > (255 << 2): typenode = gdb.Value(typenode).cast(gdb.lookup_type("TypeNode").pointer()) else: typenode = lookup_fundamental_type(typenode) return typenode def g_type_to_name(gtype): typenode = g_type_to_typenode(gtype) if typenode is not None: return glib_gdb.g_quark_to_string(typenode["qname"]) return None def is_g_type_instance(val): def is_g_type_instance_helper(type): if str(type) == "GTypeInstance": return True while type.code == gdb.TYPE_CODE_TYPEDEF: type = type.target() if type.code != gdb.TYPE_CODE_STRUCT: return False fields = type.fields() if len(fields) < 1: return False first_field = fields[0] return is_g_type_instance_helper(first_field.type) type = val.type if type.code != gdb.TYPE_CODE_PTR: return False type = type.target() return is_g_type_instance_helper(type) def g_type_name_from_instance(instance): if long(instance) != 0: try: inst = instance.cast(gdb.lookup_type("GTypeInstance").pointer()) klass = inst["g_class"] gtype = klass["g_type"] name = g_type_to_name(gtype) return name except RuntimeError: pass return None class GTypePrettyPrinter: "Prints a GType instance pointer" def __init__(self, val): self.val = val def to_string(self): name = g_type_name_from_instance(self.val) if name: return ("0x%x [%s]") % (long(self.val), name) return ("0x%x") % (long(self.val)) def is_g_type_class_instance(val): type = val.type if type.code != gdb.TYPE_CODE_PTR: return False return str(type.target()) == "GTypeClass" class GTypeHandlePrettyPrinter: "Prints a GType instance" def __init__(self, val, hint=""): self.val = val self.hint = hint def to_string(self): typenode = g_type_to_typenode(self.val) if typenode is not None: name = glib_gdb.g_quark_to_string(typenode["qname"]) s = ("0x%x [%s%s") % (long(self.val), self.hint, name) for i in range(1, int(typenode["n_supers"])): node = g_type_to_typenode(typenode["supers"][i]) if node: name = glib_gdb.g_quark_to_string(node["qname"]) else: name = "???" s += "/" + name return s + "]" else: return ("0x%x") % (long(self.val)) def pretty_printer_lookup(val): if is_g_type_instance(val): return GTypePrettyPrinter(val) if str(val.type) == "GType": return GTypeHandlePrettyPrinter(val) if is_g_type_class_instance(val): return GTypeHandlePrettyPrinter(val["g_type"], "g_type: ") return None def get_signal_name(id): if id is None: return None id = long(id) if id == 0: return None val = read_global_var("g_signal_nodes") max_s = read_global_var("g_n_signal_nodes") max_s = long(max_s) if id < max_s: return val[id]["name"].string() return None def frame_name(frame): return str(frame.function()) def frame_var(frame, var): return frame.inferior_frame().read_var(var) class SignalFrame(FrameDecorator): def __init__(self, frames): FrameDecorator.__init__(self, frames[-1]) self.frame = frames[-1] self.frames = frames def name(self): return "signal-emission" def read_var(self, frame, name, array=None): try: v = frame_var(frame, name) if v is None or v.is_optimized_out: return None if array is not None: array.append(v) return v except ValueError: return None def read_object(self, frame, name, array=None): try: v = frame_var(frame, name) if v is None or v.is_optimized_out: return None v = v.cast(gdb.lookup_type("GObject").pointer()) # Ensure this is a somewhat correct object pointer if v is not None and g_type_name_from_instance(v): if array is not None: array.append(v) return v return None except ValueError: return None def append(self, array, obj): if obj is not None: array.append(obj) def or_join_array(self, array): if len(array) == 0: return "???" else: return " or ".join(set(map(str, array))) def get_detailed_signal_from_frame(self, frame, signal): detail = self.read_var(frame, "detail") detail = glib_gdb.g_quark_to_string(detail) if detail is not None: return signal + ":" + detail else: return detail def function(self): instances = [] signals = [] for frame in self.frames: name = frame_name(frame) if name == "signal_emit_unlocked_R": self.read_object(frame, "instance", instances) node = self.read_var(frame, "node") if node: signal = node["name"].string() signal = self.get_detailed_signal_from_frame(frame, signal) self.append(signals, signal) if name == "g_signal_emitv": instance_and_params = self.read_var(frame, "instance_and_params") if instance_and_params: instance = instance_and_params[0]["v_pointer"].cast( gdb.Type("GObject").pointer() ) self.append(instances, instance) id = self.read_var(frame, "signal_id") signal = get_signal_name(id) if signal: signal = self.get_detailed_signal_from_frame(frame, signal) self.append(signals, signal) if name == "g_signal_emit_valist" or name == "g_signal_emit": self.read_object(frame, "instance", instances) id = self.read_var(frame, "signal_id") signal = get_signal_name(id) if signal: signal = self.get_detailed_signal_from_frame(frame, signal) self.append(signals, signal) if name == "g_signal_emit_by_name": self.read_object(frame, "instance", instances) self.read_var(frame, "detailed_signal", signals) break instance = self.or_join_array(instances) signal = self.or_join_array(signals) return "<emit signal %s on instance %s>" % (signal, instance) def elided(self): return self.frames[0:-1] def describe(self, stream, full): stream.write(" " + self.function() + "\n") class GFrameDecorator: def __init__(self, iter): self.queue = [] self.iter = iter def __iter__(self): return self def fill(self): while len(self.queue) <= 8: try: f = next(self.iter) self.queue.append(f) except StopIteration: return def find_signal_emission(self): for i in range(min(len(self.queue), 3)): if frame_name(self.queue[i]) == "signal_emit_unlocked_R": return i return -1 def next(self): # Ensure we have enough frames for a full signal emission self.fill() # Are we at the end? if len(self.queue) == 0: raise StopIteration emission = self.find_signal_emission() if emission > 0: start = emission while True: if start == 0: break prev_name = frame_name(self.queue[start - 1]) if prev_name.find("_marshal_") >= 0 or prev_name == "g_closure_invoke": start = start - 1 else: break end = emission + 1 while end < len(self.queue): if frame_name(self.queue[end]) in [ "g_signal_emitv", "g_signal_emit_valist", "g_signal_emit", "g_signal_emit_by_name", "_g_closure_invoke_va", ]: end = end + 1 else: break signal_frames = self.queue[start:end] new_frames = [SignalFrame(signal_frames)] self.queue[start:end] = new_frames return self.queue.pop(0) def __next__(self): return self.next() class GFrameFilter(object): name = "glib" enabled = True priority = 100 def filter(self, iterator): return GFrameDecorator(iterator) def register(obj): if obj is None: obj = gdb if HAVE_GDB_FRAMEDECORATOR: filter = GFrameFilter() obj.frame_filters[filter.name] = filter obj.pretty_printers.append(pretty_printer_lookup) gettext/po/Makefile.in.in 0000644 00000017434 15125157507 0011341 0 ustar 00 # Makefile for program source directory in GNU NLS utilities package. # Copyright (C) 1995, 1996, 1997 by Ulrich Drepper <drepper@gnu.ai.mit.edu> # # This file file be copied and used freely without restrictions. It can # be used in projects which are not available under the GNU Public License # but which still want to provide support for the GNU gettext functionality. # Please note that the actual code is *not* freely available. # # - Modified by Owen Taylor <otaylor@redhat.com> to use GETTEXT_PACKAGE # instead of PACKAGE and to look for po2tbl in ./ not in intl/ # # - Modified by jacob berkman <jacob@ximian.com> to install # Makefile.in.in and po2tbl.sed.in for use with glib-gettextize GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ PACKAGE = @PACKAGE@ VERSION = @VERSION@ SHELL = @SHELL@ @SET_MAKE@ srcdir = @srcdir@ top_srcdir = @top_srcdir@ VPATH = @srcdir@ prefix = @prefix@ exec_prefix = @exec_prefix@ datarootdir = @datarootdir@ datadir = @datadir@ libdir = @libdir@ localedir = $(libdir)/locale gnulocaledir = $(datadir)/locale gettextsrcdir = $(datadir)/glib-2.0/gettext/po subdir = po INSTALL = @INSTALL@ INSTALL_DATA = @INSTALL_DATA@ MKINSTALLDIRS = mkdir -p CC = @CC@ GENCAT = @GENCAT@ GMSGFMT = @GMSGFMT@ MSGFMT = @MSGFMT@ MSGFMT_OPTS = @MSGFMT_OPTS@ XGETTEXT = @XGETTEXT@ MSGMERGE = msgmerge DEFS = @DEFS@ CFLAGS = @CFLAGS@ CPPFLAGS = @CPPFLAGS@ INCLUDES = -I.. -I$(top_srcdir)/intl COMPILE = $(CC) -c $(DEFS) $(INCLUDES) $(CPPFLAGS) $(CFLAGS) $(XCFLAGS) SOURCES = POFILES = @POFILES@ GMOFILES = @GMOFILES@ DISTFILES = LINGUAS Makefile.in.in POTFILES.in $(GETTEXT_PACKAGE).pot \ $(POFILES) $(GMOFILES) $(SOURCES) POTFILES = \ CATALOGS = @CATALOGS@ CATOBJEXT = @CATOBJEXT@ INSTOBJEXT = @INSTOBJEXT@ .SUFFIXES: .SUFFIXES: .c .o .po .pox .gmo .mo .msg .cat .c.o: $(COMPILE) $< .po.pox: $(MAKE) $(GETTEXT_PACKAGE).pot $(MSGMERGE) $< $(srcdir)/$(GETTEXT_PACKAGE).pot -o $*.pox .po.mo: $(MSGFMT) -o $@ $< .po.gmo: $(AM_V_GEN) file=$(srcdir)/`echo $* | sed 's,.*/,,'`.gmo \ && rm -f $$file && $(GMSGFMT) $(MSGFMT_OPTS) -o $$file $< .po.cat: sed -f ../intl/po2msg.sed < $< > $*.msg \ && rm -f $@ && $(GENCAT) $@ $*.msg all: all-@USE_NLS@ all-yes: $(CATALOGS) all-no: $(srcdir)/$(GETTEXT_PACKAGE).pot: $(POTFILES) $(XGETTEXT) --default-domain=$(GETTEXT_PACKAGE) --from-code=UTF-8 \ --msgid-bugs-address='http://bugzilla.gnome.org/enter_bug.cgi?product=glib&keywords=I18N+L10N&component=general' \ --add-comments --keyword=_ --keyword=N_ \ --keyword=C_:1c,2 \ --keyword=NC_:1c,2 \ --keyword=g_dcgettext:2 \ --keyword=g_dngettext:2,3 \ --keyword=g_dpgettext2:2c,3 \ --flag=N_:1:pass-c-format \ --flag=C_:2:pass-c-format \ --flag=NC_:2:pass-c-format \ --flag=g_dngettext:2:pass-c-format \ --flag=g_strdup_printf:1:c-format \ --flag=g_string_printf:2:c-format \ --flag=g_string_append_printf:2:c-format \ --flag=g_error_new:3:c-format \ --flag=g_set_error:4:c-format \ --flag=g_markup_printf_escaped:1:c-format \ --flag=g_log:3:c-format \ --flag=g_print:1:c-format \ --flag=g_printerr:1:c-format \ --flag=g_printf:1:c-format \ --flag=g_fprintf:2:c-format \ --flag=g_sprintf:2:c-format \ --flag=g_snprintf:3:c-format \ --flag=g_scanner_error:2:c-format \ --flag=g_scanner_warn:2:c-format \ $(POTFILES) \ && test ! -f $(GETTEXT_PACKAGE).po \ || ( rm -f $(srcdir)/$(GETTEXT_PACKAGE).pot \ && mv $(GETTEXT_PACKAGE).po $(srcdir)/$(GETTEXT_PACKAGE).pot ) install: install-exec install-data install-exec: install-data: install-data-@USE_NLS@ install-data-no: all install-data-yes: all $(MKINSTALLDIRS) $(DESTDIR)$(datadir); \ catalogs='$(CATALOGS)'; \ for cat in $$catalogs; do \ cat=`basename $$cat`; \ case "$$cat" in \ *.gmo) destdir=$(gnulocaledir);; \ *) destdir=$(localedir);; \ esac; \ lang=`echo $$cat | sed 's/\$(CATOBJEXT)$$//'`; \ dir=$(DESTDIR)$$destdir/$$lang/LC_MESSAGES; \ $(MKINSTALLDIRS) $$dir; \ if test -r $$cat; then \ $(INSTALL_DATA) $$cat $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT); \ echo "installing $$cat as $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT)"; \ else \ $(INSTALL_DATA) $(srcdir)/$$cat $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT); \ echo "installing $(srcdir)/$$cat as" \ "$$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT)"; \ fi; \ if test -r $$cat.m; then \ $(INSTALL_DATA) $$cat.m $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m; \ echo "installing $$cat.m as $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m"; \ else \ if test -r $(srcdir)/$$cat.m ; then \ $(INSTALL_DATA) $(srcdir)/$$cat.m \ $$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m; \ echo "installing $(srcdir)/$$cat as" \ "$$dir/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m"; \ else \ true; \ fi; \ fi; \ done if test "$(PACKAGE)" = "glib"; then \ $(MKINSTALLDIRS) $(DESTDIR)$(gettextsrcdir); \ $(INSTALL_DATA) $(srcdir)/Makefile.in.in \ $(DESTDIR)$(gettextsrcdir)/Makefile.in.in; \ else \ : ; \ fi # Define this as empty until I found a useful application. installcheck: uninstall: catalogs='$(CATALOGS)'; \ for cat in $$catalogs; do \ cat=`basename $$cat`; \ lang=`echo $$cat | sed 's/\$(CATOBJEXT)$$//'`; \ rm -f $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE)$(INSTOBJEXT); \ rm -f $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m; \ rm -f $(DESTDIR)$(gnulocaledir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE)$(INSTOBJEXT); \ rm -f $(DESTDIR)$(gnulocaledir)/$$lang/LC_MESSAGES/$(GETTEXT_PACKAGE)$(INSTOBJEXT).m; \ done if test "$(PACKAGE)" = "glib"; then \ rm -f $(DESTDIR)$(gettextsrcdir)/Makefile.in.in; \ fi check: all dvi info tags TAGS ID: mostlyclean: rm -f core core.* *.pox $(GETTEXT_PACKAGE).po *.old.po cat-id-tbl.tmp rm -fr *.o clean: mostlyclean distclean: clean rm -f Makefile Makefile.in POTFILES *.mo *.msg *.cat *.cat.m maintainer-clean: distclean @echo "This command is intended for maintainers to use;" @echo "it deletes files that may require special tools to rebuild." rm -f $(GMOFILES) distdir = ../$(GETTEXT_PACKAGE)-$(VERSION)/$(subdir) dist distdir: $(DISTFILES) dists="$(DISTFILES)"; \ for file in $$dists; do \ ln $(srcdir)/$$file $(distdir) 2> /dev/null \ || cp -p $(srcdir)/$$file $(distdir); \ done update-po: Makefile $(MAKE) $(GETTEXT_PACKAGE).pot tmpdir=`pwd`; \ cd $(srcdir); \ catalogs='$(CATALOGS)'; \ for cat in $$catalogs; do \ cat=`basename $$cat`; \ lang=`echo $$cat | sed 's/\$(CATOBJEXT)$$//'`; \ echo "$$lang:"; \ if $(MSGMERGE) $$lang.po $(GETTEXT_PACKAGE).pot -o $$tmpdir/$$lang.new.po; then \ if cmp $$lang.po $$tmpdir/$$lang.new.po >/dev/null 2>&1; then \ rm -f $$tmpdir/$$lang.new.po; \ else \ if mv -f $$tmpdir/$$lang.new.po $$lang.po; then \ :; \ else \ echo "msgmerge for $$lang.po failed: cannot move $$tmpdir/$$lang.new.po to $$lang.po" 1>&2; \ rm -f $$tmpdir/$$lang.new.po; \ exit 1; \ fi; \ fi; \ else \ echo "msgmerge for $$cat failed!"; \ rm -f $$tmpdir/$$lang.new.po; \ fi; \ done # POTFILES is created from POTFILES.in by stripping comments, empty lines # and Intltool tags (enclosed in square brackets), and appending a full # relative path to them POTFILES: POTFILES.in ( if test 'x$(srcdir)' != 'x.'; then \ posrcprefix='$(top_srcdir)/'; \ else \ posrcprefix="../"; \ fi; \ rm -f $@-t $@ \ && (sed -e '/^#/d' \ -e "s/^\[.*\] +//" \ -e '/^[ ]*$$/d' \ -e "s@.*@ $$posrcprefix& \\\\@" < $(srcdir)/$@.in \ | sed -e '$$s/\\$$//') > $@-t \ && chmod a-w $@-t \ && mv $@-t $@ ) Makefile: Makefile.in.in ../config.status POTFILES cd .. \ && $(SHELL) ./config.status $(subdir)/$@.in # Tell versions [3.59,3.63) of GNU make not to export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. .NOEXPORT: schemas/org.freedesktop.Tracker3.Miner.Files.gschema.xml 0000644 00000015063 15125157507 0017224 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <!-- Copyright (C) 2011, Nokia <ivan.frade@nokia.com> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. --> <schemalist> <schema id="org.freedesktop.Tracker3.Miner.Files" path="/org/freedesktop/tracker/miner/files/" gettext-domain="tracker-miners"> <key name="initial-sleep" type="i"> <summary>Initial sleep</summary> <description>Initial sleep time, in seconds.</description> <range min="0" max="1000"/> <default>15</default> </key> <key name="throttle" type="i"> <summary>Throttle</summary> <description>Indexing speed, the higher the slower.</description> <range min="0" max="20"/> <default>0</default> </key> <key name="low-disk-space-limit" type="i"> <summary>Low disk space limit</summary> <description>Disk space threshold in percent at which to pause indexing, or -1 to disable.</description> <range min="-1" max="100"/> <default>-1</default> </key> <key name="crawling-interval" type="i"> <summary>Crawling interval</summary> <description> Interval in days to check whether the filesystem is up to date in the database. 0 forces crawling anytime, -1 forces it only after unclean shutdowns, and -2 disables it entirely. </description> <range min="-2" max="365"/> <default>-1</default> </key> <key name="removable-days-threshold" type="i"> <summary>Removable devices’ data permanence threshold</summary> <description> Threshold in days after which files from removables devices will be removed from database if not mounted. 0 means never, maximum is 365. </description> <range min="0" max="365"/> <default>3</default> </key> <key name="enable-monitors" type="b"> <summary>Enable monitors</summary> <description>Set to false to completely disable any file monitoring</description> <default>true</default> </key> <key name="index-removable-devices" type="b"> <summary>Index removable devices</summary> <description>Set to true to enable indexing mounted directories for removable devices.</description> <default>false</default> </key> <key name="index-optical-discs" type="b"> <summary>Index optical discs</summary> <description> Set to true to enable indexing CDs, DVDs, and generally optical media (if removable devices are not indexed, optical discs won’t be either) </description> <default>false</default> </key> <key name="index-on-battery" type="b"> <summary>Index when running on battery</summary> <description>Set to true to index while running on battery</description> <default>true</default> </key> <key name="index-on-battery-first-time" type="b"> <summary>Perform initial indexing when running on battery</summary> <description>Set to true to index while running on battery for the first time only</description> <default>true</default> </key> <key name="index-recursive-directories" type="as"> <summary>Directories to index recursively</summary> <!-- Translators: Do NOT translate the directories names in capital. Those are keys used by Tracker. --> <description> List of directories to index recursively, Special values include: ‘&DESKTOP’, ‘&DOCUMENTS’, ‘&DOWNLOAD’, ‘&MUSIC’, ‘&PICTURES’, ‘&PUBLIC_SHARE’, ‘&TEMPLATES’, ‘&VIDEOS’. See /etc/xdg/user-dirs.defaults and $HOME/.config/user-dirs.default </description> <default>[ '&DESKTOP', '&DOCUMENTS', '&MUSIC', '&PICTURES', '&VIDEOS' ]</default> </key> <key name="index-single-directories" type="as"> <summary>Directories to index non-recursively</summary> <!-- Translators: Do NOT translate the directories names in capital. Those are keys used by Tracker. --> <description> List of directories to index without inspecting subfolders, Special values include: ‘&DESKTOP’, ‘&DOCUMENTS’, ‘&DOWNLOAD’, ‘&MUSIC’, ‘&PICTURES’, ‘&PUBLIC_SHARE’, ‘&TEMPLATES’, ‘&VIDEOS’. See /etc/xdg/user-dirs.defaults and $HOME/.config/user-dirs.default </description> <default>[ '$HOME', '&DOWNLOAD' ]</default> </key> <key name="index-applications" type="b"> <summary>Index applications installed on the system</summary> <description> If this option is enabled, the filesystem miner will look for .desktop files in the standard XDG system and user data directories. </description> <default>true</default> </key> <key name="ignored-files" type="as"> <summary>Ignored files</summary> <description>List of file patterns to avoid</description> <default>[ '*~', '*.o', '*.la', '*.lo' , '*.loT', '*.in', '*.csproj', '*.m4', '*.rej', '*.gmo', '*.orig', '*.pc', '*.omf', '*.aux', '*.tmp', '*.vmdk', '*.vm*', '*.nvram', '*.part', '*.rcore', '*.lzo', 'autom4te', 'conftest', 'confstat', 'Makefile', 'SCCS', 'ltmain.sh', 'libtool', 'config.status', 'confdefs.h', 'configure', '#*#', '~$*.doc?', '~$*.dot?', '~$*.xls?', '~$*.xlt?', '~$*.xlam', '~$*.ppt?', '~$*.pot?', '~$*.ppam', '~$*.ppsm', '~$*.ppsx', '~$*.vsd?', '~$*.vss?', '~$*.vst?', 'mimeapps.list', 'mimeinfo.cache', 'gnome-mimeapps.list', 'kde-mimeapps.list', '*.directory' ]</default> </key> <key name="ignored-directories" type="as"> <summary>Ignored directories</summary> <description>List of directories to avoid</description> <default>[ 'po', 'CVS', 'core-dumps', 'lost+found' ]</default> </key> <key name="ignored-directories-with-content" type="as"> <summary>Ignored directories with content</summary> <description>Avoid any directory containing a file blocklisted here</description> <default>[ '.trackerignore', '.git', '.hg', '.nomedia' ]</default> </key> </schema> </schemalist> schemas/org.gtk.Settings.EmojiChooser.gschema.xml 0000644 00000001157 15125157507 0016072 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist> <schema id='org.gtk.Settings.EmojiChooser' path='/org/gtk/settings/emoji-chooser/'> <key name='recent-emoji' type='a((auss)u)'> <default>[]</default> <summary>Recently used Emoji</summary> <description> An array of Emoji definitions to show in the Emoji chooser. Each Emoji is specified as an array of codepoints, name and shortname. The extra integer after this pair is the code of the Fitzpatrick modifier to use in place of a 0 in the codepoint array. </description> </key> </schema> </schemalist> schemas/org.freedesktop.Tracker3.FTS.gschema.xml 0000644 00000003671 15125157507 0015547 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <!-- Copyright (C) 2011, Nokia <ivan.frade@nokia.com> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. --> <schemalist> <schema id="org.freedesktop.Tracker3.FTS" path="/org/freedesktop/tracker/fts/" gettext-domain="tracker-miners"> <key name="enable-stemmer" type="b"> <summary>Enable stemmer</summary> <description>Simplify the words to their root to provide more results. E.g. “shelves” and “shelf” to “shel”</description> <default>false</default> </key> <key name="enable-unaccent" type="b"> <summary>Enable unaccent</summary> <description>Translate accented characters to the equivalent unaccented. E.g. “Idéa” to “Idea” for improved matching. </description> <default>true</default> </key> <key name="ignore-numbers" type="b"> <summary>Ignore numbers</summary> <description>If enabled, numbers will not be indexed.</description> <default>true</default> </key> <key name="ignore-stop-words" type="b"> <summary>Ignore stop words</summary> <description>If enabled, the words listed in the stop-words list are ignored. E.g. common words like “the”, “yes”, “no”, etc.</description> <default>true</default> </key> </schema> </schemalist> schemas/org.gnome.desktop.search-providers.gschema.xml 0000644 00000003563 15125157507 0017160 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.search-providers" path="/org/gnome/desktop/search-providers/"> <key name="disable-external" type="b"> <default>false</default> <summary>Disable all external search providers</summary> <description> Set to true to disable all external search provider programs, whether or not they are independently disabled or enabled. External search providers are installed by applications in $XDG_DATA_DIR/gnome-shell/search-providers. </description> </key> <key name="disabled" type="as"> <default>[]</default> <summary> List of desktop file IDs for which the associated default-enabled search provider should be disabled </summary> <description> Results for applications contained in this list will not be displayed when searching. </description> </key> <key name="enabled" type="as"> <default>[]</default> <summary> List of desktop file IDs for which the associated default-disabled search provider should be enabled </summary> <description> Results for applications contained in this list will be displayed when searching. </description> </key> <key name="sort-order" type="as"> <default>['org.gnome.Contacts.desktop', 'org.gnome.Documents.desktop', 'org.gnome.Nautilus.desktop']</default> <summary>List of desktop file IDs for search providers sort order</summary> <description> Results for applications contained in this list will be displayed in the specified order. Results for applications not specified in this list will be displayed last, sorted alphabetically. </description> </key> </schema> </schemalist> schemas/org.gtk.exampleapp.gschema.xml 0000644 00000001515 15125157507 0014037 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist> <schema path="/org/gtk/exampleapp/" id="org.gtk.exampleapp"> <key name="font" type="s"> <default>'Monospace 12'</default> <summary>Font</summary> <description>The font to be used for content.</description> </key> <key name="transition" type="s"> <choices> <choice value='none'/> <choice value='crossfade'/> <choice value='slide-left-right'/> </choices> <default>'none'</default> <summary>Transition</summary> <description>The transition to use when switching tabs.</description> </key> <key name="show-words" type="b"> <default>false</default> <summary>Show words</summary> <description>Whether to show a word list in the sidebar</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.a11y.applications.gschema.xml 0000644 00000001515 15125157507 0017133 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.a11y.applications" path="/org/gnome/desktop/a11y/applications/"> <key name="screen-keyboard-enabled" type="b"> <default>false</default> <summary>On-screen keyboard</summary> <description>Whether the on-screen keyboard is turned on.</description> </key> <key name="screen-magnifier-enabled" type="b"> <default>false</default> <summary>Screen magnifier</summary> <description>Whether the screen magnifier is turned on.</description> </key> <key name="screen-reader-enabled" type="b"> <default>false</default> <summary>Screen reader</summary> <description>Whether the screen reader is turned on.</description> </key> </schema> </schemalist> schemas/gschemas.compiled 0000644 00000120305 15125157507 0011510 0 ustar 00 GVariant $ (7 " $ $ % ' ) * * * * + + , - . . / 1 2 2 3 5 6 7 7 �p8�0 $ H D � ��2�0 � # H � < N[>40 � 3 H � �#0 � H � &-.�0 H 0 �]�40 � & H � 4 <��0 � H � � ��Ś0 A ) H l � T|��0 � H � @ �W'b0 � $ H � � �[P>0 � H � �fn$0 ! 6 H H! �! �t t0 :" H \" �" ̆@t0 |# H �# $ ��Z�0 e$ H �$ �& :�v0 * - H L* �* �:r0 �+ H �+ �, j�*K0 B. / H t. �. }��0 [/ # H �/ �0 u;k0 �1 H �1 l2 �X?j0 �2 $ H �2 �3 a�0 ]4 H x4 �4 2e�0 5 + H H5 �5 e�e�0 �7 H �7 \8 �i0 �8 H �8 D9 ( �0 �9 H �9 �: g@A 0 �; H �; �< �۶�0 �> " H �> t? �pa0 ]@ H x@ �A zR�0 �C H �C �D �D�0 }E $ H �E TF %���0 �F H �F �H д��0 K H @K �T ��� 0 �b H c xc 8fU0 �c H �c �h �{�k0 5p ! H Xp �p t"0 8q H Xq �s +DE�0 { H ({ �{ t 0 X| H p| } ��n50 �} ' H �} �~ � ��0 � H � 4� u�� 0 h� H �� � �Z�0 5� H L� ā ��} 0 -� + H X� @� ����0 � H � �� ���0 � H � �� ⍤0 � H � t� �� 0 � H <� � ������ L �� `� �o�X0 `� & H �� 4� ��d�0 � H $� �� ��bN0 T� / H �� � a �0 d� H �� �� �G��0 � H � � ��0 � & H @� � org.freedesktop.Tracker3.Extract ( ����� L � � ?��� � v � ��� v : �$� : v P U �}~ ����U v ` � max-bytes r � (i(y(ii)))text-allowlist *.txt *.md *.mdwn (as)wait-for-miner-fs (b).path /org/freedesktop/tracker/extract/ sorg.gnome.desktop.a11y.applications ( ����< L < H < �� H v ` e �}~ ����e v p � ;4M� � v � � }�� � v � � screen-magnifier-enabled (b).path /org/gnome/desktop/a11y/applications/ sscreen-keyboard-enabled (b)screen-reader-enabled (b)org.gnome.desktop.default-applications.office.tasks ( �}~ ����� v � � ����� L � � �p�> � v � � �}�| � v � � .path /org/gnome/desktop/applications/office/tasks/ s needs-term (b)exec evolution -c tasks (s)org.gnome.desktop.a11y.magnifier ( tq� � v � ��} v z ���w z v � � ˩� � v � � ��� � v � � ��� � v � �� v 3 ��f 3 v H P [Ԑ P v ` � ���o � v � � 1|W: � v � � &��3 � v � ���� v 0 [ �3 [ v p | Y�w | v � � 3�� � v � � �Ϝ � v 3 ���� 3 v H M ���I M v ` � {�k* � v � � �}~ ����� v % �ȡ) % v 8 � ����� L � caret-tracking centered e �none � �centered � �proportional � �push � (s(yau))focus-tracking proportional e �none � �centered � �proportional � �push � (s(yau))invert-lightness (b)scroll-at-edges (b)contrast-blue r � �? (d(y(dd)))cross-hairs-clip (b)cross-hairs-length r (i(y(ii)))cross-hairs-thickness (i)contrast-red r � �? (d(y(dd)))lens-mode (b)contrast-green r � �? (d(y(dd)))brightness-red r � �? (d(y(dd)))brightness-green r � �? (d(y(dd)))cross-hairs-color #ff0000 (s)cross-hairs-opacity ��Q� �?r �? (d(y(dd)))brightness-blue r � �? (d(y(dd)))mag-factor @r �������? @@ (d(y(dd)))show-cross-hairs (b)mouse-tracking proportional e �none � �centered � �proportional � �push � (s(yau))color-saturation �?r �? (d(y(dd))).path/org/gnome/desktop/a11y/magnifier/ sscreen-position full-screen e �none � �full-screen � �top-half � �bottom-half � �left-half � �right-half � (s(yau)) org.gnome.desktop.peripherals ( ��� v G �}~ ����G v P r ���G r v � � ��U4 � v � � �< � v � e�' v A ����A L D \ 77n� \ v h � tablet/ org.gnome.desktop.peripherals.tablet s.path /org/gnome/desktop/peripherals/ stouchpad/ org.gnome.desktop.peripherals.touchpad strackball/ org.gnome.desktop.peripherals.trackball smouse/org.gnome.desktop.peripherals.mouse skeyboard/ org.gnome.desktop.peripherals.keyboard s touchscreen/org.gnome.desktop.peripherals.touchscreen sorg.gnome.desktop.default-applications ( �.�Y 4 v @ p � �= p v � � �}~ ����� v � � ����� L � � office/ org.gnome.desktop.default-applications.office sterminal/ org.gnome.desktop.default-applications.terminal s.path /org/gnome/desktop/applications/ s org.gtk.exampleapp ( poH� � v � � ����� L � � b�x � v �}~ ���� v ' ��| ' v 0 A transition none c �none � �crossfade � �slide-left-right � (s(yau)) show-words (b).path /org/gtk/exampleapp/ sfont Monospace 12 (s)org.gnome.desktop.peripherals.touchscreen ( v]R � v � � ����� L � � output (as) org.gnome.desktop.datetime ( �}~ ����@ v H g d;l� g v � � ����� L � � .path /org/gnome/desktop/datetime/ sautomatic-timezone (b) org.freedesktop.Tracker3.Miner.Files ( ���@ � v � � l.� � v � ' �H)P ' v @ f �x f v � � V�� � v � � �SE& � v � ��6� v + �3<� + v 8 S �}~ ����S v X � �{t" � v � � ��f� � v � 43 � v M��R v 0 = �%p� = v P U Oby U v h m ��\ m v � � q�xm � v � � ����� L � � index-on-battery-first-time (b)index-recursive-directories&DESKTOP &DOCUMENTS &MUSIC &PICTURES &VIDEOS %- (as)ignored-directories po CVS core-dumps lost+found (as)low-disk-space-limit ����r ����d (i(y(ii)))index-single-directories $HOME &DOWNLOAD (as)removable-days-threshold r m (i(y(ii)))throttle r (i(y(ii)))initial-sleep r � (i(y(ii))).path/org/freedesktop/tracker/miner/files/ scrawling-interval ����r ����m (i(y(ii)))ignored-directories-with-content .trackerignore .git .hg .nomedia ! (as)enable-monitors (b)ignored-files *~ *.o *.la *.lo *.loT *.in *.csproj *.m4 *.rej *.gmo *.orig *.pc *.omf *.aux *.tmp *.vmdk *.vm* *.nvram *.part *.rcore *.lzo autom4te conftest confstat Makefile SCCS ltmain.sh libtool config.status confdefs.h configure #*# ~$*.doc? ~$*.dot? ~$*.xls? ~$*.xlt? ~$*.xlam ~$*.ppt? ~$*.pot? ~$*.ppam ~$*.ppsm ~$*.ppsx ~$*.vsd? ~$*.vss? ~$*.vst? mimeapps.list mimeinfo.cache gnome-mimeapps.list kde-mimeapps.list *.directory % * 0 6 = B H N T [ a i p x ~ � � � � � � � � � � � � � � (1:CLUcr��� (as)index-optical-discs (b)index-on-battery (b)index-removable-devices (b)index-applications (b) org.gtk.Settings.ColorChooser ( �}~ ����� v � � ����� L � � Z�eO � v � � �b� � v ! ! .path /org/gtk/settings/color-chooser/ s selected-color �? �? �? �? ((bdddd))custom-colors (a(dddd))org.gnome.desktop.default-applications.office.calendar ( �}~ �����! v �! �! �����! L �! " �p�> " v " " �}�| " v " :" .path /org/gnome/desktop/applications/office/calendar/ s needs-term (b)exec evolution -c calendar (s)org.gnome.desktop.notifications ( �i/� �" v # # o�� # v (# -# ����-# L 0# <# �v�S <# v H# M# �}~ ����M# v X# |# show-in-lock-screen (b)application-children (as) show-banners (b).path /org/gnome/desktop/notifications/ sorg.gnome.system.proxy.ftp ( �}~ ����$ v $ -$ ����-$ L 0$ 8$ Ja�| 8$ v @$ [$ c��| [$ v `$ e$ .path /system/proxy/ftp/ s port r �� (i(y(ii)))host (s)org.gnome.desktop.screensaver ( ���J �& v �& �& �����& L �& $' ���n $' v @' E' ~�5� E' v X' �' �}~ �����' v �' �' ��� �' v �' �' B�q� �' v ( ( ��E ( v ( J( ��W� J( v `( {( ˁ>� {( v �( �( �mM� �( v �( �( �Ӑ �( v �( �( ��r@ �( v �( �( [��� �( v ) ) ��� ) v ) %) ��i� %) v 8) D) e�k� D) v `) e) :�� e) v x) �) ��gf �) v * * �� * v * * secondary-color #5789ca (s) idle-activation-enabled (b)color-shading-type solid e �solid � �vertical � �horizontal � (s(yau)).path /org/gnome/desktop/screensaver/ sembedded-keyboard-command (s)restart-enabled (b)picture-urifile:///usr/share/backgrounds/Alma-mountains-dark.xml (s)picture-opacity d r d (i(y(ii)))logout-command (s)show-full-name-in-top-bar (b)lock-enabled (b)logout-delay (u)user-switch-enabled (b)status-message-enabled (b)primary-color #023c88 (s)embedded-keyboard-enabled (b)picture-options scaled e �none � �wallpaper � �centered � �scaled � �stretched � �zoom � �spanned � (s(yau))lock-delay (u)logout-enabled (b)org.gnome.desktop.default-applications.office ( �}~ �����* v �* �* �����* L �* + Z�� + v + F+ �W� F+ v P+ �+ .path /org/gnome/desktop/applications/office/ s tasks/ org.gnome.desktop.default-applications.office.tasks scalendar/ org.gnome.desktop.default-applications.office.calendar sorg.gnome.system.proxy ( �����, L �, �, ��� �, v �, - t� - v - - �}~ ���� - v (- 9- 40�� 9- v H- M- (� M- v X- w- >��| w- v �- �- J��| �- v �- �- �1 �- v �- . � �W . v . B. http/ org.gnome.system.proxy.http sautoconfig-url (s).path /system/proxy/ suse-same-proxy (b)https/ org.gnome.system.proxy.https sftp/ org.gnome.system.proxy.ftp smode none e �none � �manual � �auto � (s(yau))socks/ org.gnome.system.proxy.socks signore-hosts localhost 127.0.0.0/8 ::1 (as)org.gnome.desktop.default-applications.terminal ( �}~ �����. v �. $/ ����$/ L $/ ,/ q��� ,/ v 8/ ?/ �}�| ?/ v H/ [/ .path /org/gnome/desktop/applications/terminal/ s exec-arg -x (s)exec gnome-terminal (s)org.gnome.desktop.peripherals.mouse ( �}~ �����0 v �0 �0 a~ɿ �0 v �0 �0 X��� �0 v �0 �0 �6 �0 v �0 1 �>�r 1 v 1 1 �'_ 1 v 1 K1 [�� K1 v X1 �1 �� �1 v �1 �1 �����1 L �1 �1 .path /org/gnome/desktop/peripherals/mouse/ sleft-handed (b)natural-scroll (b)double-click � (i)drag-threshold (i)speed r � �? (d(y(dd)))accel-profiledefault e �default � �flat � �adaptive � (s(yau))middle-click-emulation (b) org.gnome.desktop.thumbnailers ( �}~ ����l2 v x2 �2 �����2 L �2 �2 ��� �2 v �2 �2 ?�� �2 v �2 �2 .path /org/gnome/desktop/thumbnailers/ s disable (as)disable-all (b)org.gnome.desktop.peripherals.tablet ( v]R �3 v �3 �3 �2�| �3 v �3 �3 �й� �3 v �3 "4 a~ɿ "4 v 04 54 ����54 L 84 L4 �� L4 v X4 ]4 output (as)area (ad)mapping absolute e �absolute � �relative � (s(yau))left-handed (b) keep-aspect (b)org.gnome.desktop.calendar ( �}~ �����4 v �4 �4 =(<J �4 v 5 5 ����5 L 5 5 .path /org/gnome/desktop/calendar/ sshow-weekdate (b) org.gnome.desktop.peripherals.tablet.stylus ( �^� �5 v 6 6 M�- 6 v 86 �6 ?��� �6 v �6 �6 ��"� �6 v �6 67 ����67 L 87 L7 ��Lb L7 v h7 �7 pressure-curve d d (ai)tertiary-button-action default e �default � �middle � �right � �back � �forward � (s(yau))eraser-pressure-curve d d (ai)button-action default e �default � �middle � �right � �back � �forward � (s(yau)) secondary-button-action default e �default � �middle � �right � �back � �forward � (s(yau))org.gnome.system.proxy.socks ( �}~ ����\8 v h8 8 ����8 L �8 �8 Ja�| �8 v �8 �8 c��| �8 v �8 �8 .path /system/proxy/socks/ s port r �� (i(y(ii)))host (s)org.gnome.desktop.a11y ( �}~ ����D9 v P9 k9 ����k9 L l9 t9 ��d t9 v �9 �9 �ԋ_ �9 # v �9 �9 .path /org/gnome/desktop/a11y/ s always-show-text-caret (b)always-show-universal-access-status (b)org.gnome.desktop.input-sources ( �ֿ� �: v �: �: �}~ �����: v �: ; � ; v ; ; �f�� ; v (; -; ���� -; v 8; @; Cȯ� @; v P; U; <H U; v h; m; ����m; L p; �; current (u).path /org/gnome/desktop/input-sources/ ssources (a(ss))per-window (b)mru-sources (a(ss))xkb-options (as)show-all-sources (b) org.gnome.desktop.background ( ��W� �< v �< �< �}~ �����< v �< �< ~�5� �< v = V= �&�� V= v h= m= :�� m= v �= �= ��i� �= v > > ��E > v (> c> ���J c> v x> �> �����> L �> �> picture-opacity d r d (i(y(ii))).path/org/gnome/desktop/background/ scolor-shading-type solid e �solid � �vertical � �horizontal � (s(yau))show-desktop-icons (b)picture-options scaled e �none � �wallpaper � �centered � �scaled � �stretched � �zoom � �spanned � (s(yau))primary-color #023c88 (s)picture-uri file:///usr/share/backgrounds/Alma-mountains-white.xml (s)secondary-color #5789ca (s) org.gnome.desktop.search-providers ( )H� t? v �? �? ��#j �? v �? �? �}~ �����? v �? �? vb' �? v �? :@ ����:@ L <@ L@ =|ak L@ v X@ ]@ disable-external (b)enabled (as).path /org/gnome/desktop/search-providers/ ssort-order org.gnome.Contacts.desktop org.gnome.Documents.desktop org.gnome.Nautilus.desktop 7R (as) disabled (as)org.gnome.desktop.lockdown ( ��^ �A v B B � � B v B %B �}~ ����%B v 0B OB <� OB , v �B �B I� �B v �B �B -�ɤ �B v �B �B �Ї� �B v �B �B ��:� �B v C C �9� C v C %C q��� %C v 8C =C Sj0 =C v XC ]C ;� ]C v xC }C ����}C L �C �C disable-lock-screen (b)disable-user-switching (b).path /org/gnome/desktop/lockdown/ smount-removable-storage-devices-as-read-only (b)disable-command-line (b)disable-log-out (b)user-administration-disabled (b)disable-application-handlers (b)disable-printing (b)disable-print-setup (b)disable-save-to-disk (b)disable-show-password (b) org.gnome.system.proxy.http ( �}~ �����D v �D �D ��#j �D v �D �D �1� �D v �D �D Ja�| �D v E E c��| E v E %E %� %E v @E EE ����EE L HE `E �j� `E v xE }E .path /system/proxy/http/ senabled (b)authentication-user (s)port � r �� (i(y(ii)))host (s)authentication-password (s) use-authentication (b)org.gnome.desktop.app-folders.folder ( �;�� TF v hF mF �+�| mF v xF }F F �| }F v �F �F �����F L �F �F ���M �F v �F �F s�# �F v �F �F excluded-apps (as)apps (as)name (s) categories (as)translate (b)org.gnome.desktop.privacy ( ��Z1 �H v �H �H ���� �H v �H �H ��� �H v I I (x'� I v 0I nI �}_� nI v �I �I �����I L �I �I Z� �I v �I �I �o � �I v �I �I �� �I v J J �}~ ����J v J >J �is� >J v PJ UJ n�Fe UJ v pJ uJ "E� uJ v �J �J ��o? �J v �J �J �O�� �J v �J �J �D �J v �J �J �mM� �J v K K send-software-usage-stats (b)usb-protection (b)remember-app-usage (b)usb-protection-level lockscreen e �lockscreen � �always � (s(yau))remove-old-temp-files (b) disable-microphone (b)hide-identity (b)old-files-age (u).path /org/gnome/desktop/privacy/ sdisable-camera (b)remove-old-trash-files (b)remember-recent-files (b)report-technical-problems (b)disable-sound-output (b)recent-files-max-age ���� (i)show-full-name-in-top-bar (b)org.gnome.desktop.wm.keybindings (W ! # & ' ' ' ( ( ) * * , , - . / 0 2 2 2 4 5 6 6 8 ; = = = ? A B C D E F G H J K L M O Q Q Q R T U U U U U V V V V V P�`iQ �T v �T �T �})MQ �T v �T U �/Q U v 0U NU ,��UQ NU v hU �U ��CQ �U v �U �U ��[Q �U v �U �U �p� Q �U v �U �U Y�`iQ �U v �U �U 'Q �U v V V ,h�Q V v V ;V � �Q ;V v PV ^V ^G%(Q ^V v �V �V ^�`iQ �V v �V �V ӟ�Q �V v �V �V ��oQ �V v W W m�U�Q W v (W -W }�e�Q -W v @W EW �rr�Q EW v `W wW 3�u�Q wW v �W �W i� ^Q �W v �W �W b�`iQ �W v �W �W �I� Q �W v �W X �� Q X v (X xX &��Q xX v �X �X N<�Q �X v �X �X '��Q �X v �X �X ]��<Q �X v �X �X (��Q �X v Y Y )��Q Y v (Y -Y � e�Q -Y v @Y gY ]�Q gY v �Y �Y *��Q �Y v �Y �Y +��Q �Y v �Y �Y W|�rQ �Y v Z 1Z ,��Q 1Z v HZ MZ /^b�Q MZ v XZ fZ t���Q fZ v xZ �Z -��Q �Z v �Z �Z .��Q �Z v �Z �Z �Gz=Q �Z v �Z ,[ �`�RQ ,[ v 8[ =[ �}~ ����=[ v H[ m[ ���Q m[ v �[ �[ ���mQ �[ v �[ �[ D���Q �[ v �[ \ ��Q \ v \ *\ �/Q *\ v @\ E\ �/Q E\ v `\ e\ W�@Q e\ v x\ }\ �/Q }\ v �\ �\ ��lcQ �\ v �\ �\ �.�Q �\ v �\ ] � x�Q ] v ] ;] �3��Q ;] v P] U] [�;Q U] v `] n] ��Q n] v �] �] H���Q �] v �] �] ����Q �] v �] #^ [� FQ #^ v @^ E^ ��3�Q E^ v X^ s^ }�W�Q s^ v �^ �^ �$�$Q �^ v �^ �^ ��lcQ �^ v �^ �^ ��_Q �^ v �^ �^ Y��_Q �^ v _ !_ �ir�Q !_ v 8_ =_ �ir�Q =_ v X_ ]_ �ir�Q ]_ v x_ }_ ���iQ }_ v �_ �_ ���iQ �_ v �_ �_ ���iQ �_ v �_ �_ ���iQ �_ v ` ` ���iQ ` v ` %` ��lcQ %` v 8` =` ���iQ =` v X` ]` ���iQ ]` v x` }` ���iQ }` v �` �` ���iQ �` v �` �` ��A8Q �` v �` �` 5���Q �` v �` �` FM��Q �` v a a ����a L a lb �d �Q lb v �b �b ��lcQ �b v �b �b 9�DQ �b v �b �b �� Q �b v �b �b {��Q �b v �b �b move-to-side-e (as)switch-input-source<Super>space XF86Keyboard (as)move-to-workspace-up <Control><Shift><Alt>Up (as)move-to-monitor-right <Super><Shift>Right (as)move-to-center (as)begin-move <Alt>F7 (as)move-to-workspace-last <Super><Shift>End (as)move-to-side-n (as)minimize <Super>h (as)unmaximize <Super>Down <Alt>F5 (as)panel-main-menu <Alt>F1 (as)switch-input-source-backward <Shift><Super>space <Shift>XF86Keyboard ( (as)move-to-side-s (as)switch-panels-backward <Shift><Control><Alt>Tab (as)always-on-top (as)show-desktop (as)toggle-shaded (as)switch-to-workspace-up <Control><Alt>Up (as)move-to-monitor-up <Super><Shift>Up (as)maximize <Super>Up (as)move-to-side-w (as)move-to-workspace-down <Control><Shift><Alt>Down (as)move-to-workspace-left <Super><Shift>Page_Up <Super><Shift><Alt>Left <Control><Shift><Alt>Left .H (as)move-to-workspace-1 <Super><Shift>Home (as)lower (as)move-to-workspace-2 (as)activate-window-menu <Alt>space (as)move-to-workspace-3 (as)move-to-workspace-4 (as)switch-group <Super>Above_Tab <Alt>Above_Tab (as)switch-group-backward <Shift><Super>Above_Tab <Shift><Alt>Above_Tab . (as)move-to-workspace-5 (as)move-to-workspace-6 (as)switch-applications-backward <Shift><Super>Tab <Shift><Alt>Tab " (as)move-to-workspace-7 (as)cycle-group<Alt>F6 (as)panel-run-dialog <Alt>F2 (as)move-to-workspace-8 (as)move-to-workspace-9 (as)move-to-workspace-right <Super><Shift>Page_Down <Super><Shift><Alt>Right <Control><Shift><Alt>Right 1L (as)toggle-above (as).path /org/gnome/desktop/wm/keybindings/ scycle-panels-backward <Shift><Control><Alt>Escape (as)cycle-windows-backward<Shift><Alt>Escape (as)switch-to-workspace-last <Super>End (as)cycle-windows <Alt>Escape (as)move-to-workspace-10 (as)move-to-workspace-11 (as)switch-windows (as)move-to-workspace-12 (as)move-to-corner-se (as)switch-to-workspace-right <Super>Page_Down <Super><Alt>Right <Control><Alt>Right #7 (as)cycle-panels <Control><Alt>Escape (as)maximize-horizontally (as)close <Alt>F4 (as)switch-panels <Control><Alt>Tab (as)switch-to-workspace-down<Control><Alt>Down (as)switch-to-workspace-left <Super>Page_Up <Super><Alt>Left <Control><Alt>Left 3 (as)switch-windows-backward (as)switch-applications<Super>Tab <Alt>Tab (as)raise-or-lower (as)toggle-fullscreen (as)move-to-corner-ne (as)move-to-monitor-down <Super><Shift>Down (as)move-to-monitor-left <Super><Shift>Left (as)switch-to-workspace-10 (as)switch-to-workspace-11 (as)switch-to-workspace-12 (as)switch-to-workspace-1 <Super>Home (as)switch-to-workspace-2 (as)switch-to-workspace-3 (as)switch-to-workspace-4 (as)switch-to-workspace-5 (as)move-to-corner-sw (as)switch-to-workspace-6 (as)switch-to-workspace-7 (as)switch-to-workspace-8 (as)switch-to-workspace-9 (as)begin-resize <Alt>F8 (as)set-spew-mark (as)toggle-on-all-workspaces (as) N 6 # V 4 * - + 5 R > S 2 I ? @ . / 1 " % & ' $ T < O ; ! 7 D A B C E F G H J K L M 8 , 9 3 0 : ( = U P maximize-vertically (as)move-to-corner-nw (as)raise (as)toggle-maximized <Alt>F10 (as)cycle-group-backward <Shift><Alt>F6 (as)org.gnome.desktop.app-folders ( �}~ ����xc v �c �c �����c L �c �c 1�w �c v �c �c .path /org/gnome/desktop/app-folders/ s folder-children (as)org.gnome.desktop.interface (, ! " # # # $ & & & ' ' ( * * + :� �h v �h �h ��� �h v �h �h �ŷ� �h v i Vi nz� Vi v hi mi "i� mi v �i �i �Ν �i v �i �i �*|� �i v �i �i 4�/� �i v �i �i 4�d �i v �i j Υ j v j %j !|�\ %j v 8j =j �D� =j v Pj �j v�� �j v �j �j ��� �j v �j �j �8�� �j v �j �j ���a �j v k 6k ����6k L 8k �k �G�� �k v �k �k ��� �k v l l �m� l v (l -l ���� -l v @l �l ��� �l v �l �l ~� �l v m m J��P m v m m f-�� m v 8m Em �y� Em v Xm dm [��� dm v xm }m �t�� }m v �m )n yS� )n v @n En ��'< En v Xn ]n ��{ ]n v hn tn D�?� tn v �n �n ��jy �n v �n �n � �# �n v �n �n � �n v o o ��· o v (o 4o �ɴ� 4o v Ho Mo R��l Mo v `o ho �� ho v �o �o �� �o v �o �o �}~ �����o v �o �o @ׂ �o v �o �o � � �o v p p k�w� p v 0p 5p monospace-font-name Source Code Pro 10 (s)font-nameCantarell 11 (s)font-rgba-orderrgb e �rgba � �rgb � �bgr � �vrgb � �vbgr � (s(yau))avatar-directories (as)can-change-accels (b)enable-animations (b)gtk-im-module (s)menubar-accel F10 (s)cursor-blink-timeout r ��� (i(y(ii)))gtk-im-status-style callback (s)overlay-scrolling (b)font-antialiasing grayscale e �none � �grayscale � �rgba � (s(yau))document-font-name Cantarell 11 (s)toolbar-detachable (b)gtk-timeout-initial� (i)toolbar-icons-size large e �small � �large � (s(yau)) ' ) & ! * # " + $ % clock-show-weekday (b)cursor-size (i)toolkit-accessibility (b)toolbar-style both-horiz e �both � �both-horiz � �icons � �text � (s(yau))font-hinting slight e �none � �slight � �medium � �full � (s(yau))gtk-timeout-repeat (i)clock-show-date (b)gtk-im-preedit-style callback (s)cursor-theme Adwaita (s)clock-show-seconds (b)gtk-color-palette black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90 (s)show-battery-percentage (b)menubar-detachable (b)gtk-theme Adwaita (s)text-scaling-factor �?r �? @ (d(y(dd)))cursor-blink-time � r d � (i(y(ii)))gtk-color-scheme (s)icon-theme Adwaita (s)gtk-key-theme Default (s)menus-have-tearoff (b)scaling-factor (u)enable-hot-corners (b)clock-format 24h e �24h � �12h � (s(yau)).path /org/gnome/desktop/interface/ scursor-blink (b)gtk-enable-primary-paste (b)locate-pointer (b)org.gnome.desktop.thumbnail-cache ( �}~ �����p v �p �p �����p L q q �p� q v q q �vw, q v 0q 8q .path /org/gnome/desktop/thumbnail-cache/ s maximum-age � (i)maximum-size (i)org.gnome.desktop.wm.preferences ( �ٛ� �s v �s �s �7� �s v �s �s �>e �s v t t � ʄ t v (t -t �l -t v 8t Dt �'� Dt v `t lt %U�1 lt v �t �u d6�� �u v �u �u '�& �u v �u �u �� �u v v Sw �@�~ Sw v hw �w @��8 �w v �w �w �����w L �w �w �^� �w v x x ԓ4 x v 0x bx _� � bx v �x �x Ԑ� �x v �x y �ƥ� y v 0y kz �Y� kz v xz �z �}~ �����z v �z �z ?\!� �z v �z �z �m#� �z v { { visual-bell (b)workspace-names (as)resize-with-right-button (b)raise-on-click (b)theme Adwaita (s)mouse-button-modifier <Super> (s)action-right-click-titlebar menu e �toggle-shade � �toggle-maximize � �toggle-maximize-horizontally � �toggle-maximize-vertically � �minimize � �none � �lower � �menu � �toggle_shade � �toggle_maximize � �toggle_maximize_horizontally � �toggle_maximize_vertically � (s(yau))num-workspaces r $ (i(y(ii)))audible-bell (b)action-middle-click-titlebar none e �toggle-shade � �toggle-maximize � �toggle-maximize-horizontally � �toggle-maximize-vertically � �minimize � �none � �lower � �menu � �toggle_shade � �toggle_maximize � �toggle_maximize_horizontally � �toggle_maximize_vertically � (s(yau))auto-raise-delay � r ' (i(y(ii)))titlebar-fontCantarell Bold 11 (s) button-layout appmenu:close (s)focus-new-windows smart e �smart � �strict � (s(yau))titlebar-uses-system-font (b)visual-bell-type fullscreen-flash e �fullscreen-flash � �frame-flash � �fullscreen � �frame_flash � (s(yau))action-double-click-titlebar toggle-maximize e �toggle-shade � �toggle-maximize � �toggle-maximize-horizontally � �toggle-maximize-vertically � �minimize � �none � �lower � �menu � �toggle_shade � �toggle_maximize � �toggle_maximize_horizontally � �toggle_maximize_vertically � (s(yau))focus-mode click e �click � �sloppy � �mouse � (s(yau)).path /org/gnome/desktop/wm/preferences/ sauto-raise (b)disable-workarounds (b)org.gnome.system.location ( �}~ �����{ v �{ �{ �]� �{ v �{ :| ��#j :| v H| M| ����M| L P| X| .path /org/gnome/system/location/ smax-accuracy-levelexact e �country � �city � �neighborhood � �street � �exact � (s(yau))enabled (b) org.gnome.desktop.sound ( ��r( } v @} E} 8 E} v `} e} ���H e} v p} �} �}~ �����} v �} �} �3q �} v �} �} �����} L �} �} allow-volume-above-100-percent (b)input-feedback-sounds (b)theme-name freedesktop (s).path /org/gnome/desktop/sound/ sevent-sounds (b) org.gnome.desktop.peripherals.trackball ( �m�J �~ v �~ �~ �� �~ v �~ �~ [�� �~ v R �}~ ����R v X � ��� � " v � � ����� L � � scroll-wheel-emulation-button r (i(y(ii)))middle-click-emulation (b)accel-profile default e �default � �flat � �adaptive � (s(yau)).path /org/gnome/desktop/peripherals/trackball/ sscroll-wheel-emulation-button-lock (b) org.gnome.system.locale ( �) 4� v @� E� �}~ ����E� v P� b� ����b� L d� h� region (s).path /system/locale/ s org.gtk.Settings.EmojiChooser ( �}~ ����� v � � ����� L � � g � � v (� 5� .path /org/gtk/settings/emoji-chooser/ s recent-emoji (a((auss)u))org.gtk.Settings.Debug ( �}~ ����ā v Ё � ����� L � � ��>� � v � � 1�� � v (� -� .path /org/gtk/settings/debug/ s enable-inspector-keybinding (b)inspector-warning (b)org.gnome.desktop.notifications.application ( jj� @� v P� U� � �@ U� v h� m� 2/5� m� v �� �� � �� �� v �� �� �su� �� v �� �� �v�S �� v ȃ ̓ �i/� ̓ v � � ����� L � � force-expanded (b)enable-sound-alerts (b)details-in-lock-screen (b)application-id (s)enable (b)show-banners (b)show-in-lock-screen (b) org.gnome.system.proxy.https ( �}~ ������ v �� �� ������ L �� �� Ja�| �� v Ȅ � c��| � v � � .path /system/proxy/https/ s port r �� (i(y(ii)))host (s)org.gnome.desktop.session ( �}~ ������ v �� �� ������ L �� �� �Bb� �� v �� ȅ ���c ȅ v � .path /org/gnome/desktop/session/ s idle-delay , (u)session-name gnome (s)org.gnome.desktop.a11y.keyboard ( W��� t� v �� �� ��V� �� v �� �� ��'� �� v �� �� g�o �� v Ј Ո I��� Ո v � � ,K�� � v � � �gUZ � v (� 0� b�B� 0� v @� H� �ƧG H� v h� m� � �� m� v �� �� ������ L �� � {C<; � v �� � �}~ ���� � v � ,� �C�� ,� v H� M� �{� M� v h� m� +a�� m� v �� �� ��JF �� v �� �� ��� �� v �� �� PT� �� v ؊ ݊ �su� ݊ v � � ̤�* � v � � �� � v � � togglekeys-enable (b)mousekeys-enable (b)disable-timeout � (i)timeout-enable (b)slowkeys-beep-press (b)slowkeys-beep-accept (b)mousekeys-init-delay , (i)slowkeys-delay , (i)feature-state-change-beep (b)stickykeys-modifier-beep (b) mousekeys-max-speed (i).path /org/gnome/desktop/a11y/keyboard/ sstickykeys-two-key-off (b)slowkeys-beep-reject (b)mousekeys-accel-time , (i)bouncekeys-delay, (i)slowkeys-enable (b)bouncekeys-beep-reject (b)enable (b)stickykeys-enable (b)bouncekeys-enable (b)org.freedesktop.Tracker3.FTS ( �|X� � v � � X� � v � � 6�� � v 0� 5� �]|� 5� v H� M� �}~ ����M� v X� x� ����x� L x� �� enable-unaccent (b)ignore-stop-words (b)enable-stemmer (b)ignore-numbers (b).path /org/freedesktop/tracker/fts/ s / . 2 ! " 5 + 6 3 1 ' - & # $ ( % , * ) 4 org.gnome.desktop.peripherals.touchpad ( a~ɿ 4� v @� z� �'_ z� v �� �� 5� �� v �� �� �}~ ������ v ȏ � �G8� � v � F� X��� F� v X� ]� �r�? ]� v h� �ҭ� v ؐ ݐ M�, ݐ v � �� ������ L �� ,� �vzr ,� v H� M� ��ao M� v h� m� ٖy� m� v �� Α K �9 Α v � � �� � v � � left-handed mouse e �right � �left � �mouse � (s(yau))speed r � �? (d(y(dd)))tap-and-drag (b).path /org/gnome/desktop/peripherals/touchpad/ stap-button-map default e �default � �lrm � �lmr � (s(yau))natural-scroll (b)send-eventsenabled e �enabled � �disabled � �disabled-on-external-mouse � (s(yau))disable-while-typing (b)tap-to-click (b) two-finger-scrolling-enabled (b)edge-scrolling-enabled (b)click-method fingers e �default � �none � �areas � �fingers � (s(yau))tap-and-drag-lock (b)middle-click-emulation (b)org.gnome.desktop.a11y.mouse ( �\�� �� v �� �� �ȧ �� v ؓ ݓ �a ݓ v � 6� 8� t 6� v P� �� �}~ ������ v �� �� ׯ�� �� v Д ؔ 1�Q ؔ v � 2� �|� 2� v H� M� y��� M� v X� d� /ӊ� d� v p� �� �J�e �� v �� ŕ �'� ŕ v � &� ����&� L (� T� secondary-click-time 333333�? (d)secondary-click-enabled (b)dwell-gesture-drag down e �left � �right � �up � �down � (s(yau))dwell-gesture-single left e �left � �right � �up � �down � (s(yau)).path /org/gnome/desktop/a11y/mouse/ sdwell-threshold (i)dwell-gesture-double up e �left � �right � �up � �down � (s(yau))dwell-click-enabled (b)dwell-time 333333�? (d)dwell-mode window e �window � �gesture � (s(yau))click-type-window-visible (b)dwell-gesture-secondary right e �left � �right � �up � �down � (s(yau)) org.gnome.desktop.peripherals.tablet.pad-button ( I�� � v � �� Md� �� v � Z� ����Z� L \� d� keybinding (s)action none e �none � �help � �switch-monitor � �keybinding � (s(yau)) org.gtk.Settings.FileChooser ( �"Cp �� v �� ��S v ؙ ݙ P5[Q ݙ v � 2� �� 2� v H� M� ١ M� v X� �� �"O �� v �� �� �� �� v �� � ���� � v � :� �Z :� v H� M� ߄� M� v `� o� �}~ ����o� v x� �� �Ā� �� v �� �� '� �� v �� � ���b � v � '� ��7� '� v @� E� vb' E� v P� �� �O� �� v �� �� ������ L �� � startup-mode recent e �recent � �cwd � (s(yau))last-folder-uri (s)location-mode path-bar e �path-bar � �filename-entry � (s(yau))show-size-column (b)date-formatregular e �regular � �with-time � (s(yau))show-hidden (b)clock-format 24h e �24h � �12h � (s(yau))type-format category e �mime � �description � �category � (s(yau))expand-folders (b)window-position �������� ((ii)).path /org/gtk/settings/file-chooser/ ssidebar-width � (i)sort-column name e �name � �size � �type � �modified � (s(yau))window-size �������� ((ii))sort-directories-first (b)sort-order ascending e �ascending � �descending � (s(yau))show-type-column (b) org.gnome.desktop.media-handling ( HS�0 � v � � �}~ ����� v � E� ���! E� v X� ]� �t�k ]� v p� u� q�� u� v �� �� ɳ#1 �� v �� ۞ ��� ۞ v �� �� ������ L � � autorun-x-content-open-folder (as).path /org/gnome/desktop/media-handling/ sautomount-open (b)autorun-never (b)automount (b)autorun-x-content-start-appx-content/unix-software x-content/ostree-repository 4 (as)autorun-x-content-ignore (as) org.gnome.desktop.peripherals.keyboard ( x!.� � v � (� hd (� v @� E� �}~ ����E� v P� {� 4�I {� v �� �� ������ L �� �� ̣U� �� v �� �� f�- �� v �� Š repeat-interval (u)remember-numlock-state (b).path /org/gnome/desktop/peripherals/keyboard/ sdelay� (u) numlock-state (b)repeat (b) schemas/org.gnome.desktop.app-folders.gschema.xml 0000644 00000003461 15125157507 0016111 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.app-folders" path="/org/gnome/desktop/app-folders/"> <key name="folder-children" type="as"> <default>[]</default> <summary>Folder children</summary> <description>List of relative settings paths at which app-folders are stored. Each folder uses the org.gnome.desktop.app-folders.folder schema.</description> </key> </schema> <schema id="org.gnome.desktop.app-folders.folder"> <key name="name" type="s"> <default>''</default> <summary>Folder name</summary> <description>The name of the application folder.</description> </key> <key name="translate" type="b"> <default>false</default> <summary>Translate the name</summary> <description>Whether the name key is a filename to be looked up in /usr/share/desktop-directories.</description> </key> <key name="apps" type="as"> <default>[]</default> <summary>Applications</summary> <description>The list of IDs of applications that are explicitly included in this folder.</description> </key> <key name="categories" type="as"> <default>[]</default> <summary>Categories</summary> <description>A list of categories for which apps will be placed into this folder by default, in addition to the apps that are listed in the apps key.</description> </key> <key name="excluded-apps" type="as"> <default>[]</default> <summary>Excluded applications</summary> <description>A list of IDs of applications that are excluded from this folder. This can be used to remove applications that would otherwise be included by category.</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.wm.preferences.gschema.xml 0000644 00000031154 15125157507 0016620 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.wm.preferences" path="/org/gnome/desktop/wm/preferences/"> <key name="mouse-button-modifier" type="s"> <default><![CDATA['<Super>']]></default> <summary>Modifier to use for modified window click actions</summary> <description> Clicking a window while holding down this modifier key will move the window (left click), resize the window (middle click), or show the window menu (right click). The middle and right click operations may be swapped using the “resize-with-right-button” key. Modifier is expressed as <![CDATA[“<Alt>”]]> or <![CDATA[“<Super>”]]> for example. </description> </key> <key name="resize-with-right-button" type="b"> <default>false</default> <summary>Whether to resize with the right button</summary> <description> Set this to true to resize with the right button and show a menu with the middle button while holding down the key given in “mouse-button-modifier”; set it to false to make it work the opposite way around. </description> </key> <key name="button-layout" type="s"> <default>'appmenu:close'</default> <summary>Arrangement of buttons on the titlebar</summary> <description> Arrangement of buttons on the titlebar. The value should be a string, such as “menu:minimize,maximize,spacer,close”; the colon separates the left corner of the window from the right corner, and the button names are comma-separated. Duplicate buttons are not allowed. Unknown button names are silently ignored so that buttons can be added in future metacity versions without breaking older versions. A special spacer tag can be used to insert some space between two adjacent buttons. </description> </key> <key name="focus-mode" enum="org.gnome.desktop.GDesktopFocusMode"> <default>'click'</default> <summary>Window focus mode</summary> <description> The window focus mode indicates how windows are activated. It has three possible values; “click” means windows must be clicked in order to focus them, “sloppy” means windows are focused when the mouse enters the window, and “mouse” means windows are focused when the mouse enters the window and unfocused when the mouse leaves the window. </description> </key> <key name="focus-new-windows" enum="org.gnome.desktop.GDesktopFocusNewWindows"> <default>'smart'</default> <summary>Control how new windows get focus</summary> <description> This option provides additional control over how newly created windows get focus. It has two possible values; “smart” applies the user’s normal focus mode, and “strict” results in windows started from a terminal not being given focus. </description> </key> <key name="raise-on-click" type="b"> <default>true</default> <summary> Whether windows should be raised when their client area is clicked </summary> <description> The default, true, indicates that a window will be raised whenever its client area or its frame is clicked. Setting this to false means that a window will not be raised if it is clicked on the client area. To raise it, one can click anywhere in the window’s frame, or Super-click on any part of the window. This mode is useful if one uses many overlapping windows. </description> </key> <key name="action-double-click-titlebar" enum="org.gnome.desktop.GDesktopTitlebarAction"> <default>'toggle-maximize'</default> <summary>Action on title bar double-click</summary> <description> This option determines the effects of double-clicking on the title bar. Current valid options are “toggle-shade”, which will shade/unshade the window, “toggle-maximize” which will maximize/unmaximize the window, “toggle-maximize-horizontally” and “toggle-maximize-vertically” which will maximize/unmaximize the window in that direction only, “minimize” which will minimize the window, “shade” which will roll the window up, “menu” which will display the window menu, “lower” which will put the window behind all the others, and “none” which will not do anything. </description> <!-- For compatibility with GConf strings (Metacity 2.30) --> <aliases> <alias value="toggle_shade" target="toggle-shade"/> <alias value="toggle_maximize" target="toggle-maximize"/> <alias value="toggle_maximize_horizontally" target="toggle-maximize-horizontally"/> <alias value="toggle_maximize_vertically" target="toggle-maximize-vertically"/> </aliases> </key> <key name="action-middle-click-titlebar" enum="org.gnome.desktop.GDesktopTitlebarAction"> <default>'none'</default> <summary>Action on title bar middle-click</summary> <description> This option determines the effects of middle-clicking on the title bar. Current valid options are “toggle-shade”, which will shade/unshade the window, “toggle-maximize” which will maximize/unmaximize the window, “toggle-maximize-horizontally” and “toggle-maximize-vertically” which will maximize/unmaximize the window in that direction only, “minimize” which will minimize the window, “shade” which will roll the window up, “menu” which will display the window menu, “lower” which will put the window behind all the others, and “none” which will not do anything. </description> <!-- For compatibility with GConf strings (Metacity 2.30) --> <aliases> <alias value="toggle_shade" target="toggle-shade"/> <alias value="toggle_maximize" target="toggle-maximize"/> <alias value="toggle_maximize_horizontally" target="toggle-maximize-horizontally"/> <alias value="toggle_maximize_vertically" target="toggle-maximize-vertically"/> </aliases> </key> <key name="action-right-click-titlebar" enum="org.gnome.desktop.GDesktopTitlebarAction"> <default>'menu'</default> <summary>Action on title bar right-click</summary> <description> This option determines the effects of right-clicking on the title bar. Current valid options are “toggle-shade”, which will shade/unshade the window, “toggle-maximize” which will maximize/unmaximize the window, “toggle-maximize-horizontally” and “toggle-maximize-vertically” which will maximize/unmaximize the window in that direction only, “minimize” which will minimize the window, “shade” which will roll the window up, “menu” which will display the window menu, “lower” which will put the window behind all the others, and “none” which will not do anything. </description> <!-- For compatibility with GConf strings (Metacity 2.30) --> <aliases> <alias value="toggle_shade" target="toggle-shade"/> <alias value="toggle_maximize" target="toggle-maximize"/> <alias value="toggle_maximize_horizontally" target="toggle-maximize-horizontally"/> <alias value="toggle_maximize_vertically" target="toggle-maximize-vertically"/> </aliases> </key> <key name="auto-raise" type="b"> <default>false</default> <summary>Automatically raises the focused window</summary> <description> If set to true, and the focus mode is either “sloppy” or “mouse” then the focused window will be automatically raised after a delay specified by the auto-raise-delay key. This is not related to clicking on a window to raise it, nor to entering a window during drag-and-drop. </description> </key> <key name="auto-raise-delay" type="i"> <range min="0" max="10000"/> <default>500</default> <summary>Delay in milliseconds for the auto raise option</summary> <description> The time delay before raising a window if auto-raise is set to true. The delay is given in thousandths of a second. </description> </key> <key name="theme" type="s"> <default>'Adwaita'</default> <summary>Current theme</summary> <description> The theme determines the appearance of window borders, titlebar, and so forth. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="titlebar-uses-system-font" type="b"> <default>true</default> <summary>Use standard system font in window titles</summary> <description> If true, ignore the titlebar-font option, and use the standard application font for window titles. </description> </key> <key name="titlebar-font" type="s"> <default>'Cantarell Bold 11'</default> <summary>Window title font</summary> <description> A font description string describing a font for window titlebars. The size from the description will only be used if the titlebar-font-size option is set to 0. Also, this option is disabled if the titlebar-uses-desktop-font option is set to true. </description> </key> <key name="num-workspaces" type="i"> <default>4</default> <range min="1" max="36"/> <summary>Number of workspaces</summary> <description> Number of workspaces. Must be more than zero, and has a fixed maximum to prevent making the desktop unusable by accidentally asking for too many workspaces. </description> </key> <key name="audible-bell" type="b"> <default>true</default> <summary>System Bell is Audible</summary> <description> Determines whether applications or the system can generate audible “beeps”; may be used in conjunction with “visual bell” to allow silent “beeps”. </description> </key> <key name="visual-bell" type="b"> <default>false</default> <summary>Enable Visual Bell</summary> <description> Turns on a visual indication when an application or the system issues a “bell” or “beep”; useful for the hard-of-hearing and for use in noisy environments. </description> </key> <key name="visual-bell-type" enum="org.gnome.desktop.GDesktopVisualBellType"> <default>'fullscreen-flash'</default> <summary>Visual Bell Type</summary> <description> Tells the WM how to implement the visual indication that the system bell or another application “bell” indicator has been rung. Currently there are two valid values, “fullscreen-flash”, which causes a fullscreen white-black flash, and “frame-flash” which causes the titlebar of the application which sent the bell signal to flash. If the application which sent the bell is unknown (as is usually the case for the default “system beep”), the currently focused window’s titlebar is flashed. </description> <!-- For compatibility with GConf strings (Metacity 2.30) --> <aliases> <alias value="fullscreen" target="fullscreen-flash"/> <alias value="frame_flash" target="frame-flash"/> </aliases> </key> <key name="disable-workarounds" type="b"> <default>false</default> <summary> Disable misfeatures that are required by old or broken applications </summary> <description> Some applications disregard specifications in ways that result in window manager misfeatures. This option puts the WM in a rigorously correct mode, which gives a more consistent user interface, provided one does not need to run any misbehaving applications. </description> </key> <key name="workspace-names" type="as"> <default>[]</default> <summary>The names of the workspaces</summary> <description> Defines the names that should be assigned to workspaces. If the list is too long for the current number of workspaces, names in excess will be ignored. If the list is too short, or includes empty names, missing values will be replaced with the default (“Workspace N”). </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.default-applications.gschema.xml 0000644 00000006024 15125157507 0020003 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.default-applications" path="/org/gnome/desktop/applications/"> <child name="office" schema="org.gnome.desktop.default-applications.office"/> <child name="terminal" schema="org.gnome.desktop.default-applications.terminal"/> </schema> <schema id="org.gnome.desktop.default-applications.office" path="/org/gnome/desktop/applications/office/"> <child name="calendar" schema="org.gnome.desktop.default-applications.office.calendar"/> <child name="tasks" schema="org.gnome.desktop.default-applications.office.tasks"/> </schema> <schema id="org.gnome.desktop.default-applications.office.calendar" path="/org/gnome/desktop/applications/office/calendar/"> <key name="exec" type="s"> <default>'evolution -c calendar'</default> <summary>Default calendar</summary> <description> Default calendar application DEPRECATED: This key is deprecated and ignored. The preferred calendar application is the application handling the text/calendar mime type. </description> </key> <key name="needs-term" type="b"> <default>false</default> <summary>Calendar needs terminal</summary> <description> Whether the default calendar application needs a terminal to run. DEPRECATED: This key is deprecated and ignored. The preferred calendar application is the application handling the text/calendar mime type, whether it needs a terminal is taken from its desktop file. </description> </key> </schema> <schema id="org.gnome.desktop.default-applications.office.tasks" path="/org/gnome/desktop/applications/office/tasks/"> <key name="exec" type="s"> <default>'evolution -c tasks'</default> <summary>Default tasks</summary> <description> Default tasks application. </description> </key> <key name="needs-term" type="b"> <default>false</default> <summary>Tasks needs terminal</summary> <description> Whether the default tasks application needs a terminal to run. </description> </key> </schema> <schema id="org.gnome.desktop.default-applications.terminal" path="/org/gnome/desktop/applications/terminal/"> <key name="exec" type="s"> <default>'gnome-terminal'</default> <summary>Terminal application</summary> <description> Terminal program to use when starting applications that require one. DEPRECATED: This key is deprecated and ignored. The default terminal is handled in GIO. </description> </key> <key name="exec-arg" type="s"> <default>'-x'</default> <summary>Exec Arguments</summary> <description> Argument used to execute programs in the terminal defined by the “exec” key. DEPRECATED: This key is deprecated and ignored. The default terminal and how to invoke it is handled in GIO. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.a11y.magnifier.gschema.xml 0000644 00000022244 15125157507 0016410 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.a11y.magnifier" path="/org/gnome/desktop/a11y/magnifier/"> <key name="mouse-tracking" enum="org.gnome.desktop.GDesktopMagnifierMouseTrackingMode"> <default>'proportional'</default> <summary>Mouse Tracking Mode</summary> <description> Determines the position of the magnified mouse image within the magnified view and how it reacts to system mouse movement. The values are • none: no mouse tracking; • centered: the mouse image is displayed at the center of the zoom region (which also represents the point under the system mouse) and the magnified contents are scrolled as the system mouse moves; • proportional: the position of the magnified mouse in the zoom region is proportionally the same as the position of the system mouse on screen; • push: when the magnified mouse intersects a boundary of the zoom region, the contents are scrolled into view. </description> </key> <key name="focus-tracking" enum="org.gnome.desktop.GDesktopMagnifierFocusTrackingMode"> <default>'proportional'</default> <summary>Focus Tracking Mode</summary> <description> Determines the position of the focused widget within magnified view. The values are: • none: no focus tracking • centered: the focused image is displayed at the center of the zoom region (which also represents the point under the system focus) and the magnified contents are scrolled as the system focus moves • proportional: the position of the magnified focus in the zoom region is proportionally the same as the position of the system focus on screen • push: when the magnified focus intersects a boundary of the zoom region, the contents are scrolled into view </description> </key> <key name="caret-tracking" enum="org.gnome.desktop.GDesktopMagnifierCaretTrackingMode"> <default>'centered'</default> <summary>Caret Tracking Mode</summary> <description> Determines the position of the caret within magnified view. The values are: • none: no caret tracking • centered: the image of the caret is displayed at the center of the zoom region (which also represents the point under the system caret) and the magnified contents are scrolled as the system caret moves • proportional: the position of the magnified caret in the zoom region is proportionally the same as the position of the system caret on screen • push: when the magnified caret intersects a boundary of the zoom region, the contents are scrolled into view </description> </key> <key name="screen-position" enum="org.gnome.desktop.GDesktopMagnifierScreenPosition"> <default>'full-screen'</default> <summary>Screen position</summary> <description> The magnified view either fills the entire screen, or occupies the top-half, bottom-half, left-half, or right-half of the screen. </description> </key> <key name="mag-factor" type="d"> <default>2.0</default> <range min="0.1" max="32.0"/> <summary>Magnification factor</summary> <description> The power of the magnification. A value of 1.0 means no magnification. A value of 2.0 doubles the size. </description> </key> <key name="lens-mode" type="b"> <default>false</default> <summary>Enable lens mode</summary> <description> Whether the magnified view should be centered over the location of the system mouse and move with it. </description> </key> <key name="scroll-at-edges" type="b"> <default>false</default> <summary> Scroll magnified contents beyond the edges of the desktop </summary> <description> For centered mouse tracking, when the system pointer is at or near the edge of the screen, the magnified contents continue to scroll such that the screen edge moves into the magnified view. </description> </key> <!-- Cross-hairs --> <key name="show-cross-hairs" type="b"> <default>false</default> <summary>Show or hide crosshairs</summary> <description> Enables/disables display of crosshairs centered on the magnified mouse sprite. </description> </key> <key name="cross-hairs-thickness" type="i"> <default>8</default> <summary>Thickness of the crosshairs in pixels</summary> <description> Width in pixels of the vertical and horizontal lines that make up the crosshairs. </description> </key> <key name="cross-hairs-color" type="s"> <default>'#ff0000'</default> <summary>Color of the crosshairs</summary> <description> The color of the the vertical and horizontal lines that make up the crosshairs. </description> </key> <key name="cross-hairs-opacity" type="d"> <default>0.66</default> <range min="0.0" max="1.0"/> <summary>Opacity of the crosshairs</summary> <description> Determines the transparency of the crosshairs, from fully opaque to fully transparent. </description> </key> <key name="cross-hairs-length" type="i"> <default>4096</default> <range min="20" max="4096"/> <summary>Length of the crosshairs in pixels</summary> <description> Determines the length in pixels of the vertical and horizontal lines that make up the crosshairs. </description> </key> <key name="cross-hairs-clip" type="b"> <default>false</default> <summary>Clip the crosshairs at the center</summary> <description> Determines whether the crosshairs intersect the magnified mouse sprite, or are clipped such that the ends of the horizontal and vertical lines surround the mouse image. </description> </key> <key name="invert-lightness" type="b"> <default>false</default> <summary>Inverse lightness</summary> <description> Determines whether the lightness values are inverted: darker colors become lighter and vice versa, and white and black are interchanged. </description> </key> <key name="color-saturation" type="d"> <default>1.0</default> <range min="0.0" max="1.0"/> <summary>Color Saturation</summary> <description> Represents a change to the color saturation, from 0.0 (grayscale) to 1.0 (full color). </description> </key> <key name="brightness-red" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change brightness of red</summary> <description> Represents a change to the default brightness of the red component. Zero indicates no change, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> <key name="brightness-green" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change brightness of green</summary> <description> Represents a change to the default brightness for the green component. Zero indicates no change, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> <key name="brightness-blue" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change brightness of blue</summary> <description> Represents a change to the default brightness for the blue component. Zero indicates no change, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> <key name="contrast-red" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change contrast of red</summary> <description> Represents a change to the default contrast of the red component. Zero indicates no change in contrast, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> <key name="contrast-green" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change contrast of green</summary> <description> Represents a change to the default contrast of the green component. Zero indicates no change in contrast, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> <key name="contrast-blue" type="d"> <default>0.0</default> <range min="-1.0" max="1.0"/> <summary>Change contrast of blue</summary> <description> Represents a change to the default contrast of the blue component. Zero indicates no change in contrast, values less than zero indicate a decrease, and values greater than zero indicate an increase. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.lockdown.gschema.xml 0000644 00000006576 15125157507 0015527 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.lockdown" path="/org/gnome/desktop/lockdown/"> <key name="disable-command-line" type="b"> <default>false</default> <summary>Disable command line</summary> <description> Prevent the user from accessing the terminal or specifying a command line to be executed. For example, this would disable access to the panel’s “Run Application” dialog. </description> </key> <key name="disable-save-to-disk" type="b"> <default>false</default> <summary>Disable saving files to disk</summary> <description> Prevent the user from saving files to disk. For example, this would disable access to all applications’ “Save as” dialogs. </description> </key> <key name="disable-printing" type="b"> <default>false</default> <summary>Disable printing</summary> <description> Prevent the user from printing. For example, this would disable access to all applications’ “Print” dialogs. </description> </key> <key name="disable-print-setup" type="b"> <default>false</default> <summary>Disable print setup</summary> <description> Prevent the user from modifying print settings. For example, this would disable access to all applications’ “Print Setup” dialogs. </description> </key> <key name="disable-user-switching" type="b"> <default>false</default> <summary>Disable user switching</summary> <description> Prevent the user from switching to another account while his session is active. </description> </key> <key name="disable-lock-screen" type="b"> <default>false</default> <summary>Disable lock screen</summary> <description> Prevent the user to lock his screen. </description> </key> <key name="disable-application-handlers" type="b"> <default>false</default> <summary>Disable URL and MIME type handlers</summary> <description> Prevent running any URL or MIME type handler applications. </description> </key> <key name="disable-log-out" type="b"> <default>false</default> <summary>Disable log out</summary> <description> Prevent the user from logging out. </description> </key> <key name="user-administration-disabled" type="b"> <default>false</default> <summary>Disable user administration</summary> <description> Stop the user from modifying user accounts. By default, we allow adding and removing users, as well as changing other users settings. </description> </key> <key name="mount-removable-storage-devices-as-read-only" type="b"> <default>false</default> <summary>Mount removable storage devices as read-only</summary> <description> Prevent users from writing or modifying files on removable storage devices (i.e. flash disks, mobile phones, cameras). </description> </key> <key name="disable-show-password" type="b"> <default>false</default> <summary>Disable password showing</summary> <description> Disable the "Show Password" menu item in password entries. </description> </key> </schema> </schemalist> schemas/gschema.dtd 0000644 00000005544 15125157507 0010313 0 ustar 00 <!ELEMENT schemalist (schema|enum|flags)* > <!ATTLIST schemalist gettext-domain CDATA #IMPLIED > <!ELEMENT schema (key|child|override)* > <!ATTLIST schema id CDATA #REQUIRED path CDATA #IMPLIED gettext-domain CDATA #IMPLIED extends CDATA #IMPLIED list-of CDATA #IMPLIED > <!-- enumerated and flags types --> <!-- each value element maps a nick to a numeric value --> <!ELEMENT enum (value*) > <!ATTLIST enum id CDATA #REQUIRED > <!ELEMENT flags (value*) > <!ATTLIST flags id CDATA #REQUIRED > <!ELEMENT value EMPTY > <!-- nick must be at least 2 characters long --> <!-- value must be parsable as a 32-bit integer --> <!ATTLIST value nick CDATA #REQUIRED value CDATA #REQUIRED > <!ELEMENT key (default|summary?|description?|range?|choices?|aliases?)* > <!-- name can only contain lowercase letters, numbers and '-' --> <!-- type must be a GVariant type string --> <!-- enum must be the id of an enum type that has been defined earlier --> <!-- flags must be the id of a flags type that has been defined earlier --> <!-- exactly one of type, enum or flags must be given --> <!ATTLIST key name CDATA #REQUIRED type CDATA #IMPLIED enum CDATA #IMPLIED flags CDATA #IMPLIED > <!-- the default value is specified a a serialized GVariant, i.e. you have to include the quotes when specifying a string --> <!ELEMENT default (#PCDATA) > <!-- the presence of the l10n attribute marks a default value for translation, its value is the gettext category to use --> <!-- if context is present, it specifies msgctxt to use --> <!ATTLIST default l10n (messages|time) #IMPLIED context CDATA #IMPLIED > <!ELEMENT summary (#PCDATA) > <!ELEMENT description (#PCDATA) > <!-- range is only allowed for keys with numeric type --> <!ELEMENT range EMPTY > <!-- min and max must be parseable as values of the key type and min must be less than or equal to max --> <!ATTLIST range min CDATA #IMPLIED max CDATA #IMPLIED > <!-- choices is only allowed for keys with string or string array type --> <!ELEMENT choices (choice+) > <!-- each choice element specifies one possible value --> <!ELEMENT choice EMPTY > <!ATTLIST choice value CDATA #REQUIRED > <!-- aliases is only allowed for keys with enumerated type or with choices --> <!ELEMENT aliases (alias+) > <!-- each alias element specifies an alias for one of the possible values --> <!ELEMENT alias EMPTY > <!ATTLIST alias value CDATA #REQUIRED target CDATA #REQUIRED > <!ELEMENT child EMPTY > <!ATTLIST child name CDATA #REQUIRED schema CDATA #REQUIRED > <!ELEMENT override (#PCDATA) > <!ATTLIST override name CDATA #REQUIRED l10n CDATA #IMPLIED context CDATA #IMPLIED > schemas/org.gnome.desktop.session.gschema.xml 0000644 00000001234 15125157507 0015354 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.session" path="/org/gnome/desktop/session/"> <key name="idle-delay" type="u"> <default>300</default> <summary>Time before session is considered idle</summary> <description>The number of seconds of inactivity before the session is considered idle.</description> </key> <key name="session-name" type="s"> <default>"gnome"</default> <summary>Session type</summary> <description>The name of the session to use. Known value is “gnome”.</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.interface.gschema.xml 0000644 00000027562 15125157507 0015645 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.interface" path="/org/gnome/desktop/interface/"> <key name="toolkit-accessibility" type="b"> <default>false</default> <summary>Enable Toolkit Accessibility</summary> <description> Whether toolkits should load accessibility related modules. </description> </key> <key name="enable-animations" type="b"> <default>true</default> <summary>Enable Animations</summary> <description> Whether animations should be displayed. Note: This is a global key, it changes the behaviour of the window manager, the panel etc. </description> </key> <key name="menus-have-tearoff" type="b"> <default>false</default> <summary>Menus Have Tearoff</summary> <description> Whether menus should have a tearoff. </description> </key> <key name="can-change-accels" type="b"> <default>false</default> <summary>Can Change Accels</summary> <description> Whether the user can dynamically type a new accelerator when positioned over an active menuitem. </description> </key> <key name="toolbar-style" enum="org.gnome.desktop.GDesktopToolbarStyle"> <default>'both-horiz'</default> <summary>Toolbar Style</summary> <description> Toolbar Style. Valid values are “both”, “both-horiz”, “icons”, and “text”. </description> </key> <key name="menubar-detachable" type="b"> <default>false</default> <summary>Menubar Detachable</summary> <description> Whether the user can detach menubars and move them around. </description> </key> <key name="toolbar-detachable" type="b"> <default>false</default> <summary>Toolbar Detachable</summary> <description> Whether the user can detach toolbars and move them around. </description> </key> <key name="toolbar-icons-size" enum="org.gnome.desktop.GDesktopToolbarIconSize"> <default>'large'</default> <summary>Toolbar Icon Size</summary> <description> Size of icons in toolbars, either “small” or “large”. </description> </key> <key name="cursor-blink" type="b"> <default>true</default> <summary>Cursor Blink</summary> <description> Whether the cursor should blink. </description> </key> <key name="cursor-blink-time" type="i"> <range min="100" max="2500"/> <default>1200</default> <summary>Cursor Blink Time</summary> <description> Length of the cursor blink cycle, in milliseconds. </description> </key> <key name="cursor-blink-timeout" type="i"> <range min="1" max="2147483647"/> <default>10</default> <summary>Cursor Blink Timeout</summary> <description> Time after which the cursor stops blinking, in seconds. </description> </key> <key name="icon-theme" type="s"> <default>'Adwaita'</default> <summary>Icon Theme</summary> <description> Icon theme to use for the panel, nautilus etc. </description> </key> <key name="gtk-theme" type="s"> <default>'Adwaita'</default> <summary>Gtk+ Theme</summary> <description> Basename of the default theme used by gtk+. </description> </key> <key name="gtk-key-theme" type="s"> <default>'Default'</default> <summary>Gtk+ Keybinding Theme</summary> <description> Basename of the default keybinding theme used by gtk+. </description> </key> <key name="font-name" type="s"> <default>'Cantarell 11'</default> <summary>Default font</summary> <description> Name of the default font used by gtk+. </description> </key> <key name="avatar-directories" type="as"> <default>[]</default> <summary>Directories with avatar faces</summary> <description> Directories to override the default avatar faces installed by gnome-control-center. </description> </key> <key name="text-scaling-factor" type="d"> <range min="0.5" max="3.0"/> <default>1.0</default> <summary>Text scaling factor</summary> <description> Factor used to enlarge or reduce text display, without changing font size. </description> </key> <key name="scaling-factor" type="u"> <default>0</default> <summary>Window scaling factor</summary> <description> Integer factor used to scale windows by. For use on high-dpi screens. 0 means pick automatically based on monitor. </description> </key> <key name="gtk-im-preedit-style" type="s"> <default>'callback'</default> <summary>GTK IM Preedit Style</summary> <description> Name of the GTK+ input method Preedit Style used by gtk+. </description> </key> <key name="gtk-im-status-style" type="s"> <default>'callback'</default> <summary>GTK IM Status Style</summary> <description> Name of the GTK+ input method Status Style used by gtk+. </description> </key> <key name="gtk-im-module" type="s"> <default>''</default> <summary>GTK IM Module</summary> <description> Name of the input method module used by GTK+. </description> </key> <key name="document-font-name" type="s"> <default>'Cantarell 11'</default> <summary>Document font</summary> <description> Name of the default font used for reading documents. </description> </key> <key name="monospace-font-name" type="s"> <default>'Source Code Pro 10'</default> <summary>Monospace font</summary> <description> Name of a monospaced (fixed-width) font for use in locations like terminals. </description> </key> <key name="menubar-accel" type="s"> <default>'F10'</default> <summary>Menubar accelerator</summary> <description> Keyboard shortcut to open the menu bars. </description> </key> <key name="cursor-theme" type="s"> <default>'Adwaita'</default> <summary>Cursor theme</summary> <description>Cursor theme name. Used only by Xservers that support the Xcursor extension.</description> </key> <key name="cursor-size" type="i"> <default>24</default> <summary>Cursor size</summary> <description>Size of the cursor used as cursor theme.</description> </key> <key name="gtk-timeout-initial" type="i"> <default>200</default> <summary>Timeout before click repeat</summary> <description>Timeout in milliseconds before a click starts repeating (on spinner buttons for example).</description> </key> <key name="gtk-timeout-repeat" type="i"> <default>20</default> <summary>Timeout between click repeats</summary> <description>Timeout in milliseconds between repeated clicks when a button is left pressed.</description> </key> <key name="gtk-color-palette" type="s"> <default>'black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90'</default> <summary>Palette used in the color selector</summary> <description>Palette used in the color selector as defined by the “gtk-color-palette” setting</description> </key> <key name="gtk-color-scheme" type="s"> <default>''</default> <summary>List of symbolic names and color equivalents</summary> <description>A “\n” separated list of “name:color” as defined by the “gtk-color-scheme” setting</description> </key> <key name="clock-format" enum="org.gnome.desktop.GDesktopClockFormat"> <default>'24h'</default> <summary>Whether the clock displays in 24h or 12h format</summary> <description> Whether the clock displays in 24h or 12h format </description> </key> <key name="clock-show-seconds" type="b"> <default>false</default> <summary>Whether the clock shows seconds</summary> <description> If true, display seconds in the clock. </description> </key> <key name="clock-show-date" type="b"> <default>true</default> <summary>Show date in clock</summary> <description> If true, display date in the clock, in addition to time. </description> </key> <key name="clock-show-weekday" type="b"> <default>false</default> <summary>Show weekday in clock</summary> <description> If true, display weekday in the clock, in addition to time. </description> </key> <key name="enable-hot-corners" type="b"> <default>true</default> <summary>Enable hot corners</summary> <description> If true, the activities overview can be accessed by moving the mouse to the top-left corner. </description> </key> <key name="show-battery-percentage" type="b"> <default>false</default> <summary>Show battery percentage</summary> <description> If true, display battery percentage in the status menu, in addition to the icon. </description> </key> <key name="gtk-enable-primary-paste" type="b"> <default>true</default> <summary>Enable the primary paste selection</summary> <description> If true, gtk+ uses the primary paste selection, usually triggered by a middle mouse button click. </description> </key> <key name="overlay-scrolling" type="b"> <default>true</default> <summary>Allow overlay scrolling</summary> <description> Whether scrollbars should be overlayed as indicators. Depending on input devices in use, permanent scrollbars may still be displayed. </description> </key> <key name="locate-pointer" type="b"> <default>false</default> <summary>Highlights the current location of the pointer.</summary> <description> If true, pressing a key will highlight the current pointer location on screen. </description> </key> <key name="font-antialiasing" enum="org.gnome.desktop.GDesktopFontAntialiasingMode"> <default>'grayscale'</default> <summary>Antialiasing</summary> <description> The type of antialiasing to use when rendering fonts. Possible values are: “none” for no antialiasing, “grayscale” for standard grayscale antialiasing, and “rgba” for subpixel antialiasing (LCD screens only). </description> </key> <key name="font-hinting" enum="org.gnome.desktop.GDesktopFontHinting"> <default>'slight'</default> <summary>Hinting</summary> <description> The type of hinting to use when rendering fonts. Possible values are: “none” for no hinting and “slight” for fitting only to the Y-axis like Microsoft’s ClearType, DirectWrite and Adobe’s proprietary font rendering engine. Ignores native hinting within the font, generates hints algorithmically. Used on Ubuntu by default. Recommended. The meaning of “medium” and “full” depends on the font format (.ttf, .otf, .pfa/.pfb) and the installed version of FreeType. They usually try to fit glyphs to both the X and the Y axis (except for .otf: Y-only). This can lead to distortion and/or inconsistent rendering depending on the quality of the font, the font format and the state of FreeType’s font engines. </description> </key> <key name="font-rgba-order" enum="org.gnome.desktop.GDesktopFontRgbaOrder"> <default>'rgb'</default> <summary>RGBA order</summary> <description> The order of subpixel elements on an LCD screen; only used when antialiasing is set to “rgba”. Possible values are: “rgb” for red on left (most common), “bgr” for blue on left, “vrgb” for red on top, “vbgr” for red on bottom. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.a11y.gschema.xml 0000644 00000001474 15125157507 0014452 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.a11y" path="/org/gnome/desktop/a11y/"> <key name="always-show-universal-access-status" type="b"> <default>false</default> <summary>Always show the Universal Access status icon</summary> <description> This key overrides the automatic hiding of the Universal Access status icon when no accessibility features are enabled. </description> </key> <key name="always-show-text-caret" type="b"> <default>false</default> <summary>Always show the text caret</summary> <description> This key overrides the hiding of the text caret in noneditable text in applications. </description> </key> </schema> </schemalist> schemas/10_org.gnome.desktop.screensaver.default.gschema.override 0000644 00000000176 15125157507 0021157 0 ustar 00 [org.gnome.desktop.screensaver] picture-uri='file:///usr/share/backgrounds/Alma-mountains-dark.xml' picture-options='scaled' schemas/org.gnome.system.location.gschema.xml 0000644 00000002207 15125157507 0015355 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.system.location" path="/org/gnome/system/location/"> <key type="b" name="enabled"> <default>false</default> <summary>Geolocation services are enabled.</summary> <description> If true, applications are allowed to access location information. </description> </key> <key name="max-accuracy-level" enum="org.gnome.desktop.GDesktopLocationAccuracyLevel"> <default>'exact'</default> <summary>The maximum accuracy level of location.</summary> <description> Configures the maximum level of location accuracy applications are allowed to see. Valid options are “country”, “city”, “neighborhood”, “street”, and “exact” (typically requires GPS receiver). Please keep in mind that this only controls what GeoClue will allow applications to see and they can find user’s location on their own using network resources (albeit with street-level accuracy at best). </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.enums.xml 0000644 00000014355 15125157507 0013422 0 ustar 00 <!-- This file is generated by glib-mkenums, do not modify it. This code is licensed under the same license as the containing project. Note that it links to GLib, so must comply with the LGPL linking clauses. --> <schemalist> <enum id="org.gnome.desktop.GDesktopProxyMode"> <value nick="none" value="0"/> <value nick="manual" value="1"/> <value nick="auto" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopToolbarStyle"> <value nick="both" value="0"/> <value nick="both-horiz" value="1"/> <value nick="icons" value="2"/> <value nick="text" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopToolbarIconSize"> <value nick="small" value="0"/> <value nick="large" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopBackgroundStyle"> <value nick="none" value="0"/> <value nick="wallpaper" value="1"/> <value nick="centered" value="2"/> <value nick="scaled" value="3"/> <value nick="stretched" value="4"/> <value nick="zoom" value="5"/> <value nick="spanned" value="6"/> </enum> <enum id="org.gnome.desktop.GDesktopBackgroundShading"> <value nick="solid" value="0"/> <value nick="vertical" value="1"/> <value nick="horizontal" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopMouseDwellMode"> <value nick="window" value="0"/> <value nick="gesture" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopMouseDwellDirection"> <value nick="left" value="0"/> <value nick="right" value="1"/> <value nick="up" value="2"/> <value nick="down" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopClockFormat"> <value nick="24h" value="0"/> <value nick="12h" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopScreensaverMode"> <value nick="blank-only" value="0"/> <value nick="random" value="1"/> <value nick="single" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopMagnifierMouseTrackingMode"> <value nick="none" value="0"/> <value nick="centered" value="1"/> <value nick="proportional" value="2"/> <value nick="push" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopMagnifierFocusTrackingMode"> <value nick="none" value="0"/> <value nick="centered" value="1"/> <value nick="proportional" value="2"/> <value nick="push" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopMagnifierCaretTrackingMode"> <value nick="none" value="0"/> <value nick="centered" value="1"/> <value nick="proportional" value="2"/> <value nick="push" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopMagnifierScreenPosition"> <value nick="none" value="0"/> <value nick="full-screen" value="1"/> <value nick="top-half" value="2"/> <value nick="bottom-half" value="3"/> <value nick="left-half" value="4"/> <value nick="right-half" value="5"/> </enum> <enum id="org.gnome.desktop.GDesktopTitlebarAction"> <value nick="toggle-shade" value="0"/> <value nick="toggle-maximize" value="1"/> <value nick="toggle-maximize-horizontally" value="2"/> <value nick="toggle-maximize-vertically" value="3"/> <value nick="minimize" value="4"/> <value nick="none" value="5"/> <value nick="lower" value="6"/> <value nick="menu" value="7"/> </enum> <enum id="org.gnome.desktop.GDesktopFocusMode"> <value nick="click" value="0"/> <value nick="sloppy" value="1"/> <value nick="mouse" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopFocusNewWindows"> <value nick="smart" value="0"/> <value nick="strict" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopVisualBellType"> <value nick="fullscreen-flash" value="0"/> <value nick="frame-flash" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopLocationAccuracyLevel"> <value nick="country" value="0"/> <value nick="city" value="1"/> <value nick="neighborhood" value="2"/> <value nick="street" value="3"/> <value nick="exact" value="4"/> </enum> <enum id="org.gnome.desktop.GDesktopTouchpadHandedness"> <value nick="right" value="0"/> <value nick="left" value="1"/> <value nick="mouse" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopTouchpadClickMethod"> <value nick="default" value="0"/> <value nick="none" value="1"/> <value nick="areas" value="2"/> <value nick="fingers" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopTouchpadTapButtonMap"> <value nick="default" value="0"/> <value nick="lrm" value="1"/> <value nick="lmr" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopDeviceSendEvents"> <value nick="enabled" value="0"/> <value nick="disabled" value="1"/> <value nick="disabled-on-external-mouse" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopTabletMapping"> <value nick="absolute" value="0"/> <value nick="relative" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopPadButtonAction"> <value nick="none" value="0"/> <value nick="help" value="1"/> <value nick="switch-monitor" value="2"/> <value nick="keybinding" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopStylusButtonAction"> <value nick="default" value="0"/> <value nick="middle" value="1"/> <value nick="right" value="2"/> <value nick="back" value="3"/> <value nick="forward" value="4"/> </enum> <enum id="org.gnome.desktop.GDesktopPointerAccelProfile"> <value nick="default" value="0"/> <value nick="flat" value="1"/> <value nick="adaptive" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopUsbProtection"> <value nick="lockscreen" value="0"/> <value nick="always" value="1"/> </enum> <enum id="org.gnome.desktop.GDesktopFontAntialiasingMode"> <value nick="none" value="0"/> <value nick="grayscale" value="1"/> <value nick="rgba" value="2"/> </enum> <enum id="org.gnome.desktop.GDesktopFontHinting"> <value nick="none" value="0"/> <value nick="slight" value="1"/> <value nick="medium" value="2"/> <value nick="full" value="3"/> </enum> <enum id="org.gnome.desktop.GDesktopFontRgbaOrder"> <value nick="rgba" value="0"/> <value nick="rgb" value="1"/> <value nick="bgr" value="2"/> <value nick="vrgb" value="3"/> <value nick="vbgr" value="4"/> </enum> </schemalist> <!-- Generated data ends here --> schemas/org.gnome.desktop.screensaver.gschema.xml 0000644 00000014074 15125157507 0016217 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.screensaver" path="/org/gnome/desktop/screensaver/"> <key name="restart-enabled" type="b"> <default>false</default> <summary>Enable restart/shutdown</summary> <description> Allow shutdown and restart actions from the lock screen. </description> </key> <key name="idle-activation-enabled" type="b"> <default>true</default> <summary>Activate when idle</summary> <description> Set this to TRUE to activate the screensaver when the session is idle. DEPRECATED: This key is deprecated and ignored. Set org.gnome.desktop.session idle-delay to 0 if you do not want to activate the screensaver. </description> </key> <key name="lock-enabled" type="b"> <default>true</default> <summary>Lock on activation</summary> <description>Set this to TRUE to lock the screen when the screensaver goes active.</description> </key> <key name="lock-delay" type="u"> <default>0</default> <summary>Time before locking</summary> <description>The number of seconds after screensaver activation before locking the screen.</description> </key> <key name="show-full-name-in-top-bar" type="b"> <default>true</default> <summary>Show full name in the lock screen</summary> <description>Whether the user’s full name is shown in the lock screen or not. This only affects the screen shield, the name is always shown in the unlock dialog.</description> </key> <key name="embedded-keyboard-enabled" type="b"> <default>false</default> <summary>Allow embedding a keyboard into the window</summary> <description> Set this to TRUE to allow embedding a keyboard into the window when trying to unlock. The “keyboard_command” key must be set with the appropriate command. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="embedded-keyboard-command" type="s"> <default>''</default> <summary>Embedded keyboard command</summary> <description> The command that will be run, if the “embedded_keyboard_enabled” key is set to TRUE, to embed a keyboard widget into the window. This command should implement an XEMBED plug interface and output a window XID on the standard output. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="logout-enabled" type="b"> <default>false</default> <summary>Allow logout</summary> <description> Set this to TRUE to offer an option in the unlock dialog to allow logging out after a delay. The delay is specified in the “logout_delay” key. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="logout-delay" type="u"> <default>7200</default> <summary>Time before logout option</summary> <description> The number of seconds after the screensaver activation before a logout option will appear in the unlock dialog. This key has effect only if the “logout_enable” key is set to TRUE. DEPRECATED: This key is deprecated and ignored </description> </key> <key name="logout-command" type="s"> <default>''</default> <summary>Logout command</summary> <description> The command to invoke when the logout button is clicked. This command should simply log the user out without any interaction. This key has effect only if the “logout_enable” key is set to TRUE. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="user-switch-enabled" type="b"> <default>true</default> <summary>Allow user switching</summary> <description>Set this to TRUE to offer an option in the unlock dialog to switch to a different user account.</description> </key> <key name="status-message-enabled" type="b"> <default>true</default> <summary>Allow the session status message to be displayed</summary> <description> Allow the session status message to be displayed when the screen is locked. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="picture-options" enum="org.gnome.desktop.GDesktopBackgroundStyle"> <default>'zoom'</default> <summary>Picture Options</summary> <description> Determines how the image set by wallpaper_filename is rendered. Possible values are “none”, “wallpaper”, “centered”, “scaled”, “stretched”, “zoom”, “spanned”. </description> </key> <key name="picture-uri" type="s"> <default>'file:///usr/share/backgrounds/gnome/adwaita-timed.xml'</default> <summary>Picture URI</summary> <description> URI to use for the background image. Note that the backend only supports local (file://) URIs. </description> </key> <key name="picture-opacity" type="i"> <range min="0" max="100"/> <default>100</default> <summary>Picture Opacity</summary> <description> Opacity with which to draw the background picture. </description> </key> <key name="primary-color" type="s"> <default>'#023c88'</default> <summary>Primary Color</summary> <description> Left or Top color when drawing gradients, or the solid color. </description> </key> <key name="secondary-color" type="s"> <default>'#5789ca'</default> <summary>Secondary Color</summary> <description> Right or Bottom color when drawing gradients, not used for solid color. </description> </key> <key name="color-shading-type" enum="org.gnome.desktop.GDesktopBackgroundShading"> <default>'solid'</default> <summary>Color Shading Type</summary> <description> How to shade the background color. Possible values are “horizontal”, “vertical”, and “solid”. </description> </key> </schema> </schemalist> schemas/org.freedesktop.TrackerMiners3.enums.xml 0000644 00000001153 15125157507 0016003 0 ustar 00 <!-- This file is generated by glib-mkenums, do not modify it. This code is licensed under the same license as the containing project. Note that it links to GLib, so must comply with the LGPL linking clauses. --> <schemalist> <enum id="org.freedesktop.TrackerMiners3.TrackerSerializationFormat"> <value nick="sparql" value="0"/> <value nick="turtle" value="1"/> <value nick="json" value="2"/> <value nick="json-ld" value="3"/> </enum> <enum id="org.freedesktop.TrackerMiners3.TrackerIndexLocationFlags"> <value nick="none" value="0"/> </enum> </schemalist> <!-- Generated data ends here --> schemas/org.gnome.desktop.privacy.gschema.xml 0000644 00000010704 15125157507 0015350 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.privacy" path="/org/gnome/desktop/privacy/"> <key name="hide-identity" type="b"> <default>false</default> <summary>Controls visibility of personal information</summary> <description>If set to true, the system will make an effort to not divulge the user’s identity on screen or on the network.</description> </key> <key name="show-full-name-in-top-bar" type="b"> <default>true</default> <summary>Show full name in the user menu</summary> <description>Whether the users full name is shown in the user menu or not.</description> </key> <key name="remove-old-trash-files" type="b"> <default>false</default> <summary>Whether to remove old files from the trash automatically</summary> <description>If TRUE, automatically remove files from the trash when they are older than “old-files-age” days.</description> </key> <key name="remove-old-temp-files" type="b"> <default>false</default> <summary>Whether to remove old temporary files automatically</summary> <description>If TRUE, automatically remove temporary files when they are older than “old-files-age” days.</description> </key> <key name="old-files-age" type="u"> <default>30</default> <summary>Number of days to keep trash and temporary files</summary> <description>Consider trash and temporary files old after this many days.</description> </key> <key name="remember-recent-files" type="b"> <default>true</default> <summary>Whether to remember recently used files</summary> <description>If FALSE, applications will not remember recently used files.</description> </key> <key name="recent-files-max-age" type="i"> <default>-1</default> <summary>Number of days to remember recently used files for</summary> <description>Recently used files will be remembered for this many days. If set to 0, recent files will not be remembered; if set to -1, they will be retained indefinitely.</description> </key> <key name="remember-app-usage" type="b"> <default>true</default> <summary>Whether to remember application usage</summary> <description>If FALSE, application usage will not be monitored and recorded.</description> </key> <key name="send-software-usage-stats" type="b"> <default>false</default> <summary>Send statistics when applications are removed or installed</summary> <description>If FALSE, no anonymous installation or removal information will be sent to the vendor.</description> </key> <key name="report-technical-problems" type="b"> <default>false</default> <summary>Send reports of technical problems to the vendor</summary> <description>If TRUE, anonymized reports will be sent automatically to the vendor.</description> </key> <key name="disable-microphone" type="b"> <default>false</default> <summary>Don’t allow applications to access the microphone</summary> <description>If TRUE, applications should not use the microphone.</description> </key> <key name="disable-camera" type="b"> <default>false</default> <summary>Don’t allow applications to access the camera</summary> <description>If TRUE, applications should not use the camera.</description> </key> <key name="disable-sound-output" type="b"> <default>false</default> <summary>Don’t allow applications to output sound</summary> <description>If TRUE, applications should not make sound.</description> </key> <key name="usb-protection" type="b"> <default>true</default> <summary>Whether to protect USB devices</summary> <description>If the USBGuard service is present and this setting is enabled, USB devices will be protected as configured in the usb-protection-level setting. </description> </key> <key name="usb-protection-level" enum="org.gnome.desktop.GDesktopUsbProtection"> <default>'lockscreen'</default> <summary>When USB devices should be rejected</summary> <description> If set to “lockscreen”, only when the lock screen is present new USB devices will be rejected; if set to “always”, all new USB devices will always be rejected. </description> </key> </schema> </schemalist> schemas/10_org.gnome.desktop.background.default.gschema.override 0000644 00000000176 15125157507 0020756 0 ustar 00 [org.gnome.desktop.background] picture-uri='file:///usr/share/backgrounds/Alma-mountains-white.xml' picture-options='scaled' schemas/org.gnome.desktop.wm.keybindings.gschema.xml 0000644 00000032501 15125157507 0016622 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.wm.keybindings" path="/org/gnome/desktop/wm/keybindings/"> <key name="switch-to-workspace-1" type="as"> <default><![CDATA[['<Super>Home']]]></default> <summary>Switch to workspace 1</summary> </key> <key name="switch-to-workspace-2" type="as"> <default>[]</default> <summary>Switch to workspace 2</summary> </key> <key name="switch-to-workspace-3" type="as"> <default>[]</default> <summary>Switch to workspace 3</summary> </key> <key name="switch-to-workspace-4" type="as"> <default>[]</default> <summary>Switch to workspace 4</summary> </key> <key name="switch-to-workspace-5" type="as"> <default>[]</default> <summary>Switch to workspace 5</summary> </key> <key name="switch-to-workspace-6" type="as"> <default>[]</default> <summary>Switch to workspace 6</summary> </key> <key name="switch-to-workspace-7" type="as"> <default>[]</default> <summary>Switch to workspace 7</summary> </key> <key name="switch-to-workspace-8" type="as"> <default>[]</default> <summary>Switch to workspace 8</summary> </key> <key name="switch-to-workspace-9" type="as"> <default>[]</default> <summary>Switch to workspace 9</summary> </key> <key name="switch-to-workspace-10" type="as"> <default>[]</default> <summary>Switch to workspace 10</summary> </key> <key name="switch-to-workspace-11" type="as"> <default>[]</default> <summary>Switch to workspace 11</summary> </key> <key name="switch-to-workspace-12" type="as"> <default>[]</default> <summary>Switch to workspace 12</summary> </key> <key name="switch-to-workspace-left" type="as"> <default><![CDATA[['<Super>Page_Up','<Super><Alt>Left','<Control><Alt>Left']]]></default> <summary>Switch to workspace left</summary> </key> <key name="switch-to-workspace-right" type="as"> <default><![CDATA[['<Super>Page_Down','<Super><Alt>Right','<Control><Alt>Right']]]></default> <summary>Switch to workspace right</summary> </key> <key name="switch-to-workspace-up" type="as"> <default><![CDATA[['<Control><Alt>Up']]]></default> <summary>Switch to workspace above</summary> </key> <key name="switch-to-workspace-down" type="as"> <default><![CDATA[['<Control><Alt>Down']]]></default> <summary>Switch to workspace below</summary> </key> <key name="switch-to-workspace-last" type="as"> <default><![CDATA[['<Super>End']]]></default> <summary>Switch to last workspace</summary> </key> <key name="switch-group" type="as"> <default><![CDATA[['<Super>Above_Tab','<Alt>Above_Tab']]]></default> <summary>Switch windows of an application</summary> </key> <key name="switch-group-backward" type="as"> <default><![CDATA[['<Shift><Super>Above_Tab','<Shift><Alt>Above_Tab']]]></default> <summary>Reverse switch windows of an application</summary> </key> <key name="switch-applications" type="as"> <default><![CDATA[['<Super>Tab','<Alt>Tab']]]></default> <summary>Switch applications</summary> </key> <key name="switch-applications-backward" type="as"> <default><![CDATA[['<Shift><Super>Tab','<Shift><Alt>Tab']]]></default> <summary>Reverse switch applications</summary> </key> <key name="switch-windows" type="as"> <default>[]</default> <summary>Switch windows</summary> </key> <key name="switch-windows-backward" type="as"> <default>[]</default> <summary>Reverse switch windows</summary> </key> <key name="switch-panels" type="as"> <default><![CDATA[['<Control><Alt>Tab']]]></default> <summary>Switch system controls</summary> </key> <key name="switch-panels-backward" type="as"> <default><![CDATA[['<Shift><Control><Alt>Tab']]]></default> <summary>Reverse switch system controls</summary> </key> <key name="cycle-group" type="as"> <default><![CDATA[['<Alt>F6']]]></default> <summary>Switch windows of an app directly</summary> </key> <key name="cycle-group-backward" type="as"> <default><![CDATA[['<Shift><Alt>F6']]]></default> <summary>Reverse switch windows of an app directly</summary> </key> <key name="cycle-windows" type="as"> <default><![CDATA[['<Alt>Escape']]]></default> <summary>Switch windows directly</summary> </key> <key name="cycle-windows-backward" type="as"> <default><![CDATA[['<Shift><Alt>Escape']]]></default> <summary>Reverse switch windows directly</summary> </key> <key name="cycle-panels" type="as"> <default><![CDATA[['<Control><Alt>Escape']]]></default> <summary>Switch system controls directly</summary> </key> <key name="cycle-panels-backward" type="as"> <default><![CDATA[['<Shift><Control><Alt>Escape']]]></default> <summary>Reverse switch system controls directly</summary> </key> <key name="show-desktop" type="as"> <default>[]</default> <summary>Hide all normal windows</summary> </key> <key name="panel-main-menu" type="as"> <default><![CDATA[['<Alt>F1']]]></default> <summary>Show the activities overview</summary> </key> <key name="panel-run-dialog" type="as"> <default><![CDATA[['<Alt>F2']]]></default> <summary>Show the run command prompt</summary> </key> <key name="set-spew-mark" type="as"> <default>[]</default> <summary>Don’t use</summary> </key> <key name="activate-window-menu" type="as"> <default><![CDATA[['<Alt>space']]]></default> <summary>Activate the window menu</summary> </key> <key name="toggle-fullscreen" type="as"> <default>[]</default> <summary>Toggle fullscreen mode</summary> </key> <key name="toggle-maximized" type="as"> <default><![CDATA[['<Alt>F10']]]></default> <summary>Toggle maximization state</summary> </key> <key name="toggle-above" type="as"> <default>[]</default> <summary>Toggle window always appearing on top</summary> </key> <key name="maximize" type="as"> <default><![CDATA[['<Super>Up']]]></default> <summary>Maximize window</summary> </key> <key name="unmaximize" type="as"> <default><![CDATA[['<Super>Down','<Alt>F5']]]></default> <summary>Restore window</summary> </key> <key name="toggle-shaded" type="as"> <default>[]</default> <summary>Toggle shaded state</summary> </key> <key name="minimize" type="as"> <default><![CDATA[['<Super>h']]]></default> <summary>Minimize window</summary> </key> <key name="close" type="as"> <default><![CDATA[['<Alt>F4']]]></default> <summary>Close window</summary> </key> <key name="begin-move" type="as"> <default><![CDATA[['<Alt>F7']]]></default> <summary>Move window</summary> </key> <key name="begin-resize" type="as"> <default><![CDATA[['<Alt>F8']]]></default> <summary>Resize window</summary> </key> <key name="toggle-on-all-workspaces" type="as"> <default>[]</default> <summary>Toggle window on all workspaces or one</summary> </key> <key name="move-to-workspace-1" type="as"> <default><![CDATA[['<Super><Shift>Home']]]></default> <summary>Move window to workspace 1</summary> </key> <key name="move-to-workspace-2" type="as"> <default>[]</default> <summary>Move window to workspace 2</summary> </key> <key name="move-to-workspace-3" type="as"> <default>[]</default> <summary>Move window to workspace 3</summary> </key> <key name="move-to-workspace-4" type="as"> <default>[]</default> <summary>Move window to workspace 4</summary> </key> <key name="move-to-workspace-5" type="as"> <default>[]</default> <summary>Move window to workspace 5</summary> </key> <key name="move-to-workspace-6" type="as"> <default>[]</default> <summary>Move window to workspace 6</summary> </key> <key name="move-to-workspace-7" type="as"> <default>[]</default> <summary>Move window to workspace 7</summary> </key> <key name="move-to-workspace-8" type="as"> <default>[]</default> <summary>Move window to workspace 8</summary> </key> <key name="move-to-workspace-9" type="as"> <default>[]</default> <summary>Move window to workspace 9</summary> </key> <key name="move-to-workspace-10" type="as"> <default>[]</default> <summary>Move window to workspace 10</summary> </key> <key name="move-to-workspace-11" type="as"> <default>[]</default> <summary>Move window to workspace 11</summary> </key> <key name="move-to-workspace-12" type="as"> <default>[]</default> <summary>Move window to workspace 12</summary> </key> <key name="move-to-workspace-last" type="as"> <default><![CDATA[['<Super><Shift>End']]]></default> <summary>Move window to last workspace</summary> </key> <key name="move-to-workspace-left" type="as"> <default><![CDATA[['<Super><Shift>Page_Up','<Super><Shift><Alt>Left','<Control><Shift><Alt>Left']]]></default> <summary>Move window one workspace to the left</summary> </key> <key name="move-to-workspace-right" type="as"> <default><![CDATA[['<Super><Shift>Page_Down','<Super><Shift><Alt>Right','<Control><Shift><Alt>Right']]]></default> <summary>Move window one workspace to the right</summary> </key> <key name="move-to-workspace-up" type="as"> <default><![CDATA[['<Control><Shift><Alt>Up']]]></default> <summary>Move window one workspace up</summary> </key> <key name="move-to-workspace-down" type="as"> <default><![CDATA[['<Control><Shift><Alt>Down']]]></default> <summary>Move window one workspace down</summary> </key> <key name="move-to-monitor-left" type="as"> <default><![CDATA[['<Super><Shift>Left']]]></default> <summary>Move window to the next monitor on the left</summary> </key> <key name="move-to-monitor-right" type="as"> <default><![CDATA[['<Super><Shift>Right']]]></default> <summary>Move window to the next monitor on the right</summary> </key> <key name="move-to-monitor-up" type="as"> <default><![CDATA[['<Super><Shift>Up']]]></default> <summary>Move window to the next monitor above</summary> </key> <key name="move-to-monitor-down" type="as"> <default><![CDATA[['<Super><Shift>Down']]]></default> <summary>Move window to the next monitor below</summary> </key> <key name="raise-or-lower" type="as"> <default>[]</default> <summary>Raise window if covered, otherwise lower it</summary> </key> <key name="raise" type="as"> <default>[]</default> <summary>Raise window above other windows</summary> </key> <key name="lower" type="as"> <default>[]</default> <summary>Lower window below other windows</summary> </key> <key name="maximize-vertically" type="as"> <default>[]</default> <summary>Maximize window vertically</summary> </key> <key name="maximize-horizontally" type="as"> <default>[]</default> <summary>Maximize window horizontally</summary> </key> <key name="move-to-corner-nw" type="as"> <default>[]</default> <summary>Move window to top left corner</summary> </key> <key name="move-to-corner-ne" type="as"> <default>[]</default> <summary>Move window to top right corner</summary> </key> <key name="move-to-corner-sw" type="as"> <default>[]</default> <summary>Move window to bottom left corner</summary> </key> <key name="move-to-corner-se" type="as"> <default>[]</default> <summary>Move window to bottom right corner</summary> </key> <key name="move-to-side-n" type="as"> <default>[]</default> <summary>Move window to top edge of screen</summary> </key> <key name="move-to-side-s" type="as"> <default>[]</default> <summary>Move window to bottom edge of screen</summary> </key> <key name="move-to-side-e" type="as"> <default>[]</default> <summary>Move window to right side of screen</summary> </key> <key name="move-to-side-w" type="as"> <default>[]</default> <summary>Move window to left side of screen</summary> </key> <key name="move-to-center" type="as"> <default>[]</default> <summary>Move window to center of screen</summary> </key> <key name="switch-input-source" type="as"> <default><![CDATA[['<Super>space','XF86Keyboard']]]></default> <summary>Switch input source</summary> <description>Binding to select the next input source</description> </key> <key name="switch-input-source-backward" type="as"> <default><![CDATA[['<Shift><Super>space','<Shift>XF86Keyboard']]]></default> <summary>Switch input source backward</summary> <description>Binding to select the previous input source</description> </key> <key name="always-on-top" type="as"> <default>[]</default> <summary>Toggle window to be always on top</summary> <description>Set or unset window to appear always on top</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.a11y.keyboard.gschema.xml 0000644 00000011441 15125157507 0016244 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.a11y.keyboard" path="/org/gnome/desktop/a11y/keyboard/"> <key name="enable" type="b"> <default>false</default> <summary>Enable accessibility keyboard shortcuts</summary> </key> <key name="feature-state-change-beep" type="b"> <default>false</default> <summary>Beep when a keyboard accessibility feature changes</summary> <description>Whether to beep when a keyboard accessibility feature is enabled or disabled.</description> </key> <key name="timeout-enable" type="b"> <default>false</default> <summary>Disable keyboard accessibility after a timeout</summary> <description>Whether to disable keyboard accessibility after a timeout, useful for shared machines.</description> </key> <key name="disable-timeout" type="i"> <default>200</default> <summary>Duration of the disabling timeout</summary> <description>Duration of the timeout before disabling the keyboard accessibility.</description> </key> <key name="bouncekeys-enable" type="b"> <default>false</default> <summary>Enable “Bounce Keys”</summary> <description>Whether the “Bounce Keys” keyboard accessibility feature is turned on.</description> </key> <key name="bouncekeys-delay" type="i"> <default>300</default> <summary>Minimum interval in milliseconds</summary> <description>Ignore multiple presses of the same key within this many milliseconds.</description> </key> <key name="bouncekeys-beep-reject" type="b"> <default>false</default> <summary>Beep when a key is rejected</summary> <description>Whether to beep when a key is rejected.</description> </key> <key name="mousekeys-enable" type="b"> <default>false</default> <summary>Enable “Mouse Keys”</summary> <description>Whether the “Mouse Keys” accessibility feature is turned on.</description> </key> <key name="mousekeys-max-speed" type="i"> <default>10</default> <summary>Pixels per seconds</summary> <description>How many pixels per second to move at the maximum speed.</description> </key> <key name="mousekeys-accel-time" type="i"> <default>300</default> <summary>How long to accelerate in milliseconds</summary> <description>How many milliseconds it takes to go from 0 to maximum speed.</description> </key> <key name="mousekeys-init-delay" type="i"> <default>300</default> <summary>Initial delay in milliseconds</summary> <description>How many milliseconds to wait before mouse movement keys start to operate.</description> </key> <key name="slowkeys-enable" type="b"> <default>false</default> <summary>Enable “Slow Keys”</summary> <description>Whether the “Slow Keys” accessibility feature is turned on.</description> </key> <key name="slowkeys-delay" type="i"> <default>300</default> <summary>Minimum interval in milliseconds</summary> <description>Do not accept a key as being pressed unless held for this many milliseconds.</description> </key> <key name="slowkeys-beep-press" type="b"> <default>false</default> <summary>Beep when a key is first pressed</summary> <description>Whether to beep when a key is first pressed.</description> </key> <key name="slowkeys-beep-accept" type="b"> <default>false</default> <summary>Beep when a key is accepted</summary> <description>Whether to beep when a key is accepted.</description> </key> <key name="slowkeys-beep-reject" type="b"> <default>false</default> <summary>Beep when a key is rejected</summary> <description>Whether to beep when a key is rejected.</description> </key> <key name="stickykeys-enable" type="b"> <default>false</default> <summary>Enable sticky keys</summary> <description>Whether the sticky keys accessibility feature is turned on.</description> </key> <key name="stickykeys-two-key-off" type="b"> <default>false</default> <summary>Disable when two keys are pressed at the same time</summary> <description>Whether to disable sticky keys if two keys are pressed at the same time.</description> </key> <key name="stickykeys-modifier-beep" type="b"> <default>false</default> <summary>Beep when a modifier is pressed.</summary> <description>Whether to beep when a modifier key is pressed.</description> </key> <key name="togglekeys-enable" type="b"> <default>false</default> <summary>Enable “Toggle Keys”</summary> <description>Whether the “Toggle Keys” accessibility feature is turned on.</description> </key> </schema> </schemalist> schemas/org.gnome.system.proxy.gschema.xml 0000644 00000014313 15125157507 0014727 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.system.proxy" path="/system/proxy/"> <child name="http" schema="org.gnome.system.proxy.http"/> <child name="https" schema="org.gnome.system.proxy.https"/> <child name="ftp" schema="org.gnome.system.proxy.ftp"/> <child name="socks" schema="org.gnome.system.proxy.socks"/> <key name="mode" enum="org.gnome.desktop.GDesktopProxyMode"> <default>'none'</default> <summary>Proxy configuration mode</summary> <description> Select the proxy configuration mode. Supported values are “none”, “manual”, “auto”. If this is “none”, then proxies are not used. If it is “auto”, the autoconfiguration URL described by the “autoconfig-url” key is used. If it is “manual”, then the proxies described by “/system/proxy/http”, “/system/proxy/https”, “/system/proxy/ftp” and “/system/proxy/socks” will be used. Each of the 4 proxy types is enabled if its “host” key is non-empty and its “port” key is non-0. If an http proxy is configured, but an https proxy is not, then the http proxy is also used for https. If a SOCKS proxy is configured, it is used for all protocols, except that the http, https, and ftp proxy settings override it for those protocols only. </description> </key> <key name="autoconfig-url" type="s"> <default>''</default> <summary>Automatic proxy configuration URL</summary> <description> URL that provides proxy configuration values. When mode is “auto”, this URL is used to look up proxy information for all protocols. </description> </key> <key name="ignore-hosts" type="as"> <default>[ 'localhost', '127.0.0.0/8', '::1' ]</default> <summary>Non-proxy hosts</summary> <description> This key contains a list of hosts which are connected to directly, rather than via the proxy (if it is active). The values can be hostnames, domains (using an initial wildcard like *.foo.com), IP host addresses (both IPv4 and IPv6) and network addresses with a netmask (something like 192.168.0.0/24). </description> </key> <key name="use-same-proxy" type="b"> <default>true</default> <summary>Unused; ignore</summary> <description> This key is not used, and should not be read or modified. </description> </key> </schema> <schema id="org.gnome.system.proxy.http" path="/system/proxy/http/"> <key name="enabled" type="b"> <default>false</default> <summary>Unused; ignore</summary> <description> This key is not used; HTTP proxying is enabled when the host key is non-empty and the port is non-0. </description> </key> <key name="host" type="s"> <default>''</default> <summary>HTTP proxy host name</summary> <description> The machine name to proxy HTTP through. </description> </key> <key name="port" type="i"> <range min="0" max="65535"/> <default>8080</default> <summary>HTTP proxy port</summary> <description> The port on the machine defined by “/system/proxy/http/host” that you proxy through. </description> </key> <key name="use-authentication" type="b"> <default>false</default> <summary>Authenticate proxy server connections</summary> <description> If true, then connections to the proxy server require authentication. The username/password combo is defined by “/system/proxy/http/authentication-user” and “/system/proxy/http/authentication-password”. This applies only to the http proxy; when using a separate https proxy, there is currently no way to specify that it should use authentication. </description> </key> <key name="authentication-user" type="s"> <default>''</default> <summary>HTTP proxy username</summary> <description> User name to pass as authentication when doing HTTP proxying. </description> </key> <key name="authentication-password" type="s"> <default>''</default> <summary>HTTP proxy password</summary> <description> Password to pass as authentication when doing HTTP proxying. </description> </key> </schema> <schema id="org.gnome.system.proxy.https" path="/system/proxy/https/"> <key name="host" type="s"> <default>''</default> <summary>Secure HTTP proxy host name</summary> <description> The machine name to proxy secure HTTP through. </description> </key> <key name="port" type="i"> <range min="0" max="65535"/> <default>0</default> <summary>Secure HTTP proxy port</summary> <description> The port on the machine defined by “/system/proxy/https/host” that you proxy through. </description> </key> </schema> <schema id="org.gnome.system.proxy.ftp" path="/system/proxy/ftp/"> <key name="host" type="s"> <default>''</default> <summary>FTP proxy host name</summary> <description> The machine name to proxy FTP through. </description> </key> <key name="port" type="i"> <range min="0" max="65535"/> <default>0</default> <summary>FTP proxy port</summary> <description> The port on the machine defined by “/system/proxy/ftp/host” that you proxy through. </description> </key> </schema> <schema id="org.gnome.system.proxy.socks" path="/system/proxy/socks/"> <key name="host" type="s"> <default>''</default> <summary>SOCKS proxy host name</summary> <description> The machine name to use as a SOCKS proxy. </description> </key> <key name="port" type="i"> <range min="0" max="65535"/> <default>0</default> <summary>SOCKS proxy port</summary> <description> The port on the machine defined by “/system/proxy/socks/host” that you proxy through. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.input-sources.gschema.xml 0000644 00000004765 15125157507 0016525 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.input-sources" path="/org/gnome/desktop/input-sources/"> <key name="current" type="u"> <default>0</default> <summary>Current input source</summary> <description> The zero-based index into the input sources list specifying the current one in effect. The value is automatically capped to remain in the range [0, sources_length) as long as the sources list isn’t empty. DEPRECATED: This key is deprecated and ignored. </description> </key> <key name="sources" type="a(ss)"> <default>[]</default> <summary>List of input sources</summary> <description> List of input source identifiers available. Each source is specified as a tuple of 2 strings. The first string is the type and can be one of “xkb” or “ibus”. For “xkb” sources the second string is “xkb_layout+xkb_variant” or just “xkb_layout” if a XKB variant isn’t needed. For “ibus” sources the second string is the IBus engine name. An empty list means that the X server’s current XKB layout and variant won’t be touched and IBus won’t be used. </description> </key> <key name="mru-sources" type="a(ss)"> <default>[]</default> <summary>List of most recently used input sources</summary> <description> List of most recently used input sources. The value is in the same format as the available sources list. </description> </key> <key name="xkb-options" type="as"> <default>[]</default> <summary>List of XKB options</summary> <description> List of XKB options. Each option is an XKB option string as defined by xkeyboard-config’s rules files. </description> </key> <key name="show-all-sources" type="b"> <default>false</default> <summary>Show all installed input sources</summary> <description> Makes all installed input sources available for choosing in System Settings. </description> </key> <key name="per-window" type="b"> <default>false</default> <summary>Use different input sources for each window</summary> <description> When enabled, input sources get attached to the currently focused window when activated. </description> </key> </schema> </schemalist> schemas/org.gtk.Settings.ColorChooser.gschema.xml 0000644 00000001643 15125157507 0016105 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist> <schema id='org.gtk.Settings.ColorChooser' path='/org/gtk/settings/color-chooser/'> <key name='custom-colors' type='a(dddd)'> <default>[]</default> <summary>Custom colors</summary> <description> An array of custom colors to show in the color chooser. Each color is specified as a tuple of four doubles, specifying RGBA values between 0 and 1. </description> </key> <key name='selected-color' type='(bdddd)'> <default>(false,1.0,1.0,1.0,1.0)</default> <summary>The selected color</summary> <description> The selected color, described as a tuple whose first member is a boolean that is true if a color was selected, and the remaining four members are four doubles, specifying RGBA values between 0 and 1. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.notifications.gschema.xml 0000644 00000005426 15125157507 0016551 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.notifications" path="/org/gnome/desktop/notifications/"> <key name="show-banners" type="b"> <default>true</default> <summary>Show notification banners</summary> <description> Whether notification banners are visible for application notifications. </description> </key> <key name="show-in-lock-screen" type="b"> <default>true</default> <summary>Show notifications in the lock screen</summary> <description> Whether notifications are shown in the lock screen or not. </description> </key> <!-- Temporary hack until GSettingsList lands --> <key name="application-children" type="as"> <default>[]</default> <summary /> <description /> </key> </schema> <schema id="org.gnome.desktop.notifications.application"> <key name="application-id" type="s"> <default>''</default> <summary>Application ID</summary> <description> The application that this policy is for. </description> </key> <key name="enable" type="b"> <default>true</default> <summary>Enable notifications</summary> <description> Whether notifications are globally enabled for this application. </description> </key> <key name="enable-sound-alerts" type="b"> <default>true</default> <summary>Enable sound alerts</summary> <description> Whether notifications should be accompanied by sound alerts. </description> </key> <key name="show-banners" type="b"> <default>true</default> <summary>Show notification banners</summary> <description> Whether notification banners for this application are shown or not. Does not affect clicking on message tray buttons. </description> </key> <key name="force-expanded" type="b"> <default>false</default> <summary>Force automatic expanding of banners</summary> <description> Whether notifications from this application are expanded automatically when in banner mode. </description> </key> <key name="show-in-lock-screen" type="b"> <default>true</default> <summary>Show in the lock screen</summary> <description> Whether notifications from this application are shown when the screen is locked. </description> </key> <key name="details-in-lock-screen" type="b"> <default>false</default> <summary>Show details in the lock screen</summary> <description> Whether the summary and body of notifications from this application will be visible in the locked screen. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.peripherals.gschema.xml 0000644 00000032504 15125157507 0016213 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.peripherals" path="/org/gnome/desktop/peripherals/"> <child name="touchpad" schema="org.gnome.desktop.peripherals.touchpad"/> <child name="keyboard" schema="org.gnome.desktop.peripherals.keyboard"/> <child name="mouse" schema="org.gnome.desktop.peripherals.mouse"/> <child name="trackball" schema="org.gnome.desktop.peripherals.trackball"/> <child name="tablet" schema="org.gnome.desktop.peripherals.tablet"/> <child name="touchscreen" schema="org.gnome.desktop.peripherals.touchscreen"/> </schema> <schema id="org.gnome.desktop.peripherals.touchpad" path="/org/gnome/desktop/peripherals/touchpad/"> <key name="edge-scrolling-enabled" type="b"> <default>false</default> <summary>Whether edge scrolling is enabled</summary> <description>When enabled, touchpads that support edge scrolling will have that feature enabled.</description> </key> <key name="two-finger-scrolling-enabled" type="b"> <default>true</default> <summary>Whether two-finger scrolling is enabled</summary> <description>When enabled, touchpads that support two-finger scrolling will have that feature enabled.</description> </key> <key name="disable-while-typing" type="b"> <default>true</default> <summary>Whether to disable the touchpad while typing</summary> <description>When enabled, touchpads will be disabled while typing on the keyboard.</description> </key> <key name="tap-to-click" type="b"> <default>false</default> <summary>Enable mouse clicks with touchpad</summary> <description>Set this to TRUE to be able to send mouse clicks by tapping on the touchpad.</description> </key> <key name="tap-button-map" enum="org.gnome.desktop.GDesktopTouchpadTapButtonMap"> <default>'default'</default> <summary>Tap Button Map</summary> <description>Defines the mapping between the number of fingers and touchpad buttons. The default is to have a 1, 2 and 3 finger tap to map to the left, right and middle button ("lrm"), respectively.</description> </key> <key name="tap-and-drag" type="b"> <default>true</default> <summary>Enable tap-and-drag with touchpad</summary> <description>Set this to TRUE to be able to start a drag by tapping and immediately moving the finger that’s now pressed on the touchpad.</description> </key> <key name="tap-and-drag-lock" type="b"> <default>false</default> <summary>Enable tap-and-drag-lock with touchpad</summary> <description>Set this to TRUE to lock the dragging process within a short timeout when the finger is lifted on the touchpad and the tap-and-drag setting is enabled.</description> </key> <key name="send-events" enum="org.gnome.desktop.GDesktopDeviceSendEvents"> <default>'enabled'</default> <summary>Touchpad enabled</summary> <description>Defines the situations in which the touchpad is enabled.</description> </key> <key name="left-handed" enum="org.gnome.desktop.GDesktopTouchpadHandedness"> <default>'mouse'</default> <summary>Touchpad button orientation</summary> <description>Swap left and right mouse buttons for left-handed mice with “left”, “right” for right-handed, “mouse” to follow the mouse setting.</description> </key> <key name="speed" type="d"> <default>0</default> <summary>Pointer speed</summary> <description>Pointer speed for the touchpad. Accepted values are in the [-1..1] range (from “unaccelerated” to “fast”). A value of 0 is the system default.</description> <range min="-1" max="1"/> </key> <key name="natural-scroll" type="b"> <default>true</default> <summary>Natural scrolling</summary> <description>Set this to TRUE to enable natural (reverse) scrolling for touchpads.</description> </key> <key name="click-method" enum="org.gnome.desktop.GDesktopTouchpadClickMethod"> <default>'fingers'</default> <summary>Click method</summary> <description>How to generate software-emulated buttons, either disabled (“none”), through specific areas (“areas”), number of fingers (“fingers”) or left as hardware default (“default”).</description> </key> <key name="middle-click-emulation" type="b"> <default>false</default> <summary>Emulate middle click</summary> <description>Set this to TRUE to enable middle click during simultaneous left and right click.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.keyboard" path="/org/gnome/desktop/peripherals/keyboard/"> <key name="repeat" type="b"> <default>true</default> <summary>Keyboard repeat</summary> <description>Set this to TRUE to enable keyboard repeat.</description> </key> <key name="repeat-interval" type="u"> <default>30</default> <summary>Key Repeat Interval</summary> <description>Delay between repeats in milliseconds.</description> </key> <key name="delay" type="u"> <default>500</default> <summary>Initial Key Repeat Delay</summary> <description>Initial key repeat delay in milliseconds.</description> </key> <key name="remember-numlock-state" type="b"> <default>true</default> <summary>Remember NumLock state</summary> <description>When set to true, GNOME will remember the state of the NumLock LED between sessions.</description> </key> <key name="numlock-state" type="b"> <default>false</default> <summary>NumLock state</summary> <description>The remembered state of the NumLock LED.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.mouse" path="/org/gnome/desktop/peripherals/mouse/"> <key name="left-handed" type="b"> <default>false</default> <summary>Mouse button orientation</summary> <description>Swap left and right mouse buttons for left-handed mice.</description> </key> <key name="speed" type="d"> <default>0</default> <summary>Pointer speed</summary> <description>Pointer speed for mice. Accepted values are in the [-1..1] range (from “unaccelerated” to “fast”). A value of 0 is the system default.</description> <range min="-1" max="1"/> </key> <key name="natural-scroll" type="b"> <default>false</default> <summary>Natural scrolling</summary> <description>Set this to TRUE to enable natural (reverse) scrolling for mice.</description> </key> <key name="accel-profile" enum="org.gnome.desktop.GDesktopPointerAccelProfile"> <default>'default'</default> <summary>Acceleration profile</summary> <description>Acceleration profile used for connected mice. The acceleration profile can be set to either default (“default”) which uses the default acceleration profile for each device, flat (“flat”), which accelerates by a device specific constant factor derived from the configured pointer speed, or adaptive (“adaptive”) which adapts the acceleration depending on the mouse movement. If a mouse doesn’t support the configured profile, “default” will be used.</description> </key> <key name="middle-click-emulation" type="b"> <default>false</default> <summary>Emulate middle click</summary> <description>Set this to TRUE to enable middle click during simultaneous left and right click.</description> </key> <key name="double-click" type="i"> <default>400</default> <summary>Double click time</summary> <description>Length of a double click in milliseconds.</description> </key> <key name="drag-threshold" type="i"> <default>8</default> <summary>Drag threshold</summary> <description>Distance before a drag is started.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.tablet"> <key name="output" type="as"> <default>["", "", ""]</default> <summary>Drawing tablet mapping</summary> <description>EDID information of the output the tablet is mapped to. Must be in the format [vendor, product, serial]. ["","",""] relies on automatic mapping.</description> </key> <key name="mapping" enum="org.gnome.desktop.GDesktopTabletMapping"> <default>'absolute'</default> <summary>Tablet mapping</summary> <description>How input affects the pointer on the screen</description> </key> <key name="area" type="ad"> <default>[0, 0, 0, 0]</default> <summary>Tablet area</summary> <description>Dead area padding around the active area, in percentages. Respectively applied to left,right,top and bottom sides.</description> </key> <key name="keep-aspect" type="b"> <default>false</default> <summary>Tablet aspect ratio</summary> <description>Enable this to restrict the tablet area to match the aspect ratio of the output.</description> </key> <key name="left-handed" type="b"> <default>false</default> <summary>Tablet left-handed mode</summary> <description>Enable this to allow physically rotating the tablet for left-handed setups</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.tablet.stylus"> <key name="pressure-curve" type="ai"> <default>[0, 0, 100, 100]</default> <summary>Stylus pressure curve</summary> <description>Set this to x1, y1 and x2, y2 of the pressure curve applied to the stylus.</description> </key> <key name="eraser-pressure-curve" type="ai"> <default>[0, 0, 100, 100]</default> <summary>Eraser pressure curve</summary> <description>Set this to x1, y1 and x2, y2 of the pressure curve applied to the eraser.</description> </key> <key name="button-action" enum="org.gnome.desktop.GDesktopStylusButtonAction"> <default>'default'</default> <summary>Button action</summary> <description>Stylus button action, this button is located along the pen handle.</description> </key> <key name="secondary-button-action" enum="org.gnome.desktop.GDesktopStylusButtonAction"> <default>'default'</default> <summary>Secondary button action</summary> <description>Secondary stylus button action, this button is located along the pen handle on some styli like the Grip Pen. Other styli like the Airbrush Pen or the Inking Pen only have one button, this setting is ineffective on those.</description> </key> <key name="tertiary-button-action" enum="org.gnome.desktop.GDesktopStylusButtonAction"> <default>'default'</default> <summary>Tertiary button action</summary> <description>Tertiary stylus button action, this button is located along the pen handle on some styli like the 3D Pen. Other styli like the Grip Pen only have two buttons, this setting is ineffective on those.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.tablet.pad-button"> <key name="action" enum="org.gnome.desktop.GDesktopPadButtonAction"> <default>'none'</default> <summary>Pad button action type</summary> <description>The type of action triggered by the button being pressed.</description> </key> <key type="s" name="keybinding"> <default>''</default> <summary>Key combination for the custom action</summary> <description>The keyboard shortcut generated when the button is pressed for custom actions.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.touchscreen"> <key name="output" type="as"> <default>["", "", ""]</default> <summary>Touchscreen output mapping</summary> <description>EDID information of the output the touchscreen is mapped to. Must be in the format [vendor, product, serial]. ["","",""] relies on automatic mapping.</description> </key> </schema> <schema id="org.gnome.desktop.peripherals.trackball" path="/org/gnome/desktop/peripherals/trackball/"> <key name="scroll-wheel-emulation-button" type="i"> <default>0</default> <range min="0" max="24"/> <summary>Mouse wheel emulation button. 0 to disable the feature.</summary> </key> <key name="scroll-wheel-emulation-button-lock" type="b"> <default>false</default> <summary>Mouse wheel emulation button lock</summary> <description>Set this to TRUE to enable button locking for the wheel emulation button. If enabled, the first click of the button enables scrolling, the second click disables scrolling again.</description> </key> <key name="accel-profile" enum="org.gnome.desktop.GDesktopPointerAccelProfile"> <default>'default'</default> <summary>Acceleration profile</summary> <description>Acceleration profile used for the trackball. The acceleration profile can be set to either default (“default”) which uses the default acceleration profile, flat (“flat”), which accelerates by a device specific constant factor derived from the configured speed, or adaptive (“adaptive”) which adapts the acceleration depending on the movement. If the trackball doesn’t support the configured profile, “default” will be used.</description> </key> <key name="middle-click-emulation" type="b"> <default>false</default> <summary>Emulate middle click</summary> <description>Set this to TRUE to enable middle click during simultaneous left and right click.</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.thumbnailers.gschema.xml 0000644 00000001542 15125157507 0016370 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.thumbnailers" path="/org/gnome/desktop/thumbnailers/"> <key name="disable-all" type="b"> <default>false</default> <summary>Disable all external thumbnailers</summary> <description> Set to true to disable all external thumbnailer programs, independent on whether they are independently disabled/enabled. </description> </key> <key name="disable" type="as"> <default>[]</default> <summary> List of mime-types for which external thumbnailer programs will be disabled </summary> <description> Thumbnails will not be created for files whose mime-type is contained in the list. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.media-handling.gschema.xml 0000644 00000005055 15125157507 0016537 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.media-handling" path="/org/gnome/desktop/media-handling/"> <key name="automount" type="b"> <default>true</default> <summary>Whether to automatically mount media</summary> <description>If set to true, then Nautilus will automatically mount media such as user-visible hard disks and removable media on start-up and media insertion.</description> </key> <key name="automount-open" type="b"> <default>true</default> <summary>Whether to automatically open a folder for automounted media</summary> <description>If set to true, then Nautilus will automatically open a folder when media is automounted. This only applies to media where no known x-content/* type was detected; for media where a known x-content type is detected, the user configurable action will be taken instead.</description> </key> <key name="autorun-never" type="b"> <default>false</default> <summary>Never prompt or autorun/autostart programs when media are inserted</summary> <description>If set to true, then Nautilus will never prompt nor autorun/autostart programs when a medium is inserted.</description> </key> <key name="autorun-x-content-start-app" type="as"> <default>[ 'x-content/unix-software', 'x-content/ostree-repository' ]</default> <summary>List of x-content/* types where the preferred application will be launched</summary> <description>List of x-content/* types for which the user have chosen to start an application in the preference capplet. The preferred application for the given type will be started on insertion on media matching these types.</description> </key> <key name="autorun-x-content-ignore" type="as"> <default>[]</default> <summary>List of x-content/* types set to “Do Nothing”</summary> <description>List of x-content/* types for which the user have chosen “Do Nothing” in the preference capplet. No prompt will be shown nor will any matching application be started on insertion of media matching these types.</description> </key> <key name="autorun-x-content-open-folder" type="as"> <default>[]</default> <summary>List of x-content/* types set to “Open Folder”</summary> <description>List of x-content/* types for which the user have chosen “Open Folder” in the preferences capplet. A folder window will be opened on insertion of media matching these types.</description> </key> </schema> </schemalist> schemas/org.gtk.Settings.Debug.gschema.xml 0000644 00000001501 15125157507 0014523 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist> <schema id='org.gtk.Settings.Debug' path='/org/gtk/settings/debug/'> <key name='enable-inspector-keybinding' type='b'> <default>false</default> <summary>Enable inspector keybinding</summary> <description> If this setting is true, GTK+ lets the user open an interactive debugging window with a keybinding. The default shortcuts for the keybinding are Control-Shift-I and Control-Shift-D. </description> </key> <key name='inspector-warning' type='b'> <default>true</default> <summary>Inspector warning</summary> <description> If this setting is true, GTK+ shows a warning before letting the user use the interactive debugger. </description> </key> </schema> </schemalist> schemas/org.freedesktop.Tracker3.Extract.gschema.xml 0000644 00000003551 15125157507 0016522 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <!-- Copyright (C) 2011, Nokia <ivan.frade@nokia.com> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. --> <schemalist> <schema id="org.freedesktop.Tracker3.Extract" path="/org/freedesktop/tracker/extract/" gettext-domain="tracker-miners"> <key name="max-bytes" type="i"> <summary>Max bytes to extract</summary> <description>Maximum number of UTF-8 bytes to extract.</description> <range min="0" max="10485760"/> <default>1048576</default> </key> <key name="text-allowlist" type="as"> <summary>Text file allowlist</summary> <description>Filename patterns for plain text documents that should be indexed</description> <default>[ '*.txt', '*.md', '*.mdwn' ]</default> </key> <key name="wait-for-miner-fs" type="b"> <summary>Wait for FS miner to be done before extracting</summary> <description>When true, tracker-extract will wait for tracker-miner-fs to be done crawling before extracting meta-data. This option is useful on constrained environment where it is important to list files as fast as possible and can wait to get meta-data later.</description> <default>false</default> </key> </schema> </schemalist> schemas/org.gnome.desktop.a11y.mouse.gschema.xml 0000644 00000005533 15125157507 0015601 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.a11y.mouse" path="/org/gnome/desktop/a11y/mouse/"> <key name="dwell-time" type="d"> <default>1.20</default> <summary>Dwell click time</summary> <description>Time in seconds before a click is triggered.</description> </key> <key name="dwell-threshold" type="i"> <default>10</default> <summary>Movement threshold</summary> <description>Distance in pixels before movement will be recognized.</description> </key> <key name="dwell-gesture-single" enum="org.gnome.desktop.GDesktopMouseDwellDirection"> <default>'left'</default> <summary>Gesture single click</summary> <description>Direction to perform a single click (“left”, “right”, “up”, “down”).</description> </key> <key name="dwell-gesture-double" enum="org.gnome.desktop.GDesktopMouseDwellDirection"> <default>'up'</default> <summary>Gesture double click</summary> <description>Direction to perform a double click (“left”, “right”, “up”, “down”).</description> </key> <key name="dwell-gesture-drag" enum="org.gnome.desktop.GDesktopMouseDwellDirection"> <default>'down'</default> <summary>Gesture drag click</summary> <description>Direction to perform dragging (“left”, “right”, “up”, “down”).</description> </key> <key name="dwell-gesture-secondary" enum="org.gnome.desktop.GDesktopMouseDwellDirection"> <default>'right'</default> <summary>Gesture secondary click</summary> <description>Direction to perform a secondary click (“left”, “right”, “up”, “down”).</description> </key> <key name="dwell-mode" enum="org.gnome.desktop.GDesktopMouseDwellMode"> <default>'window'</default> <summary>Dwell click mode</summary> <description>The active dwell click mode. Possible values are “window” and “gesture”.</description> </key> <key name="click-type-window-visible" type="b"> <default>true</default> <summary>Show click type window</summary> <description>Show click type window.</description> </key> <key name="dwell-click-enabled" type="b"> <default>false</default> <summary>Enable dwell clicks</summary> <description>Enable dwell clicks.</description> </key> <key name="secondary-click-enabled" type="b"> <default>false</default> <summary>Secondary click enabled</summary> <description>Enable simulated secondary clicks</description> </key> <key name="secondary-click-time" type="d"> <default>1.20</default> <summary>Secondary click time</summary> <description>Time in seconds before a simulated secondary click is triggered.</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.thumbnail-cache.gschema.xml 0000644 00000001130 15125157507 0016710 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.thumbnail-cache" path="/org/gnome/desktop/thumbnail-cache/"> <key name="maximum-age" type="i"> <default>180</default> <description>Maximum age for thumbnails in the cache, in days. Set to -1 to disable cleaning.</description> </key> <key name="maximum-size" type="i"> <default>512</default> <description>Maximum size of the thumbnail cache, in megabytes. Set to -1 to disable cleaning.</description> </key> </schema> </schemalist> schemas/org.gnome.desktop.background.gschema.xml 0000644 00000004361 15125157507 0016014 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.background" path="/org/gnome/desktop/background/"> <key name="picture-options" enum="org.gnome.desktop.GDesktopBackgroundStyle"> <default>'zoom'</default> <summary>Picture Options</summary> <description> Determines how the image set by wallpaper_filename is rendered. Possible values are “none”, “wallpaper”, “centered”, “scaled”, “stretched”, “zoom”, “spanned”. </description> </key> <key name="picture-uri" type="s"> <default>'file:///usr/share/backgrounds/gnome/adwaita-timed.xml'</default> <summary>Picture URI</summary> <description> URI to use for the background image. Note that the backend only supports local (file://) URIs. </description> </key> <key name="picture-opacity" type="i"> <range min="0" max="100"/> <default>100</default> <summary>Picture Opacity</summary> <description> Opacity with which to draw the background picture. </description> </key> <key name="primary-color" type="s"> <default>'#023c88'</default> <summary>Primary Color</summary> <description> Left or Top color when drawing gradients, or the solid color. </description> </key> <key name="secondary-color" type="s"> <default>'#5789ca'</default> <summary>Secondary Color</summary> <description> Right or Bottom color when drawing gradients, not used for solid color. </description> </key> <key name="color-shading-type" enum="org.gnome.desktop.GDesktopBackgroundShading"> <default>'solid'</default> <summary>Color Shading Type</summary> <description> How to shade the background color. Possible values are “horizontal”, “vertical”, and “solid”. </description> </key> <key name="show-desktop-icons" type="b"> <default>false</default> <summary>Have file manager handle the desktop</summary> <description> If set to true, then file manager will draw the icons on the desktop. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.datetime.gschema.xml 0000644 00000000667 15125157507 0015476 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.datetime" path="/org/gnome/desktop/datetime/"> <key name="automatic-timezone" type="b"> <default>false</default> <summary>Automatically update timezone</summary> <description>Whether to automatically update the timezone using geolocation.</description> </key> </schema> </schemalist> schemas/org.gtk.Settings.FileChooser.gschema.xml 0000644 00000014104 15125157507 0015702 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <!-- Copyright © 2010 Christian Persch This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1, 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library. If not, see <http://www.gnu.org/licenses/>. --> <schemalist> <enum id='org.gtk.Settings.FileChooser.LocationMode'> <value nick='path-bar' value='0'/> <value nick='filename-entry' value='1'/> </enum> <enum id='org.gtk.Settings.FileChooser.SortColumn'> <value nick='name' value='0'/> <value nick='size' value='1'/> <value nick='type' value='2'/> <value nick='modified' value='3'/> </enum> <enum id='org.gtk.Settings.FileChooser.SortOrder'> <value nick='ascending' value='0'/> <value nick='descending' value='1'/> </enum> <enum id='org.gtk.Settings.FileChooser.StartupMode'> <value nick='recent' value='0'/> <value nick='cwd' value='1'/> </enum> <enum id='org.gtk.Settings.FileChooser.ClockFormat'> <value nick='24h' value='0'/> <value nick='12h' value='1'/> </enum> <enum id='org.gtk.Settings.FileChooser.DateFormat'> <value nick='regular' value='0'/> <value nick='with-time' value='1'/> </enum> <enum id='org.gtk.Settings.FileChooser.TypeFormat'> <value nick='mime' value='0'/> <value nick='description' value='1'/> <value nick='category' value='2'/> </enum> <schema id='org.gtk.Settings.FileChooser' path='/org/gtk/settings/file-chooser/'> <key name='last-folder-uri' type='s'> <default>""</default> </key> <key name='location-mode' enum='org.gtk.Settings.FileChooser.LocationMode'> <default>'path-bar'</default> <summary>Location mode</summary> <description> Controls whether the file chooser shows just a path bar, or a visible entry for the filename as well, for the benefit of typing-oriented users. The possible values for these modes are "path-bar" and "filename-entry". </description> </key> <key name='show-hidden' type='b'> <default>false</default> <summary>Show hidden files</summary> <description> Controls whether the file chooser shows hidden files or not. </description> </key> <key type="b" name="sort-directories-first"> <default>false</default> <summary>Show folders first</summary> <description> If set to true, then folders are shown before files in the list. </description> </key> <key name='expand-folders' type='b'> <default>false</default> <summary>Expand folders</summary> <description>This key is deprecated; do not use it.</description> </key> <key name='show-size-column' type='b'> <default>true</default> <summary>Show file sizes</summary> <description> Controls whether the file chooser shows a column with file sizes. </description> </key> <key name='show-type-column' type='b'> <default>true</default> <summary>Show file types</summary> <description> Controls whether the file chooser shows a column with file types. </description> </key> <key name='sort-column' enum='org.gtk.Settings.FileChooser.SortColumn'> <default>'name'</default> <summary>Sort column</summary> <description> Can be one of "name", "modified", or "size". It controls which of the columns in the file chooser is used for sorting the list of files. </description> </key> <key name='sort-order' enum='org.gtk.Settings.FileChooser.SortOrder'> <default>'ascending'</default> <summary>Sort order</summary> <description> Can be one of the strings "ascending" or "descending". </description> </key> <key name='window-position' type='(ii)'> <default>(-1, -1)</default> <summary>Window position</summary> <description> The (x, y) coordinates of the upper-left corner of the GtkFileChooserDialog's window. </description> </key> <key name='window-size' type='(ii)'> <default>(-1, -1)</default> <summary>Window size</summary> <description> The size (width, height) of the GtkFileChooserDialog's window, in pixels. </description> </key> <key name='startup-mode' enum='org.gtk.Settings.FileChooser.StartupMode'> <default>'recent'</default> <summary>Startup mode</summary> <description> Either "recent" or "cwd"; controls whether the file chooser starts up showing the list of recently-used files, or the contents of the current working directory. </description> </key> <key name='sidebar-width' type='i'> <default>148</default> <summary>Sidebar width</summary> <description> Width in pixels of the file chooser's places sidebar. </description> </key> <key name="clock-format" enum="org.gtk.Settings.FileChooser.ClockFormat"> <default>'24h'</default> <summary>Time format</summary> <description> Whether the time is shown in 24h or 12h format. </description> </key> <key name="date-format" enum="org.gtk.Settings.FileChooser.DateFormat"> <default>'regular'</default> <summary>Date format</summary> <description> The amount of detail to show in the Modified column. </description> </key> <key name="type-format" enum="org.gtk.Settings.FileChooser.TypeFormat"> <default>'category'</default> <summary>Type format</summary> <description> Different ways to show the 'Type' column information. Example outputs for a video mp4 file: 'mime' -> 'video/mp4' 'description' -> 'MPEG-4 video' 'category' -> 'Video' </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.sound.gschema.xml 0000644 00000002037 15125157507 0015023 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.sound" path="/org/gnome/desktop/sound/"> <key name="event-sounds" type="b"> <default>true</default> <summary>Sounds for events</summary> <description>Whether to play sounds on user events.</description> </key> <key name="theme-name" type="s"> <default>'freedesktop'</default> <summary>Sound theme name</summary> <description>The XDG sound theme to use for event sounds.</description> </key> <key name="input-feedback-sounds" type="b"> <default>false</default> <summary>Input feedback sounds</summary> <description>Whether to play sounds on input events.</description> </key> <key type="b" name="allow-volume-above-100-percent"> <default>false</default> <summary>Allow volume above 100%</summary> <description>Whether volume can be set above 100%, using software amplification.</description> </key> </schema> </schemalist> schemas/org.gnome.system.locale.gschema.xml 0000644 00000000700 15125157507 0015000 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.system.locale" path="/system/locale/"> <key name="region" type="s"> <default>''</default> <summary>The locale to use for dates / numbers formats</summary> <description> Specify the locale to be used for displaying dates, times and numbers formats. </description> </key> </schema> </schemalist> schemas/org.gnome.desktop.calendar.gschema.xml 0000644 00000000653 15125157507 0015446 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?> <schemalist gettext-domain="gsettings-desktop-schemas"> <schema id="org.gnome.desktop.calendar" path="/org/gnome/desktop/calendar/"> <key name="show-weekdate" type="b"> <default>false</default> <summary>Show the week date in the calendar</summary> <description>If true, display the ISO week date in the calendar.</description> </key> </schema> </schemalist> codegen/__pycache__/dbustypes.cpython-39.pyc 0000644 00000022505 15125157507 0015047 0 ustar 00 a ]x a�O � @ sp d dl mZ d dlmZ G dd� d�ZG dd� d�ZG dd� d�ZG d d � d �ZG d d � d �ZG d d� d�ZdS )� )�utils)� print_errorc @ s e Zd Zdd� Zdd� ZdS )� Annotationc C s || _ || _g | _d| _d S �N� )�key�value� annotations�since)�selfr r � r �(/usr/share/glib-2.0/codegen/dbustypes.py�__init__ s zAnnotation.__init__c C s� | j }t�| jd�}t�|�r*|�� | _n(|r2|}t�|��� �dd��dd�| _t | j �dkr�t� | j�| _ t | j �dkr�|j | _ | jD ]}|� ||||| � q�d S )N�org.gtk.GDBus.C.Name�-�_�.� ) r r �lookup_annotationr � is_ugly_case�lowerZ key_lower�camel_case_to_uscore�replace�lenr � lookup_since� post_process) r �interface_prefix�cns� cns_upper� cns_lower� containerr Zoverridden_key�ar r r r ! s( � ��� zAnnotation.post_processN��__name__� __module__� __qualname__r r r r r r r s r c @ s e Zd Zdd� Zdd� ZdS )�Argc C s" || _ || _g | _d| _d| _d S r )�name� signaturer � doc_stringr )r r' r( r r r r < s z Arg.__init__c C s^ t | j�dkr t�| j�| _t | j�dkr8t�| j�| _| jd u rLd| | _d| _d| _ d| _ d| _ d| _ d| _ d| j | _d| j | _d| _d | _d | _t�| jd ��s:| jd kr�d | _d | _ d| _ d| _ d | _ d | _d | _d| _d| _�nL| jdk�r4d| _d| _ d| _ d| _ d | _ d| _d| _d| _d| _�n| jdk�rzd| _d| _ d| _ d | _ d | _ d| _d| _d | _d | _�n�| jd k�r�d | _d!| _ d"| _ d#| _ d | _ d | _d | _d$| _d%| _�nz| jd&k�rd| _d| _ d'| _ d | _ d | _ d&| _d&| _d(| _d | _�n4| jd)k�rLd | _d | _ d*| _ d#| _ d | _ d)| _d)| _d+| _d%| _�n�| jd,k�r�d-| _d-| _ d.| _ d/| _ d | _ d,| _d,| _d0| _d1| _�n�| jd2k�r�d3| _d3| _ d4| _ d5| _ d | _ d2| _d2| _d6| _d7| _�nb| jd8k�r d9| _d9| _ d:| _ d;| _ d | _ d8| _d8| _d<| _d=| _�n | jd>k�rjd?| _d?| _ d@| _ dA| _ dB| _ dC| _ d>| _d>| _dD| _dE| _�n�| jdFk�r�d?| _d?| _ d@| _ dA| _ dB| _ dC| _ dF| _dF| _dD| _dE| _�n�| jdGk�rd?| _d?| _ d@| _ dA| _ dB| _ dC| _ dG| _dG| _dD| _dE| _�n8| jdHk�rLd?| _d?| _ d@| _ dA| _ dB| _ dC| _ dI| _dI| _dJ| _dE| _n�| jdKk�r�dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dP| _dP| _dQ| _dR| _dS| _n�| jdTk�r�dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dU| _dU| _dV| _dR| _dS| _nN| jdWk�r:dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dX| _dX| _dY| _dR| _dS| _| jD ]}|�||||| � �q@d S )ZNr z unnamed_arg%dz GVariant *z GVariant **ZG_TYPE_VARIANTZg_variant_unref�@ZXXXZg_value_get_variantr z org.gtk.GDBus.C.ForceGVariant�bz gboolean z gboolean *ZG_TYPE_BOOLEANZg_variant_get_booleanZg_value_get_boolean�yzguchar zguchar *Z G_TYPE_UCHARZg_variant_get_byteZg_value_get_uchar�nzgint zgint16 zgint16 *Z G_TYPE_INTZg_variant_get_int16Zg_value_get_int�qzguint zguint16 z guint16 *Z G_TYPE_UINTZg_variant_get_uint16Zg_value_get_uint�izgint *Zg_variant_get_int32�uzguint *Zg_variant_get_uint32�xzgint64 zgint64 *Z G_TYPE_INT64Zg_variant_get_int64Zg_value_get_int64�tzguint64 z guint64 *Z G_TYPE_UINT64Zg_variant_get_uint64Zg_value_get_uint64�dzgdouble z gdouble *Z G_TYPE_DOUBLEZg_variant_get_doubleZg_value_get_double�sz const gchar *zgchar *zgchar **Z G_TYPE_STRINGZg_freeZg_variant_get_stringZg_value_get_string�o�gZayz^ayZg_variant_get_bytestring�aszconst gchar *const *z gchar ***Z G_TYPE_STRVZ g_strfreevz^asZg_variant_get_strvZg_value_get_boxedz(array zero-terminated=1)Zaoz^aoZg_variant_get_objvZaayz^aayZ g_variant_get_bytestring_array)r r) r � lookup_docsr r r r' Z ctype_in_gZctype_inZ ctype_in_dupZ ctype_outZgtypeZ free_funcr( Z format_inZ format_outZ gvariant_getZ gvalue_getZarray_annotationr r )r r r r r Z arg_numberr! r r r r C s� � zArg.post_processNr" r r r r r& ; s r& c @ s e Zd Zddd�Zdd� ZdS )�MethodTc C s: || _ || _g | _g | _g | _d| _d| _d| _d| _d S �Nr F) r' �h_type_implies_unix_fd�in_args�out_argsr r) r � deprecated�unix_fd)r r' r; r r r r s zMethod.__init__c C sx t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _d}| jD ]4} | �|||||� |d7 }| jr�d| jv r�d| _q�| jD ]4} | �|||||� |d7 }| jr�d| jv r�d| _q�t�| jd�d k�r>d| _t�| jd ��rTd| _| jD ]} | �||||| � �qZd S ) Nr r r r r �hT� org.freedesktop.DBus.Deprecated�truezorg.gtk.GDBus.C.UnixFD)r r) r r8 r r r r' r r r � name_lowerr r � name_hyphenr< r r; r( r? r= r> � r r r r r �containing_ifacer' �overridden_name� arg_countr! r r r r sH � �� zMethod.post_processN)Tr" r r r r r9 s r9 c @ s e Zd Zdd� Zdd� ZdS )�Signalc C s( || _ g | _g | _d| _d| _d| _d S r: )r' �argsr r) r r> �r r' r r r r G s zSignal.__init__c C s t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _d}| jD ] } | �|||||� |d7 }q�t�| jd�dkr�d| _| jD ]} | �||||| � q�d S ) Nr r r r r rA rB T)r r) r r8 r r r r' r r r rC r r rD rJ r r> rE r r r r O s6 � �� zSignal.post_processNr" r r r r rI F s rI c @ s e Zd Zdd� Zdd� ZdS )�Propertyc C s� || _ || _|| _g | _td| j�| _| j| j_d| _d| _| jdkrTd| _d| _n4| jdkrfd| _n"| jdkrxd| _ntd� | j�� d| _ d| _ d| _ d| _ d S ) Nr FZ readwriteT�read�writezInvalid access type "{}"r )r' r( �accessr r& �arg�readable�writabler �formatr) r r> �emits_changed_signal)r r' r( rO r r r r u s( zProperty.__init__c C s* t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _| j dkr�d| _ | j| j_| j�||||d� t�| jd�dkr�d | _| jD ]}|�||||| � q�t�| jd �d v �r&d | _d S ) Nr r r r �type�type_rA rB Tz0org.freedesktop.DBus.Property.EmitsChangedSignal)Zfalse�constF)r r) r r8 r r r r' r r r rC r r rD rP r r> rT ) r r r r r rF r' rG r! r r r r � sB � �� ��zProperty.post_processNr" r r r r rL t s rL c @ s e Zd Zdd� Zdd� ZdS )� Interfacec C s: || _ g | _g | _g | _g | _d| _d| _d| _d| _d S r: ) r' �methods�signals� propertiesr r) �doc_string_briefr r> rK r r r r � s zInterface.__init__c C sN t | j�dkr t�| j�| _t | j�dkr8t�| j�| _t | j�dkrTt�| j�| _t |�dkr�t� |�r�|� dd�}|� � d }|� � d }q�|}t� |�� � d }t� |�� � d }n d}d}d}t�| jd�}t� |��r |� dd�}|| }|| _|| _|| _||� � | _|� � | _n||�r,|}n"| j}|�|��rN|t |�d � }|| _t�|�}t�|d | �}|| _|| _|t� |� | _t� |�� � | _| j� � � dd�| _t�| jd�dk�r�d | _| jD ]} | �||||| � �q�| jD ]} | �||||| � �q�| j D ]} | �||||| � �q| jD ]} | �||||| � �q0d S ) Nr r r r r r rA rB T) r r) r r8 r r\ Zlookup_brief_docsr r r r �upperr r r Zname_without_prefixZ camel_nameZns_upperrC Z name_upperr' � startswithZ strip_dotsrD r> rY r rZ r[ ) r r Z c_namespacer r r rG r' Z name_with_ns�mr4 �pr! r r r r � sl � �� zInterface.post_processNr" r r r r rX � s rX N) r r r r r& r9 rI rL rX r r r r �<module> s ! P<.I codegen/__pycache__/parser.cpython-39.pyc 0000644 00000012471 15125157507 0014322 0 ustar 00 a ]x a�2 � @ s: d dl ZddlmZ ddlmZ G dd� d�Zdd� ZdS ) � N� )� dbustypes)� print_errorc @ sj e Zd ZdZdZdZdZdZdZdZ dZ d Z dd d �Z d Z dZdZdZdd� Zdd� Zdd� Zdd� ZdS )� DBusXMLParser�topZnodeZ interface�method�signal�property�arg� annotationZignoredTc C sx t jj�� | _| j| j_| j| j_| j | j_ | j | j_ g | _ d | _tj| _g | _d | _g | _d| _|| _| j�|� d S )N� )�xml�parsersZexpatZ ParserCreateZ_parser�handle_commentZCommentHandler�handle_char_dataZCharacterDataHandler�handle_start_elementZStartElementHandler�handle_end_elementZEndElementHandler�parsed_interfaces� _cur_objectr � STATE_TOP�state� state_stack�_cur_object_stack�doc_comment_last_symbol�_h_type_implies_unix_fdZParse)�self�xml_data�h_type_implies_unix_fd� r �%/usr/share/glib-2.0/codegen/parser.py�__init__' s zDBusXMLParser.__init__Zbegin�params�body�skipc C s� t j}|�d�}d}d}d}i }|D �]�}|} |�� }|t jkr�t|�dkr�|�d�} | dkr�|�d�r�|dt|�d � }t j}q�t j}nB|d| � }|| d d � � � } t| �dkr�|d | d 7 }t j}q$|t jk�r||� d ��rH|�d�} | dk�r"t j }|�s|d 7 }d }|| d 7 }n$|d| � } || d d � } | || < n2t j }t|�dk�r�|�sn|d 7 }d }|| d 7 }q$|t j kr$t|�dk�r�|�s�|d 7 }d }|| d 7 }q$|r$|d 7 }d}q$|�r�|d 7 }|dk�r�|| _ || _ || _d S )N� r Fr z: ����:r � z<para>z</para>�@T)r �COMMENT_STATE_BEGIN�split�lstrip�len�find�endswith�COMMENT_STATE_PARAMS�COMMENT_STATE_SKIP�strip� startswith�COMMENT_STATE_BODYr �doc_comment_params�doc_comment_body)r �dataZ comment_state�lines�symbolr" Zin_parar! �lineZ orig_lineZ colon_indexZ rest_of_lineZparamZdocsr r r r A sn z DBusXMLParser.handle_commentc C s d S �Nr )r r6 r r r r � s z DBusXMLParser.handle_char_datac C s | j }| j}| j tjkr$tj| _ �n�| j tjkrP|tjkrDtj| _ ntj| _ �n�| j tjk�r:|tjkr�tj| _ t�|d �}|| _| j � |� nD|tj kr�tj | _ t� |d |d �}| jj � |� || _ntj| _ d|v �r�| j|d k�r�| j| j_d| jv �r| jd }|| j_d| jv �r�| jd �� | j_�n�| j tjk�r�|tjk�r�tj| _ tj|d | jd�}| jj� |� || _n�|tjk�r�tj| _ t�|d �} | jj� | � | | _n�|tj k�rtj | _ t� |d |d |d �} | jj � | � | | _nF|tj k�r@tj | _ t� |d |d �}| jj � |� || _ntj| _ d|v �r�| j|d k�r�| j| j_d| jv �r�| jd �� | j_�np| j tjk�r�|tj k�r,tj | _ d } d|v �r�|d } t� | |d �} |�!dd �} | d k�r�| jj"� | � n(| d k�r| jj#� | � nt$d �%| �� | | _nF|tj k�rjtj | _ t� |d |d �}| jj � |� || _ntj| _ | j|j&k�r�d|v �r�|d | jv �r�| j|d }|d u�r�|| j_d| jv �r�| jd �� | j_�n"| j tjk�r�|tj k�r:tj | _ d } d|v �r|d } t� | |d �} | jj'� | � | | _nF|tj k�rxtj | _ t� |d |d �}| jj � |� || _ntj| _ | j|j&k�r�d|v �r�|d | jv �r�| j|d }|d u�r�|| j_d| jv �r�| jd �� | j_�n| j tj k�r@|tj k�r6tj | _ t� |d |d �}| jj � |� || _ntj| _ n�| j tj k�r�|tj k�r�tj | _ t� |d |d �}| jj � |� || _ntj| _ nh| j tj k�r�|tj k�r�tj | _ t� |d |d �}| jj � |� || _ntj| _ nt$d �%| j |�� | j(� |� | j)� |� d S ) N�name�value�short_description�since)r �type�access� direction�in�outzInvalid direction "{}"z:Unhandled state "{}" while entering element with name "{}")*r r r � STATE_IGNOREDr � STATE_NODE�STATE_INTERFACEr Z Interfacer �append�STATE_ANNOTATIONZ Annotation� annotationsr r5 � doc_stringr4 Zdoc_string_briefr1 r> � STATE_METHODZMethodr �methods� STATE_SIGNALZSignalZsignals�STATE_PROPERTYZPropertyZ properties� STATE_ARGZArg�getZin_argsZout_argsr �formatr; �argsr r )r r; �attrsZ old_stateZold_cur_objectZifaceZannor= r r ZpropZarg_namer rA rJ r r r r � s � � � �� z"DBusXMLParser.handle_start_elementc C s | j �� | _| j�� | _d S r: )r �popr r r )r r; r r r r ( s z DBusXMLParser.handle_end_elementN)T)�__name__� __module__� __qualname__r rE rF rK rM rN rO rH rD r r) r/ r3 r0 r r r r r r r r r s& ? %r c C s t | |�}|jS r: )r r )r r �parserr r r �parse_dbus_xml- s rY )Zxml.parsers.expatr r r Zutilsr r rY r r r r �<module> s codegen/__pycache__/parser.cpython-39.opt-1.pyc 0000644 00000012471 15125157507 0015261 0 ustar 00 a ]x a�2 � @ s: d dl ZddlmZ ddlmZ G dd� d�Zdd� ZdS ) � N� )� dbustypes)� print_errorc @ sj e Zd ZdZdZdZdZdZdZdZ dZ d Z dd d �Z d Z dZdZdZdd� Zdd� Zdd� Zdd� ZdS )� DBusXMLParser�topZnodeZ interface�method�signal�property�arg� annotationZignoredTc C sx t jj�� | _| j| j_| j| j_| j | j_ | j | j_ g | _ d | _tj| _g | _d | _g | _d| _|| _| j�|� d S )N� )�xml�parsersZexpatZ ParserCreateZ_parser�handle_commentZCommentHandler�handle_char_dataZCharacterDataHandler�handle_start_elementZStartElementHandler�handle_end_elementZEndElementHandler�parsed_interfaces� _cur_objectr � STATE_TOP�state� state_stack�_cur_object_stack�doc_comment_last_symbol�_h_type_implies_unix_fdZParse)�self�xml_data�h_type_implies_unix_fd� r �%/usr/share/glib-2.0/codegen/parser.py�__init__' s zDBusXMLParser.__init__Zbegin�params�body�skipc C s� t j}|�d�}d}d}d}i }|D �]�}|} |�� }|t jkr�t|�dkr�|�d�} | dkr�|�d�r�|dt|�d � }t j}q�t j}nB|d| � }|| d d � � � } t| �dkr�|d | d 7 }t j}q$|t jk�r||� d ��rH|�d�} | dk�r"t j }|�s|d 7 }d }|| d 7 }n$|d| � } || d d � } | || < n2t j }t|�dk�r�|�sn|d 7 }d }|| d 7 }q$|t j kr$t|�dk�r�|�s�|d 7 }d }|| d 7 }q$|r$|d 7 }d}q$|�r�|d 7 }|dk�r�|| _ || _ || _d S )N� r Fr z: ����:r � z<para>z</para>�@T)r �COMMENT_STATE_BEGIN�split�lstrip�len�find�endswith�COMMENT_STATE_PARAMS�COMMENT_STATE_SKIP�strip� startswith�COMMENT_STATE_BODYr �doc_comment_params�doc_comment_body)r �dataZ comment_state�lines�symbolr" Zin_parar! �lineZ orig_lineZ colon_indexZ rest_of_lineZparamZdocsr r r r A sn z DBusXMLParser.handle_commentc C s d S �Nr )r r6 r r r r � s z DBusXMLParser.handle_char_datac C s | j }| j}| j tjkr$tj| _ �n�| j tjkrP|tjkrDtj| _ ntj| _ �n�| j tjk�r:|tjkr�tj| _ t�|d �}|| _| j � |� nD|tj kr�tj | _ t� |d |d �}| jj � |� || _ntj| _ d|v �r�| j|d k�r�| j| j_d| jv �r| jd }|| j_d| jv �r�| jd �� | j_�n�| j tjk�r�|tjk�r�tj| _ tj|d | jd�}| jj� |� || _n�|tjk�r�tj| _ t�|d �} | jj� | � | | _n�|tj k�rtj | _ t� |d |d |d �} | jj � | � | | _nF|tj k�r@tj | _ t� |d |d �}| jj � |� || _ntj| _ d|v �r�| j|d k�r�| j| j_d| jv �r�| jd �� | j_�np| j tjk�r�|tj k�r,tj | _ d } d|v �r�|d } t� | |d �} |�!dd �} | d k�r�| jj"� | � n(| d k�r| jj#� | � nt$d �%| �� | | _nF|tj k�rjtj | _ t� |d |d �}| jj � |� || _ntj| _ | j|j&k�r�d|v �r�|d | jv �r�| j|d }|d u�r�|| j_d| jv �r�| jd �� | j_�n"| j tjk�r�|tj k�r:tj | _ d } d|v �r|d } t� | |d �} | jj'� | � | | _nF|tj k�rxtj | _ t� |d |d �}| jj � |� || _ntj| _ | j|j&k�r�d|v �r�|d | jv �r�| j|d }|d u�r�|| j_d| jv �r�| jd �� | j_�n| j tj k�r@|tj k�r6tj | _ t� |d |d �}| jj � |� || _ntj| _ n�| j tj k�r�|tj k�r�tj | _ t� |d |d �}| jj � |� || _ntj| _ nh| j tj k�r�|tj k�r�tj | _ t� |d |d �}| jj � |� || _ntj| _ nt$d �%| j |�� | j(� |� | j)� |� d S ) N�name�value�short_description�since)r �type�access� direction�in�outzInvalid direction "{}"z:Unhandled state "{}" while entering element with name "{}")*r r r � STATE_IGNOREDr � STATE_NODE�STATE_INTERFACEr Z Interfacer �append�STATE_ANNOTATIONZ Annotation� annotationsr r5 � doc_stringr4 Zdoc_string_briefr1 r> � STATE_METHODZMethodr �methods� STATE_SIGNALZSignalZsignals�STATE_PROPERTYZPropertyZ properties� STATE_ARGZArg�getZin_argsZout_argsr �formatr; �argsr r )r r; �attrsZ old_stateZold_cur_objectZifaceZannor= r r ZpropZarg_namer rA rJ r r r r � s � � � �� z"DBusXMLParser.handle_start_elementc C s | j �� | _| j�� | _d S r: )r �popr r r )r r; r r r r ( s z DBusXMLParser.handle_end_elementN)T)�__name__� __module__� __qualname__r rE rF rK rM rN rO rH rD r r) r/ r3 r0 r r r r r r r r r s& ? %r c C s t | |�}|jS r: )r r )r r �parserr r r �parse_dbus_xml- s rY )Zxml.parsers.expatr r r Zutilsr r rY r r r r �<module> s codegen/__pycache__/codegen_docbook.cpython-39.pyc 0000644 00000026625 15125157507 0016140 0 ustar 00 a ]x a�H � @ s2 d dl Z d dlmZ ddlmZ G dd� d�ZdS )� N)�path� )�utilsc @ s| e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd S ) �DocbookCodeGeneratorc C s || _ | �� d S )N)�ifaces�generate_expand_dicts)�selfr � r �./usr/share/glib-2.0/codegen/codegen_docbook.py�__init__$ s z DocbookCodeGenerator.__init__c C s� d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|r�|j D ]<}|jD ]}tt|j�|�}qN|jD ]}tt|j�|�}qjqDn8|jD ]}tt|j�|�}q�|jD ]}tt|j�|�}q�|r�| j�dt � |j�|j|j|t|j� df � n"| j�d|j|t|j� df � d}|jD ]V}|dk�rD| j�d|d df � | j�d|j|t|j� d|jf � |d }�q |jD ]V}|dk�r�| j�d|d df � | j�d |j|t|j� d|jf � |d }�q|| j�d � d S ) Nr z1<link linkend="gdbus-method-%s.%s">%s</link>%*s (� �%s%*s (�, %*s� z IN %s%*s %sr z OUT %s%*s %s�); ) �methods�max�len�name�in_args� signature�out_args�out�writer �dots_to_hyphens) r �i�m� in_synopsisZmax_method_lenZ_m�max_signature_len�a�countr r r �print_method_prototype( s` ��� " �� �� z+DocbookCodeGenerator.print_method_prototypec C sL d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|rh|j D ] }|jD ]}tt|j�|�}qNqDn |jD ]}tt|j�|�}qn|r�| j�dt� |j�|j|j|t|j� df � n"| j�d|j|t|j� df � d}|jD ]T}|dk�r | j�d|d df � | j�d|j|t|j� d|jf � |d }q�| j�d � d S ) Nr z1<link linkend="gdbus-signal-%s.%s">%s</link>%*s (r r r r z%s%*s %sr r ) �signalsr r r �argsr r r r r ) r r �sr Zmax_signal_lenZ_sr r r r r r �print_signal_prototype] sF ��� " �� z+DocbookCodeGenerator.print_signal_prototypec C s d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|r\|j D ]}tt|j�|�}qDntt|j�|�}|r�| j�dt�|j�|j|j|t|j� df � n"| j�d|j|t|j� df � |j r�|j r�d}n|j r�d}nd}| j�d||jf � d S ) Nr z1<link linkend="gdbus-property-%s.%s">%s</link>%*sr z%s%*sZ readwritez readable z writable z %s %s ) � propertiesr r r r r r r r �readable�writable)r r �pr Zmax_property_lenZ_pr �accessr r r �print_property_prototype� s8 ��� " z-DocbookCodeGenerator.print_property_prototypec C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz# <refsynopsisdiv role="synopsis"> z1 <title role="synopsis.title">Methods</title> � <synopsis> T�r � </synopsis> z </refsynopsisdiv> )r r r r! )r r r r r r �print_synopsis_methods� s z+DocbookCodeGenerator.print_synopsis_methodsc C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz! <refsect1 role="signal_proto"> z5 <title role="signal_proto.title">Signals</title> r, Tr- r. � </refsect1> )r r r" r% )r r r$ r r r �print_synopsis_signals� s z+DocbookCodeGenerator.print_synopsis_signalsc C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz <refsect1 role="properties"> z6 <title role="properties.title">Properties</title> r, Tr- r. r0 )r r r& r+ �r r r) r r r �print_synopsis_properties� s z.DocbookCodeGenerator.print_synopsis_propertiesc C s� | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � |j s�|j �rt| j �d � |j D ]N}| j �d � | j �d |j |jf � | j �d | �|jd � � | j �d� q�|j D ]P}| j �d � | j �d|j |jf � | j �d | �|jd � � | j �d� �q| j �d� t |j �dk�r�| j �d|j � |j�r�| j �d|j � | j �d� d S )Nz1<refsect2 role="method" id="gdbus-method-%s.%s"> z! <title>The %s() method</title> z] <indexterm zone="gdbus-method-%s.%s"><primary sortas="%s.%s">%s.%s()</primary></indexterm> �<programlisting> Fr- �</programlisting> �%s T� <variablelist role="params"> �<varlistentry> zC <term><literal>IN %s <parameter>%s</parameter></literal>:</term> � <listitem>%s</listitem> �</varlistentry> zD <term><literal>OUT %s <parameter>%s</parameter></literal>:</term> �</variablelist> r �#<para role="since">Since %s</para> z><warning><para>The %s() method is deprecated.</para></warning>� </refsect2> )r r r r r �name_without_prefixr! � expand_paras� doc_stringr r r r �since� deprecated)r r r r r r r � print_method� sv �� ��� �� �� �� �� ��z!DocbookCodeGenerator.print_methodc C sb | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � |j �r| j �d � |j D ]N}| j �d � | j �d |j |jf � | j �d | �|jd � � | j �d� q�| j �d� t |j �dk�r8| j �d|j � |j �rR| j �d|j � | j �d� d S )Nz1<refsect2 role="signal" id="gdbus-signal-%s.%s"> z! <title>The "%s" signal</title> z] <indexterm zone="gdbus-signal-%s.%s"><primary sortas="%s::%s">%s::%s</primary></indexterm> r4 Fr- r5 r6 Tr7 r8 z@ <term><literal>%s <parameter>%s</parameter></literal>:</term> r9 r: r; r r< z><warning><para>The "%s" signal is deprecated.</para></warning>r= )r r r r r r> r% r? r@ r# r r rA rB )r r r$ r r r r � print_signal� s\ �� ��� �� �� ��z!DocbookCodeGenerator.print_signalc C s� | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � t |j �d kr�| j �d |j � |j r�| j �d |j � | j �d � d S )Nz5<refsect2 role="property" id="gdbus-property-%s.%s"> z# <title>The "%s" property</title> z] <indexterm zone="gdbus-property-%s.%s"><primary sortas="%s:%s">%s:%s</primary></indexterm> r4 Fr- r5 r6 Tr r< z@<warning><para>The "%s" property is deprecated.</para></warning>r= ) r r r r r r> r+ r? r@ r rA rB r2 r r r �print_property( s< �� ��� ��z#DocbookCodeGenerator.print_propertyc C sh | j D ]}|�|| j| �}q| jD ]}|�|| j| �}q$|rdt�ddd� |�}t�ddd� |�}|S )Nz@[a-zA-Z0-9_]*c S s d| � d�dd � d S )Nz <parameter>r r z </parameter>��group�r r r r �<lambda>O � z-DocbookCodeGenerator.expand.<locals>.<lambda>z%[a-zA-Z0-9_]*c S s d| � d�dd � d S )Nz <constant>r r z </constant>rF rH r r r rI U rJ )�expand_member_dict_keys�replace�expand_member_dict�expand_iface_dict_keys�expand_iface_dict�re�sub)r r$ �expandParamsAndConstants�keyr r r �expandF s ��zDocbookCodeGenerator.expandc C s& | � ||��� }|�d�s"d| }|S )Nz<paraz<para>%s</para>)rT �strip� startswith)r r$ rR r r r r? Z s z!DocbookCodeGenerator.expand_parasc C s. i | _ i | _| jD ]�}d|j }dt�|j�|jf }|| j|< |jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< qF|jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< q�|jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< q�qt | j � � d d �| _ t | j� � d d �| _ d S ) Nz#%sz8<link linkend="gdbus-interface-%s.top_of_page">%s</link>z%s.%s()z.<link linkend="gdbus-method-%s.%s">%s()</link>z#%s::%sz.<link linkend="gdbus-signal-%s.%s">"%s"</link>z#%s:%sz0<link linkend="gdbus-property-%s.%s">"%s"</link>T)�reverse) rM rO r r r r r r" r& �sorted�keysrK rN )r r rS �valuer r$ r) r r r r ` sN � � � � � �z*DocbookCodeGenerator.generate_expand_dictsc C s� | j D �]�}tt�|d||jf �d�| _| j�d� | j�d� | j�d� | j�d� | j�d� | j�d|j � | j�d � | j�d t�|j�|jf � | j�d t�|j�|j |jf � | j�d � | j�d � | j�d|j � | j�d|j � | j�d� t |j �dk�r&| � |� t |j�dk�r@| �|� t |j�dk�rZ| �|� | j�dt�|j� � | j�d� | j�d| �|jd� � t |j�dk�r�| j�d|j � |j�r�| j�d|j � | j�d� t |j �dk�r4| j�d|j � | j�d� |j D ]}| �||� �q| j�d� t |j�dk�r�| j�d|j � | j�d � |jD ]}| �||� �qh| j�d� t |j�dk�r�| j�d |j � | j�d � |jD ]}| �||� �q�| j�d� | j�d � | j�d � qd S )!Nz %s-%s.xml�wr z'<?xml version="1.0" encoding="utf-8"?> zA<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" zL "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ z]> z<refentry id="gdbus-%s"> z <refmeta>z] <refentrytitle role="top_of_page" id="gdbus-interface-%s.top_of_page">%s</refentrytitle> za <indexterm zone="gdbus-interface-%s.top_of_page"><primary sortas="%s">%s</primary></indexterm> z </refmeta>z <refnamediv>z <refname>%s</refname>z <refpurpose>%s</refpurpose>z </refnamediv>r z/<refsect1 role="desc" id="gdbus-interface-%s"> z/ <title role="desc.title">Description</title> z %s Tz% <para role="since">Since %s</para> z?<warning><para>The %s interface is deprecated.</para></warning>z </refsect1> z0<refsect1 role="details" id="gdbus-methods-%s"> z5 <title role="details.title">Method Details</title> z0<refsect1 role="details" id="gdbus-signals-%s"> z5 <title role="details.title">Signal Details</title> z3<refsect1 role="details" id="gdbus-properties-%s"> z7 <title role="details.title">Property Details</title> z </refentry> � )r �openr �joinr r r r r r> Zdoc_string_briefr r r/ r" r1 r& r3 r? r@ rA rB rC rD rE )r ZdocbookZoutdirr r r$ r r r �generate� s� �� ���� �� �� � � �� z DocbookCodeGenerator.generateN)�__name__� __module__� __qualname__r r! r% r+ r/ r1 r3 rC rD rE rT r? r r_ r r r r r # s 5)$ 7, +r )rP �osr r r r r r r r �<module> s codegen/__pycache__/codegen.cpython-39.opt-1.pyc 0000644 00000356367 15125157507 0015410 0 ustar 00 a ]x a�� � @ s� d dl mZ d dl mZ d dl mZ d dlmZ dZdd� Zdd � ZG d d � d �ZG d d � d �Z G dd� d�Z G dd� d�Z dS )� )�config)�utils)� dbustypes)� print_errorz�/* * This file is generated by gdbus-codegen, do not modify it. * * The license of this code is the same as for the D-Bus interface description * it was derived from. Note that it links to GLib, so must comply with the * LGPL linking clauses. */ c C sx | }t | �dkrft�| �r@| �dd�}| �� d }| �� d }qnt�| ��� d }t�| ��� d }nd}d}|||fS )N� �_� )�lenr Z is_ugly_case�replace�upper�lowerZcamel_case_to_uscore)� namespace�ns�ns_upper�ns_lower� r �&/usr/share/glib-2.0/codegen/codegen.py�generate_namespace* s r c s d� d� t� fdd�| �� ��S )NZ$0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZr c s | � v r | S dS )Nr r )�c�Zsafe_valid_charsr r �<lambda>@ � z'generate_header_guard.<locals>.<lambda>)�join�mapr )� header_namer r r �generate_header_guard; s �r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) �HeaderCodeGeneratorc C sX || _ t|�\| _| _| _|| _|| _t|�| _|| _ || _ || _ | | _ | | _ | | _d S �N)�ifacesr r r r �generate_objmanager�generate_autocleanupr � header_guard�input_files_basenames� use_pragma�glib_min_required�symbol_decorator�symbol_decorator_header�outfile) �selfr r r r r r" r# r$ r% r& r' r r r �__init__E s z HeaderCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | j�d� | jrB| j�d� n(| j�d�| j �� | j�d�| j �� | j d ur�| j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d� d S � N�, � z #pragma once z#ifndef __{!s}__ z#define __{!s}__ z#include "%s" z#include <gio/gio.h> zG_BEGIN_DECLS � r r" r' �write� LICENSE_STR�formatr �VERSIONr# r! r& �r( Z basenamesr r r �generate_header_preamblea s z,HeaderCodeGenerator.generate_header_preamblec C s� | j D �]p}| j�d� | j�d� | j�d|j � | j�d� | j�d|j|j|jf � | j�d|j|j|j|j|jf � | j�d|j|j|j|jf � | j�d|j|j|j|j|jf � | j�d� | j�d|j � | j�d |j|jf � | j�d |j|jf � | j�d� | j�d |j � | j�d � | j�d � i }t|j �dk�r�| j�d� |j D ]x}|j d|j f}d|j }|d|j 7 }|d7 }|j �r�|d7 }|j D ]}|d|j |jf 7 }�q�|d7 }|||< �qpt|j�dk�rn| j�d� |jD ]`}|j d|j f}d|j }|d|j 7 }|jD ]}|d|j |jf 7 }�q>|d7 }|||< �q t|j�dk�r�| j�d� |jD ]4}|j d|j f}d|jj |j|jf }|||< �q�t|�� tjd�D ]}| j�d || � �q�| j�d � | j�d� | jd k�rN| j�d � | j�d |j � | j�d!� | j�d� | jd u�rl| j�d"| j � | j�d#|j � | j�d� | jd u�r�| j�d"| j � | j�d$|j � | jd u�r�| j�d"| j � | j�d%|j � | j�d� t|j �dk�r�| j�d� | j�d&� |j D ]�}| jd u�rF| j�d"| j � |j�rZ| j�d'� | j�d(|j|j|jf � |j �r�| j�d� |jD ] }| j�d)|j |jf � �q�| j�d*� | j�d� �q$| j�d� t|j�dk�r�| j�d� | j�d+� |jD ]�}| jd u�r(| j�d"| j � |j�r<| j�d'� | j�d,|j|j|jf � |jD ] }| j�d|j |jf � �q^| j�d*� | j�d� �q| j�d� t|j �dk�r4| j�d� | j�d-� |j D �]P}| jd u�r�| j�d"| j � |j�r | j�d'� | j�d.|j|j|jf � |j D ] }| j�d|j |jf � �q.| jd/k�rf| j�d0� |j �rz| j�d� | j�d1� | j�d� | jd u�r�| j�d"| j � |j�r�| j�d'� | j�d2|j|j|jf � |jD ] }| j�d3|j|jf � �q�|j �r| j�d4� | j�d5� | j�d� | jd u�rP| j�d"| j � |j�rd| j�d'� | j�d6|j|j|jf � |j D ] }| j�d|j |jf � �q�| jd/k�r�| j�d0� |j �r�| j�d7� |jD ] }| j�d3|j|jf � �q�|j �r | j�d4� | j�d8� | j�d� �q�| j�d� t|j�dk� r�| j�d� | j�d9� |jD �] }| jd u�r�| j�d"| j � |j�r�| j�d'� | j�d:|jj |j|j|jf � |jj d u� r | jd u�r�| j�d"| j � |j�r�| j�d'� | j�d;|jj |j|j|jf � | jd u� r<| j�d"| j � |j� rP| j�d'� | j�d<|j|j|j|jj f � | j�d� �qb| j�d� | j�d=� | j�d� | j�d>|j|j|jf � | j�d?|j|j|j|j|jf � | j�d@|j|j|j|j|jf � | j�dA|j|j|j|j|jf � | j�dB|j|j|j|jf � | j�dC|j|j|j|jf � | j�d� | j�dD|j|jf � | j�dE|j|jf � | j�dF|j|jf � | j�d� | j�dG|j � | j�d � | j�dH� | j�dI� | j�dJ|j � | j�d � | j�d� | j�dK|j � | j�d � | j�dL� | j�d � | j�d� | jd u� r�| j�d"| j � | j�dM|j � | j�d� | jdNv � r�| j�d � | j�dO|j � | j�d!� | j�d� | jd u� r | j�d"| j � |j� r | j�d'� | j�dP|j � | jd u� rP| j�d"| j � |j� rd| j�d'� | j�dQ|j|jf � | jd u� r�| j�d"| j � |j� r�| j�d'� | j�dR|j|jf � | j�d� | jd u� r�| j�d"| j � |j� r| j�d'� | j�dS|j � | jd u� r4| j�d"| j � |j� rH| j�d'� | j�dT|j|jf � | jd u� r~| j�d"| j � |j� r�| j�d'� | j�dU|j|jf � | j�d� | j�d� | j�d=� | j�d� | j�dV|j|j|jf � | j�dW|j|j|j|j|jf � | j�dX|j|j|j|j|jf � | j�dY|j|j|j|j|jf � | j�dZ|j|j|j|jf � | j�d[|j|j|j|jf � | j�d� | j�d\|j|jf � | j�d]|j|jf � | j�d^|j|jf � | j�d� | j�d_|j � | j�d � | j�dH� | j�d`� | j�da|j � | j�d � | j�d� | j�db|j � | j�d � | j�dc� | j�d � | j�d� | jd u�r�| j�d"| j � | j�dd|j � | j�d� | jdNv �r"| j�d � | j�de|j � | j�d!� | j�d� | jd u�r@| j�d"| j � |j�rT| j�d'� | j�df|j|jf � | j�d� q| j �r�| j�d� | j�d=� | j�d� | j�dg| j| j f � | j�dh| j| j| j f � | j�di| j| jf � | j�dj| j| j| j f � | j�d� | j�dk| j � | j�dl| j | j f � | j�dm| j | j f � | j�d� | j�dn| j � | j�do� | jd u�r�| j�d"| j � | j�dp| j � | jd k�r�| j�d � | j�dq| j � | j�d!� | j�d� | j D ]\}| jd u�r | j�d"| j � |j�r4| j�d'� | j�dr|j| j |j�!� | j f � �q�| j D ]\}| jd u�r�| j�d"| j � |j�r�| j�d'� | j�ds|j| j |j�!� | j f � �qb| j�d� | j�dt| j| j f � | j�du| j| j| j f � | j�dv| j| j| j f � | j�dw| j| j| j f � | j�dx| j| jf � | j�dy| j| jf � | j�d� | j�dz| j | j f � | j�d{| j | j f � | j�d|| j | j f � | j�d� | j�d}| j � | j�d � | j�dH� | j�d~� | j�d| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jdNv �r�| j�d � | j�d�| j � | j�d!� | j�d� | jd u�r| j�d"| j � | j�d�| j | j f � | j�d� | j�d�| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| jf � | j�d�| j| jf � | j�d� | j�d�| j | j f � | j�d�| j | j f � | j�d�| j | j f � | j�d� | j�d�| j � | j�d � | j�dH� | j�d�� | j�d�| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jdNv �rF| j�d � | j�d�| j � | j�d!� | j�d� | jd u�rd| j�d"| j � | j�d�| j | j f � | j D ]\}| jd u�r�| j�d"| j � |j�r�| j�d'� | j�d�| j |j�!� | j |jf � �q�| j�d� | j�d=� | j�d� | j�d�| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| jf � | j�d�| j| jf � | j�d� | j�d�| j | j f � | j�d�| j | j f � | j�d�| j | j f � | j�d� | j�d�| j � | j�d � | j�dH� | j�d�� | j�d�| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jdNv �r�| j�d � | j�d�| j � | j�d!� | j�d� | jd u�r| j�d"| j � | j�d�| j � | j�d� | jd u�r>| j�d"| j � | j�d�| j � | j�d� | jd u�rz| j�d"| j � | j�d�| j � | jd u�r�| j�d"| j � | j�d�| j � | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jd u�r| j�d"| j � | j�d�| j � | jd u�rF| j�d"| j � | j�d�| j � | jd u�rv| j�d"| j � | j�d�| j � | j�d� d S )�Nr, �O/* ------------------------------------------------------------------------ */ z/* Declarations for %s */ z##define %sTYPE_%s (%s_get_type ()) zB#define %s%s(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s, %s)) zA#define %sIS_%s(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s)) zT#define %s%s_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_%s, %sIface)) z struct _%s; ztypedef struct _%s %s; z!typedef struct _%sIface %sIface; zstruct _%sIface �{ z GTypeInterface parent_iface; r � _method_%sz gboolean (*handle_%s) ( z %s *object, z% GDBusMethodInvocation *invocation�, GUnixFDList *fd_list�, %sarg_%sz); � _signal_%sz void (*%s) ( z %s *object� _prop_get_%sz %s (*get_%s) (%s *object); ��key�%s�}; �allz!#if GLIB_CHECK_VERSION(2, 44, 0) z3G_DEFINE_AUTOPTR_CLEANUP_FUNC (%s, g_object_unref) �#endif z%s z'GType %s_get_type (void) G_GNUC_CONST; z.GDBusInterfaceInfo *%s_interface_info (void); zMguint %s_override_properties (GObjectClass *klass, guint property_id_begin); z./* D-Bus method call completion functions: */ zG_GNUC_DEPRECATED zKvoid %s_complete_%s ( %s *object, GDBusMethodInvocation *invocation� , %s%s�); z(/* D-Bus signal emissions functions: */ z void %s_emit_%s ( %s *objectz/* D-Bus method calls: */ z void %s_call_%s ( %s *proxy�� �@ �6, GDBusCallFlags call_flags, gint timeout_msecz\, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); z*gboolean %s_call_%s_finish ( %s *proxy�, %sout_%s� , GUnixFDList **out_fd_listz., GAsyncResult *res, GError **error); z(gboolean %s_call_%s_sync ( %s *proxy�, GUnixFDList *fd_listz6, GCancellable *cancellable, GError **error); z /* D-Bus property accessors: */ z%s%s_get_%s (%s *object); z%s%s_dup_%s (%s *object); z&void %s_set_%s (%s *object, %svalue); z /* ---- */ z/#define %sTYPE_%s_PROXY (%s_proxy_get_type ()) zS#define %s%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_PROXY, %sProxy)) z[#define %s%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_PROXY, %sProxyClass)) za#define %s%s_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_PROXY, %sProxyClass)) zM#define %sIS_%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_PROXY)) zP#define %sIS_%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_PROXY)) z!typedef struct _%sProxy %sProxy; z+typedef struct _%sProxyClass %sProxyClass; z/typedef struct _%sProxyPrivate %sProxyPrivate; zstruct _%sProxy z /*< private >*/ z GDBusProxy parent_instance; z %sProxyPrivate *priv; zstruct _%sProxyClass z GDBusProxyClass parent_class; z-GType %s_proxy_get_type (void) G_GNUC_CONST; )Zobjectsr? z8G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sProxy, g_object_unref) a void %s_proxy_new ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); zY%s *%s_proxy_new_finish ( GAsyncResult *res, GError **error); z�%s *%s_proxy_new_sync ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); a void %s_proxy_new_for_bus ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); za%s *%s_proxy_new_for_bus_finish ( GAsyncResult *res, GError **error); z�%s *%s_proxy_new_for_bus_sync ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); z5#define %sTYPE_%s_SKELETON (%s_skeleton_get_type ()) z\#define %s%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_SKELETON, %sSkeleton)) zd#define %s%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_SKELETON, %sSkeletonClass)) zj#define %s%s_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_SKELETON, %sSkeletonClass)) zS#define %sIS_%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_SKELETON)) zV#define %sIS_%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_SKELETON)) z'typedef struct _%sSkeleton %sSkeleton; z1typedef struct _%sSkeletonClass %sSkeletonClass; z5typedef struct _%sSkeletonPrivate %sSkeletonPrivate; zstruct _%sSkeleton z* GDBusInterfaceSkeleton parent_instance; z %sSkeletonPrivate *priv; zstruct _%sSkeletonClass z, GDBusInterfaceSkeletonClass parent_class; z0GType %s_skeleton_get_type (void) G_GNUC_CONST; z;G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sSkeleton, g_object_unref) z %s *%s_skeleton_new (void); z-#define %sTYPE_OBJECT (%sobject_get_type ()) zP#define %sOBJECT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT, %sObject)) zI#define %sIS_OBJECT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT)) z]#define %sOBJECT_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_OBJECT, %sObject)) zstruct _%sObject; z#typedef struct _%sObject %sObject; z-typedef struct _%sObjectIface %sObjectIface; zstruct _%sObjectIface z%{ GTypeInterface parent_iface; }; z.GType %sobject_get_type (void) G_GNUC_CONST; z9G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObject, g_object_unref) z(%s *%sobject_get_%s (%sObject *object); z)%s *%sobject_peek_%s (%sObject *object); z9#define %sTYPE_OBJECT_PROXY (%sobject_proxy_get_type ()) za#define %sOBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_PROXY, %sObjectProxy)) zi#define %sOBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_PROXY, %sObjectProxyClass)) zo#define %sOBJECT_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_PROXY, %sObjectProxyClass)) zU#define %sIS_OBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_PROXY)) zX#define %sIS_OBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_PROXY)) z-typedef struct _%sObjectProxy %sObjectProxy; z7typedef struct _%sObjectProxyClass %sObjectProxyClass; z;typedef struct _%sObjectProxyPrivate %sObjectProxyPrivate; zstruct _%sObjectProxy z$ GDBusObjectProxy parent_instance; z %sObjectProxyPrivate *priv; zstruct _%sObjectProxyClass z& GDBusObjectProxyClass parent_class; z3GType %sobject_proxy_get_type (void) G_GNUC_CONST; z>G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectProxy, g_object_unref) z[%sObjectProxy *%sobject_proxy_new (GDBusConnection *connection, const gchar *object_path); z?#define %sTYPE_OBJECT_SKELETON (%sobject_skeleton_get_type ()) zj#define %sOBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeleton)) zr#define %sOBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass)) zx#define %sOBJECT_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass)) z[#define %sIS_OBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_SKELETON)) z^#define %sIS_OBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_SKELETON)) z3typedef struct _%sObjectSkeleton %sObjectSkeleton; z=typedef struct _%sObjectSkeletonClass %sObjectSkeletonClass; zAtypedef struct _%sObjectSkeletonPrivate %sObjectSkeletonPrivate; zstruct _%sObjectSkeleton z' GDBusObjectSkeleton parent_instance; z! %sObjectSkeletonPrivate *priv; z struct _%sObjectSkeletonClass z) GDBusObjectSkeletonClass parent_class; z6GType %sobject_skeleton_get_type (void) G_GNUC_CONST; zAG_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectSkeleton, g_object_unref) zD%sObjectSkeleton *%sobject_skeleton_new (const gchar *object_path); zJvoid %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_); zK#define %sTYPE_OBJECT_MANAGER_CLIENT (%sobject_manager_client_get_type ()) z{#define %sOBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClient)) z�#define %sOBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass)) z�#define %sOBJECT_MANAGER_CLIENT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass)) zg#define %sIS_OBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_MANAGER_CLIENT)) zj#define %sIS_OBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_MANAGER_CLIENT)) z=typedef struct _%sObjectManagerClient %sObjectManagerClient; zGtypedef struct _%sObjectManagerClientClass %sObjectManagerClientClass; zKtypedef struct _%sObjectManagerClientPrivate %sObjectManagerClientPrivate; z struct _%sObjectManagerClient z, GDBusObjectManagerClient parent_instance; z& %sObjectManagerClientPrivate *priv; z#struct _%sObjectManagerClientClass z. GDBusObjectManagerClientClass parent_class; zFG_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectManagerClient, g_object_unref) z<GType %sobject_manager_client_get_type (void) G_GNUC_CONST; z�GType %sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager, const gchar *object_path, const gchar *interface_name, gpointer user_data); a7 void %sobject_manager_client_new ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); zxGDBusObjectManager *%sobject_manager_client_new_finish ( GAsyncResult *res, GError **error); a! GDBusObjectManager *%sobject_manager_client_new_sync ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); a= void %sobject_manager_client_new_for_bus ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); z�GDBusObjectManager *%sobject_manager_client_new_for_bus_finish ( GAsyncResult *res, GError **error); a' GDBusObjectManager *%sobject_manager_client_new_for_bus_sync ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); )"r r' r. �namer � name_upper� name_lower� camel_namer �methods�since�unix_fd�in_args�ctype_in�signals�args� properties�arg�sorted�keysr �version_cmp_keyr r% � deprecated�out_argsr$ � ctype_out� free_func� ctype_in_dupr r r r ) r( �iZfunction_pointers�mr< �value�a�s�pr r r � declare_typesx s� � �������� �� � �� � � �� �� �� �� � � �� � �� � � �� ��� �� ������������ � �� �� � �� �� �� �� �� �� �� ������������ �� �� �� � �� � ���� ���� �� �� � �� ��� ��� �������� �� �� �� �� �� � �� �� �������� �� �� �� �� �� �� �� �� ��� �������� �� �� �� �� �� � � �� �� �� �� �� �� �� �� �� z!HeaderCodeGenerator.declare_typesc C sB | j �d� | j �d� | js>| j �d� | j �d�| j�� d S �Nr, z G_END_DECLS z#endif /* __{!s}__ */ �r' r. r# r0 r! �r( r r r �generate_header_postamble� s z-HeaderCodeGenerator.generate_header_postamblec C s | � � | �� | �� d S r )r3 re ri rh r r r �generate� s z HeaderCodeGenerator.generateN)�__name__� __module__� __qualname__r) r3 re ri rj r r r r r D s r r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) � InterfaceInfoHeaderCodeGeneratorc C s\ || _ t|�\| _| _| _t|�| _|| _|| _|| _ || _ | j d u rLd| _ || _ | | _ d S )Nr ) r r r r r r r! r" r# r$ r% r& r' ) r( r r r r" r# r$ r% r& r' r r r r) � s z)InterfaceInfoHeaderCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | j�d� | jrB| j�d� n(| j�d�| j �� | j�d�| j �� | j d ur�| j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d� d S r* r- r2 r r r r3 s z9InterfaceInfoHeaderCodeGenerator.generate_header_preamblec C s( | j D ] }| j�d| j|jf � qd S )Nz1extern %s const GDBusInterfaceInfo %s_interface; )r r' r. r% rL �r( r_ r r r � declare_infos) s ��z.InterfaceInfoHeaderCodeGenerator.declare_infosc C sB | j �d� | j �d� | js>| j �d� | j �d�| j�� d S rf rg rh r r r ri 2 s z:InterfaceInfoHeaderCodeGenerator.generate_header_postamblec C s | � � | �� | �� d S r )r3 rp ri rh r r r rj < s z)InterfaceInfoHeaderCodeGenerator.generateN)rk rl rm r) r3 rp ri rj r r r r rn � s rn c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )� InterfaceInfoBodyCodeGeneratorc C s< || _ t|�\| _| _| _|| _|| _|| _|| _|| _ d S r ) r r r r r r r" r$ �symbol_decoration_definer' )r( r r r r" r$ rr r' r r r r) F s z'InterfaceInfoBodyCodeGenerator.__init__c C sx d� | j�}| j�t�tj|�� | jd urJ| j�d� | j�d| j � | j�d� | j�d| j � | j�d� d S )Nr+ r, � #define %s �V#ifdef HAVE_CONFIG_H # include "config.h" #endif #include "%s" #include <string.h> � r r" r' r. r/ r0 r r1 rr r r2 r r r �generate_body_preambleZ s �� z5InterfaceInfoBodyCodeGenerator.generate_body_preamblec C sf | j �d||f � | j �d� |D ]\}}| j �d| � q$| j �d� | j �d� | j �d� d S )Nzconst %s * const %s[] = r5 z &%s, z NULL, r> r, )r' r. )r( �array_name_lowerZ element_type�elementsr rJ r r r �generate_arrayp s � z-InterfaceInfoBodyCodeGenerator.generate_arrayc C s t |�dkrd S g }|D ]�}|j�d�r*q| �d||jf |j� | j�d||jf � | j�d� | j�d� | j�d|j � | j�d|j � t |j�dkr�| j�d||jf � n | j�d � | j�d � | j�d � |j d ||jf f}|� |� q| � |d |� d S )Nr � org.gtk.GDBusz%s__%s_annotationsz.const GDBusAnnotationInfo %s__%s_annotation = r5 � -1, /* ref count */ � (gchar *) "%s", z/ (GDBusAnnotationInfo **) %s__%s_annotations, � NULL, /* no annotations */ r> r, z%s__%s_annotationZGDBusAnnotationInfo) r r< � startswith�define_annotationsZ key_lower� annotationsr' r. ra rO �appendry )r( rw r� Zannotation_pointersrb r< r r r r { s@ ��� �� �z1InterfaceInfoBodyCodeGenerator.define_annotationsc C s t |�dkrd S g }|D ]�}| �d||jf |j� | j�d||jf � | j�d� | j�d� | j�d|j � | j�d|j � t |j�dkr�| j�d||jf � n | j�d� | j�d � | j�d � |jd ||jf f}|�|� q| � |d |� d S ) Nr z%s__%s_arg_annotationsz const GDBusArgInfo %s__%s_arg = r5 r{ r| z3 (GDBusAnnotationInfo **) %s__%s_arg_annotations, r} r> r, z %s__%s_argZ GDBusArgInfo) r r rJ r� r' r. � signaturerO r� ry )r( rw rT Z arg_pointersrb r< r r r � define_args� s4 � � �� z*InterfaceInfoBodyCodeGenerator.define_argsc C s� | j D �]�}| j�d� | j�d|j � | j�d� t|j�dk�r�g }|jD �]n}| �d|j|jf |j� | �d|j|jf |j � | � d|j|jf |j � | j�d|j|jf � | j�d � | j�d � | j�d |j � t|j�dk�r| j�d |j|jf � n | j�d � t|j �dk�rF| j�d|j|jf � n | j�d� t|j �dk�r|| j�d|j|jf � n | j�d� | j�d� | j�d� |j d|j|jf f}|� |� qP| �d|j d|� t|j�dk�r(g }|jD �] }| �d|j|jf |j� | � d|j|jf |j � | j�d|j|jf � | j�d � | j�d � | j�d |j � t|j�dk�r�| j�d|j|jf � n | j�d� t|j �dk�r�| j�d|j|jf � n | j�d� | j�d� | j�d� |j d |j|jf f}|� |� �q�| �d |j d |� t|j�dk�r�g }|jD �](}|j�r^|j�r^d } n |j�rld } n|j�rzd!} nd"} | � d#|j|jf |j � | j�d$|j|jf � | j�d � | j�d � | j�d |j � | j�d |j � | j�d%| � t|j �dk�r&| j�d&|j|jf � n | j�d� | j�d� | j�d� |j d'|j|jf f}|� |� �qB| �d(|j d)|� | � d*|j |j � | j�d+|j � | j�d � | j�d � | j�d |j � t|j�dk�r�| j�d,|j � n | j�d-� t|j�dk�r&| j�d.|j � n | j�d/� t|j�dk�rV| j�d0|j � n | j�d1� t|j �dk�r�| j�d2|j � n | j�d� | j�d� | j�d� qd S )3Nr4 z/* Definitions for %s */ r, r z %s_interface__%s_method_in_argsz %s_interface__%s_method_out_argsz#%s_interface__%s_method_annotationsz0const GDBusMethodInfo %s_interface__%s_method = r5 r{ r| z5 (GDBusArgInfo **) %s_interface__%s_method_in_args, z NULL, /* no in args */ z6 (GDBusArgInfo **) %s_interface__%s_method_out_args, z NULL, /* no out args */ z@ (GDBusAnnotationInfo **) %s_interface__%s_method_annotations, r} r> z%s_interface__%s_methodz%s_interface_methodsZGDBusMethodInfoz %s_interface__%s_signal_argsz#%s_interface__%s_signal_annotationsz0const GDBusSignalInfo %s_interface__%s_signal = z2 (GDBusArgInfo **) %s_interface__%s_signal_args, z NULL, /* no args */ z@ (GDBusAnnotationInfo **) %s_interface__%s_signal_annotations, z%s_interface__%s_signalz%s_interface_signalsZGDBusSignalInfo�IG_DBUS_PROPERTY_INFO_FLAGS_READABLE | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE�#G_DBUS_PROPERTY_INFO_FLAGS_READABLE�#G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE� G_DBUS_PROPERTY_INFO_FLAGS_NONEz%%s_interface__%s_property_annotationsz4const GDBusPropertyInfo %s_interface__%s_property = z %s, zB (GDBusAnnotationInfo **) %s_interface__%s_property_annotations, z%s_interface__%s_propertyz%s_interface_propertiesZGDBusPropertyInfoz%s_interface_annotationsz(const GDBusInterfaceInfo %s_interface = z- (GDBusMethodInfo **) %s_interface_methods, z NULL, /* no methods */ z- (GDBusSignalInfo **) %s_interface_signals, z NULL, /* no signals */ z2 (GDBusPropertyInfo **) %s_interface_properties, zNULL, /* no properties */ z5 (GDBusAnnotationInfo **) %s_interface_annotations, )r r' r. rJ r rN r� rL rQ r[ r r� rO r� ry rS rT rU �readable�writabler� ) r( r_ Zmethod_pointersr` r< Zsignal_pointersrc Zproperty_pointersrd �flagsr r r � define_infos� s| � �� �� �� �� �� �� �� � � � �� �� �� �� �� �� �� �� �� �� � � � �� z+InterfaceInfoBodyCodeGenerator.define_infosc C s | � � | �� d S r )rv r� rh r r r rj � s z'InterfaceInfoBodyCodeGenerator.generateN) rk rl rm r) rv ry r r� r� rj r r r r rq E s (! Xrq c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#S )$� CodeGeneratorc C sH || _ t|�\| _| _| _|| _|| _|| _|| _|| _ || _ | | _ d S r ) r r r r r r r r" � docbook_genr$ rr r' ) r( r r r r r" r� r$ rr r' r r r r) � s zCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | jd urJ| j�d� | j�d| j � | j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d � | j�d � | j�d � | j�d � | j�d � | j�d� d S )Nr+ r, rs rt z8#ifdef G_OS_UNIX # include <gio/gunixfdlist.h> #endif zbtypedef struct { GDBusArgInfo parent_struct; gboolean use_gvariant; } _ExtendedGDBusArgInfo; z�typedef struct { GDBusMethodInfo parent_struct; const gchar *signal_name; gboolean pass_fdlist; } _ExtendedGDBusMethodInfo; zktypedef struct { GDBusSignalInfo parent_struct; const gchar *signal_name; } _ExtendedGDBusSignalInfo; z�typedef struct { GDBusPropertyInfo parent_struct; const gchar *hyphen_name; guint use_gvariant : 1; guint emits_changed_signal : 1; } _ExtendedGDBusPropertyInfo; zqtypedef struct { GDBusInterfaceInfo parent_struct; const gchar *hyphen_name; } _ExtendedGDBusInterfaceInfo; a typedef struct { const _ExtendedGDBusPropertyInfo *info; guint prop_id; GValue orig_value; /* the value before the change */ } ChangedProperty; static void _changed_property_free (ChangedProperty *data) { g_value_unset (&data->orig_value); g_free (data); } a� static gboolean _g_strv_equal0 (gchar **a, gchar **b) { gboolean ret = FALSE; guint n; if (a == NULL && b == NULL) { ret = TRUE; goto out; } if (a == NULL || b == NULL) goto out; if (g_strv_length (a) != g_strv_length (b)) goto out; for (n = 0; a[n] != NULL; n++) if (g_strcmp0 (a[n], b[n]) != 0) goto out; ret = TRUE; out: return ret; } a static gboolean _g_variant_equal0 (GVariant *a, GVariant *b) { gboolean ret = FALSE; if (a == NULL && b == NULL) { ret = TRUE; goto out; } if (a == NULL || b == NULL) goto out; ret = g_variant_equal (a, b); out: return ret; } ah G_GNUC_UNUSED static gboolean _g_value_equal (const GValue *a, const GValue *b) { gboolean ret = FALSE; g_assert (G_VALUE_TYPE (a) == G_VALUE_TYPE (b)); switch (G_VALUE_TYPE (a)) { case G_TYPE_BOOLEAN: ret = (g_value_get_boolean (a) == g_value_get_boolean (b)); break; case G_TYPE_UCHAR: ret = (g_value_get_uchar (a) == g_value_get_uchar (b)); break; case G_TYPE_INT: ret = (g_value_get_int (a) == g_value_get_int (b)); break; case G_TYPE_UINT: ret = (g_value_get_uint (a) == g_value_get_uint (b)); break; case G_TYPE_INT64: ret = (g_value_get_int64 (a) == g_value_get_int64 (b)); break; case G_TYPE_UINT64: ret = (g_value_get_uint64 (a) == g_value_get_uint64 (b)); break; case G_TYPE_DOUBLE: { /* Avoid -Wfloat-equal warnings by doing a direct bit compare */ gdouble da = g_value_get_double (a); gdouble db = g_value_get_double (b); ret = memcmp (&da, &db, sizeof (gdouble)) == 0; } break; case G_TYPE_STRING: ret = (g_strcmp0 (g_value_get_string (a), g_value_get_string (b)) == 0); break; case G_TYPE_VARIANT: ret = _g_variant_equal0 (g_value_get_variant (a), g_value_get_variant (b)); break; default: if (G_VALUE_TYPE (a) == G_TYPE_STRV) ret = _g_strv_equal0 (g_value_get_boxed (a), g_value_get_boxed (b)); else g_critical ("_g_value_equal() does not handle type %s", g_type_name (G_VALUE_TYPE (a))); break; } return ret; } ru r2 r r r rv � sR �� �� � � � � ����z$CodeGenerator.generate_body_preamblec C s� |d u r d S d}|D ]r}|j �d�r&q| j�d|||j |jf � t|j�dkr^| j�d� n| j�d||f � | j�d� |d7 }q|dkr�| j�d| � d}|D ].}|j �d�r�q�| j�d ||f � |d7 }q�| j�d � |S ) Nr rz zUstatic const GDBusAnnotationInfo %s_%d = { -1, (gchar *) "%s", (gchar *) "%s", z NULL z+ (GDBusAnnotationInfo **) &%s_%d_pointers �}; r z;static const GDBusAnnotationInfo * const %s_pointers[] = { z &%s_%d, � NULL }; )r< r~ r' r. ra r r� )r( �prefixr� �nrb r` r r r �generate_annotationss s@ �� � �� z"CodeGenerator.generate_annotationsc C s� |D ]�}| � d||jf |j�}| j�d||j|j|jf � |dkrT| j�d� n| j�d||jf � | j�d� t�|jd�s�| j�d� n | j�d � | j�d � qt|�dkr�| j�d | � |D ]}| j�d ||jf � q�| j�d � d S )Nz%s_arg_%s_annotation_infozastatic const _ExtendedGDBusArgInfo %s_%s = { { -1, (gchar *) "%s", (gchar *) "%s", r � NULL zA (GDBusAnnotationInfo **) &%s_arg_%s_annotation_info_pointers z }, � org.gtk.GDBus.C.ForceGVariant� FALSE � TRUE r� z4static const GDBusArgInfo * const %s_pointers[] = { z &%s_%s.parent_struct, r� ) r� rJ r� r' r. r� r �lookup_annotationr )r( r� rT rb �num_annor r r � generate_args� s< ����� � �zCodeGenerator.generate_argsc C sB | j �d|j � t|j�dk�r�|jD �]4}| �d|j|jf |j� | �d|j|jf |j� | � d|j|jf |j �}| j �d|j|j|jf � t|j�dkr�| j �d� n| j �d|j|jf � t|j�dkr�| j �d� n| j �d |j|jf � |dk�r| j �d � n| j �d |j|jf � | j �d |j |j �rHd ndf � | j �d� q(| j �d|j � |jD ] }| j �d|j|jf � �qx| j �d� t|j �dk�r�|j D ]�}| �d|j|jf |j� | � d|j|jf |j �}| j �d|j|j|jf � t|j�dk�r,| j �d� n| j �d|j|jf � |dk�r\| j �d � n| j �d|j|jf � | j �d|j � | j �d� �q�| j �d|j � |j D ] }| j �d|j|jf � �q�| j �d� t|j�dk�rL|jD �]}|j�r |j�r d}n |j�rd }n|j�r(d }nd }| � d |j|jf |j �}| j �d |j|j|j|jj|f � |dk�r�| j �d � n| j �d!|j|jf � | j �d"|j � t�|j d#��s�| j �d$� n | j �d%� |j�r�| j �d&� n | j �d'� | j �d� �q�| j �d(|j � |jD ] }| j �d)|j|jf � �q | j �d� | � d*|j |j �}| j �d+|j|jf � t|j�dk�r�| j �d� n| j �d,|j � t|j �dk�r�| j �d� n| j �d-|j � t|j�dk�r�| j �d� n| j �d.|j � |dk�r | j �d � n| j �d/|j � | j �d0|j � | j �d1� | j �| j�d2|j|jf d3�� | �|| j d� | j �d4|j|jf � | j �| j�d5|j|jf d3�� | �|| j d� | j �d6|j � t|j�dk�r�| j �d7� | j �d8� |jD ]}| j �d9|j � �q | j �d:� | j �d1� d S );Nz+/* ---- Introspection data for %s ---- */ r z_%s_method_info_%s_IN_ARGz_%s_method_info_%s_OUT_ARGz _%s_method_%s_annotation_infoz]static const _ExtendedGDBusMethodInfo _%s_method_info_%s = { { -1, (gchar *) "%s", z NULL, z; (GDBusArgInfo **) &_%s_method_info_%s_IN_ARG_pointers, z< (GDBusArgInfo **) &_%s_method_info_%s_OUT_ARG_pointers, r� zE (GDBusAnnotationInfo **) &_%s_method_%s_annotation_info_pointers z }, "handle-%s", %s ZTRUEZFALSEr� zDstatic const GDBusMethodInfo * const _%s_method_info_pointers[] = { z% &_%s_method_info_%s.parent_struct, r� z_%s_signal_info_%s_ARGz _%s_signal_%s_annotation_infoz]static const _ExtendedGDBusSignalInfo _%s_signal_info_%s = { { -1, (gchar *) "%s", z8 (GDBusArgInfo **) &_%s_signal_info_%s_ARG_pointers, zE (GDBusAnnotationInfo **) &_%s_signal_%s_annotation_info_pointers z }, "%s" zDstatic const GDBusSignalInfo * const _%s_signal_info_pointers[] = { z% &_%s_signal_info_%s.parent_struct, r� r� r� r� z _%s_property_%s_annotation_infoz}static const _ExtendedGDBusPropertyInfo _%s_property_info_%s = { { -1, (gchar *) "%s", (gchar *) "%s", %s, zG (GDBusAnnotationInfo **) &_%s_property_%s_annotation_info_pointers z }, "%s", r� z FALSE, z TRUE, r� r� zHstatic const GDBusPropertyInfo * const _%s_property_info_pointers[] = { z' &_%s_property_info_%s.parent_struct, z_%s_annotation_infoz`static const _ExtendedGDBusInterfaceInfo _%s_interface_info = { { -1, (gchar *) "%s", z4 (GDBusMethodInfo **) &_%s_method_info_pointers, z4 (GDBusSignalInfo **) &_%s_signal_info_pointers, z8 (GDBusPropertyInfo **) &_%s_property_info_pointers, z; (GDBusAnnotationInfo **) &_%s_annotation_info_pointers z }, "%s", }; r, z�/** * %s_interface_info: * * Gets a machine-readable description of the #%s D-Bus interface. * * Returns: (transfer none): A #GDBusInterfaceInfo. Do not free. FzvGDBusInterfaceInfo * %s_interface_info (void) { return (GDBusInterfaceInfo *) &_%s_interface_info.parent_struct; } ag /** * %s_override_properties: * @klass: The class structure for a #GObject derived class. * @property_id_begin: The property id to assign to the first overridden property. * * Overrides all #GObject properties in the #%s interface for a concrete class. * The properties are overridden in the order they are defined. * * Returns: The last property id. z1guint %s_override_properties (GObjectClass *klassz G_GNUC_UNUSEDz , guint property_id_begin) { zG g_object_class_override_property (klass, property_id_begin++, "%s"); z# return property_id_begin - 1; } )r' r. rJ r rN r� rL rQ r[ r� r� � name_hyphenrP rS rT rU r� r� rV r� r r� Zemits_changed_signalr� �expand�+write_gtkdoc_deprecated_and_since_and_closerM )r( r_ r` r� rc rd �accessr r r �$generate_introspection_for_interface� s� � ����� �� �� ������ �� ���� �� ���� �� ��� ��� �� �� � ������ �� ��� �� � ��� �� z2CodeGenerator.generate_introspection_for_interfacec C s> | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j d�� i }t|j�dkr�|jD ]:}|j d|j f}d|j }|d|j|j f 7 }|||< q~t|j �dk�r |j D ]:}|j d |j f}d |j }|d |j|j f 7 }|||< q�t|j �dk�r`|j D ]<}|j d |j f}d |j }|d|j|j f 7 }|||< �q"t|�� tjd�D ]}| j �d|| � �qr| j �| j�d|j d�� | �|| j d� | j �d� | j �d|j|jf � | j �d|j|j f � | j �d� | j �d|j |jf � t|j�dk�rXt|j �dk�rXt|j �dk�rX| j �d� n | j �d� | j �d� t|j�dk�r�| j �d� |jD �] }| j �| j�d|j|j |jf d�� |j�r�| j �d� |jD ]}| j �d|j � �q�| j �| j�d |j|j|j |j f d�� | �|| j d � |j�r:d } nd } | j �d |j |j|j t|j�| f � |j�rz| j �d � |jD ]}| j �d!|j � �q�| j �d"� | j �d� �q�t|j �dk�r�| j �d#� |j D ]�}| j �| j�d$|j|j |jf d�� |jD ]}| j �d%|j � �q| j �| j�d&|j|jf d�� | �|| j d � | j �d'|j |j|j t|j�f � |jD ]}| j �d!|j � �q~| j �d"� | j �d� �q�t|j �dk�r.| j �d(� |j D �]T}|j�r�|j�r�d)} n,|j�r d*} n |j�rd+} ntd,�|j�� | j �| j�d-|j|j |j|j| f d�� | �|| j d � | j �d.� |jjd/k�r�d0|j |j|j|jjf }�nd|jjd1k�r�d2|j |j|jf }�n>|jjd3k�r�d4|j |j|jf }�n|jjd5k�rd6|j |j|jf }�n�|jjd7k�r*d8|j |j|jf }�n�|jjd9k�rPd:|j |j|jf }�n�|jjd;k�rvd<|j |j|jf }�n�|jjd=k�r�d>|j |j|jf }�nZ|jjd?k�r�d@|j |j|jf }�n4|jjdAk�r�dB|j |j|jf }�n|jjdCk�r dD|j |j|jf }n�|jjdEk�r0dD|j |j|jf }n�|jjdFk�rTdD|j |j|jf }n�|jjdGk�rxdD|j |j|jf }n~|jjdHk�r�dI|j |j|jf }nZ|jjdJk�r�dI|j |j|jf }n6|jjdKk�r�dI|j |j|jf }ntdL�|jj�� dM} |j �r dN| } | j �dO|| f � | j �d� �q�| j �dP� d S )QNr, zF/** * %s: * * Abstract interface type for the D-Bus interface #%s. Fr z8/** * %sIface: * @parent_iface: The parent interface. r6 z @handle_%s: z&Handler for the #%s::handle-%s signal.r9 z@%s: z Handler for the #%s::%s signal.r: z @get_%s: z Getter for the #%s:%s property.r; z * %s z1 * * Virtual table for the D-Bus interface #%s. z typedef %sIface %sInterface; z+G_DEFINE_INTERFACE (%s, %s, G_TYPE_OBJECT) z+static void %s_default_init (%sIface *iface� G_GNUC_UNUSED) �) r5 z9 /* GObject signals for incoming D-Bus method calls: */ z[ /** * %s::handle-%s: * @object: A #%s. * @invocation: A #GDBusMethodInvocation. z4 * @fd_list: (nullable): A #GUnixFDList or %NULL. z0 * @arg_%s: Argument passed by remote caller. au * * Signal emitted when a remote caller is invoking the %s.%s() D-Bus method. * * If a signal handler returns %%TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call %s_complete_%s() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %%G_DBUS_ERROR_UNKNOWN_METHOD error is returned. * * Returns: %%G_DBUS_METHOD_INVOCATION_HANDLED or %%TRUE if the invocation was handled, %%G_DBUS_METHOD_INVOCATION_UNHANDLED or %%FALSE to let other signal handlers run. rD r a g_signal_new ("handle-%s", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (%sIface, handle_%s), g_signal_accumulator_true_handled, NULL, g_cclosure_marshal_generic, G_TYPE_BOOLEAN, %d, G_TYPE_DBUS_METHOD_INVOCATIONz, G_TYPE_UNIX_FD_LISTz, %srB z4 /* GObject signals for received D-Bus signals: */ z( /** * %s::%s: * @object: A #%s. z * @arg_%s: Argument. z� * * On the client-side, this signal is emitted whenever the D-Bus signal #%s::%s is received. * * On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. z� g_signal_new ("%s", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (%sIface, %s), NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, %dz1 /* GObject properties for D-Bus properties: */ z�Since the D-Bus property for this #GObject property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.z�Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.z�Since the D-Bus property for this #GObject property is writable but not readable, it is meaningful to write to it on both the client- and service-side. It is only meaningful, however, to read from it on the service-side.�>Cannot handle property "{}" that neither readable nor writablezO /** * %s:%s: * * Represents the D-Bus property #%s:%s. * * %s z. g_object_interface_install_property (iface, �G_TYPE_VARIANTzCg_param_spec_variant ("%s", "%s", "%s", G_VARIANT_TYPE ("%s"), NULL�bz-g_param_spec_boolean ("%s", "%s", "%s", FALSE�yz/g_param_spec_uchar ("%s", "%s", "%s", 0, 255, 0r� z=g_param_spec_int ("%s", "%s", "%s", G_MININT16, G_MAXINT16, 0�qz6g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT16, 0r_ z=g_param_spec_int ("%s", "%s", "%s", G_MININT32, G_MAXINT32, 0�uz6g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT32, 0�xz?g_param_spec_int64 ("%s", "%s", "%s", G_MININT64, G_MAXINT64, 0�tz8g_param_spec_uint64 ("%s", "%s", "%s", 0, G_MAXUINT64, 0�dzEg_param_spec_double ("%s", "%s", "%s", -G_MAXDOUBLE, G_MAXDOUBLE, 0.0rc z+g_param_spec_string ("%s", "%s", "%s", NULL�o�gZay�asz1g_param_spec_boxed ("%s", "%s", "%s", G_TYPE_STRVZaoZaayz%Unsupported gtype "{}" for GParamSpec�*G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS�G_PARAM_DEPRECATED | z %s, %s));�} ) r' r. r� r� rM rJ r� r rN rO rL r� rS rU rW rX r rY rP rQ �gtyperT r� r� r r0 rV r� rZ ) r( r_ Zdoc_bitsr` r< ra rc rd rb � extra_args�hintr� r r r �generate_interface� s8 ��� ��� � � � �� � �� ��0 � ��� � ���� ��� ��� ��� �� ����� ��� � ��� ��� ��� ��������� �z CodeGenerator.generate_interfacec C s� |j D �]�}|jr |jr d}n(|jr*d}n |jr6d}ntd�|j�� | j�| j� d|j |j |j |j|j|f d�� |j j d ur�| j�d|j |j f � n | j�d� | �|| jd � | j�d |j j|j |j |j f � | j�d |j|j|j f � | j�d � | j�d � |j j d u�r�| j�| j� d|j |j |j |j|j||j j f d�� | �|| jd � | j�d|j j|j |j |j |j jf � | j�d|j � | j�d� | j�d � | j�d � |j�r�|j�r�d}n,|j�r�d}n |j�r�d}ntd�|j�� | j�| j� d|j |j |j |j|j|f d�� | �|| jd � | j�d|j |j |j |j jf � | j�d|j � | j�d � | j�d � qd S )Nz�Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.zrSince this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.zjSince this D-Bus property is not readable, it is only meaningful to use this function on the service-side.r� zk/** * %s_get_%s: (skip) * @object: A #%s. * * Gets the value of the #%s:%s D-Bus property. * * %s * Fah * The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use %s_dup_%s() if on another thread. * * Returns: (transfer none) (nullable): The property value or %%NULL if the property is not set. Do not free the returned value, it belongs to @object. z * Returns: The property value. r z %s %s_get_%s (%s *object) { z3 return %s%s_GET_IFACE (object)->get_%s (object); �} r, z�/** * %s_dup_%s: (skip) * @object: A #%s. * * Gets a copy of the #%s:%s D-Bus property. * * %s * * Returns: (transfer full) (nullable): The property value or %%NULL if the property is not set. The returned value should be freed with %s(). z'%s %s_dup_%s (%s *object) { %svalue; z8 g_object_get (G_OBJECT (object), "%s", &value, NULL); � return value; zjSince this D-Bus property is not writable, it is only meaningful to use this function on the service-side.zrSince this D-Bus property is writable, it is meaningful to use this function on both the client- and service-side.z�/** * %s_set_%s: (skip) * @object: A #%s. * @value: The value to set. * * Sets the #%s:%s D-Bus property to @value. * * %s z'void %s_set_%s (%s *object, %svalue) { z7 g_object_set (G_OBJECT (object), "%s", value, NULL); )rU r� r� r r0 rJ r' r. r� r� rL rM rV r] r� rR r rK r^ r� )r( r_ rd r� r r r �generate_property_accessors s� ��� �� �� ���� ������� �� ��� ������ z)CodeGenerator.generate_property_accessorsc C s |j D �]}| j�| j�d|j|j|jf d�� |jD ]}| j�d|j � q8| j�| j�d|j|jf d�� | � || jd� | j�d|j|j|jf � |jD ] }| j�d|j |jf � q�| j�d|j � |jD ]}| j�d |j � q�| j�d � | j�d � qd S ) Nz&/** * %s_emit_%s: * @object: A #%s. Fz. * @arg_%s: Argument to pass with the signal. z& * * Emits the #%s::%s D-Bus signal. r z void %s_emit_%s ( %s *objectr8 z)) { g_signal_emit_by_name (object, "%s"z, arg_%srB r� ) rS r' r. r� r� rL rM rT rJ r� rR r� )r( r_ rc rb r r r �generate_signal_emitters� sD ��� ����� � z&CodeGenerator.generate_signal_emittersc C s� |j D �]�}| j�d|j|j|jf � |jD ]}| j�d|j � q.| jdkr\| j�d� |jrn| j�d� | j�| j � d|j|j|j|j|j|jf d�� | � || jd� | j�d |j|j|jf � |jD ] }| j�d |j |jf � q�| jdk�r| j�d � |j�r | j�d � | j�d � |j�r>| j�d� n | j�d� | j�d|j � |jD ]}| j�d|j � �qb| j�d� |jD ]}| j�d|j � �q�| j�d� | jdk�r�| j�d� n | j�d� |j�r�| j�d� | j�d� | j�d� | j�d|j|j|jf � |jD ].}| j�d|j|j�rJd |j nd f � �q(|j�rl| j�d � | j�| j � d |j|j|j|jf d�� | � || jd� | j�d |j|j|jf � |jD ] }| j�d!|j|jf � �q�|j�r�| j�d"� | j�d#� |j�r | j�d$� n | j�d%� | j�d&� | j�d'� |jD ]}| j�d|j � �qH| j�d� |jD ]}| j�d(|j � �qt| j�d)� | j�d*� | j�d+|j|j|jf � |jD ]}| j�d|j � �q�| jdk�r�| j�d� |j�r| j�d� |jD ].}| j�d|j|j�r6d |j nd f � �q|j�rX| j�d,� | j�| j � d-|j|j|j|jf d�� | � || jd� | j�d.|j|j|jf � |jD ] }| j�d |j |jf � �q�| jdk�r�| j�d � |j�r | j�d/� |jD ] }| j�d!|j|jf � �q|j�r:| j�d"� | j�d0� |j�r\| j�d1� n | j�d2� | j�d|j � |jD ]}| j�d|j � �q�| j�d� |jD ]}| j�d|j � �q�| j�d� | jdk�r�| j�d� n | j�d� |j�r | j�d3� | j�d4� | j�d'� |jD ]}| j�d|j � �q*| j�d� |jD ]}| j�d(|j � �qV| j�d)� | j�d*� qd S )5Nz*/** * %s_call_%s: * @proxy: A #%sProxy. z9 * @arg_%s: Argument to pass with the method invocation. rC a6 * @call_flags: Flags from the #GDBusCallFlags enumeration. If you want to allow interactive authorization be sure to set %G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning "infinite") or -1 to use the proxy default timeout. �2 * @fd_list: (nullable): A #GUnixFDList or %NULL. aU * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %%NULL. * @user_data: User data to pass to @callback. * * Asynchronously invokes the %s.%s() D-Bus method on @proxy. * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_call_%s_finish() to get the result of the operation. * * See %s_call_%s_sync() for the synchronous, blocking version of this method. Fr z void %s_call_%s ( %s *proxyr8 rF r7 z], GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { z= g_dbus_proxy_call_with_unix_fd_list (G_DBUS_PROXY (proxy), z+ g_dbus_proxy_call (G_DBUS_PROXY (proxy), z "%s", g_variant_new ("(r= �)"�, arg_%sz), z" call_flags, timeout_msec, z$ G_DBUS_CALL_FLAGS_NONE, -1, z fd_list, z/ cancellable, callback, user_data); r� z1/** * %s_call_%s_finish: * @proxy: A #%sProxy. zZ * @out_%s: (out) (optional)%s: Return location for return parameter or %%NULL to ignore. � r zZ * @out_fd_list: (out) (optional): Return location for a #GUnixFDList or %NULL to ignore. a * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_call_%s(). * @error: Return location for error or %%NULL. * * Finishes an operation started with %s_call_%s(). * * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set. z*gboolean %s_call_%s_finish ( %s *proxyrG rH zA, GAsyncResult *res, GError **error) { GVariant *_ret; ze _ret = g_dbus_proxy_call_with_unix_fd_list_finish (G_DBUS_PROXY (proxy), out_fd_list, res, error); zF _ret = g_dbus_proxy_call_finish (G_DBUS_PROXY (proxy), res, error); z# if (_ret == NULL) goto _out; z* g_variant_get (_ret, "(z, out_%sz ); g_variant_unref (_ret); z _out: return _ret != NULL; } z//** * %s_call_%s_sync: * @proxy: A #%sProxy. zE * @out_fd_list: (out): Return location for a #GUnixFDList or %NULL. at * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL. * * Synchronously invokes the %s.%s() D-Bus method on @proxy. The calling thread is blocked until a reply is received. * * See %s_call_%s() for the asynchronous version of this method. * * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set. z(gboolean %s_call_%s_sync ( %s *proxyrI zI, GCancellable *cancellable, GError **error) { GVariant *_ret; zI _ret = g_dbus_proxy_call_with_unix_fd_list_sync (G_DBUS_PROXY (proxy), z7 _ret = g_dbus_proxy_call_sync (G_DBUS_PROXY (proxy), z fd_list, out_fd_list, z@ cancellable, error); if (_ret == NULL) goto _out; )rN r' r. rL rM rQ rJ r$ rP r� r� r� rR � format_inr[ Zarray_annotationr\ Z format_out�r( r_ r` rb r r r �generate_method_calls� s� �� �� �� ������ � �� � �� ������ �� ��� �� �� �� ���� ���� � ��� � z#CodeGenerator.generate_method_callsc C s� |j D �]z}| j�d|j|j|jf � |jr:| j�d� |jD ]}| j�d|j � q@| j�| j� d|j|jf d�� | � || jd� | j�d|j|j|jf � |jr�| j�d� |jD ] }| j�d |j |jf � q�| j�d � |jr�| j�d � n | j�d � |jD ]}| j�d |j � �q| j�d� |jD ]}| j�d|j � �q:|j�rj| j�d� n | j�d� | j�d� qd S )Nze/** * %s_complete_%s: * @object: A #%s. * @invocation: (transfer full): A #GDBusMethodInvocation. r� z * @%s: Parameter to return. a= * * Helper function used in service implementations to finish handling invocations of the %s.%s() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. * * This method will free @invocation, you cannot use it afterwards. Fr zYvoid %s_complete_%s ( %s *object G_GNUC_UNUSED, GDBusMethodInvocation *invocationr7 rA z) { z\ g_dbus_method_invocation_return_value_with_unix_fd_list (invocation, g_variant_new ("(zJ g_dbus_method_invocation_return_value (invocation, g_variant_new ("(r= r� z, %sz), fd_list); �)); r� ) rN r' r. rL rM rP r[ rJ r� r� r� rR r� r� r r r �generate_method_completers� s^ ��� ��� �� �� z(CodeGenerator.generate_method_completersc C s� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �d|j � | j �d|j|jf � | j �d � | j �d |j|jf � | j �d |j � | j �d |j|j|jf � | j �d � | j �d |j|jf � | j �d |j|j|jf � | j �d� | j �d|j � | j �d|j|j|jf � | j �d� | j �d|j � | j �d|j � t |j �dk�r�| j �d� n | j �d� | j �d� t |j �dk�r| j �dt |j �|jf � | j �d� t |j �dk�r\| j �d|j � | j �d|j � | j �d� | j �d|j � t |j �dk�r�| j �d � n | j �d � | j �d� t |j �dk�r�| j �d t |j �|j|j |jf � | j �d� | j �d |j � | j �d � | j �d!|j � | j �d"|j|jf � | j �d#� | j �d$|j|jf � | j �d%� | j �d&� | j �d� | j �d'|j � | j �d(|j|j|j|j|jf � |j D �]�}d)}|j j d u�r�d*}| j �d+|j j|j|j|j|j|j|j|j j|f � d}|j jd,k�s0|j jd-k�s0|j jd.k�r4d/}|�rL| j �d0|j � | j �d1|j � |j jd2k�r�| j �d3� | j �d4� | j �d5� n�| j �d6� d7}|j jd8k�s�|j jd,k�s�|j jd-k�s�|j jd.k�r�d9}| j �d:|j j|f � |�r| j �d;|j � | j �d<� | j �d=� | j �d>� | j �d?� | j �d� �q�| j �d@|j|j|j|j|j|j|jf � | j �dA|j|j|j|j|j|j|jf � t |j �dk�r�| j �dB|j � | j �dC|j � | j �d� | j �dD|j|jf � t |j �dk�r | j �dE� n | j �dF� | j �dG� |j D ]"}| j �dH|j|j|jf � �q:| j �d� | j �| j�dI|j|j |j|jf d�� | �|| j d� | j �dJ|j|j|j|j f � | j �dK|j|j|j|jf � | �|| j d� | j �dL|j|j|j|jf � | j �| j�dM|j|j |j|jf d�� | �|| j d� | j �dN|j|j|j|j|j |j|jf � | j �d� | j �| j�dO|j|j|j|jf d�� | �|| j d� | j �dP|j|j|j|j f � | j �dQ|j|j|j|jf � | �|| j d� | j �dR|j|j|j|jf � | j �| j�dS|j|j|j|jf d�� | �|| j d� | j �dT|j|j|j|j|j |j|jf � | j �d� d S )UN�P/* ------------------------------------------------------------------------ */ z|/** * %sProxy: * * The #%sProxy structure contains only private data and should only be accessed using the provided API. Fr r, z]/** * %sProxyClass: * @parent_class: The parent class. * * Class structure for #%sProxy. z-struct _%sProxyPrivate { GData *qdata; }; z3static void %s_proxy_iface_init (%sIface *iface); �2#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 z?G_DEFINE_TYPE_WITH_CODE (%sProxy, %s_proxy, G_TYPE_DBUS_PROXY, z1 G_ADD_PRIVATE (%sProxy) zR G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_proxy_iface_init)) �#else r@ z2static void %s_proxy_finalize (GObject *object) { z( %sProxy *proxy = %s%s_PROXY (object); z* g_datalist_clear (&proxy->priv->qdata); z@ G_OBJECT_CLASS (%s_proxy_parent_class)->finalize (object); } z7static void %s_proxy_get_property (GObject *objectz\ G_GNUC_UNUSED, guint prop_id G_GNUC_UNUSED, GValue *value G_GNUC_UNUSED, z2, guint prop_id, GValue *value, z' GParamSpec *pspec G_GNUC_UNUSED) { a const _ExtendedGDBusPropertyInfo *info; GVariant *variant; g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (object), info->parent_struct.name); if (info->use_gvariant) { g_value_set_variant (value, variant); } else { if (variant != NULL) g_dbus_gvariant_to_gvalue (variant, value); } if (variant != NULL) g_variant_unref (variant); r� zkstatic void %s_proxy_set_property_cb (GDBusProxy *proxy, GAsyncResult *res, gpointer user_data) { a� const _ExtendedGDBusPropertyInfo *info = user_data; GError *error; GVariant *_ret; error = NULL; _ret = g_dbus_proxy_call_finish (proxy, res, &error); if (!_ret) { g_warning ("Error setting property '%%s' on interface %s: %%s (%%s, %%d)", info->parent_struct.name, error->message, g_quark_to_string (error->domain), error->code); g_error_free (error); } else { g_variant_unref (_ret); } z#static void %s_proxy_set_property (zpGObject *object G_GNUC_UNUSED, guint prop_id G_GNUC_UNUSED, const GValue *value G_GNUC_UNUSED, zFGObject *object, guint prop_id, const GValue *value, ai const _ExtendedGDBusPropertyInfo *info; GVariant *variant; g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; variant = g_dbus_gvalue_to_gvariant (value, G_VARIANT_TYPE (info->parent_struct.signature)); g_dbus_proxy_call (G_DBUS_PROXY (object), "org.freedesktop.DBus.Properties.Set", g_variant_new ("(ssv)", "%s", info->parent_struct.name, variant), G_DBUS_CALL_FLAGS_NONE, -1, NULL, (GAsyncReadyCallback) %s_proxy_set_property_cb, (GDBusPropertyInfo *) &info->parent_struct); g_variant_unref (variant); z�static void %s_proxy_g_signal (GDBusProxy *proxy, const gchar *sender_name G_GNUC_UNUSED, const gchar *signal_name, GVariant *parameters) { z� _ExtendedGDBusSignalInfo *info; GVariantIter iter; GVariant *child; GValue *paramv; gsize num_params; gsize n; guint signal_id; z� info = (_ExtendedGDBusSignalInfo *) g_dbus_interface_info_lookup_signal ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, signal_name); if (info == NULL) return; z� num_params = g_variant_n_children (parameters); paramv = g_new0 (GValue, num_params + 1); g_value_init (¶mv[0], %sTYPE_%s); g_value_set_object (¶mv[0], proxy); a� g_variant_iter_init (&iter, parameters); n = 1; while ((child = g_variant_iter_next_value (&iter)) != NULL) { _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.args[n - 1]; if (arg_info->use_gvariant) { g_value_init (¶mv[n], G_TYPE_VARIANT); g_value_set_variant (¶mv[n], child); n++; } else g_dbus_gvariant_to_gvalue (child, ¶mv[n++]); g_variant_unref (child); } �> signal_id = g_signal_lookup (info->signal_name, %sTYPE_%s); z/ g_signal_emitv (paramv, signal_id, 0, NULL); zZ for (n = 0; n < num_params + 1; n++) g_value_unset (¶mv[n]); g_free (paramv); z�static void %s_proxy_g_properties_changed (GDBusProxy *_proxy, GVariant *changed_properties, const gchar *const *invalidated_properties) { a� %sProxy *proxy = %s%s_PROXY (_proxy); guint n; const gchar *key; GVariantIter *iter; _ExtendedGDBusPropertyInfo *info; g_variant_get (changed_properties, "a{sv}", &iter); while (g_variant_iter_next (iter, "{&sv}", &key, NULL)) { info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, key); g_datalist_remove_data (&proxy->priv->qdata, key); if (info != NULL) g_object_notify (G_OBJECT (proxy), info->hyphen_name); } g_variant_iter_free (iter); for (n = 0; invalidated_properties[n] != NULL; n++) { info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, invalidated_properties[n]); g_datalist_remove_data (&proxy->priv->qdata, invalidated_properties[n]); if (info != NULL) g_object_notify (G_OBJECT (proxy), info->hyphen_name); } } �0ZNULLzvstatic %s %s_proxy_get_%s (%s *object) { %sProxy *proxy = %s%s_PROXY (object); GVariant *variant; %svalue = %s; Zg_variant_get_strvZg_variant_get_objvZ g_variant_get_bytestring_arrayTzb value = g_datalist_get_data (&proxy->priv->qdata, "%s"); if (value != NULL) return value; zK variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (proxy), "%s"); r� z value = variant; z if (variant != NULL) z g_variant_unref (variant); z if (variant != NULL) { r Zg_variant_get_stringz, NULLz value = %s (variant%s); zV g_datalist_set_data_full (&proxy->priv->qdata, "%s", (gpointer) value, g_free); z! g_variant_unref (variant); z } r� r� aM static void %s_proxy_init (%sProxy *proxy) { #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 proxy->priv = %s_proxy_get_instance_private (proxy); #else proxy->priv = G_TYPE_INSTANCE_GET_PRIVATE (proxy, %sTYPE_%s_PROXY, %sProxyPrivate); #endif g_dbus_proxy_set_interface_info (G_DBUS_PROXY (proxy), %s_interface_info ()); } a� static void %s_proxy_class_init (%sProxyClass *klass) { GObjectClass *gobject_class; GDBusProxyClass *proxy_class; gobject_class = G_OBJECT_CLASS (klass); gobject_class->finalize = %s_proxy_finalize; gobject_class->get_property = %s_proxy_get_property; gobject_class->set_property = %s_proxy_set_property; proxy_class = G_DBUS_PROXY_CLASS (klass); proxy_class->g_signal = %s_proxy_g_signal; proxy_class->g_properties_changed = %s_proxy_g_properties_changed; z. %s_override_properties (gobject_class, 1); zu#if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38 g_type_class_add_private (klass, sizeof (%sProxyPrivate)); #endif z/static void %s_proxy_iface_init (%sIface *ifacer� r� r5 z# iface->get_%s = %s_proxy_get_%s; a� /** * %s_proxy_new: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Asynchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new() for more details. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_proxy_new_finish() to get the result of the operation. * * See %s_proxy_new_sync() for the synchronous, blocking version of this constructor. a� void %s_proxy_new ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL); } aH /** * %s_proxy_new_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new(). * @error: Return location for error or %%NULL * * Finishes an operation started with %s_proxy_new(). * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. az %s * %s_proxy_new_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return %s%s (ret); else return NULL; } a� /** * %s_proxy_new_sync: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Synchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new_sync() for more details. * * The calling thread is blocked until a reply is received. * * See %s_proxy_new() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_sync ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL); if (ret != NULL) return %s%s (ret); else return NULL; } a3 /** * %s_proxy_new_for_bus: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Like %s_proxy_new() but takes a #GBusType instead of a #GDBusConnection. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_proxy_new_for_bus_finish() to get the result of the operation. * * See %s_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. a� void %s_proxy_new_for_bus ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL); } a` /** * %s_proxy_new_for_bus_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new_for_bus(). * @error: Return location for error or %%NULL * * Finishes an operation started with %s_proxy_new_for_bus(). * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_for_bus_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return %s%s (ret); else return NULL; } ax /** * %s_proxy_new_for_bus_sync: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Like %s_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. * * The calling thread is blocked until a reply is received. * * See %s_proxy_new_for_bus() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_for_bus_sync ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL); if (ret != NULL) return %s%s (ret); else return NULL; } )r' r. r� r� rM r� rL r rK r rU rJ rV r] rR Z gvariant_getr� )r( r_ rd Z nul_valueZfree_containerZ extra_lenr r r �generate_proxy s� � ��� ��� �� �� ����� ���� ���� �� ���� �� ���� �� �� ��� �� ��� �� � ���� ��� � � ����� � � � ���� ��������� �� �� ��� ���� �������� ��� ���� �������� z CodeGenerator.generate_proxyc C s� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �d|j � | j �d|j|j|j|jf � | j �d � | j �d |j|jf � | j �d � | j �d |j|jf � | j �d � | j �d� | j �d� | j �d|j|j|j|jf � | j �d|j � | j �d|j|j|j|jf � | j �d|j � | j �d|j|j|j|jf � | j �d|j|jf � | j �d� | j �d|j|jf � | j �d� | j �d|j|j|j|jf � | j �d|j|j|j|j|j f � t |j �dk�rX| j �d|j � | j �d|j � t |j �dk�r�| j �d� n | j �d � | j �d � t |j �dk�r�| j �d |j|j|j|jf � | j �d� |j D �]}| j �d |j|j|jf � |j D ] }| j �d |j|j f � �q | j �d!|j|j|jf � | j �d"� |j D ]}| j �d#|j � �qX| j �d$� |j D ]}| j �d%|j � �q�| j �d&� | j �d'|j |j f � | j �d(� | j �d)� | j �d� �q�| j �d*|j|jf � | j �d+� | j �d,|j|jf � | j �d-|j � | j �d.|j|j|jf � | j �d/� | j �d,|j|jf � | j �d.|j|j|jf � | j �d0� | j �d1|j � | j �d2|j|j|jf � t |j �dk�r | j �d3t |j � � | j �d4� | j �d5� | j �d6� | j �d7� | j �d8� | j �d9� | j �d:|j � t |j �dk�r�| j �d;|j � | j �d<|j|j|jt |j �f � | j �d� | j �d=|j|j|j|jf � | j �d>|j � | j �d5� | j �d?� | j �d@� | j �dA� | j �dB� | j �dC|j|jf � | j �dD� | j �dE|j|j|j|j|j|jf � | j �dF|j � | j �dG|j|j|jt |j �|j|jf � | j �d� | j �dH|j|j|j|j|j|jf � | j �dI� | j �dJ� t |j �dk�r<| j �dKt |j � � d}|j D ]&}| j �dL||jjf � |dM7 }�q| j �d� d}|j D ]�}| j �dN|jj|j|j|jf � | j �d2|j|j|jf � | j �dO|jj|jj|f � | j �dP� | j �dQ� | j �d� |dM7 }�qR| j �dR|j|j|jf � t |j �dk�r<| j �dS|j|j|jf � | j �dT|j � | j �dU� | j �dV|j � | j �dW|j � | j �dX|j � | j �dY|j � | j �dZ|j � | j �d� | j �d[|j|jf � t |j �dk�r�t |j �dk�r�| j �d� n | j �d � | j �d � |j D ]"}| j �d\|j|j|jf � � q|j D ]"}| j �d]|j|j|jf � � q<| j �d� | j �| j�d^|j|j |jf d�� | �|| j d� | j �d_|j|j|j|j|j|jf � d S )`Nr� z�/** * %sSkeleton: * * The #%sSkeleton structure contains only private data and should only be accessed using the provided API. Fr r, zc/** * %sSkeletonClass: * @parent_class: The parent class. * * Class structure for #%sSkeleton. z�struct _%sSkeletonPrivate { GValue *properties; GList *changed_properties; GSource *changed_properties_idle_source; GMainContext *context; GMutex lock; }; a5 static void _%s_skeleton_handle_method_call ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name, const gchar *method_name, GVariant *parameters, GDBusMethodInvocation *invocation, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); _ExtendedGDBusMethodInfo *info; GVariantIter iter; GVariant *child; GValue *paramv; gsize num_params; guint num_extra; gsize n; guint signal_id; GValue return_value = G_VALUE_INIT; zx info = (_ExtendedGDBusMethodInfo *) g_dbus_method_invocation_get_method_info (invocation); g_assert (info != NULL); aq num_params = g_variant_n_children (parameters); num_extra = info->pass_fdlist ? 3 : 2; paramv = g_new0 (GValue, num_params + num_extra); n = 0; g_value_init (¶mv[n], %sTYPE_%s); g_value_set_object (¶mv[n++], skeleton); g_value_init (¶mv[n], G_TYPE_DBUS_METHOD_INVOCATION); g_value_set_object (¶mv[n++], invocation); if (info->pass_fdlist) { #ifdef G_OS_UNIX g_value_init (¶mv[n], G_TYPE_UNIX_FD_LIST); g_value_set_object (¶mv[n++], g_dbus_message_get_unix_fd_list (g_dbus_method_invocation_get_message (invocation))); #else g_assert_not_reached (); #endif } a� g_variant_iter_init (&iter, parameters); while ((child = g_variant_iter_next_value (&iter)) != NULL) { _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.in_args[n - num_extra]; if (arg_info->use_gvariant) { g_value_init (¶mv[n], G_TYPE_VARIANT); g_value_set_variant (¶mv[n], child); n++; } else g_dbus_gvariant_to_gvalue (child, ¶mv[n++]); g_variant_unref (child); } r� ae g_value_init (&return_value, G_TYPE_BOOLEAN); g_signal_emitv (paramv, signal_id, 0, &return_value); if (!g_value_get_boolean (&return_value)) g_dbus_method_invocation_return_error (invocation, G_DBUS_ERROR, G_DBUS_ERROR_UNKNOWN_METHOD, "Method %s is not implemented on interface %s", method_name, interface_name); g_value_unset (&return_value); zb for (n = 0; n < num_params + num_extra; n++) g_value_unset (¶mv[n]); g_free (paramv); r� a� static GVariant * _%s_skeleton_handle_get_property ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name G_GNUC_UNUSED, const gchar *property_name, GError **error, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); GValue value = G_VALUE_INIT; GParamSpec *pspec; _ExtendedGDBusPropertyInfo *info; GVariant *ret; a� ret = NULL; info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name); g_assert (info != NULL); pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name); if (pspec == NULL) { g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name); } else { g_value_init (&value, pspec->value_type); g_object_get_property (G_OBJECT (skeleton), info->hyphen_name, &value); ret = g_dbus_gvalue_to_gvariant (&value, G_VARIANT_TYPE (info->parent_struct.signature)); g_value_unset (&value); } return ret; } a� static gboolean _%s_skeleton_handle_set_property ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name G_GNUC_UNUSED, const gchar *property_name, GVariant *variant, GError **error, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); GValue value = G_VALUE_INIT; GParamSpec *pspec; _ExtendedGDBusPropertyInfo *info; gboolean ret; a� ret = FALSE; info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name); g_assert (info != NULL); pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name); if (pspec == NULL) { g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name); } else { if (info->use_gvariant) g_value_set_variant (&value, variant); else g_dbus_gvariant_to_gvalue (variant, &value); g_object_set_property (G_OBJECT (skeleton), info->hyphen_name, &value); g_value_unset (&value); ret = TRUE; } return ret; } z�static const GDBusInterfaceVTable _%s_skeleton_vtable = { _%s_skeleton_handle_method_call, _%s_skeleton_handle_get_property, _%s_skeleton_handle_set_property, {NULL} }; z�static GDBusInterfaceInfo * %s_skeleton_dbus_interface_get_info (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED) { return %s_interface_info (); z�static GDBusInterfaceVTable * %s_skeleton_dbus_interface_get_vtable (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED) { return (GDBusInterfaceVTable *) &_%s_skeleton_vtable; z�static GVariant * %s_skeleton_dbus_interface_get_properties (GDBusInterfaceSkeleton *_skeleton) { %sSkeleton *skeleton = %s%s_SKELETON (_skeleton); a� GVariantBuilder builder; guint n; g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}")); if (_%s_interface_info.parent_struct.properties == NULL) goto out; for (n = 0; _%s_interface_info.parent_struct.properties[n] != NULL; n++) { GDBusPropertyInfo *info = _%s_interface_info.parent_struct.properties[n]; if (info->flags & G_DBUS_PROPERTY_INFO_FLAGS_READABLE) { GVariant *value; value = _%s_skeleton_handle_get_property (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)), NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", info->name, NULL, skeleton); if (value != NULL) { g_variant_take_ref (value); g_variant_builder_add (&builder, "{sv}", info->name, value); g_variant_unref (value); } } } out: return g_variant_builder_end (&builder); } z8static gboolean _%s_emit_changed (gpointer user_data); zOstatic void %s_skeleton_dbus_interface_flush (GDBusInterfaceSkeleton *_skeletonr� r� r5 a� %sSkeleton *skeleton = %s%s_SKELETON (_skeleton); gboolean emit_changed = FALSE; g_mutex_lock (&skeleton->priv->lock); if (skeleton->priv->changed_properties_idle_source != NULL) { g_source_destroy (skeleton->priv->changed_properties_idle_source); skeleton->priv->changed_properties_idle_source = NULL; emit_changed = TRUE; } g_mutex_unlock (&skeleton->priv->lock); if (emit_changed) _%s_emit_changed (skeleton); z-static void _%s_on_signal_%s ( %s *objectr8 z�) { %sSkeleton *skeleton = %s%s_SKELETON (object); GList *connections, *l; GVariant *signal_variant; connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton)); z9 signal_variant = g_variant_ref_sink (g_variant_new ("(r= r� r� r� a% for (l = connections; l != NULL; l = l->next) { GDBusConnection *connection = l->data; g_dbus_connection_emit_signal (connection, NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", "%s", signal_variant, NULL); } z$ g_variant_unref (signal_variant); z2 g_list_free_full (connections, g_object_unref); z5static void %s_skeleton_iface_init (%sIface *iface); r� zRG_DEFINE_TYPE_WITH_CODE (%sSkeleton, %s_skeleton, G_TYPE_DBUS_INTERFACE_SKELETON, z4 G_ADD_PRIVATE (%sSkeleton) zU G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_skeleton_iface_init)) r� r@ z5static void %s_skeleton_finalize (GObject *object) { z1 %sSkeleton *skeleton = %s%s_SKELETON (object); zZ guint n; for (n = 0; n < %d; n++) g_value_unset (&skeleton->priv->properties[n]); z' g_free (skeleton->priv->properties); zb g_list_free_full (skeleton->priv->changed_properties, (GDestroyNotify) _changed_property_free); z> if (skeleton->priv->changed_properties_idle_source != NULL) zG g_source_destroy (skeleton->priv->changed_properties_idle_source); z2 g_main_context_unref (skeleton->priv->context); z) g_mutex_clear (&skeleton->priv->lock); zC G_OBJECT_CLASS (%s_skeleton_parent_class)->finalize (object); } z�static void %s_skeleton_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec G_GNUC_UNUSED) { z� %sSkeleton *skeleton = %s%s_SKELETON (object); g_assert (prop_id != 0 && prop_id - 1 < %d); g_mutex_lock (&skeleton->priv->lock); g_value_copy (&skeleton->priv->properties[prop_id - 1], value); g_mutex_unlock (&skeleton->priv->lock); zlstatic gboolean _%s_emit_changed (gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); a� GList *l; GVariantBuilder builder; GVariantBuilder invalidated_builder; guint num_changes; g_mutex_lock (&skeleton->priv->lock); g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}")); g_variant_builder_init (&invalidated_builder, G_VARIANT_TYPE ("as")); for (l = skeleton->priv->changed_properties, num_changes = 0; l != NULL; l = l->next) { ChangedProperty *cp = l->data; GVariant *variant; const GValue *cur_value; cur_value = &skeleton->priv->properties[cp->prop_id - 1]; if (!_g_value_equal (cur_value, &cp->orig_value)) { variant = g_dbus_gvalue_to_gvariant (cur_value, G_VARIANT_TYPE (cp->info->parent_struct.signature)); g_variant_builder_add (&builder, "{sv}", cp->info->parent_struct.name, variant); g_variant_unref (variant); num_changes++; } } if (num_changes > 0) { GList *connections, *ll; GVariant *signal_variant; signal_variant = g_variant_ref_sink (g_variant_new ("(sa{sv}as)", "%s", &builder, &invalidated_builder)); connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton)); for (ll = connections; ll != NULL; ll = ll->next) { GDBusConnection *connection = ll->data; g_dbus_connection_emit_signal (connection, NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "org.freedesktop.DBus.Properties", "PropertiesChanged", signal_variant, NULL); } g_variant_unref (signal_variant); g_list_free_full (connections, g_object_unref); } else { g_variant_builder_clear (&builder); g_variant_builder_clear (&invalidated_builder); } z- skeleton->priv->changed_properties = NULL; z9 skeleton->priv->changed_properties_idle_source = NULL; z* g_mutex_unlock (&skeleton->priv->lock); z return FALSE; } a� static void _%s_schedule_emit_changed (%sSkeleton *skeleton, const _ExtendedGDBusPropertyInfo *info, guint prop_id, const GValue *orig_value) { ChangedProperty *cp; GList *l; cp = NULL; for (l = skeleton->priv->changed_properties; l != NULL; l = l->next) { ChangedProperty *i_cp = l->data; if (i_cp->info == info) { cp = i_cp; break; } } aT if (cp == NULL) { cp = g_new0 (ChangedProperty, 1); cp->prop_id = prop_id; cp->info = info; skeleton->priv->changed_properties = g_list_prepend (skeleton->priv->changed_properties, cp); g_value_init (&cp->orig_value, G_VALUE_TYPE (orig_value)); g_value_copy (orig_value, &cp->orig_value); } } a� static void %s_skeleton_notify (GObject *object, GParamSpec *pspec G_GNUC_UNUSED) { %sSkeleton *skeleton = %s%s_SKELETON (object); g_mutex_lock (&skeleton->priv->lock); if (skeleton->priv->changed_properties != NULL && skeleton->priv->changed_properties_idle_source == NULL) { skeleton->priv->changed_properties_idle_source = g_idle_source_new (); g_source_set_priority (skeleton->priv->changed_properties_idle_source, G_PRIORITY_DEFAULT); g_source_set_callback (skeleton->priv->changed_properties_idle_source, _%s_emit_changed, g_object_ref (skeleton), (GDestroyNotify) g_object_unref); g_source_set_name (skeleton->priv->changed_properties_idle_source, "[generated] _%s_emit_changed"); g_source_attach (skeleton->priv->changed_properties_idle_source, skeleton->priv->context); g_source_unref (skeleton->priv->changed_properties_idle_source); } g_mutex_unlock (&skeleton->priv->lock); } z�static void %s_skeleton_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { a4 const _ExtendedGDBusPropertyInfo *info; %sSkeleton *skeleton = %s%s_SKELETON (object); g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; g_mutex_lock (&skeleton->priv->lock); g_object_freeze_notify (object); if (!_g_value_equal (value, &skeleton->priv->properties[prop_id - 1])) { if (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)) != NULL && info->emits_changed_signal) _%s_schedule_emit_changed (skeleton, info, prop_id, &skeleton->priv->properties[prop_id - 1]); g_value_copy (value, &skeleton->priv->properties[prop_id - 1]); g_object_notify_by_pspec (object, pspec); } g_mutex_unlock (&skeleton->priv->lock); g_object_thaw_notify (object); a static void %s_skeleton_init (%sSkeleton *skeleton) { #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 skeleton->priv = %s_skeleton_get_instance_private (skeleton); #else skeleton->priv = G_TYPE_INSTANCE_GET_PRIVATE (skeleton, %sTYPE_%s_SKELETON, %sSkeletonPrivate); #endif z( g_mutex_init (&skeleton->priv->lock); zB skeleton->priv->context = g_main_context_ref_thread_default (); z4 skeleton->priv->properties = g_new0 (GValue, %d); z6 g_value_init (&skeleton->priv->properties[%d], %s); r z,static %s %s_skeleton_get_%s (%s *object) { z� %svalue; g_mutex_lock (&skeleton->priv->lock); value = %s (&(skeleton->priv->properties[%d])); g_mutex_unlock (&skeleton->priv->lock); r� r� z�static void %s_skeleton_class_init (%sSkeletonClass *klass) { GObjectClass *gobject_class; GDBusInterfaceSkeletonClass *skeleton_class; gobject_class = G_OBJECT_CLASS (klass); gobject_class->finalize = %s_skeleton_finalize; z� gobject_class->get_property = %s_skeleton_get_property; gobject_class->set_property = %s_skeleton_set_property; gobject_class->notify = %s_skeleton_notify; z. %s_override_properties (gobject_class, 1); z= skeleton_class = G_DBUS_INTERFACE_SKELETON_CLASS (klass); zB skeleton_class->get_info = %s_skeleton_dbus_interface_get_info; zN skeleton_class->get_properties = %s_skeleton_dbus_interface_get_properties; z< skeleton_class->flush = %s_skeleton_dbus_interface_flush; zF skeleton_class->get_vtable = %s_skeleton_dbus_interface_get_vtable; zy #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38 g_type_class_add_private (klass, sizeof (%sSkeletonPrivate)); #endif z2static void %s_skeleton_iface_init (%sIface *ifacez iface->%s = _%s_on_signal_%s; z& iface->get_%s = %s_skeleton_get_%s; z�/** * %s_skeleton_new: * * Creates a skeleton object for the D-Bus interface #%s. * * Returns: (transfer full) (type %sSkeleton): The skeleton object. zZ%s * %s_skeleton_new (void) { return %s%s (g_object_new (%sTYPE_%s_SKELETON, NULL)); } )r' r. r� r� rM r� rL r rK rJ r rU rS rT rR r� rV r� Z ctype_in_gZ gvalue_get)r( r_ rc rb r� rd r r r �generate_skeleton� sL � ��� ��� �� ��� ��� ���� ���������� �� �� ���� ���� �� �� �� � �� �� ����� ���� ������ ��� ������ ��1��4� � ������ ����� ��� ��� �� ������ �� �������������� �� �� �� ��� ���z CodeGenerator.generate_skeletonc C s� | j �d� | j �| j�d| j| j| j| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d| j| jf � | j �d| j| jf � | j �d� | j �d | j| jf � | jD ]x}| j �| j�d | j|j|j|j f d�� | � || j d � d }|j �rNd | }| j �d|j|j|j| j |j |f � q�| j �d� | jD ]�}| j �| j�d| j|j �� | j|j|j |jf d�� | � || j d� | j �d|j| j|j �� | jf � | j �d|j | j |j f � �q�| j �d� | jD ]�}| j �| j�d| j|j �� | j| j|j �� |jf d�� | � || j d� | j �d|j| j|j �� | jf � | j �d|j | j |j f � �q(| j �d� | j �d| j � | j �| j�d| j| jf d�� | j �d� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �d| j| j| jf � | j �d | j| j| jf � | j �d� | j �d | j| j| j | j| j| jf � | j �d | j| jf � | j �d | j � | j �d� | j �d | j| j| j f � d!}| jD ]$}| j �d"||j f � |d!7 }�q| j �d#� | j �d$| j| j| j| jf � d!}| jD ]$}| j �d%||jf � |d!7 }�qp| j �d� | j �| j�d&| j d�� | j �d'| j| j| j | j f � | j �| j�d(| j| jf d�� | j �d� | j �d� | j �| j�d)| j| jf d�� | j �d� | j �d� | j �d*| j| j| jf � | j �d� | j �d+| j| j| jf � | j �d,| j| j| j | j| j| jf � | j �d-| j| jf � | j �d.| j| j| j f � d!}| jD ],}| j �d/|| j |j |j f � |d!7 }�q�| j �d#� | j �d0| j| j| j f � d!}| jD ]$}| j �d"||j f � |d!7 }�q\| j �d#� | j �d1| j| j| j| jf � d!}| jD ]$}| j �d%||jf � |d!7 }�q�| j �d� | j �| j�d2| j d�� | j �d3| j| j| j | j f � | jD ]�}| j �| j�d4| j|j �� | j|j|j|j f d�� | � || j d� | j �d5| j|j �� | j|jf � | j �d6|j � �q,| j �d� d S )7Nz�/* ------------------------------------------------------------------------ * Code for Object, ObjectProxy and ObjectSkeleton * ------------------------------------------------------------------------ */ a /** * SECTION:%sObject * @title: %sObject * @short_description: Specialized GDBusObject types * * This section contains the #%sObject, #%sObjectProxy, and #%sObjectSkeleton types which make it easier to work with objects implementing generated types for D-Bus interfaces. */ Fr, zX/** * %sObject: * * The #%sObject type is a specialized container of interfaces. */ zs/** * %sObjectIface: * @parent_iface: The parent interface. * * Virtual table for the #%sObject interface. */ z)typedef %sObjectIface %sObjectInterface; z�G_DEFINE_INTERFACE_WITH_CODE (%sObject, %sobject, G_TYPE_OBJECT, g_type_interface_add_prerequisite (g_define_type_id, G_TYPE_DBUS_OBJECT);) z;static void %sobject_default_init (%sObjectIface *iface) { z� /** * %sObject:%s: * * The #%s instance corresponding to the D-Bus interface #%s, if any. * * Connect to the #GObject::notify signal to get informed of property changes. rD r� r� zg g_object_interface_install_property (iface, g_param_spec_object ("%s", "%s", "%s", %sTYPE_%s, %s)); r� a /** * %sobject_get_%s: * @object: A #%sObject. * * Gets the #%s instance for the D-Bus interface #%s on @object, if any. * * Returns: (transfer full) (nullable): A #%s that must be freed with g_object_unref() or %%NULL if @object does not implement the interface. r z'%s *%sobject_get_%s (%sObject *object) z�{ GDBusInterface *ret; ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); if (ret == NULL) return NULL; return %s%s (ret); } a� /** * %sobject_peek_%s: (skip) * @object: A #%sObject. * * Like %sobject_get_%s() but doesn't increase the reference count on the returned object. * * It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running. * * Returns: (transfer none) (nullable): A #%s or %%NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object. z(%s *%sobject_peek_%s (%sObject *object) z�{ GDBusInterface *ret; ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); if (ret == NULL) return NULL; g_object_unref (ret); return %s%s (ret); } a� static void %sobject_notify (GDBusObject *object, GDBusInterface *interface) { _ExtendedGDBusInterfaceInfo *info = (_ExtendedGDBusInterfaceInfo *) g_dbus_interface_get_info (interface); /* info can be NULL if the other end is using a D-Bus interface we don't know * anything about, for example old generated code in this process talking to * newer generated code in the other process. */ if (info != NULL) g_object_notify (G_OBJECT (object), info->hyphen_name); } z�/** * %sObjectProxy: * * The #%sObjectProxy structure contains only private data and should only be accessed using the provided API. � */ zi/** * %sObjectProxyClass: * @parent_class: The parent class. * * Class structure for #%sObjectProxy. zZstatic void %sobject_proxy__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED) { } z�static void %sobject_proxy__g_dbus_object_iface_init (GDBusObjectIface *iface) { iface->interface_added = %sobject_notify; iface->interface_removed = %sobject_notify; } a& G_DEFINE_TYPE_WITH_CODE (%sObjectProxy, %sobject_proxy, G_TYPE_DBUS_OBJECT_PROXY, G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_proxy__%sobject_iface_init) G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_proxy__g_dbus_object_iface_init)) zKstatic void %sobject_proxy_init (%sObjectProxy *object G_GNUC_UNUSED) { } z�static void %sobject_proxy_set_property (GObject *gobject, guint prop_id, const GValue *value G_GNUC_UNUSED, GParamSpec *pspec) { G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); z�static void %sobject_proxy_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { %sObjectProxy *object = %sOBJECT_PROXY (gobject); GDBusInterface *interface; switch (prop_id) { r z� case %d: interface = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); g_value_take_object (value, interface); break; zd default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); break; } } z�static void %sobject_proxy_class_init (%sObjectProxyClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = %sobject_proxy_set_property; gobject_class->get_property = %sobject_proxy_get_property; z> g_object_class_override_property (gobject_class, %d, "%s"); z�/** * %sobject_proxy_new: * @connection: A #GDBusConnection. * @object_path: An object path. * * Creates a new proxy object. * * Returns: (transfer full): The proxy object. */ ai %sObjectProxy * %sobject_proxy_new (GDBusConnection *connection, const gchar *object_path) { g_return_val_if_fail (G_IS_DBUS_CONNECTION (connection), NULL); g_return_val_if_fail (g_variant_is_object_path (object_path), NULL); return %sOBJECT_PROXY (g_object_new (%sTYPE_OBJECT_PROXY, "g-connection", connection, "g-object-path", object_path, NULL)); } z�/** * %sObjectSkeleton: * * The #%sObjectSkeleton structure contains only private data and should only be accessed using the provided API. zo/** * %sObjectSkeletonClass: * @parent_class: The parent class. * * Class structure for #%sObjectSkeleton. z]static void %sobject_skeleton__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED) { } z�static void %sobject_skeleton__g_dbus_object_iface_init (GDBusObjectIface *iface) { iface->interface_added = %sobject_notify; iface->interface_removed = %sobject_notify; } a5 G_DEFINE_TYPE_WITH_CODE (%sObjectSkeleton, %sobject_skeleton, G_TYPE_DBUS_OBJECT_SKELETON, G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_skeleton__%sobject_iface_init) G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_skeleton__g_dbus_object_iface_init)) zQstatic void %sobject_skeleton_init (%sObjectSkeleton *object G_GNUC_UNUSED) { } a static void %sobject_skeleton_set_property (GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject); GDBusInterfaceSkeleton *interface; switch (prop_id) { a� case %d: interface = g_value_get_object (value); if (interface != NULL) { g_warn_if_fail (%sIS_%s (interface)); g_dbus_object_skeleton_add_interface (G_DBUS_OBJECT_SKELETON (object), interface); } else { g_dbus_object_skeleton_remove_interface_by_name (G_DBUS_OBJECT_SKELETON (object), "%s"); } break; z�static void %sobject_skeleton_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject); GDBusInterface *interface; switch (prop_id) { a static void %sobject_skeleton_class_init (%sObjectSkeletonClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = %sobject_skeleton_set_property; gobject_class->get_property = %sobject_skeleton_get_property; z�/** * %sobject_skeleton_new: * @object_path: An object path. * * Creates a new skeleton object. * * Returns: (transfer full): The skeleton object. */ z�%sObjectSkeleton * %sobject_skeleton_new (const gchar *object_path) { g_return_val_if_fail (g_variant_is_object_path (object_path), NULL); return %sOBJECT_SKELETON (g_object_new (%sTYPE_OBJECT_SKELETON, "g-object-path", object_path, NULL)); } z�/** * %sobject_skeleton_set_%s: * @object: A #%sObjectSkeleton. * @interface_: (nullable): A #%s or %%NULL to clear the interface. * * Sets the #%s instance for the D-Bus interface #%s on @object. zIvoid %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_) zA{ g_object_set (G_OBJECT (object), "%s", interface_, NULL); } )r' r. r� r� r r r r� rM rJ r� rZ r rK r )r( r_ r� r� r r r �generate_object� s� ����� ��� ��� �� �� �� ��� ��� �������� �������� �� ��� ��� ���� ��� ���� �� �� ��� �� � ���� ��� ��� �� �� ��� �� �� �� � �� �� ��� �� ��� �� ��������z CodeGenerator.generate_objectc C sz | j �d� | j �| j�d| j| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �d| j| jf � | j �d | j| jf � | j �d | j| jf � | j �| j�d | j| jf d�� | j �d� | j �d | j � | j �d | j � | jD ]"}| j �d|j|j|j f � �qR| j �d� | j �d� | j �d� | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d| j| j| j| jf � | j �d� | j �d| j � | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d� | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d| j| j| j| jf � | j �d� | j �d| j � | j �| j�d | j| j| j| jf d�� | j �d� | j �d | j| j| jf � | j �d� d S ) Nz�/* ------------------------------------------------------------------------ * Code for ObjectManager client * ------------------------------------------------------------------------ */ a /** * SECTION:%sObjectManagerClient * @title: %sObjectManagerClient * @short_description: Generated GDBusObjectManagerClient type * * This section contains a #GDBusObjectManagerClient that uses %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. */ Fr, z�/** * %sObjectManagerClient: * * The #%sObjectManagerClient structure contains only private data and should only be accessed using the provided API. r� zy/** * %sObjectManagerClientClass: * @parent_class: The parent class. * * Class structure for #%sObjectManagerClient. zcG_DEFINE_TYPE (%sObjectManagerClient, %sobject_manager_client, G_TYPE_DBUS_OBJECT_MANAGER_CLIENT) z]static void %sobject_manager_client_init (%sObjectManagerClient *manager G_GNUC_UNUSED) { } zfstatic void %sobject_manager_client_class_init (%sObjectManagerClientClass *klass G_GNUC_UNUSED) { } a! /** * %sobject_manager_client_get_proxy_type: * @manager: A #GDBusObjectManagerClient. * @object_path: The object path of the remote object (unused). * @interface_name: (nullable): Interface name of the remote object or %%NULL to get the object proxy #GType. * @user_data: User data (unused). * * A #GDBusProxyTypeFunc that maps @interface_name to the generated #GDBusObjectProxy derived and #GDBusProxy derived types. * * Returns: A #GDBusProxy derived #GType if @interface_name is not %%NULL, otherwise the #GType for #%sObjectProxy. z�GType %sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name, gpointer user_data G_GNUC_UNUSED) { a static gsize once_init_value = 0; static GHashTable *lookup_hash; GType ret; if (interface_name == NULL) return %sTYPE_OBJECT_PROXY; if (g_once_init_enter (&once_init_value)) { lookup_hash = g_hash_table_new (g_str_hash, g_str_equal); z^ g_hash_table_insert (lookup_hash, (gpointer) "%s", GSIZE_TO_POINTER (%sTYPE_%s_PROXY)); z5 g_once_init_leave (&once_init_value, 1); } z� ret = (GType) GPOINTER_TO_SIZE (g_hash_table_lookup (lookup_hash, interface_name)); if (ret == (GType) 0) ret = G_TYPE_DBUS_PROXY; z return ret; } a /** * %sobject_manager_client_new: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Asynchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %sobject_manager_client_new_finish() to get the result of the operation. * * See %sobject_manager_client_new_sync() for the synchronous, blocking version of this constructor. aG void %sobject_manager_client_new ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); } a� /** * %sobject_manager_client_new_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new(). * @error: Return location for error or %%NULL * * Finishes an operation started with %sobject_manager_client_new(). * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. a� GDBusObjectManager * %sobject_manager_client_new_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } ad /** * %sobject_manager_client_new_sync: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Synchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details. * * The calling thread is blocked until a reply is received. * * See %sobject_manager_client_new() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. ao GDBusObjectManager * %sobject_manager_client_new_sync ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } a} /** * %sobject_manager_client_new_for_bus: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Like %sobject_manager_client_new() but takes a #GBusType instead of a #GDBusConnection. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %sobject_manager_client_new_for_bus_finish() to get the result of the operation. * * See %sobject_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor. aI void %sobject_manager_client_new_for_bus ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); } a� /** * %sobject_manager_client_new_for_bus_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new_for_bus(). * @error: Return location for error or %%NULL * * Finishes an operation started with %sobject_manager_client_new_for_bus(). * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. a� GDBusObjectManager * %sobject_manager_client_new_for_bus_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } a� /** * %sobject_manager_client_new_for_bus_sync: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Like %sobject_manager_client_new_sync() but takes a #GBusType instead of a #GDBusConnection. * * The calling thread is blocked until a reply is received. * * See %sobject_manager_client_new_for_bus() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. aq GDBusObjectManager * %sobject_manager_client_new_for_bus_sync ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } ) r' r. r� r� r r r r rJ rK ro r r r � generate_object_manager_client� s: ���� ��� ��� �� �� �� � �� �� �� �� � ��� ���� ����� �� ��� ���� ����� ��z,CodeGenerator.generate_object_manager_clientc C s� t |j�dkr(|�d|d|d|jf � |jr�t|tj�r@d}nDt|tj�rRd}n2t|tj�rdd}n t|tj �rvd}nt d� |�� |�| j � d |d|d|f d �� |�d |df � d S ) Nr z%*s * %*s * Since: %s r zThe D-Bus interfacezThe D-Bus methodzThe D-Bus signalzThe D-Bus propertyzCannot handle object "{}"z0%*s * %*s * Deprecated: %s has been deprecated. Fz%*s */ )r rO r. rZ � isinstancer Z InterfaceZMethodZSignalZPropertyr r0 r� r� )r( �obj�f�indent�thingr r r r� 3 s* ���z9CodeGenerator.write_gtkdoc_deprecated_and_since_and_closec C sL | j �d|j � | j �| j�d|j|j|j|jf d�� | j �d� d S )Nz�/* ------------------------------------------------------------------------ * Code for interface %s * ------------------------------------------------------------------------ */ z�/** * SECTION:%s * @title: %s * @short_description: Generated C code for the %s D-Bus interface * * This section contains code for working with the #%s D-Bus interface in C. */ Fr, )r' r. rJ r� r� rM ro r r r �generate_interface_introM s ����� z&CodeGenerator.generate_interface_introc C s� | � � | jD ]^}| �|� | �|� | �|� | �|� | �|� | �|� | �|� | � |� | � |� q| j r�| � � | � � d S r )rv r r� r� r� r� r� r� r� r� r� r r� r� ro r r r rj d s zCodeGenerator.generateN)rk rl rm r) rv r� r� r� r� r� r� r� r� r� r� r� r� r� r� rj r r r r r� � sT 8*& K & > + , [r� N) r r r r r r/ r r r rn rq r� r r r r �<module> s& :N ` codegen/__pycache__/codegen_main.cpython-39.opt-1.pyc 0000644 00000021322 15125157507 0016370 0 ustar 00 a ]x a�? � @ s� d dl Z d dlZd dlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z m Z d d � Z d d � Z d d� Zdd� Zdd� Zdd� Zdd� Zedkr�e� dS )� N� )�config)� dbustypes)�parser)�codegen)�codegen_docbook)� print_error� print_warningc C s | D ]}|j |kr| S qd S �N)�name)�arg_listZarg_name�a� r �+/usr/share/glib-2.0/codegen/codegen_main.py�find_arg$ s r c C s" | j D ]}|j|kr| S qd S r )�methodsr )�iface�method�mr r r � find_method+ s r c C s" | j D ]}|j|kr| S qd S r )Zsignalsr )r �signalr r r r � find_signal2 s r c C s" | j D ]}|j|kr| S qd S r )Z propertiesr )r �propr r r r � find_prop9 s r c C sX d }| D ]} | j |kr| } q q|d u r6td�|�� d } |r�t||�} | d u r`td�||�� |r�t| j|�} | d u r�t| j|�} | d u r�td�|||�� | } n| } n�|�r t||�} | d u r�td�||�� |�rt| j|�} | d u r�td�|||�� | } n| } n4|�r:t ||�}|d u �r4td�||�� |} n|} | j � dt � ||�� d S )NzNo interface "{}"z No method "{}" on interface "{}"z,No arg "{}" on method "{}" on interface "{}"z No signal "{}" on interface "{}"z,No arg "{}" on signal "{}" on interface "{}"z"No property "{}" on interface "{}"r )r r �formatr r Zin_argsZout_argsr �argsr � annotations�insertr Z Annotation)� iface_listr r r r �arg�key�valueZ iface_obj�iZ target_objZ method_objZarg_objZ signal_objZprop_objr r r �apply_annotation@ sZ �� �� r# c C s� |D �]�\}}}|� d�}|dkr�|d|� }||d d � }|� d�}|dkr�||d d � }|d|� }|� d�}|d|� }t| |d |d |||� nt| |d |d d ||� q|� d�}|dkr�|d|� }||d d � } t| |d d | d ||� q|� d �}|dk�r�|d|� } | �d �}| d|� }| |d d � } |� d�}|dk�r�||d d � }|� d�}|d|� }t| || d d |||� nt| || d d d ||� q|}t| |d d d d ||� qd S ) Nz::���r � �[r �]�:z()�.)�findr# �rfind) r Zannotation_listZwhatr r! �posr r r r Zcombinedr r r r �apply_annotationsv sR � ���r- c C s t jdd�} | jddddd� | jddd g t jd � | jd d d dd� | jddd dd� | jdddd� | jdg d�ddd� | jd d d d � | jd dd!d� | jd"d#d d$d%d&� | jd'd(d)d � | jd*d(d+d � | jd,d-d.� | jd/d0d.� | jd1d2d.� | �� }|jd3d d4d � |jd5dd6d� |jd7dd8d� |jd9dd:d� |jd;dd<d� | �� }|jd=dd>d � |jd?d@d dAd� | �� }t|j�dBk�r�tdC� |j d u�s�|j d u�r�|j d u�r�t dD� |j �r|j dE }t j�|j|�}dF|_t j�|j|j dG �}dF|_n�|j�r@|j d u �r,t dH� |j }t j�|�}n�|j�r�|j d u �r\t dI� |j }t j�t j�|��dB dE }n�|j�r�|j d u �r�t dJ� |j�r�t dK� |j }t j�|�}nN|j�r|j d u �r�t dL� |j�r�t dM� |j }t j�t j�|��dB dE }|j�r�zZ|j�dNd#�}t|dB �tt|�dOk�rH|dO ndB�f}tt|�dPk�rh|dP ndB�}W n( tt f�y� t dQ� |j�� Y n0 |dRk �r�t dS� |j�� ndR}|j �rHzZ|j �dNd#�}t|dB �tt|�dOk�r�|dO ndB�f} tt|�dPk�r|dP ndB�}W n( tt f�yD t dT� |j �� Y n0 n t j t j!f} |j"d u �rx|j#�sp|j$�rxt dU� | dB | dO | dO dP f} | |k �r�t dV� || �� g } g } t%|j&|j �D ]h} t'| dW��} | �(� }W d � n1 �s�0 Y t)j*||dXkdY�}| �+|� | �,t j�| �� �q�|j-d u�rHt.| |j-� | D ]}|�/|j0|j1� �qL|j }t2�3| �}|�r�|�4||j� |j�r�t'|dZ��B}t5�6| |j1|j|j7|| |j8||j"|j#|� }|�4� W d � n1 �s�0 Y |j�rJt'|dZ��8}t5�9| |j1|j|| |||j$|� }|�4� W d � n1 �s@0 Y |j�r�t'|dZ��:}t5�:| |j1|| |j8||j"|j#|� }|�4� W d � n1 �s�0 Y |j�r�t'|dZ��2}t5�;| |j1|| ||j$|�}|�4� W d � n1 �s�0 Y t<�=dB� d S )[Nz&D-Bus code and documentation generator)� description�files�FILE�+z D-Bus introspection XML file)�metavar�nargs�helpz --xml-files�append)r2 �action�defaultr4 z--interface-prefixZPREFIX� z<String to strip from D-Bus interface names for code and docs)r2 r7 r4 z --c-namespaceZ NAMESPACEz)The namespace to use for generated C codez--c-generate-object-manager� store_truezCGenerate a GDBusObjectManagerClient subclass when generating C code)r6 r4 z--c-generate-autocleanup)Znone�objects�allr: z Generate autocleanup support)�choicesr7 r4 z--generate-docbookZOUTFILESz2Generate Docbook in OUTFILES-org.Project.IFace.xml)r2 r4 z --pragma-oncez(Use "pragma once" as the inclusion guardz --annotate� zWHAT KEY VALUEz*Add annotation (may be used several times))r3 r6 r2 r4 z--glib-min-requiredZVERSIONzMMinimum version of GLib to be supported by the outputted code (default: 2.30)z--glib-max-allowedzXMaximum version of GLib to be used by the outputted code (default: current GLib version)z--symbol-decoratorzSMacro used to decorate a symbol in the outputted header, possibly to export symbols)r4 z--symbol-decorator-headerzHAdditional header required for decorator specified by --symbol-decoratorz--symbol-decorator-definezHAdditional define required for decorator specified by --symbol-decoratorz--generate-c-codez Generate C code in OUTFILES.[ch]z--headerzGenerate C headersz--bodyzGenerate C codez--interface-info-headerz$Generate GDBusInterfaceInfo C headerz--interface-info-bodyz"Generate GDBusInterfaceInfo C codez--outputz$Write output into the specified filez--output-directoryZOUTDIRz"Location to output generated filesr zHThe "--xml-files" option is deprecated; use positional arguments insteadzZUsing --generate-c-code or --generate-docbook and --output at the same time is not allowedz.hTz.cz Using --header requires --outputz Using --body requires --outputz/Using --interface-info-header requires --outputzH--c-generate-object-manager is incompatible with --interface-info-headerz-Using --interface-info-body requires --outputzF--c-generate-object-manager is incompatible with --interface-info-bodyr) r r% u0 Unrecognized --glib-min-required string ‘{}’)r% � uD Invalid --glib-min-required string ‘{}’: minimum version is 2.30u/ Unrecognized --glib-max-allowed string ‘{}’z\--symbol-decorator-define and --symbol-decorator-header must be used with --symbol-decoratorz`Invalid versions: --glib-min-required ({}) must be less than or equal to --glib-max-allowed ({})�rb)r% �@ )Zh_type_implies_unix_fd�w)>�argparse�ArgumentParser� add_argument�SUPPRESS� add_mutually_exclusive_group� parse_args�lenZ xml_filesr Zgenerate_c_codeZgenerate_docbook�outputr �os�path�joinZoutput_directory�header�body�basename�splitextZinterface_info_headerZc_generate_object_managerZinterface_info_body�glib_min_required�split�int� ValueError� IndexErrorr �glib_max_allowedr Z MAJOR_VERSIONZ MINOR_VERSIONZsymbol_decoratorZsymbol_decorator_headerZsymbol_decorator_define�sortedr/ �open�readr Zparse_dbus_xml�extendr5 Zannotater- Z post_processZinterface_prefixZ c_namespacer ZDocbookCodeGeneratorZgenerater ZHeaderCodeGeneratorZc_generate_autocleanupZ pragma_onceZ CodeGeneratorZ InterfaceInfoHeaderCodeGeneratorZ InterfaceInfoBodyCodeGenerator�sys�exit)Z arg_parser�groupr Z header_nameZh_fileZc_file�partsrQ �_rV Z all_ifacesZinput_files_basenames�fname�fZxml_dataZ parsed_ifacesr" ZdocbookZ docbook_genZoutfile�genr r r � codegen_main� s ������������������������� � � *"�� ��*"�� �� �� (� � ( � ( � ( � (rc �__main__)rB rJ r[ r8 r r r r r Zutilsr r r r r r r# r- rc �__name__r r r r �<module> s& 66 < codegen/__pycache__/codegen_main.cpython-39.pyc 0000644 00000021322 15125157507 0015431 0 ustar 00 a ]x a�? � @ s� d dl Z d dlZd dlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z m Z d d � Z d d � Z d d� Zdd� Zdd� Zdd� Zdd� Zedkr�e� dS )� N� )�config)� dbustypes)�parser)�codegen)�codegen_docbook)� print_error� print_warningc C s | D ]}|j |kr| S qd S �N)�name)�arg_listZarg_name�a� r �+/usr/share/glib-2.0/codegen/codegen_main.py�find_arg$ s r c C s" | j D ]}|j|kr| S qd S r )�methodsr )�iface�method�mr r r � find_method+ s r c C s" | j D ]}|j|kr| S qd S r )Zsignalsr )r �signalr r r r � find_signal2 s r c C s" | j D ]}|j|kr| S qd S r )Z propertiesr )r �propr r r r � find_prop9 s r c C sX d }| D ]} | j |kr| } q q|d u r6td�|�� d } |r�t||�} | d u r`td�||�� |r�t| j|�} | d u r�t| j|�} | d u r�td�|||�� | } n| } n�|�r t||�} | d u r�td�||�� |�rt| j|�} | d u r�td�|||�� | } n| } n4|�r:t ||�}|d u �r4td�||�� |} n|} | j � dt � ||�� d S )NzNo interface "{}"z No method "{}" on interface "{}"z,No arg "{}" on method "{}" on interface "{}"z No signal "{}" on interface "{}"z,No arg "{}" on signal "{}" on interface "{}"z"No property "{}" on interface "{}"r )r r �formatr r Zin_argsZout_argsr �argsr � annotations�insertr Z Annotation)� iface_listr r r r �arg�key�valueZ iface_obj�iZ target_objZ method_objZarg_objZ signal_objZprop_objr r r �apply_annotation@ sZ �� �� r# c C s� |D �]�\}}}|� d�}|dkr�|d|� }||d d � }|� d�}|dkr�||d d � }|d|� }|� d�}|d|� }t| |d |d |||� nt| |d |d d ||� q|� d�}|dkr�|d|� }||d d � } t| |d d | d ||� q|� d �}|dk�r�|d|� } | �d �}| d|� }| |d d � } |� d�}|dk�r�||d d � }|� d�}|d|� }t| || d d |||� nt| || d d d ||� q|}t| |d d d d ||� qd S ) Nz::���r � �[r �]�:z()�.)�findr# �rfind) r Zannotation_listZwhatr r! �posr r r r Zcombinedr r r r �apply_annotationsv sR � ���r- c C s t jdd�} | jddddd� | jddd g t jd � | jd d d dd� | jddd dd� | jdddd� | jdg d�ddd� | jd d d d � | jd dd!d� | jd"d#d d$d%d&� | jd'd(d)d � | jd*d(d+d � | jd,d-d.� | jd/d0d.� | jd1d2d.� | �� }|jd3d d4d � |jd5dd6d� |jd7dd8d� |jd9dd:d� |jd;dd<d� | �� }|jd=dd>d � |jd?d@d dAd� | �� }t|j�dBk�r�tdC� |j d u�s�|j d u�r�|j d u�r�t dD� |j �r|j dE }t j�|j|�}dF|_t j�|j|j dG �}dF|_n�|j�r@|j d u �r,t dH� |j }t j�|�}n�|j�r�|j d u �r\t dI� |j }t j�t j�|��dB dE }n�|j�r�|j d u �r�t dJ� |j�r�t dK� |j }t j�|�}nN|j�r|j d u �r�t dL� |j�r�t dM� |j }t j�t j�|��dB dE }|j�r�zZ|j�dNd#�}t|dB �tt|�dOk�rH|dO ndB�f}tt|�dPk�rh|dP ndB�}W n( tt f�y� t dQ� |j�� Y n0 |dRk �r�t dS� |j�� ndR}|j �rHzZ|j �dNd#�}t|dB �tt|�dOk�r�|dO ndB�f} tt|�dPk�r|dP ndB�}W n( tt f�yD t dT� |j �� Y n0 n t j t j!f} |j"d u �rx|j#�sp|j$�rxt dU� | dB | dO | dO dP f} | |k �r�t dV� || �� g } g } t%|j&|j �D ]h} t'| dW��} | �(� }W d � n1 �s�0 Y t)j*||dXkdY�}| �+|� | �,t j�| �� �q�|j-d u�rHt.| |j-� | D ]}|�/|j0|j1� �qL|j }t2�3| �}|�r�|�4||j� |j�r�t'|dZ��B}t5�6| |j1|j|j7|| |j8||j"|j#|� }|�4� W d � n1 �s�0 Y |j�rJt'|dZ��8}t5�9| |j1|j|| |||j$|� }|�4� W d � n1 �s@0 Y |j�r�t'|dZ��:}t5�:| |j1|| |j8||j"|j#|� }|�4� W d � n1 �s�0 Y |j�r�t'|dZ��2}t5�;| |j1|| ||j$|�}|�4� W d � n1 �s�0 Y t<�=dB� d S )[Nz&D-Bus code and documentation generator)� description�files�FILE�+z D-Bus introspection XML file)�metavar�nargs�helpz --xml-files�append)r2 �action�defaultr4 z--interface-prefixZPREFIX� z<String to strip from D-Bus interface names for code and docs)r2 r7 r4 z --c-namespaceZ NAMESPACEz)The namespace to use for generated C codez--c-generate-object-manager� store_truezCGenerate a GDBusObjectManagerClient subclass when generating C code)r6 r4 z--c-generate-autocleanup)Znone�objects�allr: z Generate autocleanup support)�choicesr7 r4 z--generate-docbookZOUTFILESz2Generate Docbook in OUTFILES-org.Project.IFace.xml)r2 r4 z --pragma-oncez(Use "pragma once" as the inclusion guardz --annotate� zWHAT KEY VALUEz*Add annotation (may be used several times))r3 r6 r2 r4 z--glib-min-requiredZVERSIONzMMinimum version of GLib to be supported by the outputted code (default: 2.30)z--glib-max-allowedzXMaximum version of GLib to be used by the outputted code (default: current GLib version)z--symbol-decoratorzSMacro used to decorate a symbol in the outputted header, possibly to export symbols)r4 z--symbol-decorator-headerzHAdditional header required for decorator specified by --symbol-decoratorz--symbol-decorator-definezHAdditional define required for decorator specified by --symbol-decoratorz--generate-c-codez Generate C code in OUTFILES.[ch]z--headerzGenerate C headersz--bodyzGenerate C codez--interface-info-headerz$Generate GDBusInterfaceInfo C headerz--interface-info-bodyz"Generate GDBusInterfaceInfo C codez--outputz$Write output into the specified filez--output-directoryZOUTDIRz"Location to output generated filesr zHThe "--xml-files" option is deprecated; use positional arguments insteadzZUsing --generate-c-code or --generate-docbook and --output at the same time is not allowedz.hTz.cz Using --header requires --outputz Using --body requires --outputz/Using --interface-info-header requires --outputzH--c-generate-object-manager is incompatible with --interface-info-headerz-Using --interface-info-body requires --outputzF--c-generate-object-manager is incompatible with --interface-info-bodyr) r r% u0 Unrecognized --glib-min-required string ‘{}’)r% � uD Invalid --glib-min-required string ‘{}’: minimum version is 2.30u/ Unrecognized --glib-max-allowed string ‘{}’z\--symbol-decorator-define and --symbol-decorator-header must be used with --symbol-decoratorz`Invalid versions: --glib-min-required ({}) must be less than or equal to --glib-max-allowed ({})�rb)r% �@ )Zh_type_implies_unix_fd�w)>�argparse�ArgumentParser� add_argument�SUPPRESS� add_mutually_exclusive_group� parse_args�lenZ xml_filesr Zgenerate_c_codeZgenerate_docbook�outputr �os�path�joinZoutput_directory�header�body�basename�splitextZinterface_info_headerZc_generate_object_managerZinterface_info_body�glib_min_required�split�int� ValueError� IndexErrorr �glib_max_allowedr Z MAJOR_VERSIONZ MINOR_VERSIONZsymbol_decoratorZsymbol_decorator_headerZsymbol_decorator_define�sortedr/ �open�readr Zparse_dbus_xml�extendr5 Zannotater- Z post_processZinterface_prefixZ c_namespacer ZDocbookCodeGeneratorZgenerater ZHeaderCodeGeneratorZc_generate_autocleanupZ pragma_onceZ CodeGeneratorZ InterfaceInfoHeaderCodeGeneratorZ InterfaceInfoBodyCodeGenerator�sys�exit)Z arg_parser�groupr Z header_nameZh_fileZc_file�partsrQ �_rV Z all_ifacesZinput_files_basenames�fname�fZxml_dataZ parsed_ifacesr" ZdocbookZ docbook_genZoutfile�genr r r � codegen_main� s ������������������������� � � *"�� ��*"�� �� �� (� � ( � ( � ( � (rc �__main__)rB rJ r[ r8 r r r r r Zutilsr r r r r r r# r- rc �__name__r r r r �<module> s& 66 < codegen/__pycache__/__init__.cpython-39.opt-1.pyc 0000644 00000000501 15125157507 0015513 0 ustar 00 a ]x a� � @ s@ d dl Z e j�d�Zedur<e�e j�e j�eddd��� dS )� NZUNINSTALLED_GLIB_BUILDDIRZgioz gdbus-2.0Zcodegen) �os�environ�getZbuilddir�__path__�append�path�abspath�join� r r �'/usr/share/glib-2.0/codegen/__init__.py�<module> s � codegen/__pycache__/codegen.cpython-39.pyc 0000644 00000356367 15125157507 0014451 0 ustar 00 a ]x a�� � @ s� d dl mZ d dl mZ d dl mZ d dlmZ dZdd� Zdd � ZG d d � d �ZG d d � d �Z G dd� d�Z G dd� d�Z dS )� )�config)�utils)� dbustypes)� print_errorz�/* * This file is generated by gdbus-codegen, do not modify it. * * The license of this code is the same as for the D-Bus interface description * it was derived from. Note that it links to GLib, so must comply with the * LGPL linking clauses. */ c C sx | }t | �dkrft�| �r@| �dd�}| �� d }| �� d }qnt�| ��� d }t�| ��� d }nd}d}|||fS )N� �_� )�lenr Z is_ugly_case�replace�upper�lowerZcamel_case_to_uscore)� namespace�ns�ns_upper�ns_lower� r �&/usr/share/glib-2.0/codegen/codegen.py�generate_namespace* s r c s d� d� t� fdd�| �� ��S )NZ$0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZr c s | � v r | S dS )Nr r )�c�Zsafe_valid_charsr r �<lambda>@ � z'generate_header_guard.<locals>.<lambda>)�join�mapr )� header_namer r r �generate_header_guard; s �r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) �HeaderCodeGeneratorc C sX || _ t|�\| _| _| _|| _|| _t|�| _|| _ || _ || _ | | _ | | _ | | _d S �N)�ifacesr r r r �generate_objmanager�generate_autocleanupr � header_guard�input_files_basenames� use_pragma�glib_min_required�symbol_decorator�symbol_decorator_header�outfile) �selfr r r r r r" r# r$ r% r& r' r r r �__init__E s z HeaderCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | j�d� | jrB| j�d� n(| j�d�| j �� | j�d�| j �� | j d ur�| j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d� d S � N�, � z #pragma once z#ifndef __{!s}__ z#define __{!s}__ z#include "%s" z#include <gio/gio.h> zG_BEGIN_DECLS � r r" r' �write� LICENSE_STR�formatr �VERSIONr# r! r& �r( Z basenamesr r r �generate_header_preamblea s z,HeaderCodeGenerator.generate_header_preamblec C s� | j D �]p}| j�d� | j�d� | j�d|j � | j�d� | j�d|j|j|jf � | j�d|j|j|j|j|jf � | j�d|j|j|j|jf � | j�d|j|j|j|j|jf � | j�d� | j�d|j � | j�d |j|jf � | j�d |j|jf � | j�d� | j�d |j � | j�d � | j�d � i }t|j �dk�r�| j�d� |j D ]x}|j d|j f}d|j }|d|j 7 }|d7 }|j �r�|d7 }|j D ]}|d|j |jf 7 }�q�|d7 }|||< �qpt|j�dk�rn| j�d� |jD ]`}|j d|j f}d|j }|d|j 7 }|jD ]}|d|j |jf 7 }�q>|d7 }|||< �q t|j�dk�r�| j�d� |jD ]4}|j d|j f}d|jj |j|jf }|||< �q�t|�� tjd�D ]}| j�d || � �q�| j�d � | j�d� | jd k�rN| j�d � | j�d |j � | j�d!� | j�d� | jd u�rl| j�d"| j � | j�d#|j � | j�d� | jd u�r�| j�d"| j � | j�d$|j � | jd u�r�| j�d"| j � | j�d%|j � | j�d� t|j �dk�r�| j�d� | j�d&� |j D ]�}| jd u�rF| j�d"| j � |j�rZ| j�d'� | j�d(|j|j|jf � |j �r�| j�d� |jD ] }| j�d)|j |jf � �q�| j�d*� | j�d� �q$| j�d� t|j�dk�r�| j�d� | j�d+� |jD ]�}| jd u�r(| j�d"| j � |j�r<| j�d'� | j�d,|j|j|jf � |jD ] }| j�d|j |jf � �q^| j�d*� | j�d� �q| j�d� t|j �dk�r4| j�d� | j�d-� |j D �]P}| jd u�r�| j�d"| j � |j�r | j�d'� | j�d.|j|j|jf � |j D ] }| j�d|j |jf � �q.| jd/k�rf| j�d0� |j �rz| j�d� | j�d1� | j�d� | jd u�r�| j�d"| j � |j�r�| j�d'� | j�d2|j|j|jf � |jD ] }| j�d3|j|jf � �q�|j �r| j�d4� | j�d5� | j�d� | jd u�rP| j�d"| j � |j�rd| j�d'� | j�d6|j|j|jf � |j D ] }| j�d|j |jf � �q�| jd/k�r�| j�d0� |j �r�| j�d7� |jD ] }| j�d3|j|jf � �q�|j �r | j�d4� | j�d8� | j�d� �q�| j�d� t|j�dk� r�| j�d� | j�d9� |jD �] }| jd u�r�| j�d"| j � |j�r�| j�d'� | j�d:|jj |j|j|jf � |jj d u� r | jd u�r�| j�d"| j � |j�r�| j�d'� | j�d;|jj |j|j|jf � | jd u� r<| j�d"| j � |j� rP| j�d'� | j�d<|j|j|j|jj f � | j�d� �qb| j�d� | j�d=� | j�d� | j�d>|j|j|jf � | j�d?|j|j|j|j|jf � | j�d@|j|j|j|j|jf � | j�dA|j|j|j|j|jf � | j�dB|j|j|j|jf � | j�dC|j|j|j|jf � | j�d� | j�dD|j|jf � | j�dE|j|jf � | j�dF|j|jf � | j�d� | j�dG|j � | j�d � | j�dH� | j�dI� | j�dJ|j � | j�d � | j�d� | j�dK|j � | j�d � | j�dL� | j�d � | j�d� | jd u� r�| j�d"| j � | j�dM|j � | j�d� | jdNv � r�| j�d � | j�dO|j � | j�d!� | j�d� | jd u� r | j�d"| j � |j� r | j�d'� | j�dP|j � | jd u� rP| j�d"| j � |j� rd| j�d'� | j�dQ|j|jf � | jd u� r�| j�d"| j � |j� r�| j�d'� | j�dR|j|jf � | j�d� | jd u� r�| j�d"| j � |j� r| j�d'� | j�dS|j � | jd u� r4| j�d"| j � |j� rH| j�d'� | j�dT|j|jf � | jd u� r~| j�d"| j � |j� r�| j�d'� | j�dU|j|jf � | j�d� | j�d� | j�d=� | j�d� | j�dV|j|j|jf � | j�dW|j|j|j|j|jf � | j�dX|j|j|j|j|jf � | j�dY|j|j|j|j|jf � | j�dZ|j|j|j|jf � | j�d[|j|j|j|jf � | j�d� | j�d\|j|jf � | j�d]|j|jf � | j�d^|j|jf � | j�d� | j�d_|j � | j�d � | j�dH� | j�d`� | j�da|j � | j�d � | j�d� | j�db|j � | j�d � | j�dc� | j�d � | j�d� | jd u�r�| j�d"| j � | j�dd|j � | j�d� | jdNv �r"| j�d � | j�de|j � | j�d!� | j�d� | jd u�r@| j�d"| j � |j�rT| j�d'� | j�df|j|jf � | j�d� q| j �r�| j�d� | j�d=� | j�d� | j�dg| j| j f � | j�dh| j| j| j f � | j�di| j| jf � | j�dj| j| j| j f � | j�d� | j�dk| j � | j�dl| j | j f � | j�dm| j | j f � | j�d� | j�dn| j � | j�do� | jd u�r�| j�d"| j � | j�dp| j � | jd k�r�| j�d � | j�dq| j � | j�d!� | j�d� | j D ]\}| jd u�r | j�d"| j � |j�r4| j�d'� | j�dr|j| j |j�!� | j f � �q�| j D ]\}| jd u�r�| j�d"| j � |j�r�| j�d'� | j�ds|j| j |j�!� | j f � �qb| j�d� | j�dt| j| j f � | j�du| j| j| j f � | j�dv| j| j| j f � | j�dw| j| j| j f � | j�dx| j| jf � | j�dy| j| jf � | j�d� | j�dz| j | j f � | j�d{| j | j f � | j�d|| j | j f � | j�d� | j�d}| j � | j�d � | j�dH� | j�d~� | j�d| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jdNv �r�| j�d � | j�d�| j � | j�d!� | j�d� | jd u�r| j�d"| j � | j�d�| j | j f � | j�d� | j�d�| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| jf � | j�d�| j| jf � | j�d� | j�d�| j | j f � | j�d�| j | j f � | j�d�| j | j f � | j�d� | j�d�| j � | j�d � | j�dH� | j�d�� | j�d�| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jdNv �rF| j�d � | j�d�| j � | j�d!� | j�d� | jd u�rd| j�d"| j � | j�d�| j | j f � | j D ]\}| jd u�r�| j�d"| j � |j�r�| j�d'� | j�d�| j |j�!� | j |jf � �q�| j�d� | j�d=� | j�d� | j�d�| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| j| j f � | j�d�| j| jf � | j�d�| j| jf � | j�d� | j�d�| j | j f � | j�d�| j | j f � | j�d�| j | j f � | j�d� | j�d�| j � | j�d � | j�dH� | j�d�� | j�d�| j � | j�d � | j�d� | j�d�| j � | j�d � | j�d�� | j�d � | j�d� | jdNv �r�| j�d � | j�d�| j � | j�d!� | j�d� | jd u�r| j�d"| j � | j�d�| j � | j�d� | jd u�r>| j�d"| j � | j�d�| j � | j�d� | jd u�rz| j�d"| j � | j�d�| j � | jd u�r�| j�d"| j � | j�d�| j � | jd u�r�| j�d"| j � | j�d�| j � | j�d� | jd u�r| j�d"| j � | j�d�| j � | jd u�rF| j�d"| j � | j�d�| j � | jd u�rv| j�d"| j � | j�d�| j � | j�d� d S )�Nr, �O/* ------------------------------------------------------------------------ */ z/* Declarations for %s */ z##define %sTYPE_%s (%s_get_type ()) zB#define %s%s(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s, %s)) zA#define %sIS_%s(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s)) zT#define %s%s_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_%s, %sIface)) z struct _%s; ztypedef struct _%s %s; z!typedef struct _%sIface %sIface; zstruct _%sIface �{ z GTypeInterface parent_iface; r � _method_%sz gboolean (*handle_%s) ( z %s *object, z% GDBusMethodInvocation *invocation�, GUnixFDList *fd_list�, %sarg_%sz); � _signal_%sz void (*%s) ( z %s *object� _prop_get_%sz %s (*get_%s) (%s *object); ��key�%s�}; �allz!#if GLIB_CHECK_VERSION(2, 44, 0) z3G_DEFINE_AUTOPTR_CLEANUP_FUNC (%s, g_object_unref) �#endif z%s z'GType %s_get_type (void) G_GNUC_CONST; z.GDBusInterfaceInfo *%s_interface_info (void); zMguint %s_override_properties (GObjectClass *klass, guint property_id_begin); z./* D-Bus method call completion functions: */ zG_GNUC_DEPRECATED zKvoid %s_complete_%s ( %s *object, GDBusMethodInvocation *invocation� , %s%s�); z(/* D-Bus signal emissions functions: */ z void %s_emit_%s ( %s *objectz/* D-Bus method calls: */ z void %s_call_%s ( %s *proxy�� �@ �6, GDBusCallFlags call_flags, gint timeout_msecz\, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); z*gboolean %s_call_%s_finish ( %s *proxy�, %sout_%s� , GUnixFDList **out_fd_listz., GAsyncResult *res, GError **error); z(gboolean %s_call_%s_sync ( %s *proxy�, GUnixFDList *fd_listz6, GCancellable *cancellable, GError **error); z /* D-Bus property accessors: */ z%s%s_get_%s (%s *object); z%s%s_dup_%s (%s *object); z&void %s_set_%s (%s *object, %svalue); z /* ---- */ z/#define %sTYPE_%s_PROXY (%s_proxy_get_type ()) zS#define %s%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_PROXY, %sProxy)) z[#define %s%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_PROXY, %sProxyClass)) za#define %s%s_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_PROXY, %sProxyClass)) zM#define %sIS_%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_PROXY)) zP#define %sIS_%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_PROXY)) z!typedef struct _%sProxy %sProxy; z+typedef struct _%sProxyClass %sProxyClass; z/typedef struct _%sProxyPrivate %sProxyPrivate; zstruct _%sProxy z /*< private >*/ z GDBusProxy parent_instance; z %sProxyPrivate *priv; zstruct _%sProxyClass z GDBusProxyClass parent_class; z-GType %s_proxy_get_type (void) G_GNUC_CONST; )Zobjectsr? z8G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sProxy, g_object_unref) a void %s_proxy_new ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); zY%s *%s_proxy_new_finish ( GAsyncResult *res, GError **error); z�%s *%s_proxy_new_sync ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); a void %s_proxy_new_for_bus ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); za%s *%s_proxy_new_for_bus_finish ( GAsyncResult *res, GError **error); z�%s *%s_proxy_new_for_bus_sync ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); z5#define %sTYPE_%s_SKELETON (%s_skeleton_get_type ()) z\#define %s%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_SKELETON, %sSkeleton)) zd#define %s%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_SKELETON, %sSkeletonClass)) zj#define %s%s_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_SKELETON, %sSkeletonClass)) zS#define %sIS_%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_SKELETON)) zV#define %sIS_%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_SKELETON)) z'typedef struct _%sSkeleton %sSkeleton; z1typedef struct _%sSkeletonClass %sSkeletonClass; z5typedef struct _%sSkeletonPrivate %sSkeletonPrivate; zstruct _%sSkeleton z* GDBusInterfaceSkeleton parent_instance; z %sSkeletonPrivate *priv; zstruct _%sSkeletonClass z, GDBusInterfaceSkeletonClass parent_class; z0GType %s_skeleton_get_type (void) G_GNUC_CONST; z;G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sSkeleton, g_object_unref) z %s *%s_skeleton_new (void); z-#define %sTYPE_OBJECT (%sobject_get_type ()) zP#define %sOBJECT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT, %sObject)) zI#define %sIS_OBJECT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT)) z]#define %sOBJECT_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_OBJECT, %sObject)) zstruct _%sObject; z#typedef struct _%sObject %sObject; z-typedef struct _%sObjectIface %sObjectIface; zstruct _%sObjectIface z%{ GTypeInterface parent_iface; }; z.GType %sobject_get_type (void) G_GNUC_CONST; z9G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObject, g_object_unref) z(%s *%sobject_get_%s (%sObject *object); z)%s *%sobject_peek_%s (%sObject *object); z9#define %sTYPE_OBJECT_PROXY (%sobject_proxy_get_type ()) za#define %sOBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_PROXY, %sObjectProxy)) zi#define %sOBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_PROXY, %sObjectProxyClass)) zo#define %sOBJECT_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_PROXY, %sObjectProxyClass)) zU#define %sIS_OBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_PROXY)) zX#define %sIS_OBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_PROXY)) z-typedef struct _%sObjectProxy %sObjectProxy; z7typedef struct _%sObjectProxyClass %sObjectProxyClass; z;typedef struct _%sObjectProxyPrivate %sObjectProxyPrivate; zstruct _%sObjectProxy z$ GDBusObjectProxy parent_instance; z %sObjectProxyPrivate *priv; zstruct _%sObjectProxyClass z& GDBusObjectProxyClass parent_class; z3GType %sobject_proxy_get_type (void) G_GNUC_CONST; z>G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectProxy, g_object_unref) z[%sObjectProxy *%sobject_proxy_new (GDBusConnection *connection, const gchar *object_path); z?#define %sTYPE_OBJECT_SKELETON (%sobject_skeleton_get_type ()) zj#define %sOBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeleton)) zr#define %sOBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass)) zx#define %sOBJECT_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass)) z[#define %sIS_OBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_SKELETON)) z^#define %sIS_OBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_SKELETON)) z3typedef struct _%sObjectSkeleton %sObjectSkeleton; z=typedef struct _%sObjectSkeletonClass %sObjectSkeletonClass; zAtypedef struct _%sObjectSkeletonPrivate %sObjectSkeletonPrivate; zstruct _%sObjectSkeleton z' GDBusObjectSkeleton parent_instance; z! %sObjectSkeletonPrivate *priv; z struct _%sObjectSkeletonClass z) GDBusObjectSkeletonClass parent_class; z6GType %sobject_skeleton_get_type (void) G_GNUC_CONST; zAG_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectSkeleton, g_object_unref) zD%sObjectSkeleton *%sobject_skeleton_new (const gchar *object_path); zJvoid %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_); zK#define %sTYPE_OBJECT_MANAGER_CLIENT (%sobject_manager_client_get_type ()) z{#define %sOBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClient)) z�#define %sOBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass)) z�#define %sOBJECT_MANAGER_CLIENT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass)) zg#define %sIS_OBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_MANAGER_CLIENT)) zj#define %sIS_OBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_MANAGER_CLIENT)) z=typedef struct _%sObjectManagerClient %sObjectManagerClient; zGtypedef struct _%sObjectManagerClientClass %sObjectManagerClientClass; zKtypedef struct _%sObjectManagerClientPrivate %sObjectManagerClientPrivate; z struct _%sObjectManagerClient z, GDBusObjectManagerClient parent_instance; z& %sObjectManagerClientPrivate *priv; z#struct _%sObjectManagerClientClass z. GDBusObjectManagerClientClass parent_class; zFG_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectManagerClient, g_object_unref) z<GType %sobject_manager_client_get_type (void) G_GNUC_CONST; z�GType %sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager, const gchar *object_path, const gchar *interface_name, gpointer user_data); a7 void %sobject_manager_client_new ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); zxGDBusObjectManager *%sobject_manager_client_new_finish ( GAsyncResult *res, GError **error); a! GDBusObjectManager *%sobject_manager_client_new_sync ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); a= void %sobject_manager_client_new_for_bus ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); z�GDBusObjectManager *%sobject_manager_client_new_for_bus_finish ( GAsyncResult *res, GError **error); a' GDBusObjectManager *%sobject_manager_client_new_for_bus_sync ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error); )"r r' r. �namer � name_upper� name_lower� camel_namer �methods�since�unix_fd�in_args�ctype_in�signals�args� properties�arg�sorted�keysr �version_cmp_keyr r% � deprecated�out_argsr$ � ctype_out� free_func� ctype_in_dupr r r r ) r( �iZfunction_pointers�mr< �value�a�s�pr r r � declare_typesx s� � �������� �� � �� � � �� �� �� �� � � �� � �� � � �� ��� �� ������������ � �� �� � �� �� �� �� �� �� �� ������������ �� �� �� � �� � ���� ���� �� �� � �� ��� ��� �������� �� �� �� �� �� � �� �� �������� �� �� �� �� �� �� �� �� ��� �������� �� �� �� �� �� � � �� �� �� �� �� �� �� �� �� z!HeaderCodeGenerator.declare_typesc C sB | j �d� | j �d� | js>| j �d� | j �d�| j�� d S �Nr, z G_END_DECLS z#endif /* __{!s}__ */ �r' r. r# r0 r! �r( r r r �generate_header_postamble� s z-HeaderCodeGenerator.generate_header_postamblec C s | � � | �� | �� d S r )r3 re ri rh r r r �generate� s z HeaderCodeGenerator.generateN)�__name__� __module__� __qualname__r) r3 re ri rj r r r r r D s r r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) � InterfaceInfoHeaderCodeGeneratorc C s\ || _ t|�\| _| _| _t|�| _|| _|| _|| _ || _ | j d u rLd| _ || _ | | _ d S )Nr ) r r r r r r r! r" r# r$ r% r& r' ) r( r r r r" r# r$ r% r& r' r r r r) � s z)InterfaceInfoHeaderCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | j�d� | jrB| j�d� n(| j�d�| j �� | j�d�| j �� | j d ur�| j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d� d S r* r- r2 r r r r3 s z9InterfaceInfoHeaderCodeGenerator.generate_header_preamblec C s( | j D ] }| j�d| j|jf � qd S )Nz1extern %s const GDBusInterfaceInfo %s_interface; )r r' r. r% rL �r( r_ r r r � declare_infos) s ��z.InterfaceInfoHeaderCodeGenerator.declare_infosc C sB | j �d� | j �d� | js>| j �d� | j �d�| j�� d S rf rg rh r r r ri 2 s z:InterfaceInfoHeaderCodeGenerator.generate_header_postamblec C s | � � | �� | �� d S r )r3 rp ri rh r r r rj < s z)InterfaceInfoHeaderCodeGenerator.generateN)rk rl rm r) r3 rp ri rj r r r r rn � s rn c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )� InterfaceInfoBodyCodeGeneratorc C s< || _ t|�\| _| _| _|| _|| _|| _|| _|| _ d S r ) r r r r r r r" r$ �symbol_decoration_definer' )r( r r r r" r$ rr r' r r r r) F s z'InterfaceInfoBodyCodeGenerator.__init__c C sx d� | j�}| j�t�tj|�� | jd urJ| j�d� | j�d| j � | j�d� | j�d| j � | j�d� d S )Nr+ r, � #define %s �V#ifdef HAVE_CONFIG_H # include "config.h" #endif #include "%s" #include <string.h> � r r" r' r. r/ r0 r r1 rr r r2 r r r �generate_body_preambleZ s �� z5InterfaceInfoBodyCodeGenerator.generate_body_preamblec C sf | j �d||f � | j �d� |D ]\}}| j �d| � q$| j �d� | j �d� | j �d� d S )Nzconst %s * const %s[] = r5 z &%s, z NULL, r> r, )r' r. )r( �array_name_lowerZ element_type�elementsr rJ r r r �generate_arrayp s � z-InterfaceInfoBodyCodeGenerator.generate_arrayc C s t |�dkrd S g }|D ]�}|j�d�r*q| �d||jf |j� | j�d||jf � | j�d� | j�d� | j�d|j � | j�d|j � t |j�dkr�| j�d||jf � n | j�d � | j�d � | j�d � |j d ||jf f}|� |� q| � |d |� d S )Nr � org.gtk.GDBusz%s__%s_annotationsz.const GDBusAnnotationInfo %s__%s_annotation = r5 � -1, /* ref count */ � (gchar *) "%s", z/ (GDBusAnnotationInfo **) %s__%s_annotations, � NULL, /* no annotations */ r> r, z%s__%s_annotationZGDBusAnnotationInfo) r r< � startswith�define_annotationsZ key_lower� annotationsr' r. ra rO �appendry )r( rw r� Zannotation_pointersrb r< r r r r { s@ ��� �� �z1InterfaceInfoBodyCodeGenerator.define_annotationsc C s t |�dkrd S g }|D ]�}| �d||jf |j� | j�d||jf � | j�d� | j�d� | j�d|j � | j�d|j � t |j�dkr�| j�d||jf � n | j�d� | j�d � | j�d � |jd ||jf f}|�|� q| � |d |� d S ) Nr z%s__%s_arg_annotationsz const GDBusArgInfo %s__%s_arg = r5 r{ r| z3 (GDBusAnnotationInfo **) %s__%s_arg_annotations, r} r> r, z %s__%s_argZ GDBusArgInfo) r r rJ r� r' r. � signaturerO r� ry )r( rw rT Z arg_pointersrb r< r r r � define_args� s4 � � �� z*InterfaceInfoBodyCodeGenerator.define_argsc C s� | j D �]�}| j�d� | j�d|j � | j�d� t|j�dk�r�g }|jD �]n}| �d|j|jf |j� | �d|j|jf |j � | � d|j|jf |j � | j�d|j|jf � | j�d � | j�d � | j�d |j � t|j�dk�r| j�d |j|jf � n | j�d � t|j �dk�rF| j�d|j|jf � n | j�d� t|j �dk�r|| j�d|j|jf � n | j�d� | j�d� | j�d� |j d|j|jf f}|� |� qP| �d|j d|� t|j�dk�r(g }|jD �] }| �d|j|jf |j� | � d|j|jf |j � | j�d|j|jf � | j�d � | j�d � | j�d |j � t|j�dk�r�| j�d|j|jf � n | j�d� t|j �dk�r�| j�d|j|jf � n | j�d� | j�d� | j�d� |j d |j|jf f}|� |� �q�| �d |j d |� t|j�dk�r�g }|jD �](}|j�r^|j�r^d } n |j�rld } n|j�rzd!} nd"} | � d#|j|jf |j � | j�d$|j|jf � | j�d � | j�d � | j�d |j � | j�d |j � | j�d%| � t|j �dk�r&| j�d&|j|jf � n | j�d� | j�d� | j�d� |j d'|j|jf f}|� |� �qB| �d(|j d)|� | � d*|j |j � | j�d+|j � | j�d � | j�d � | j�d |j � t|j�dk�r�| j�d,|j � n | j�d-� t|j�dk�r&| j�d.|j � n | j�d/� t|j�dk�rV| j�d0|j � n | j�d1� t|j �dk�r�| j�d2|j � n | j�d� | j�d� | j�d� qd S )3Nr4 z/* Definitions for %s */ r, r z %s_interface__%s_method_in_argsz %s_interface__%s_method_out_argsz#%s_interface__%s_method_annotationsz0const GDBusMethodInfo %s_interface__%s_method = r5 r{ r| z5 (GDBusArgInfo **) %s_interface__%s_method_in_args, z NULL, /* no in args */ z6 (GDBusArgInfo **) %s_interface__%s_method_out_args, z NULL, /* no out args */ z@ (GDBusAnnotationInfo **) %s_interface__%s_method_annotations, r} r> z%s_interface__%s_methodz%s_interface_methodsZGDBusMethodInfoz %s_interface__%s_signal_argsz#%s_interface__%s_signal_annotationsz0const GDBusSignalInfo %s_interface__%s_signal = z2 (GDBusArgInfo **) %s_interface__%s_signal_args, z NULL, /* no args */ z@ (GDBusAnnotationInfo **) %s_interface__%s_signal_annotations, z%s_interface__%s_signalz%s_interface_signalsZGDBusSignalInfo�IG_DBUS_PROPERTY_INFO_FLAGS_READABLE | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE�#G_DBUS_PROPERTY_INFO_FLAGS_READABLE�#G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE� G_DBUS_PROPERTY_INFO_FLAGS_NONEz%%s_interface__%s_property_annotationsz4const GDBusPropertyInfo %s_interface__%s_property = z %s, zB (GDBusAnnotationInfo **) %s_interface__%s_property_annotations, z%s_interface__%s_propertyz%s_interface_propertiesZGDBusPropertyInfoz%s_interface_annotationsz(const GDBusInterfaceInfo %s_interface = z- (GDBusMethodInfo **) %s_interface_methods, z NULL, /* no methods */ z- (GDBusSignalInfo **) %s_interface_signals, z NULL, /* no signals */ z2 (GDBusPropertyInfo **) %s_interface_properties, zNULL, /* no properties */ z5 (GDBusAnnotationInfo **) %s_interface_annotations, )r r' r. rJ r rN r� rL rQ r[ r r� rO r� ry rS rT rU �readable�writabler� ) r( r_ Zmethod_pointersr` r< Zsignal_pointersrc Zproperty_pointersrd �flagsr r r � define_infos� s| � �� �� �� �� �� �� �� � � � �� �� �� �� �� �� �� �� �� �� � � � �� z+InterfaceInfoBodyCodeGenerator.define_infosc C s | � � | �� d S r )rv r� rh r r r rj � s z'InterfaceInfoBodyCodeGenerator.generateN) rk rl rm r) rv ry r r� r� rj r r r r rq E s (! Xrq c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#S )$� CodeGeneratorc C sH || _ t|�\| _| _| _|| _|| _|| _|| _|| _ || _ | | _ d S r ) r r r r r r r r" � docbook_genr$ rr r' ) r( r r r r r" r� r$ rr r' r r r r) � s zCodeGenerator.__init__c C s� d� | j�}| j�t�tj|�� | jd urJ| j�d� | j�d| j � | j�d� | j�d| j � | j�d� | j�d� | j�d� | j�d� | j�d � | j�d � | j�d � | j�d � | j�d � | j�d� d S )Nr+ r, rs rt z8#ifdef G_OS_UNIX # include <gio/gunixfdlist.h> #endif zbtypedef struct { GDBusArgInfo parent_struct; gboolean use_gvariant; } _ExtendedGDBusArgInfo; z�typedef struct { GDBusMethodInfo parent_struct; const gchar *signal_name; gboolean pass_fdlist; } _ExtendedGDBusMethodInfo; zktypedef struct { GDBusSignalInfo parent_struct; const gchar *signal_name; } _ExtendedGDBusSignalInfo; z�typedef struct { GDBusPropertyInfo parent_struct; const gchar *hyphen_name; guint use_gvariant : 1; guint emits_changed_signal : 1; } _ExtendedGDBusPropertyInfo; zqtypedef struct { GDBusInterfaceInfo parent_struct; const gchar *hyphen_name; } _ExtendedGDBusInterfaceInfo; a typedef struct { const _ExtendedGDBusPropertyInfo *info; guint prop_id; GValue orig_value; /* the value before the change */ } ChangedProperty; static void _changed_property_free (ChangedProperty *data) { g_value_unset (&data->orig_value); g_free (data); } a� static gboolean _g_strv_equal0 (gchar **a, gchar **b) { gboolean ret = FALSE; guint n; if (a == NULL && b == NULL) { ret = TRUE; goto out; } if (a == NULL || b == NULL) goto out; if (g_strv_length (a) != g_strv_length (b)) goto out; for (n = 0; a[n] != NULL; n++) if (g_strcmp0 (a[n], b[n]) != 0) goto out; ret = TRUE; out: return ret; } a static gboolean _g_variant_equal0 (GVariant *a, GVariant *b) { gboolean ret = FALSE; if (a == NULL && b == NULL) { ret = TRUE; goto out; } if (a == NULL || b == NULL) goto out; ret = g_variant_equal (a, b); out: return ret; } ah G_GNUC_UNUSED static gboolean _g_value_equal (const GValue *a, const GValue *b) { gboolean ret = FALSE; g_assert (G_VALUE_TYPE (a) == G_VALUE_TYPE (b)); switch (G_VALUE_TYPE (a)) { case G_TYPE_BOOLEAN: ret = (g_value_get_boolean (a) == g_value_get_boolean (b)); break; case G_TYPE_UCHAR: ret = (g_value_get_uchar (a) == g_value_get_uchar (b)); break; case G_TYPE_INT: ret = (g_value_get_int (a) == g_value_get_int (b)); break; case G_TYPE_UINT: ret = (g_value_get_uint (a) == g_value_get_uint (b)); break; case G_TYPE_INT64: ret = (g_value_get_int64 (a) == g_value_get_int64 (b)); break; case G_TYPE_UINT64: ret = (g_value_get_uint64 (a) == g_value_get_uint64 (b)); break; case G_TYPE_DOUBLE: { /* Avoid -Wfloat-equal warnings by doing a direct bit compare */ gdouble da = g_value_get_double (a); gdouble db = g_value_get_double (b); ret = memcmp (&da, &db, sizeof (gdouble)) == 0; } break; case G_TYPE_STRING: ret = (g_strcmp0 (g_value_get_string (a), g_value_get_string (b)) == 0); break; case G_TYPE_VARIANT: ret = _g_variant_equal0 (g_value_get_variant (a), g_value_get_variant (b)); break; default: if (G_VALUE_TYPE (a) == G_TYPE_STRV) ret = _g_strv_equal0 (g_value_get_boxed (a), g_value_get_boxed (b)); else g_critical ("_g_value_equal() does not handle type %s", g_type_name (G_VALUE_TYPE (a))); break; } return ret; } ru r2 r r r rv � sR �� �� � � � � ����z$CodeGenerator.generate_body_preamblec C s� |d u r d S d}|D ]r}|j �d�r&q| j�d|||j |jf � t|j�dkr^| j�d� n| j�d||f � | j�d� |d7 }q|dkr�| j�d| � d}|D ].}|j �d�r�q�| j�d ||f � |d7 }q�| j�d � |S ) Nr rz zUstatic const GDBusAnnotationInfo %s_%d = { -1, (gchar *) "%s", (gchar *) "%s", z NULL z+ (GDBusAnnotationInfo **) &%s_%d_pointers �}; r z;static const GDBusAnnotationInfo * const %s_pointers[] = { z &%s_%d, � NULL }; )r< r~ r' r. ra r r� )r( �prefixr� �nrb r` r r r �generate_annotationss s@ �� � �� z"CodeGenerator.generate_annotationsc C s� |D ]�}| � d||jf |j�}| j�d||j|j|jf � |dkrT| j�d� n| j�d||jf � | j�d� t�|jd�s�| j�d� n | j�d � | j�d � qt|�dkr�| j�d | � |D ]}| j�d ||jf � q�| j�d � d S )Nz%s_arg_%s_annotation_infozastatic const _ExtendedGDBusArgInfo %s_%s = { { -1, (gchar *) "%s", (gchar *) "%s", r � NULL zA (GDBusAnnotationInfo **) &%s_arg_%s_annotation_info_pointers z }, � org.gtk.GDBus.C.ForceGVariant� FALSE � TRUE r� z4static const GDBusArgInfo * const %s_pointers[] = { z &%s_%s.parent_struct, r� ) r� rJ r� r' r. r� r �lookup_annotationr )r( r� rT rb �num_annor r r � generate_args� s< ����� � �zCodeGenerator.generate_argsc C sB | j �d|j � t|j�dk�r�|jD �]4}| �d|j|jf |j� | �d|j|jf |j� | � d|j|jf |j �}| j �d|j|j|jf � t|j�dkr�| j �d� n| j �d|j|jf � t|j�dkr�| j �d� n| j �d |j|jf � |dk�r| j �d � n| j �d |j|jf � | j �d |j |j �rHd ndf � | j �d� q(| j �d|j � |jD ] }| j �d|j|jf � �qx| j �d� t|j �dk�r�|j D ]�}| �d|j|jf |j� | � d|j|jf |j �}| j �d|j|j|jf � t|j�dk�r,| j �d� n| j �d|j|jf � |dk�r\| j �d � n| j �d|j|jf � | j �d|j � | j �d� �q�| j �d|j � |j D ] }| j �d|j|jf � �q�| j �d� t|j�dk�rL|jD �]}|j�r |j�r d}n |j�rd }n|j�r(d }nd }| � d |j|jf |j �}| j �d |j|j|j|jj|f � |dk�r�| j �d � n| j �d!|j|jf � | j �d"|j � t�|j d#��s�| j �d$� n | j �d%� |j�r�| j �d&� n | j �d'� | j �d� �q�| j �d(|j � |jD ] }| j �d)|j|jf � �q | j �d� | � d*|j |j �}| j �d+|j|jf � t|j�dk�r�| j �d� n| j �d,|j � t|j �dk�r�| j �d� n| j �d-|j � t|j�dk�r�| j �d� n| j �d.|j � |dk�r | j �d � n| j �d/|j � | j �d0|j � | j �d1� | j �| j�d2|j|jf d3�� | �|| j d� | j �d4|j|jf � | j �| j�d5|j|jf d3�� | �|| j d� | j �d6|j � t|j�dk�r�| j �d7� | j �d8� |jD ]}| j �d9|j � �q | j �d:� | j �d1� d S );Nz+/* ---- Introspection data for %s ---- */ r z_%s_method_info_%s_IN_ARGz_%s_method_info_%s_OUT_ARGz _%s_method_%s_annotation_infoz]static const _ExtendedGDBusMethodInfo _%s_method_info_%s = { { -1, (gchar *) "%s", z NULL, z; (GDBusArgInfo **) &_%s_method_info_%s_IN_ARG_pointers, z< (GDBusArgInfo **) &_%s_method_info_%s_OUT_ARG_pointers, r� zE (GDBusAnnotationInfo **) &_%s_method_%s_annotation_info_pointers z }, "handle-%s", %s ZTRUEZFALSEr� zDstatic const GDBusMethodInfo * const _%s_method_info_pointers[] = { z% &_%s_method_info_%s.parent_struct, r� z_%s_signal_info_%s_ARGz _%s_signal_%s_annotation_infoz]static const _ExtendedGDBusSignalInfo _%s_signal_info_%s = { { -1, (gchar *) "%s", z8 (GDBusArgInfo **) &_%s_signal_info_%s_ARG_pointers, zE (GDBusAnnotationInfo **) &_%s_signal_%s_annotation_info_pointers z }, "%s" zDstatic const GDBusSignalInfo * const _%s_signal_info_pointers[] = { z% &_%s_signal_info_%s.parent_struct, r� r� r� r� z _%s_property_%s_annotation_infoz}static const _ExtendedGDBusPropertyInfo _%s_property_info_%s = { { -1, (gchar *) "%s", (gchar *) "%s", %s, zG (GDBusAnnotationInfo **) &_%s_property_%s_annotation_info_pointers z }, "%s", r� z FALSE, z TRUE, r� r� zHstatic const GDBusPropertyInfo * const _%s_property_info_pointers[] = { z' &_%s_property_info_%s.parent_struct, z_%s_annotation_infoz`static const _ExtendedGDBusInterfaceInfo _%s_interface_info = { { -1, (gchar *) "%s", z4 (GDBusMethodInfo **) &_%s_method_info_pointers, z4 (GDBusSignalInfo **) &_%s_signal_info_pointers, z8 (GDBusPropertyInfo **) &_%s_property_info_pointers, z; (GDBusAnnotationInfo **) &_%s_annotation_info_pointers z }, "%s", }; r, z�/** * %s_interface_info: * * Gets a machine-readable description of the #%s D-Bus interface. * * Returns: (transfer none): A #GDBusInterfaceInfo. Do not free. FzvGDBusInterfaceInfo * %s_interface_info (void) { return (GDBusInterfaceInfo *) &_%s_interface_info.parent_struct; } ag /** * %s_override_properties: * @klass: The class structure for a #GObject derived class. * @property_id_begin: The property id to assign to the first overridden property. * * Overrides all #GObject properties in the #%s interface for a concrete class. * The properties are overridden in the order they are defined. * * Returns: The last property id. z1guint %s_override_properties (GObjectClass *klassz G_GNUC_UNUSEDz , guint property_id_begin) { zG g_object_class_override_property (klass, property_id_begin++, "%s"); z# return property_id_begin - 1; } )r' r. rJ r rN r� rL rQ r[ r� r� � name_hyphenrP rS rT rU r� r� rV r� r r� Zemits_changed_signalr� �expand�+write_gtkdoc_deprecated_and_since_and_closerM )r( r_ r` r� rc rd �accessr r r �$generate_introspection_for_interface� s� � ����� �� �� ������ �� ���� �� ���� �� ��� ��� �� �� � ������ �� ��� �� � ��� �� z2CodeGenerator.generate_introspection_for_interfacec C s> | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j d�� i }t|j�dkr�|jD ]:}|j d|j f}d|j }|d|j|j f 7 }|||< q~t|j �dk�r |j D ]:}|j d |j f}d |j }|d |j|j f 7 }|||< q�t|j �dk�r`|j D ]<}|j d |j f}d |j }|d|j|j f 7 }|||< �q"t|�� tjd�D ]}| j �d|| � �qr| j �| j�d|j d�� | �|| j d� | j �d� | j �d|j|jf � | j �d|j|j f � | j �d� | j �d|j |jf � t|j�dk�rXt|j �dk�rXt|j �dk�rX| j �d� n | j �d� | j �d� t|j�dk�r�| j �d� |jD �] }| j �| j�d|j|j |jf d�� |j�r�| j �d� |jD ]}| j �d|j � �q�| j �| j�d |j|j|j |j f d�� | �|| j d � |j�r:d } nd } | j �d |j |j|j t|j�| f � |j�rz| j �d � |jD ]}| j �d!|j � �q�| j �d"� | j �d� �q�t|j �dk�r�| j �d#� |j D ]�}| j �| j�d$|j|j |jf d�� |jD ]}| j �d%|j � �q| j �| j�d&|j|jf d�� | �|| j d � | j �d'|j |j|j t|j�f � |jD ]}| j �d!|j � �q~| j �d"� | j �d� �q�t|j �dk�r.| j �d(� |j D �]T}|j�r�|j�r�d)} n,|j�r d*} n |j�rd+} ntd,�|j�� | j �| j�d-|j|j |j|j| f d�� | �|| j d � | j �d.� |jjd/k�r�d0|j |j|j|jjf }�nd|jjd1k�r�d2|j |j|jf }�n>|jjd3k�r�d4|j |j|jf }�n|jjd5k�rd6|j |j|jf }�n�|jjd7k�r*d8|j |j|jf }�n�|jjd9k�rPd:|j |j|jf }�n�|jjd;k�rvd<|j |j|jf }�n�|jjd=k�r�d>|j |j|jf }�nZ|jjd?k�r�d@|j |j|jf }�n4|jjdAk�r�dB|j |j|jf }�n|jjdCk�r dD|j |j|jf }n�|jjdEk�r0dD|j |j|jf }n�|jjdFk�rTdD|j |j|jf }n�|jjdGk�rxdD|j |j|jf }n~|jjdHk�r�dI|j |j|jf }nZ|jjdJk�r�dI|j |j|jf }n6|jjdKk�r�dI|j |j|jf }ntdL�|jj�� dM} |j �r dN| } | j �dO|| f � | j �d� �q�| j �dP� d S )QNr, zF/** * %s: * * Abstract interface type for the D-Bus interface #%s. Fr z8/** * %sIface: * @parent_iface: The parent interface. r6 z @handle_%s: z&Handler for the #%s::handle-%s signal.r9 z@%s: z Handler for the #%s::%s signal.r: z @get_%s: z Getter for the #%s:%s property.r; z * %s z1 * * Virtual table for the D-Bus interface #%s. z typedef %sIface %sInterface; z+G_DEFINE_INTERFACE (%s, %s, G_TYPE_OBJECT) z+static void %s_default_init (%sIface *iface� G_GNUC_UNUSED) �) r5 z9 /* GObject signals for incoming D-Bus method calls: */ z[ /** * %s::handle-%s: * @object: A #%s. * @invocation: A #GDBusMethodInvocation. z4 * @fd_list: (nullable): A #GUnixFDList or %NULL. z0 * @arg_%s: Argument passed by remote caller. au * * Signal emitted when a remote caller is invoking the %s.%s() D-Bus method. * * If a signal handler returns %%TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call %s_complete_%s() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %%G_DBUS_ERROR_UNKNOWN_METHOD error is returned. * * Returns: %%G_DBUS_METHOD_INVOCATION_HANDLED or %%TRUE if the invocation was handled, %%G_DBUS_METHOD_INVOCATION_UNHANDLED or %%FALSE to let other signal handlers run. rD r a g_signal_new ("handle-%s", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (%sIface, handle_%s), g_signal_accumulator_true_handled, NULL, g_cclosure_marshal_generic, G_TYPE_BOOLEAN, %d, G_TYPE_DBUS_METHOD_INVOCATIONz, G_TYPE_UNIX_FD_LISTz, %srB z4 /* GObject signals for received D-Bus signals: */ z( /** * %s::%s: * @object: A #%s. z * @arg_%s: Argument. z� * * On the client-side, this signal is emitted whenever the D-Bus signal #%s::%s is received. * * On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal. z� g_signal_new ("%s", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (%sIface, %s), NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, %dz1 /* GObject properties for D-Bus properties: */ z�Since the D-Bus property for this #GObject property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.z�Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.z�Since the D-Bus property for this #GObject property is writable but not readable, it is meaningful to write to it on both the client- and service-side. It is only meaningful, however, to read from it on the service-side.�>Cannot handle property "{}" that neither readable nor writablezO /** * %s:%s: * * Represents the D-Bus property #%s:%s. * * %s z. g_object_interface_install_property (iface, �G_TYPE_VARIANTzCg_param_spec_variant ("%s", "%s", "%s", G_VARIANT_TYPE ("%s"), NULL�bz-g_param_spec_boolean ("%s", "%s", "%s", FALSE�yz/g_param_spec_uchar ("%s", "%s", "%s", 0, 255, 0r� z=g_param_spec_int ("%s", "%s", "%s", G_MININT16, G_MAXINT16, 0�qz6g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT16, 0r_ z=g_param_spec_int ("%s", "%s", "%s", G_MININT32, G_MAXINT32, 0�uz6g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT32, 0�xz?g_param_spec_int64 ("%s", "%s", "%s", G_MININT64, G_MAXINT64, 0�tz8g_param_spec_uint64 ("%s", "%s", "%s", 0, G_MAXUINT64, 0�dzEg_param_spec_double ("%s", "%s", "%s", -G_MAXDOUBLE, G_MAXDOUBLE, 0.0rc z+g_param_spec_string ("%s", "%s", "%s", NULL�o�gZay�asz1g_param_spec_boxed ("%s", "%s", "%s", G_TYPE_STRVZaoZaayz%Unsupported gtype "{}" for GParamSpec�*G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS�G_PARAM_DEPRECATED | z %s, %s));�} ) r' r. r� r� rM rJ r� r rN rO rL r� rS rU rW rX r rY rP rQ �gtyperT r� r� r r0 rV r� rZ ) r( r_ Zdoc_bitsr` r< ra rc rd rb � extra_args�hintr� r r r �generate_interface� s8 ��� ��� � � � �� � �� ��0 � ��� � ���� ��� ��� ��� �� ����� ��� � ��� ��� ��� ��������� �z CodeGenerator.generate_interfacec C s� |j D �]�}|jr |jr d}n(|jr*d}n |jr6d}ntd�|j�� | j�| j� d|j |j |j |j|j|f d�� |j j d ur�| j�d|j |j f � n | j�d� | �|| jd � | j�d |j j|j |j |j f � | j�d |j|j|j f � | j�d � | j�d � |j j d u�r�| j�| j� d|j |j |j |j|j||j j f d�� | �|| jd � | j�d|j j|j |j |j |j jf � | j�d|j � | j�d� | j�d � | j�d � |j�r�|j�r�d}n,|j�r�d}n |j�r�d}ntd�|j�� | j�| j� d|j |j |j |j|j|f d�� | �|| jd � | j�d|j |j |j |j jf � | j�d|j � | j�d � | j�d � qd S )Nz�Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.zrSince this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.zjSince this D-Bus property is not readable, it is only meaningful to use this function on the service-side.r� zk/** * %s_get_%s: (skip) * @object: A #%s. * * Gets the value of the #%s:%s D-Bus property. * * %s * Fah * The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use %s_dup_%s() if on another thread. * * Returns: (transfer none) (nullable): The property value or %%NULL if the property is not set. Do not free the returned value, it belongs to @object. z * Returns: The property value. r z %s %s_get_%s (%s *object) { z3 return %s%s_GET_IFACE (object)->get_%s (object); �} r, z�/** * %s_dup_%s: (skip) * @object: A #%s. * * Gets a copy of the #%s:%s D-Bus property. * * %s * * Returns: (transfer full) (nullable): The property value or %%NULL if the property is not set. The returned value should be freed with %s(). z'%s %s_dup_%s (%s *object) { %svalue; z8 g_object_get (G_OBJECT (object), "%s", &value, NULL); � return value; zjSince this D-Bus property is not writable, it is only meaningful to use this function on the service-side.zrSince this D-Bus property is writable, it is meaningful to use this function on both the client- and service-side.z�/** * %s_set_%s: (skip) * @object: A #%s. * @value: The value to set. * * Sets the #%s:%s D-Bus property to @value. * * %s z'void %s_set_%s (%s *object, %svalue) { z7 g_object_set (G_OBJECT (object), "%s", value, NULL); )rU r� r� r r0 rJ r' r. r� r� rL rM rV r] r� rR r rK r^ r� )r( r_ rd r� r r r �generate_property_accessors s� ��� �� �� ���� ������� �� ��� ������ z)CodeGenerator.generate_property_accessorsc C s |j D �]}| j�| j�d|j|j|jf d�� |jD ]}| j�d|j � q8| j�| j�d|j|jf d�� | � || jd� | j�d|j|j|jf � |jD ] }| j�d|j |jf � q�| j�d|j � |jD ]}| j�d |j � q�| j�d � | j�d � qd S ) Nz&/** * %s_emit_%s: * @object: A #%s. Fz. * @arg_%s: Argument to pass with the signal. z& * * Emits the #%s::%s D-Bus signal. r z void %s_emit_%s ( %s *objectr8 z)) { g_signal_emit_by_name (object, "%s"z, arg_%srB r� ) rS r' r. r� r� rL rM rT rJ r� rR r� )r( r_ rc rb r r r �generate_signal_emitters� sD ��� ����� � z&CodeGenerator.generate_signal_emittersc C s� |j D �]�}| j�d|j|j|jf � |jD ]}| j�d|j � q.| jdkr\| j�d� |jrn| j�d� | j�| j � d|j|j|j|j|j|jf d�� | � || jd� | j�d |j|j|jf � |jD ] }| j�d |j |jf � q�| jdk�r| j�d � |j�r | j�d � | j�d � |j�r>| j�d� n | j�d� | j�d|j � |jD ]}| j�d|j � �qb| j�d� |jD ]}| j�d|j � �q�| j�d� | jdk�r�| j�d� n | j�d� |j�r�| j�d� | j�d� | j�d� | j�d|j|j|jf � |jD ].}| j�d|j|j�rJd |j nd f � �q(|j�rl| j�d � | j�| j � d |j|j|j|jf d�� | � || jd� | j�d |j|j|jf � |jD ] }| j�d!|j|jf � �q�|j�r�| j�d"� | j�d#� |j�r | j�d$� n | j�d%� | j�d&� | j�d'� |jD ]}| j�d|j � �qH| j�d� |jD ]}| j�d(|j � �qt| j�d)� | j�d*� | j�d+|j|j|jf � |jD ]}| j�d|j � �q�| jdk�r�| j�d� |j�r| j�d� |jD ].}| j�d|j|j�r6d |j nd f � �q|j�rX| j�d,� | j�| j � d-|j|j|j|jf d�� | � || jd� | j�d.|j|j|jf � |jD ] }| j�d |j |jf � �q�| jdk�r�| j�d � |j�r | j�d/� |jD ] }| j�d!|j|jf � �q|j�r:| j�d"� | j�d0� |j�r\| j�d1� n | j�d2� | j�d|j � |jD ]}| j�d|j � �q�| j�d� |jD ]}| j�d|j � �q�| j�d� | jdk�r�| j�d� n | j�d� |j�r | j�d3� | j�d4� | j�d'� |jD ]}| j�d|j � �q*| j�d� |jD ]}| j�d(|j � �qV| j�d)� | j�d*� qd S )5Nz*/** * %s_call_%s: * @proxy: A #%sProxy. z9 * @arg_%s: Argument to pass with the method invocation. rC a6 * @call_flags: Flags from the #GDBusCallFlags enumeration. If you want to allow interactive authorization be sure to set %G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning "infinite") or -1 to use the proxy default timeout. �2 * @fd_list: (nullable): A #GUnixFDList or %NULL. aU * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %%NULL. * @user_data: User data to pass to @callback. * * Asynchronously invokes the %s.%s() D-Bus method on @proxy. * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_call_%s_finish() to get the result of the operation. * * See %s_call_%s_sync() for the synchronous, blocking version of this method. Fr z void %s_call_%s ( %s *proxyr8 rF r7 z], GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { z= g_dbus_proxy_call_with_unix_fd_list (G_DBUS_PROXY (proxy), z+ g_dbus_proxy_call (G_DBUS_PROXY (proxy), z "%s", g_variant_new ("(r= �)"�, arg_%sz), z" call_flags, timeout_msec, z$ G_DBUS_CALL_FLAGS_NONE, -1, z fd_list, z/ cancellable, callback, user_data); r� z1/** * %s_call_%s_finish: * @proxy: A #%sProxy. zZ * @out_%s: (out) (optional)%s: Return location for return parameter or %%NULL to ignore. � r zZ * @out_fd_list: (out) (optional): Return location for a #GUnixFDList or %NULL to ignore. a * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_call_%s(). * @error: Return location for error or %%NULL. * * Finishes an operation started with %s_call_%s(). * * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set. z*gboolean %s_call_%s_finish ( %s *proxyrG rH zA, GAsyncResult *res, GError **error) { GVariant *_ret; ze _ret = g_dbus_proxy_call_with_unix_fd_list_finish (G_DBUS_PROXY (proxy), out_fd_list, res, error); zF _ret = g_dbus_proxy_call_finish (G_DBUS_PROXY (proxy), res, error); z# if (_ret == NULL) goto _out; z* g_variant_get (_ret, "(z, out_%sz ); g_variant_unref (_ret); z _out: return _ret != NULL; } z//** * %s_call_%s_sync: * @proxy: A #%sProxy. zE * @out_fd_list: (out): Return location for a #GUnixFDList or %NULL. at * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL. * * Synchronously invokes the %s.%s() D-Bus method on @proxy. The calling thread is blocked until a reply is received. * * See %s_call_%s() for the asynchronous version of this method. * * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set. z(gboolean %s_call_%s_sync ( %s *proxyrI zI, GCancellable *cancellable, GError **error) { GVariant *_ret; zI _ret = g_dbus_proxy_call_with_unix_fd_list_sync (G_DBUS_PROXY (proxy), z7 _ret = g_dbus_proxy_call_sync (G_DBUS_PROXY (proxy), z fd_list, out_fd_list, z@ cancellable, error); if (_ret == NULL) goto _out; )rN r' r. rL rM rQ rJ r$ rP r� r� r� rR � format_inr[ Zarray_annotationr\ Z format_out�r( r_ r` rb r r r �generate_method_calls� s� �� �� �� ������ � �� � �� ������ �� ��� �� �� �� ���� ���� � ��� � z#CodeGenerator.generate_method_callsc C s� |j D �]z}| j�d|j|j|jf � |jr:| j�d� |jD ]}| j�d|j � q@| j�| j� d|j|jf d�� | � || jd� | j�d|j|j|jf � |jr�| j�d� |jD ] }| j�d |j |jf � q�| j�d � |jr�| j�d � n | j�d � |jD ]}| j�d |j � �q| j�d� |jD ]}| j�d|j � �q:|j�rj| j�d� n | j�d� | j�d� qd S )Nze/** * %s_complete_%s: * @object: A #%s. * @invocation: (transfer full): A #GDBusMethodInvocation. r� z * @%s: Parameter to return. a= * * Helper function used in service implementations to finish handling invocations of the %s.%s() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar. * * This method will free @invocation, you cannot use it afterwards. Fr zYvoid %s_complete_%s ( %s *object G_GNUC_UNUSED, GDBusMethodInvocation *invocationr7 rA z) { z\ g_dbus_method_invocation_return_value_with_unix_fd_list (invocation, g_variant_new ("(zJ g_dbus_method_invocation_return_value (invocation, g_variant_new ("(r= r� z, %sz), fd_list); �)); r� ) rN r' r. rL rM rP r[ rJ r� r� r� rR r� r� r r r �generate_method_completers� s^ ��� ��� �� �� z(CodeGenerator.generate_method_completersc C s� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �d|j � | j �d|j|jf � | j �d � | j �d |j|jf � | j �d |j � | j �d |j|j|jf � | j �d � | j �d |j|jf � | j �d |j|j|jf � | j �d� | j �d|j � | j �d|j|j|jf � | j �d� | j �d|j � | j �d|j � t |j �dk�r�| j �d� n | j �d� | j �d� t |j �dk�r| j �dt |j �|jf � | j �d� t |j �dk�r\| j �d|j � | j �d|j � | j �d� | j �d|j � t |j �dk�r�| j �d � n | j �d � | j �d� t |j �dk�r�| j �d t |j �|j|j |jf � | j �d� | j �d |j � | j �d � | j �d!|j � | j �d"|j|jf � | j �d#� | j �d$|j|jf � | j �d%� | j �d&� | j �d� | j �d'|j � | j �d(|j|j|j|j|jf � |j D �]�}d)}|j j d u�r�d*}| j �d+|j j|j|j|j|j|j|j|j j|f � d}|j jd,k�s0|j jd-k�s0|j jd.k�r4d/}|�rL| j �d0|j � | j �d1|j � |j jd2k�r�| j �d3� | j �d4� | j �d5� n�| j �d6� d7}|j jd8k�s�|j jd,k�s�|j jd-k�s�|j jd.k�r�d9}| j �d:|j j|f � |�r| j �d;|j � | j �d<� | j �d=� | j �d>� | j �d?� | j �d� �q�| j �d@|j|j|j|j|j|j|jf � | j �dA|j|j|j|j|j|j|jf � t |j �dk�r�| j �dB|j � | j �dC|j � | j �d� | j �dD|j|jf � t |j �dk�r | j �dE� n | j �dF� | j �dG� |j D ]"}| j �dH|j|j|jf � �q:| j �d� | j �| j�dI|j|j |j|jf d�� | �|| j d� | j �dJ|j|j|j|j f � | j �dK|j|j|j|jf � | �|| j d� | j �dL|j|j|j|jf � | j �| j�dM|j|j |j|jf d�� | �|| j d� | j �dN|j|j|j|j|j |j|jf � | j �d� | j �| j�dO|j|j|j|jf d�� | �|| j d� | j �dP|j|j|j|j f � | j �dQ|j|j|j|jf � | �|| j d� | j �dR|j|j|j|jf � | j �| j�dS|j|j|j|jf d�� | �|| j d� | j �dT|j|j|j|j|j |j|jf � | j �d� d S )UN�P/* ------------------------------------------------------------------------ */ z|/** * %sProxy: * * The #%sProxy structure contains only private data and should only be accessed using the provided API. Fr r, z]/** * %sProxyClass: * @parent_class: The parent class. * * Class structure for #%sProxy. z-struct _%sProxyPrivate { GData *qdata; }; z3static void %s_proxy_iface_init (%sIface *iface); �2#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 z?G_DEFINE_TYPE_WITH_CODE (%sProxy, %s_proxy, G_TYPE_DBUS_PROXY, z1 G_ADD_PRIVATE (%sProxy) zR G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_proxy_iface_init)) �#else r@ z2static void %s_proxy_finalize (GObject *object) { z( %sProxy *proxy = %s%s_PROXY (object); z* g_datalist_clear (&proxy->priv->qdata); z@ G_OBJECT_CLASS (%s_proxy_parent_class)->finalize (object); } z7static void %s_proxy_get_property (GObject *objectz\ G_GNUC_UNUSED, guint prop_id G_GNUC_UNUSED, GValue *value G_GNUC_UNUSED, z2, guint prop_id, GValue *value, z' GParamSpec *pspec G_GNUC_UNUSED) { a const _ExtendedGDBusPropertyInfo *info; GVariant *variant; g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (object), info->parent_struct.name); if (info->use_gvariant) { g_value_set_variant (value, variant); } else { if (variant != NULL) g_dbus_gvariant_to_gvalue (variant, value); } if (variant != NULL) g_variant_unref (variant); r� zkstatic void %s_proxy_set_property_cb (GDBusProxy *proxy, GAsyncResult *res, gpointer user_data) { a� const _ExtendedGDBusPropertyInfo *info = user_data; GError *error; GVariant *_ret; error = NULL; _ret = g_dbus_proxy_call_finish (proxy, res, &error); if (!_ret) { g_warning ("Error setting property '%%s' on interface %s: %%s (%%s, %%d)", info->parent_struct.name, error->message, g_quark_to_string (error->domain), error->code); g_error_free (error); } else { g_variant_unref (_ret); } z#static void %s_proxy_set_property (zpGObject *object G_GNUC_UNUSED, guint prop_id G_GNUC_UNUSED, const GValue *value G_GNUC_UNUSED, zFGObject *object, guint prop_id, const GValue *value, ai const _ExtendedGDBusPropertyInfo *info; GVariant *variant; g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; variant = g_dbus_gvalue_to_gvariant (value, G_VARIANT_TYPE (info->parent_struct.signature)); g_dbus_proxy_call (G_DBUS_PROXY (object), "org.freedesktop.DBus.Properties.Set", g_variant_new ("(ssv)", "%s", info->parent_struct.name, variant), G_DBUS_CALL_FLAGS_NONE, -1, NULL, (GAsyncReadyCallback) %s_proxy_set_property_cb, (GDBusPropertyInfo *) &info->parent_struct); g_variant_unref (variant); z�static void %s_proxy_g_signal (GDBusProxy *proxy, const gchar *sender_name G_GNUC_UNUSED, const gchar *signal_name, GVariant *parameters) { z� _ExtendedGDBusSignalInfo *info; GVariantIter iter; GVariant *child; GValue *paramv; gsize num_params; gsize n; guint signal_id; z� info = (_ExtendedGDBusSignalInfo *) g_dbus_interface_info_lookup_signal ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, signal_name); if (info == NULL) return; z� num_params = g_variant_n_children (parameters); paramv = g_new0 (GValue, num_params + 1); g_value_init (¶mv[0], %sTYPE_%s); g_value_set_object (¶mv[0], proxy); a� g_variant_iter_init (&iter, parameters); n = 1; while ((child = g_variant_iter_next_value (&iter)) != NULL) { _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.args[n - 1]; if (arg_info->use_gvariant) { g_value_init (¶mv[n], G_TYPE_VARIANT); g_value_set_variant (¶mv[n], child); n++; } else g_dbus_gvariant_to_gvalue (child, ¶mv[n++]); g_variant_unref (child); } �> signal_id = g_signal_lookup (info->signal_name, %sTYPE_%s); z/ g_signal_emitv (paramv, signal_id, 0, NULL); zZ for (n = 0; n < num_params + 1; n++) g_value_unset (¶mv[n]); g_free (paramv); z�static void %s_proxy_g_properties_changed (GDBusProxy *_proxy, GVariant *changed_properties, const gchar *const *invalidated_properties) { a� %sProxy *proxy = %s%s_PROXY (_proxy); guint n; const gchar *key; GVariantIter *iter; _ExtendedGDBusPropertyInfo *info; g_variant_get (changed_properties, "a{sv}", &iter); while (g_variant_iter_next (iter, "{&sv}", &key, NULL)) { info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, key); g_datalist_remove_data (&proxy->priv->qdata, key); if (info != NULL) g_object_notify (G_OBJECT (proxy), info->hyphen_name); } g_variant_iter_free (iter); for (n = 0; invalidated_properties[n] != NULL; n++) { info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, invalidated_properties[n]); g_datalist_remove_data (&proxy->priv->qdata, invalidated_properties[n]); if (info != NULL) g_object_notify (G_OBJECT (proxy), info->hyphen_name); } } �0ZNULLzvstatic %s %s_proxy_get_%s (%s *object) { %sProxy *proxy = %s%s_PROXY (object); GVariant *variant; %svalue = %s; Zg_variant_get_strvZg_variant_get_objvZ g_variant_get_bytestring_arrayTzb value = g_datalist_get_data (&proxy->priv->qdata, "%s"); if (value != NULL) return value; zK variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (proxy), "%s"); r� z value = variant; z if (variant != NULL) z g_variant_unref (variant); z if (variant != NULL) { r Zg_variant_get_stringz, NULLz value = %s (variant%s); zV g_datalist_set_data_full (&proxy->priv->qdata, "%s", (gpointer) value, g_free); z! g_variant_unref (variant); z } r� r� aM static void %s_proxy_init (%sProxy *proxy) { #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 proxy->priv = %s_proxy_get_instance_private (proxy); #else proxy->priv = G_TYPE_INSTANCE_GET_PRIVATE (proxy, %sTYPE_%s_PROXY, %sProxyPrivate); #endif g_dbus_proxy_set_interface_info (G_DBUS_PROXY (proxy), %s_interface_info ()); } a� static void %s_proxy_class_init (%sProxyClass *klass) { GObjectClass *gobject_class; GDBusProxyClass *proxy_class; gobject_class = G_OBJECT_CLASS (klass); gobject_class->finalize = %s_proxy_finalize; gobject_class->get_property = %s_proxy_get_property; gobject_class->set_property = %s_proxy_set_property; proxy_class = G_DBUS_PROXY_CLASS (klass); proxy_class->g_signal = %s_proxy_g_signal; proxy_class->g_properties_changed = %s_proxy_g_properties_changed; z. %s_override_properties (gobject_class, 1); zu#if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38 g_type_class_add_private (klass, sizeof (%sProxyPrivate)); #endif z/static void %s_proxy_iface_init (%sIface *ifacer� r� r5 z# iface->get_%s = %s_proxy_get_%s; a� /** * %s_proxy_new: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Asynchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new() for more details. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_proxy_new_finish() to get the result of the operation. * * See %s_proxy_new_sync() for the synchronous, blocking version of this constructor. a� void %s_proxy_new ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL); } aH /** * %s_proxy_new_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new(). * @error: Return location for error or %%NULL * * Finishes an operation started with %s_proxy_new(). * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. az %s * %s_proxy_new_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return %s%s (ret); else return NULL; } a� /** * %s_proxy_new_sync: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Synchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new_sync() for more details. * * The calling thread is blocked until a reply is received. * * See %s_proxy_new() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_sync ( GDBusConnection *connection, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL); if (ret != NULL) return %s%s (ret); else return NULL; } a3 /** * %s_proxy_new_for_bus: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Like %s_proxy_new() but takes a #GBusType instead of a #GDBusConnection. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %s_proxy_new_for_bus_finish() to get the result of the operation. * * See %s_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. a� void %s_proxy_new_for_bus ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL); } a` /** * %s_proxy_new_for_bus_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new_for_bus(). * @error: Return location for error or %%NULL * * Finishes an operation started with %s_proxy_new_for_bus(). * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_for_bus_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return %s%s (ret); else return NULL; } ax /** * %s_proxy_new_for_bus_sync: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusProxyFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Like %s_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. * * The calling thread is blocked until a reply is received. * * See %s_proxy_new_for_bus() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set. a� %s * %s_proxy_new_for_bus_sync ( GBusType bus_type, GDBusProxyFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL); if (ret != NULL) return %s%s (ret); else return NULL; } )r' r. r� r� rM r� rL r rK r rU rJ rV r] rR Z gvariant_getr� )r( r_ rd Z nul_valueZfree_containerZ extra_lenr r r �generate_proxy s� � ��� ��� �� �� ����� ���� ���� �� ���� �� ���� �� �� ��� �� ��� �� � ���� ��� � � ����� � � � ���� ��������� �� �� ��� ���� �������� ��� ���� �������� z CodeGenerator.generate_proxyc C s� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �| j�d|j|jf d�� | �|| j d� | j �d� | j �d|j � | j �d|j|j|j|jf � | j �d � | j �d |j|jf � | j �d � | j �d |j|jf � | j �d � | j �d� | j �d� | j �d|j|j|j|jf � | j �d|j � | j �d|j|j|j|jf � | j �d|j � | j �d|j|j|j|jf � | j �d|j|jf � | j �d� | j �d|j|jf � | j �d� | j �d|j|j|j|jf � | j �d|j|j|j|j|j f � t |j �dk�rX| j �d|j � | j �d|j � t |j �dk�r�| j �d� n | j �d � | j �d � t |j �dk�r�| j �d |j|j|j|jf � | j �d� |j D �]}| j �d |j|j|jf � |j D ] }| j �d |j|j f � �q | j �d!|j|j|jf � | j �d"� |j D ]}| j �d#|j � �qX| j �d$� |j D ]}| j �d%|j � �q�| j �d&� | j �d'|j |j f � | j �d(� | j �d)� | j �d� �q�| j �d*|j|jf � | j �d+� | j �d,|j|jf � | j �d-|j � | j �d.|j|j|jf � | j �d/� | j �d,|j|jf � | j �d.|j|j|jf � | j �d0� | j �d1|j � | j �d2|j|j|jf � t |j �dk�r | j �d3t |j � � | j �d4� | j �d5� | j �d6� | j �d7� | j �d8� | j �d9� | j �d:|j � t |j �dk�r�| j �d;|j � | j �d<|j|j|jt |j �f � | j �d� | j �d=|j|j|j|jf � | j �d>|j � | j �d5� | j �d?� | j �d@� | j �dA� | j �dB� | j �dC|j|jf � | j �dD� | j �dE|j|j|j|j|j|jf � | j �dF|j � | j �dG|j|j|jt |j �|j|jf � | j �d� | j �dH|j|j|j|j|j|jf � | j �dI� | j �dJ� t |j �dk�r<| j �dKt |j � � d}|j D ]&}| j �dL||jjf � |dM7 }�q| j �d� d}|j D ]�}| j �dN|jj|j|j|jf � | j �d2|j|j|jf � | j �dO|jj|jj|f � | j �dP� | j �dQ� | j �d� |dM7 }�qR| j �dR|j|j|jf � t |j �dk�r<| j �dS|j|j|jf � | j �dT|j � | j �dU� | j �dV|j � | j �dW|j � | j �dX|j � | j �dY|j � | j �dZ|j � | j �d� | j �d[|j|jf � t |j �dk�r�t |j �dk�r�| j �d� n | j �d � | j �d � |j D ]"}| j �d\|j|j|jf � � q|j D ]"}| j �d]|j|j|jf � � q<| j �d� | j �| j�d^|j|j |jf d�� | �|| j d� | j �d_|j|j|j|j|j|jf � d S )`Nr� z�/** * %sSkeleton: * * The #%sSkeleton structure contains only private data and should only be accessed using the provided API. Fr r, zc/** * %sSkeletonClass: * @parent_class: The parent class. * * Class structure for #%sSkeleton. z�struct _%sSkeletonPrivate { GValue *properties; GList *changed_properties; GSource *changed_properties_idle_source; GMainContext *context; GMutex lock; }; a5 static void _%s_skeleton_handle_method_call ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name, const gchar *method_name, GVariant *parameters, GDBusMethodInvocation *invocation, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); _ExtendedGDBusMethodInfo *info; GVariantIter iter; GVariant *child; GValue *paramv; gsize num_params; guint num_extra; gsize n; guint signal_id; GValue return_value = G_VALUE_INIT; zx info = (_ExtendedGDBusMethodInfo *) g_dbus_method_invocation_get_method_info (invocation); g_assert (info != NULL); aq num_params = g_variant_n_children (parameters); num_extra = info->pass_fdlist ? 3 : 2; paramv = g_new0 (GValue, num_params + num_extra); n = 0; g_value_init (¶mv[n], %sTYPE_%s); g_value_set_object (¶mv[n++], skeleton); g_value_init (¶mv[n], G_TYPE_DBUS_METHOD_INVOCATION); g_value_set_object (¶mv[n++], invocation); if (info->pass_fdlist) { #ifdef G_OS_UNIX g_value_init (¶mv[n], G_TYPE_UNIX_FD_LIST); g_value_set_object (¶mv[n++], g_dbus_message_get_unix_fd_list (g_dbus_method_invocation_get_message (invocation))); #else g_assert_not_reached (); #endif } a� g_variant_iter_init (&iter, parameters); while ((child = g_variant_iter_next_value (&iter)) != NULL) { _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.in_args[n - num_extra]; if (arg_info->use_gvariant) { g_value_init (¶mv[n], G_TYPE_VARIANT); g_value_set_variant (¶mv[n], child); n++; } else g_dbus_gvariant_to_gvalue (child, ¶mv[n++]); g_variant_unref (child); } r� ae g_value_init (&return_value, G_TYPE_BOOLEAN); g_signal_emitv (paramv, signal_id, 0, &return_value); if (!g_value_get_boolean (&return_value)) g_dbus_method_invocation_return_error (invocation, G_DBUS_ERROR, G_DBUS_ERROR_UNKNOWN_METHOD, "Method %s is not implemented on interface %s", method_name, interface_name); g_value_unset (&return_value); zb for (n = 0; n < num_params + num_extra; n++) g_value_unset (¶mv[n]); g_free (paramv); r� a� static GVariant * _%s_skeleton_handle_get_property ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name G_GNUC_UNUSED, const gchar *property_name, GError **error, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); GValue value = G_VALUE_INIT; GParamSpec *pspec; _ExtendedGDBusPropertyInfo *info; GVariant *ret; a� ret = NULL; info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name); g_assert (info != NULL); pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name); if (pspec == NULL) { g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name); } else { g_value_init (&value, pspec->value_type); g_object_get_property (G_OBJECT (skeleton), info->hyphen_name, &value); ret = g_dbus_gvalue_to_gvariant (&value, G_VARIANT_TYPE (info->parent_struct.signature)); g_value_unset (&value); } return ret; } a� static gboolean _%s_skeleton_handle_set_property ( GDBusConnection *connection G_GNUC_UNUSED, const gchar *sender G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name G_GNUC_UNUSED, const gchar *property_name, GVariant *variant, GError **error, gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); GValue value = G_VALUE_INIT; GParamSpec *pspec; _ExtendedGDBusPropertyInfo *info; gboolean ret; a� ret = FALSE; info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name); g_assert (info != NULL); pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name); if (pspec == NULL) { g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name); } else { if (info->use_gvariant) g_value_set_variant (&value, variant); else g_dbus_gvariant_to_gvalue (variant, &value); g_object_set_property (G_OBJECT (skeleton), info->hyphen_name, &value); g_value_unset (&value); ret = TRUE; } return ret; } z�static const GDBusInterfaceVTable _%s_skeleton_vtable = { _%s_skeleton_handle_method_call, _%s_skeleton_handle_get_property, _%s_skeleton_handle_set_property, {NULL} }; z�static GDBusInterfaceInfo * %s_skeleton_dbus_interface_get_info (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED) { return %s_interface_info (); z�static GDBusInterfaceVTable * %s_skeleton_dbus_interface_get_vtable (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED) { return (GDBusInterfaceVTable *) &_%s_skeleton_vtable; z�static GVariant * %s_skeleton_dbus_interface_get_properties (GDBusInterfaceSkeleton *_skeleton) { %sSkeleton *skeleton = %s%s_SKELETON (_skeleton); a� GVariantBuilder builder; guint n; g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}")); if (_%s_interface_info.parent_struct.properties == NULL) goto out; for (n = 0; _%s_interface_info.parent_struct.properties[n] != NULL; n++) { GDBusPropertyInfo *info = _%s_interface_info.parent_struct.properties[n]; if (info->flags & G_DBUS_PROPERTY_INFO_FLAGS_READABLE) { GVariant *value; value = _%s_skeleton_handle_get_property (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)), NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", info->name, NULL, skeleton); if (value != NULL) { g_variant_take_ref (value); g_variant_builder_add (&builder, "{sv}", info->name, value); g_variant_unref (value); } } } out: return g_variant_builder_end (&builder); } z8static gboolean _%s_emit_changed (gpointer user_data); zOstatic void %s_skeleton_dbus_interface_flush (GDBusInterfaceSkeleton *_skeletonr� r� r5 a� %sSkeleton *skeleton = %s%s_SKELETON (_skeleton); gboolean emit_changed = FALSE; g_mutex_lock (&skeleton->priv->lock); if (skeleton->priv->changed_properties_idle_source != NULL) { g_source_destroy (skeleton->priv->changed_properties_idle_source); skeleton->priv->changed_properties_idle_source = NULL; emit_changed = TRUE; } g_mutex_unlock (&skeleton->priv->lock); if (emit_changed) _%s_emit_changed (skeleton); z-static void _%s_on_signal_%s ( %s *objectr8 z�) { %sSkeleton *skeleton = %s%s_SKELETON (object); GList *connections, *l; GVariant *signal_variant; connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton)); z9 signal_variant = g_variant_ref_sink (g_variant_new ("(r= r� r� r� a% for (l = connections; l != NULL; l = l->next) { GDBusConnection *connection = l->data; g_dbus_connection_emit_signal (connection, NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", "%s", signal_variant, NULL); } z$ g_variant_unref (signal_variant); z2 g_list_free_full (connections, g_object_unref); z5static void %s_skeleton_iface_init (%sIface *iface); r� zRG_DEFINE_TYPE_WITH_CODE (%sSkeleton, %s_skeleton, G_TYPE_DBUS_INTERFACE_SKELETON, z4 G_ADD_PRIVATE (%sSkeleton) zU G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_skeleton_iface_init)) r� r@ z5static void %s_skeleton_finalize (GObject *object) { z1 %sSkeleton *skeleton = %s%s_SKELETON (object); zZ guint n; for (n = 0; n < %d; n++) g_value_unset (&skeleton->priv->properties[n]); z' g_free (skeleton->priv->properties); zb g_list_free_full (skeleton->priv->changed_properties, (GDestroyNotify) _changed_property_free); z> if (skeleton->priv->changed_properties_idle_source != NULL) zG g_source_destroy (skeleton->priv->changed_properties_idle_source); z2 g_main_context_unref (skeleton->priv->context); z) g_mutex_clear (&skeleton->priv->lock); zC G_OBJECT_CLASS (%s_skeleton_parent_class)->finalize (object); } z�static void %s_skeleton_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec G_GNUC_UNUSED) { z� %sSkeleton *skeleton = %s%s_SKELETON (object); g_assert (prop_id != 0 && prop_id - 1 < %d); g_mutex_lock (&skeleton->priv->lock); g_value_copy (&skeleton->priv->properties[prop_id - 1], value); g_mutex_unlock (&skeleton->priv->lock); zlstatic gboolean _%s_emit_changed (gpointer user_data) { %sSkeleton *skeleton = %s%s_SKELETON (user_data); a� GList *l; GVariantBuilder builder; GVariantBuilder invalidated_builder; guint num_changes; g_mutex_lock (&skeleton->priv->lock); g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}")); g_variant_builder_init (&invalidated_builder, G_VARIANT_TYPE ("as")); for (l = skeleton->priv->changed_properties, num_changes = 0; l != NULL; l = l->next) { ChangedProperty *cp = l->data; GVariant *variant; const GValue *cur_value; cur_value = &skeleton->priv->properties[cp->prop_id - 1]; if (!_g_value_equal (cur_value, &cp->orig_value)) { variant = g_dbus_gvalue_to_gvariant (cur_value, G_VARIANT_TYPE (cp->info->parent_struct.signature)); g_variant_builder_add (&builder, "{sv}", cp->info->parent_struct.name, variant); g_variant_unref (variant); num_changes++; } } if (num_changes > 0) { GList *connections, *ll; GVariant *signal_variant; signal_variant = g_variant_ref_sink (g_variant_new ("(sa{sv}as)", "%s", &builder, &invalidated_builder)); connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton)); for (ll = connections; ll != NULL; ll = ll->next) { GDBusConnection *connection = ll->data; g_dbus_connection_emit_signal (connection, NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "org.freedesktop.DBus.Properties", "PropertiesChanged", signal_variant, NULL); } g_variant_unref (signal_variant); g_list_free_full (connections, g_object_unref); } else { g_variant_builder_clear (&builder); g_variant_builder_clear (&invalidated_builder); } z- skeleton->priv->changed_properties = NULL; z9 skeleton->priv->changed_properties_idle_source = NULL; z* g_mutex_unlock (&skeleton->priv->lock); z return FALSE; } a� static void _%s_schedule_emit_changed (%sSkeleton *skeleton, const _ExtendedGDBusPropertyInfo *info, guint prop_id, const GValue *orig_value) { ChangedProperty *cp; GList *l; cp = NULL; for (l = skeleton->priv->changed_properties; l != NULL; l = l->next) { ChangedProperty *i_cp = l->data; if (i_cp->info == info) { cp = i_cp; break; } } aT if (cp == NULL) { cp = g_new0 (ChangedProperty, 1); cp->prop_id = prop_id; cp->info = info; skeleton->priv->changed_properties = g_list_prepend (skeleton->priv->changed_properties, cp); g_value_init (&cp->orig_value, G_VALUE_TYPE (orig_value)); g_value_copy (orig_value, &cp->orig_value); } } a� static void %s_skeleton_notify (GObject *object, GParamSpec *pspec G_GNUC_UNUSED) { %sSkeleton *skeleton = %s%s_SKELETON (object); g_mutex_lock (&skeleton->priv->lock); if (skeleton->priv->changed_properties != NULL && skeleton->priv->changed_properties_idle_source == NULL) { skeleton->priv->changed_properties_idle_source = g_idle_source_new (); g_source_set_priority (skeleton->priv->changed_properties_idle_source, G_PRIORITY_DEFAULT); g_source_set_callback (skeleton->priv->changed_properties_idle_source, _%s_emit_changed, g_object_ref (skeleton), (GDestroyNotify) g_object_unref); g_source_set_name (skeleton->priv->changed_properties_idle_source, "[generated] _%s_emit_changed"); g_source_attach (skeleton->priv->changed_properties_idle_source, skeleton->priv->context); g_source_unref (skeleton->priv->changed_properties_idle_source); } g_mutex_unlock (&skeleton->priv->lock); } z�static void %s_skeleton_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { a4 const _ExtendedGDBusPropertyInfo *info; %sSkeleton *skeleton = %s%s_SKELETON (object); g_assert (prop_id != 0 && prop_id - 1 < %d); info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1]; g_mutex_lock (&skeleton->priv->lock); g_object_freeze_notify (object); if (!_g_value_equal (value, &skeleton->priv->properties[prop_id - 1])) { if (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)) != NULL && info->emits_changed_signal) _%s_schedule_emit_changed (skeleton, info, prop_id, &skeleton->priv->properties[prop_id - 1]); g_value_copy (value, &skeleton->priv->properties[prop_id - 1]); g_object_notify_by_pspec (object, pspec); } g_mutex_unlock (&skeleton->priv->lock); g_object_thaw_notify (object); a static void %s_skeleton_init (%sSkeleton *skeleton) { #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 skeleton->priv = %s_skeleton_get_instance_private (skeleton); #else skeleton->priv = G_TYPE_INSTANCE_GET_PRIVATE (skeleton, %sTYPE_%s_SKELETON, %sSkeletonPrivate); #endif z( g_mutex_init (&skeleton->priv->lock); zB skeleton->priv->context = g_main_context_ref_thread_default (); z4 skeleton->priv->properties = g_new0 (GValue, %d); z6 g_value_init (&skeleton->priv->properties[%d], %s); r z,static %s %s_skeleton_get_%s (%s *object) { z� %svalue; g_mutex_lock (&skeleton->priv->lock); value = %s (&(skeleton->priv->properties[%d])); g_mutex_unlock (&skeleton->priv->lock); r� r� z�static void %s_skeleton_class_init (%sSkeletonClass *klass) { GObjectClass *gobject_class; GDBusInterfaceSkeletonClass *skeleton_class; gobject_class = G_OBJECT_CLASS (klass); gobject_class->finalize = %s_skeleton_finalize; z� gobject_class->get_property = %s_skeleton_get_property; gobject_class->set_property = %s_skeleton_set_property; gobject_class->notify = %s_skeleton_notify; z. %s_override_properties (gobject_class, 1); z= skeleton_class = G_DBUS_INTERFACE_SKELETON_CLASS (klass); zB skeleton_class->get_info = %s_skeleton_dbus_interface_get_info; zN skeleton_class->get_properties = %s_skeleton_dbus_interface_get_properties; z< skeleton_class->flush = %s_skeleton_dbus_interface_flush; zF skeleton_class->get_vtable = %s_skeleton_dbus_interface_get_vtable; zy #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38 g_type_class_add_private (klass, sizeof (%sSkeletonPrivate)); #endif z2static void %s_skeleton_iface_init (%sIface *ifacez iface->%s = _%s_on_signal_%s; z& iface->get_%s = %s_skeleton_get_%s; z�/** * %s_skeleton_new: * * Creates a skeleton object for the D-Bus interface #%s. * * Returns: (transfer full) (type %sSkeleton): The skeleton object. zZ%s * %s_skeleton_new (void) { return %s%s (g_object_new (%sTYPE_%s_SKELETON, NULL)); } )r' r. r� r� rM r� rL r rK rJ r rU rS rT rR r� rV r� Z ctype_in_gZ gvalue_get)r( r_ rc rb r� rd r r r �generate_skeleton� sL � ��� ��� �� ��� ��� ���� ���������� �� �� ���� ���� �� �� �� � �� �� ����� ���� ������ ��� ������ ��1��4� � ������ ����� ��� ��� �� ������ �� �������������� �� �� �� ��� ���z CodeGenerator.generate_skeletonc C s� | j �d� | j �| j�d| j| j| j| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d| j| jf � | j �d| j| jf � | j �d� | j �d | j| jf � | jD ]x}| j �| j�d | j|j|j|j f d�� | � || j d � d }|j �rNd | }| j �d|j|j|j| j |j |f � q�| j �d� | jD ]�}| j �| j�d| j|j �� | j|j|j |jf d�� | � || j d� | j �d|j| j|j �� | jf � | j �d|j | j |j f � �q�| j �d� | jD ]�}| j �| j�d| j|j �� | j| j|j �� |jf d�� | � || j d� | j �d|j| j|j �� | jf � | j �d|j | j |j f � �q(| j �d� | j �d| j � | j �| j�d| j| jf d�� | j �d� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �d| j| j| jf � | j �d | j| j| jf � | j �d� | j �d | j| j| j | j| j| jf � | j �d | j| jf � | j �d | j � | j �d� | j �d | j| j| j f � d!}| jD ]$}| j �d"||j f � |d!7 }�q| j �d#� | j �d$| j| j| j| jf � d!}| jD ]$}| j �d%||jf � |d!7 }�qp| j �d� | j �| j�d&| j d�� | j �d'| j| j| j | j f � | j �| j�d(| j| jf d�� | j �d� | j �d� | j �| j�d)| j| jf d�� | j �d� | j �d� | j �d*| j| j| jf � | j �d� | j �d+| j| j| jf � | j �d,| j| j| j | j| j| jf � | j �d-| j| jf � | j �d.| j| j| j f � d!}| jD ],}| j �d/|| j |j |j f � |d!7 }�q�| j �d#� | j �d0| j| j| j f � d!}| jD ]$}| j �d"||j f � |d!7 }�q\| j �d#� | j �d1| j| j| j| jf � d!}| jD ]$}| j �d%||jf � |d!7 }�q�| j �d� | j �| j�d2| j d�� | j �d3| j| j| j | j f � | jD ]�}| j �| j�d4| j|j �� | j|j|j|j f d�� | � || j d� | j �d5| j|j �� | j|jf � | j �d6|j � �q,| j �d� d S )7Nz�/* ------------------------------------------------------------------------ * Code for Object, ObjectProxy and ObjectSkeleton * ------------------------------------------------------------------------ */ a /** * SECTION:%sObject * @title: %sObject * @short_description: Specialized GDBusObject types * * This section contains the #%sObject, #%sObjectProxy, and #%sObjectSkeleton types which make it easier to work with objects implementing generated types for D-Bus interfaces. */ Fr, zX/** * %sObject: * * The #%sObject type is a specialized container of interfaces. */ zs/** * %sObjectIface: * @parent_iface: The parent interface. * * Virtual table for the #%sObject interface. */ z)typedef %sObjectIface %sObjectInterface; z�G_DEFINE_INTERFACE_WITH_CODE (%sObject, %sobject, G_TYPE_OBJECT, g_type_interface_add_prerequisite (g_define_type_id, G_TYPE_DBUS_OBJECT);) z;static void %sobject_default_init (%sObjectIface *iface) { z� /** * %sObject:%s: * * The #%s instance corresponding to the D-Bus interface #%s, if any. * * Connect to the #GObject::notify signal to get informed of property changes. rD r� r� zg g_object_interface_install_property (iface, g_param_spec_object ("%s", "%s", "%s", %sTYPE_%s, %s)); r� a /** * %sobject_get_%s: * @object: A #%sObject. * * Gets the #%s instance for the D-Bus interface #%s on @object, if any. * * Returns: (transfer full) (nullable): A #%s that must be freed with g_object_unref() or %%NULL if @object does not implement the interface. r z'%s *%sobject_get_%s (%sObject *object) z�{ GDBusInterface *ret; ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); if (ret == NULL) return NULL; return %s%s (ret); } a� /** * %sobject_peek_%s: (skip) * @object: A #%sObject. * * Like %sobject_get_%s() but doesn't increase the reference count on the returned object. * * It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running. * * Returns: (transfer none) (nullable): A #%s or %%NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object. z(%s *%sobject_peek_%s (%sObject *object) z�{ GDBusInterface *ret; ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); if (ret == NULL) return NULL; g_object_unref (ret); return %s%s (ret); } a� static void %sobject_notify (GDBusObject *object, GDBusInterface *interface) { _ExtendedGDBusInterfaceInfo *info = (_ExtendedGDBusInterfaceInfo *) g_dbus_interface_get_info (interface); /* info can be NULL if the other end is using a D-Bus interface we don't know * anything about, for example old generated code in this process talking to * newer generated code in the other process. */ if (info != NULL) g_object_notify (G_OBJECT (object), info->hyphen_name); } z�/** * %sObjectProxy: * * The #%sObjectProxy structure contains only private data and should only be accessed using the provided API. � */ zi/** * %sObjectProxyClass: * @parent_class: The parent class. * * Class structure for #%sObjectProxy. zZstatic void %sobject_proxy__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED) { } z�static void %sobject_proxy__g_dbus_object_iface_init (GDBusObjectIface *iface) { iface->interface_added = %sobject_notify; iface->interface_removed = %sobject_notify; } a& G_DEFINE_TYPE_WITH_CODE (%sObjectProxy, %sobject_proxy, G_TYPE_DBUS_OBJECT_PROXY, G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_proxy__%sobject_iface_init) G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_proxy__g_dbus_object_iface_init)) zKstatic void %sobject_proxy_init (%sObjectProxy *object G_GNUC_UNUSED) { } z�static void %sobject_proxy_set_property (GObject *gobject, guint prop_id, const GValue *value G_GNUC_UNUSED, GParamSpec *pspec) { G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); z�static void %sobject_proxy_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { %sObjectProxy *object = %sOBJECT_PROXY (gobject); GDBusInterface *interface; switch (prop_id) { r z� case %d: interface = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s"); g_value_take_object (value, interface); break; zd default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); break; } } z�static void %sobject_proxy_class_init (%sObjectProxyClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = %sobject_proxy_set_property; gobject_class->get_property = %sobject_proxy_get_property; z> g_object_class_override_property (gobject_class, %d, "%s"); z�/** * %sobject_proxy_new: * @connection: A #GDBusConnection. * @object_path: An object path. * * Creates a new proxy object. * * Returns: (transfer full): The proxy object. */ ai %sObjectProxy * %sobject_proxy_new (GDBusConnection *connection, const gchar *object_path) { g_return_val_if_fail (G_IS_DBUS_CONNECTION (connection), NULL); g_return_val_if_fail (g_variant_is_object_path (object_path), NULL); return %sOBJECT_PROXY (g_object_new (%sTYPE_OBJECT_PROXY, "g-connection", connection, "g-object-path", object_path, NULL)); } z�/** * %sObjectSkeleton: * * The #%sObjectSkeleton structure contains only private data and should only be accessed using the provided API. zo/** * %sObjectSkeletonClass: * @parent_class: The parent class. * * Class structure for #%sObjectSkeleton. z]static void %sobject_skeleton__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED) { } z�static void %sobject_skeleton__g_dbus_object_iface_init (GDBusObjectIface *iface) { iface->interface_added = %sobject_notify; iface->interface_removed = %sobject_notify; } a5 G_DEFINE_TYPE_WITH_CODE (%sObjectSkeleton, %sobject_skeleton, G_TYPE_DBUS_OBJECT_SKELETON, G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_skeleton__%sobject_iface_init) G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_skeleton__g_dbus_object_iface_init)) zQstatic void %sobject_skeleton_init (%sObjectSkeleton *object G_GNUC_UNUSED) { } a static void %sobject_skeleton_set_property (GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject); GDBusInterfaceSkeleton *interface; switch (prop_id) { a� case %d: interface = g_value_get_object (value); if (interface != NULL) { g_warn_if_fail (%sIS_%s (interface)); g_dbus_object_skeleton_add_interface (G_DBUS_OBJECT_SKELETON (object), interface); } else { g_dbus_object_skeleton_remove_interface_by_name (G_DBUS_OBJECT_SKELETON (object), "%s"); } break; z�static void %sobject_skeleton_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject); GDBusInterface *interface; switch (prop_id) { a static void %sobject_skeleton_class_init (%sObjectSkeletonClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = %sobject_skeleton_set_property; gobject_class->get_property = %sobject_skeleton_get_property; z�/** * %sobject_skeleton_new: * @object_path: An object path. * * Creates a new skeleton object. * * Returns: (transfer full): The skeleton object. */ z�%sObjectSkeleton * %sobject_skeleton_new (const gchar *object_path) { g_return_val_if_fail (g_variant_is_object_path (object_path), NULL); return %sOBJECT_SKELETON (g_object_new (%sTYPE_OBJECT_SKELETON, "g-object-path", object_path, NULL)); } z�/** * %sobject_skeleton_set_%s: * @object: A #%sObjectSkeleton. * @interface_: (nullable): A #%s or %%NULL to clear the interface. * * Sets the #%s instance for the D-Bus interface #%s on @object. zIvoid %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_) zA{ g_object_set (G_OBJECT (object), "%s", interface_, NULL); } )r' r. r� r� r r r r� rM rJ r� rZ r rK r )r( r_ r� r� r r r �generate_object� s� ����� ��� ��� �� �� �� ��� ��� �������� �������� �� ��� ��� ���� ��� ���� �� �� ��� �� � ���� ��� ��� �� �� ��� �� �� �� � �� �� ��� �� ��� �� ��������z CodeGenerator.generate_objectc C sz | j �d� | j �| j�d| j| j| jf d�� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �| j�d| j| jf d�� | j �d� | j �d� | j �d| j| jf � | j �d | j| jf � | j �d | j| jf � | j �| j�d | j| jf d�� | j �d� | j �d | j � | j �d | j � | jD ]"}| j �d|j|j|j f � �qR| j �d� | j �d� | j �d� | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d| j| j| j| jf � | j �d� | j �d| j � | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d� | j �| j�d| j| j| j| jf d�� | j �d� | j �d| j| j| jf � | j �d| j| j| j| jf � | j �d� | j �d| j � | j �| j�d | j| j| j| jf d�� | j �d� | j �d | j| j| jf � | j �d� d S ) Nz�/* ------------------------------------------------------------------------ * Code for ObjectManager client * ------------------------------------------------------------------------ */ a /** * SECTION:%sObjectManagerClient * @title: %sObjectManagerClient * @short_description: Generated GDBusObjectManagerClient type * * This section contains a #GDBusObjectManagerClient that uses %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. */ Fr, z�/** * %sObjectManagerClient: * * The #%sObjectManagerClient structure contains only private data and should only be accessed using the provided API. r� zy/** * %sObjectManagerClientClass: * @parent_class: The parent class. * * Class structure for #%sObjectManagerClient. zcG_DEFINE_TYPE (%sObjectManagerClient, %sobject_manager_client, G_TYPE_DBUS_OBJECT_MANAGER_CLIENT) z]static void %sobject_manager_client_init (%sObjectManagerClient *manager G_GNUC_UNUSED) { } zfstatic void %sobject_manager_client_class_init (%sObjectManagerClientClass *klass G_GNUC_UNUSED) { } a! /** * %sobject_manager_client_get_proxy_type: * @manager: A #GDBusObjectManagerClient. * @object_path: The object path of the remote object (unused). * @interface_name: (nullable): Interface name of the remote object or %%NULL to get the object proxy #GType. * @user_data: User data (unused). * * A #GDBusProxyTypeFunc that maps @interface_name to the generated #GDBusObjectProxy derived and #GDBusProxy derived types. * * Returns: A #GDBusProxy derived #GType if @interface_name is not %%NULL, otherwise the #GType for #%sObjectProxy. z�GType %sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name, gpointer user_data G_GNUC_UNUSED) { a static gsize once_init_value = 0; static GHashTable *lookup_hash; GType ret; if (interface_name == NULL) return %sTYPE_OBJECT_PROXY; if (g_once_init_enter (&once_init_value)) { lookup_hash = g_hash_table_new (g_str_hash, g_str_equal); z^ g_hash_table_insert (lookup_hash, (gpointer) "%s", GSIZE_TO_POINTER (%sTYPE_%s_PROXY)); z5 g_once_init_leave (&once_init_value, 1); } z� ret = (GType) GPOINTER_TO_SIZE (g_hash_table_lookup (lookup_hash, interface_name)); if (ret == (GType) 0) ret = G_TYPE_DBUS_PROXY; z return ret; } a /** * %sobject_manager_client_new: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Asynchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %sobject_manager_client_new_finish() to get the result of the operation. * * See %sobject_manager_client_new_sync() for the synchronous, blocking version of this constructor. aG void %sobject_manager_client_new ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); } a� /** * %sobject_manager_client_new_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new(). * @error: Return location for error or %%NULL * * Finishes an operation started with %sobject_manager_client_new(). * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. a� GDBusObjectManager * %sobject_manager_client_new_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } ad /** * %sobject_manager_client_new_sync: * @connection: A #GDBusConnection. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection. * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Synchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details. * * The calling thread is blocked until a reply is received. * * See %sobject_manager_client_new() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. ao GDBusObjectManager * %sobject_manager_client_new_sync ( GDBusConnection *connection, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } a} /** * %sobject_manager_client_new_for_bus: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: User data to pass to @callback. * * Like %sobject_manager_client_new() but takes a #GBusType instead of a #GDBusConnection. * * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()). * You can then call %sobject_manager_client_new_for_bus_finish() to get the result of the operation. * * See %sobject_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor. aI void %sobject_manager_client_new_for_bus ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data) { g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); } a� /** * %sobject_manager_client_new_for_bus_finish: * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new_for_bus(). * @error: Return location for error or %%NULL * * Finishes an operation started with %sobject_manager_client_new_for_bus(). * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. a� GDBusObjectManager * %sobject_manager_client_new_for_bus_finish ( GAsyncResult *res, GError **error) { GObject *ret; GObject *source_object; source_object = g_async_result_get_source_object (res); ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error); g_object_unref (source_object); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } a� /** * %sobject_manager_client_new_for_bus_sync: * @bus_type: A #GBusType. * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration. * @name: A bus name (well-known or unique). * @object_path: An object path. * @cancellable: (nullable): A #GCancellable or %%NULL. * @error: Return location for error or %%NULL * * Like %sobject_manager_client_new_sync() but takes a #GBusType instead of a #GDBusConnection. * * The calling thread is blocked until a reply is received. * * See %sobject_manager_client_new_for_bus() for the asynchronous version of this constructor. * * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set. aq GDBusObjectManager * %sobject_manager_client_new_for_bus_sync ( GBusType bus_type, GDBusObjectManagerClientFlags flags, const gchar *name, const gchar *object_path, GCancellable *cancellable, GError **error) { GInitable *ret; ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL); if (ret != NULL) return G_DBUS_OBJECT_MANAGER (ret); else return NULL; } ) r' r. r� r� r r r r rJ rK ro r r r � generate_object_manager_client� s: ���� ��� ��� �� �� �� � �� �� �� �� � ��� ���� ����� �� ��� ���� ����� ��z,CodeGenerator.generate_object_manager_clientc C s� t |j�dkr(|�d|d|d|jf � |jr�t|tj�r@d}nDt|tj�rRd}n2t|tj�rdd}n t|tj �rvd}nt d� |�� |�| j � d |d|d|f d �� |�d |df � d S ) Nr z%*s * %*s * Since: %s r zThe D-Bus interfacezThe D-Bus methodzThe D-Bus signalzThe D-Bus propertyzCannot handle object "{}"z0%*s * %*s * Deprecated: %s has been deprecated. Fz%*s */ )r rO r. rZ � isinstancer Z InterfaceZMethodZSignalZPropertyr r0 r� r� )r( �obj�f�indent�thingr r r r� 3 s* ���z9CodeGenerator.write_gtkdoc_deprecated_and_since_and_closec C sL | j �d|j � | j �| j�d|j|j|j|jf d�� | j �d� d S )Nz�/* ------------------------------------------------------------------------ * Code for interface %s * ------------------------------------------------------------------------ */ z�/** * SECTION:%s * @title: %s * @short_description: Generated C code for the %s D-Bus interface * * This section contains code for working with the #%s D-Bus interface in C. */ Fr, )r' r. rJ r� r� rM ro r r r �generate_interface_introM s ����� z&CodeGenerator.generate_interface_introc C s� | � � | jD ]^}| �|� | �|� | �|� | �|� | �|� | �|� | �|� | � |� | � |� q| j r�| � � | � � d S r )rv r r� r� r� r� r� r� r� r� r� r r� r� ro r r r rj d s zCodeGenerator.generateN)rk rl rm r) rv r� r� r� r� r� r� r� r� r� r� r� r� r� r� rj r r r r r� � sT 8*& K & > + , [r� N) r r r r r r/ r r r rn rq r� r r r r �<module> s& :N ` codegen/__pycache__/utils.cpython-39.pyc 0000644 00000006372 15125157507 0014171 0 ustar 00 a ]x a� � @ s� d dl Zd dlZd dlZG dd� d�Zejdfdd�Zdd� Zd d d �Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � ZdS )!� Nc @ s$ e Zd ZdZdZdZdZdZdZdS )�ColorzANSI Terminal colorsz[1;32mz[1;34mz[1;33mz[1;31mz[0mN) �__name__� __module__� __qualname__�__doc__�GREENZBLUE�YELLOW�RED�END� r r �$/usr/share/glib-2.0/codegen/utils.pyr s r ZMESSAGEc C sB t �tj�� �r$dj||tjd�}n|}tj�dj|| d�� dS )z"Print a string with a color prefixz{start}{prefix}{end})�start�prefix�endz{prefix}: {msg} )r �msgN) �os�isatty�sys�stderr�fileno�formatr r �write)r �colorr Z real_prefixr r r � print_color& s �r c C s t | tjdd� t�d� dS )z Print an error, and terminate�ERROR�r r � N)r r r r �exit�r r r r � print_error1 s r Fc C s8 |rt j}d}n t j}d}t| ||� |r4t�d� dS )z)Print a warning, and optionally terminater ZWARNINGr N)r r r r r r )r Zfatalr r r r r � print_warning7 s r c C s t | tjdd� dS )zPrint a message�INFOr N)r r r r r r r � print_infoD s r" c C sB d}d}| D ]0}|dkr d}q |r4||� � 7 }d}q ||7 }q |S )N� F�.T)�upper)�s�retZ force_upper�cr r r � strip_dotsI s r) c C s | � dd�S )Nr$ �-)�replace�r& r r r �dots_to_hyphensX s r- c C sn d}d}d}d}| D ]T}|r.|dkr.|d7 }qd}|� � rH|rBd}d}nd}|rX|d7 }||�� 7 }d}q|S )Nr# FT�_)�isupper�lower)r& r' Z insert_uscoreZprev_was_lower�initialr( r r r �camel_case_to_uscore\ s& r2 c C s | r| � d�dkrdS dS )Nr. r TF)�findr, r r r � is_ugly_caseu s r4 c C s& | r"| D ]}|j |kr|j S qd S )N)�key�value)� annotationsr5 �ar r r �lookup_annotation{ s r9 c C s t | d�}|d u rdS |S d S )Nzorg.gtk.GDBus.DocStringr# �r9 �r7 r& r r r � lookup_docs� s r< c C s t | d�}|d u rdS |S d S )Nzorg.gtk.GDBus.Sincer# r: r; r r r � lookup_since� s r= c C s t | d�}|d u rdS |S d S )Nz org.gtk.GDBus.DocString.Shortr# r: r; r r r �lookup_brief_docs� s r> c C s@ | d dkrd}n| d r(t | d �}nd}tj�|�| d fS )Nr Z UNRELEASEDZ9999�0r )�str� distutils�versionZ LooseVersion)r5 �vr r r �version_cmp_key� s rD )F)Zdistutils.versionrA r r r r r r r r" r) r- r2 r4 r9 r< r= r> rD r r r r �<module> s codegen/__pycache__/utils.cpython-39.opt-1.pyc 0000644 00000006372 15125157507 0015130 0 ustar 00 a ]x a� � @ s� d dl Zd dlZd dlZG dd� d�Zejdfdd�Zdd� Zd d d �Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � ZdS )!� Nc @ s$ e Zd ZdZdZdZdZdZdZdS )�ColorzANSI Terminal colorsz[1;32mz[1;34mz[1;33mz[1;31mz[0mN) �__name__� __module__� __qualname__�__doc__�GREENZBLUE�YELLOW�RED�END� r r �$/usr/share/glib-2.0/codegen/utils.pyr s r ZMESSAGEc C sB t �tj�� �r$dj||tjd�}n|}tj�dj|| d�� dS )z"Print a string with a color prefixz{start}{prefix}{end})�start�prefix�endz{prefix}: {msg} )r �msgN) �os�isatty�sys�stderr�fileno�formatr r �write)r �colorr Z real_prefixr r r � print_color& s �r c C s t | tjdd� t�d� dS )z Print an error, and terminate�ERROR�r r � N)r r r r �exit�r r r r � print_error1 s r Fc C s8 |rt j}d}n t j}d}t| ||� |r4t�d� dS )z)Print a warning, and optionally terminater ZWARNINGr N)r r r r r r )r Zfatalr r r r r � print_warning7 s r c C s t | tjdd� dS )zPrint a message�INFOr N)r r r r r r r � print_infoD s r" c C sB d}d}| D ]0}|dkr d}q |r4||� � 7 }d}q ||7 }q |S )N� F�.T)�upper)�s�retZ force_upper�cr r r � strip_dotsI s r) c C s | � dd�S )Nr$ �-)�replace�r& r r r �dots_to_hyphensX s r- c C sn d}d}d}d}| D ]T}|r.|dkr.|d7 }qd}|� � rH|rBd}d}nd}|rX|d7 }||�� 7 }d}q|S )Nr# FT�_)�isupper�lower)r& r' Z insert_uscoreZprev_was_lower�initialr( r r r �camel_case_to_uscore\ s& r2 c C s | r| � d�dkrdS dS )Nr. r TF)�findr, r r r � is_ugly_caseu s r4 c C s& | r"| D ]}|j |kr|j S qd S )N)�key�value)� annotationsr5 �ar r r �lookup_annotation{ s r9 c C s t | d�}|d u rdS |S d S )Nzorg.gtk.GDBus.DocStringr# �r9 �r7 r& r r r � lookup_docs� s r< c C s t | d�}|d u rdS |S d S )Nzorg.gtk.GDBus.Sincer# r: r; r r r � lookup_since� s r= c C s t | d�}|d u rdS |S d S )Nz org.gtk.GDBus.DocString.Shortr# r: r; r r r �lookup_brief_docs� s r> c C s@ | d dkrd}n| d r(t | d �}nd}tj�|�| d fS )Nr Z UNRELEASEDZ9999�0r )�str� distutils�versionZ LooseVersion)r5 �vr r r �version_cmp_key� s rD )F)Zdistutils.versionrA r r r r r r r r" r) r- r2 r4 r9 r< r= r> rD r r r r �<module> s codegen/__pycache__/codegen_docbook.cpython-39.opt-1.pyc 0000644 00000026625 15125157507 0017077 0 ustar 00 a ]x a�H � @ s2 d dl Z d dlmZ ddlmZ G dd� d�ZdS )� N)�path� )�utilsc @ s| e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd S ) �DocbookCodeGeneratorc C s || _ | �� d S )N)�ifaces�generate_expand_dicts)�selfr � r �./usr/share/glib-2.0/codegen/codegen_docbook.py�__init__$ s z DocbookCodeGenerator.__init__c C s� d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|r�|j D ]<}|jD ]}tt|j�|�}qN|jD ]}tt|j�|�}qjqDn8|jD ]}tt|j�|�}q�|jD ]}tt|j�|�}q�|r�| j�dt � |j�|j|j|t|j� df � n"| j�d|j|t|j� df � d}|jD ]V}|dk�rD| j�d|d df � | j�d|j|t|j� d|jf � |d }�q |jD ]V}|dk�r�| j�d|d df � | j�d |j|t|j� d|jf � |d }�q|| j�d � d S ) Nr z1<link linkend="gdbus-method-%s.%s">%s</link>%*s (� �%s%*s (�, %*s� z IN %s%*s %sr z OUT %s%*s %s�); ) �methods�max�len�name�in_args� signature�out_args�out�writer �dots_to_hyphens) r �i�m� in_synopsisZmax_method_lenZ_m�max_signature_len�a�countr r r �print_method_prototype( s` ��� " �� �� z+DocbookCodeGenerator.print_method_prototypec C sL d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|rh|j D ] }|jD ]}tt|j�|�}qNqDn |jD ]}tt|j�|�}qn|r�| j�dt� |j�|j|j|t|j� df � n"| j�d|j|t|j� df � d}|jD ]T}|dk�r | j�d|d df � | j�d|j|t|j� d|jf � |d }q�| j�d � d S ) Nr z1<link linkend="gdbus-signal-%s.%s">%s</link>%*s (r r r r z%s%*s %sr r ) �signalsr r r �argsr r r r r ) r r �sr Zmax_signal_lenZ_sr r r r r r �print_signal_prototype] sF ��� " �� z+DocbookCodeGenerator.print_signal_prototypec C s d}|r&|j D ]}tt|j�|�}qntt|j�|�}d}|r\|j D ]}tt|j�|�}qDntt|j�|�}|r�| j�dt�|j�|j|j|t|j� df � n"| j�d|j|t|j� df � |j r�|j r�d}n|j r�d}nd}| j�d||jf � d S ) Nr z1<link linkend="gdbus-property-%s.%s">%s</link>%*sr z%s%*sZ readwritez readable z writable z %s %s ) � propertiesr r r r r r r r �readable�writable)r r �pr Zmax_property_lenZ_pr �accessr r r �print_property_prototype� s8 ��� " z-DocbookCodeGenerator.print_property_prototypec C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz# <refsynopsisdiv role="synopsis"> z1 <title role="synopsis.title">Methods</title> � <synopsis> T�r � </synopsis> z </refsynopsisdiv> )r r r r! )r r r r r r �print_synopsis_methods� s z+DocbookCodeGenerator.print_synopsis_methodsc C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz! <refsect1 role="signal_proto"> z5 <title role="signal_proto.title">Signals</title> r, Tr- r. � </refsect1> )r r r" r% )r r r$ r r r �print_synopsis_signals� s z+DocbookCodeGenerator.print_synopsis_signalsc C s\ | j �d� | j �d� | j �d� |jD ]}| j||dd� q*| j �d� | j �d� d S )Nz <refsect1 role="properties"> z6 <title role="properties.title">Properties</title> r, Tr- r. r0 )r r r& r+ �r r r) r r r �print_synopsis_properties� s z.DocbookCodeGenerator.print_synopsis_propertiesc C s� | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � |j s�|j �rt| j �d � |j D ]N}| j �d � | j �d |j |jf � | j �d | �|jd � � | j �d� q�|j D ]P}| j �d � | j �d|j |jf � | j �d | �|jd � � | j �d� �q| j �d� t |j �dk�r�| j �d|j � |j�r�| j �d|j � | j �d� d S )Nz1<refsect2 role="method" id="gdbus-method-%s.%s"> z! <title>The %s() method</title> z] <indexterm zone="gdbus-method-%s.%s"><primary sortas="%s.%s">%s.%s()</primary></indexterm> �<programlisting> Fr- �</programlisting> �%s T� <variablelist role="params"> �<varlistentry> zC <term><literal>IN %s <parameter>%s</parameter></literal>:</term> � <listitem>%s</listitem> �</varlistentry> zD <term><literal>OUT %s <parameter>%s</parameter></literal>:</term> �</variablelist> r �#<para role="since">Since %s</para> z><warning><para>The %s() method is deprecated.</para></warning>� </refsect2> )r r r r r �name_without_prefixr! � expand_paras� doc_stringr r r r �since� deprecated)r r r r r r r � print_method� sv �� ��� �� �� �� �� ��z!DocbookCodeGenerator.print_methodc C sb | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � |j �r| j �d � |j D ]N}| j �d � | j �d |j |jf � | j �d | �|jd � � | j �d� q�| j �d� t |j �dk�r8| j �d|j � |j �rR| j �d|j � | j �d� d S )Nz1<refsect2 role="signal" id="gdbus-signal-%s.%s"> z! <title>The "%s" signal</title> z] <indexterm zone="gdbus-signal-%s.%s"><primary sortas="%s::%s">%s::%s</primary></indexterm> r4 Fr- r5 r6 Tr7 r8 z@ <term><literal>%s <parameter>%s</parameter></literal>:</term> r9 r: r; r r< z><warning><para>The "%s" signal is deprecated.</para></warning>r= )r r r r r r> r% r? r@ r# r r rA rB )r r r$ r r r r � print_signal� s\ �� ��� �� �� ��z!DocbookCodeGenerator.print_signalc C s� | j �dt�|j�|jf � | j �d|j � | j �dt�|j�|j|j|j|j|jf � | j �d� | j||dd� | j �d� | j �d| �|jd � � t |j �d kr�| j �d |j � |j r�| j �d |j � | j �d � d S )Nz5<refsect2 role="property" id="gdbus-property-%s.%s"> z# <title>The "%s" property</title> z] <indexterm zone="gdbus-property-%s.%s"><primary sortas="%s:%s">%s:%s</primary></indexterm> r4 Fr- r5 r6 Tr r< z@<warning><para>The "%s" property is deprecated.</para></warning>r= ) r r r r r r> r+ r? r@ r rA rB r2 r r r �print_property( s< �� ��� ��z#DocbookCodeGenerator.print_propertyc C sh | j D ]}|�|| j| �}q| jD ]}|�|| j| �}q$|rdt�ddd� |�}t�ddd� |�}|S )Nz@[a-zA-Z0-9_]*c S s d| � d�dd � d S )Nz <parameter>r r z </parameter>��group�r r r r �<lambda>O � z-DocbookCodeGenerator.expand.<locals>.<lambda>z%[a-zA-Z0-9_]*c S s d| � d�dd � d S )Nz <constant>r r z </constant>rF rH r r r rI U rJ )�expand_member_dict_keys�replace�expand_member_dict�expand_iface_dict_keys�expand_iface_dict�re�sub)r r$ �expandParamsAndConstants�keyr r r �expandF s ��zDocbookCodeGenerator.expandc C s& | � ||��� }|�d�s"d| }|S )Nz<paraz<para>%s</para>)rT �strip� startswith)r r$ rR r r r r? Z s z!DocbookCodeGenerator.expand_parasc C s. i | _ i | _| jD ]�}d|j }dt�|j�|jf }|| j|< |jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< qF|jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< q�|jD ]8}d|j|jf }dt�|j�|j|jf }|| j |< q�qt | j � � d d �| _ t | j� � d d �| _ d S ) Nz#%sz8<link linkend="gdbus-interface-%s.top_of_page">%s</link>z%s.%s()z.<link linkend="gdbus-method-%s.%s">%s()</link>z#%s::%sz.<link linkend="gdbus-signal-%s.%s">"%s"</link>z#%s:%sz0<link linkend="gdbus-property-%s.%s">"%s"</link>T)�reverse) rM rO r r r r r r" r& �sorted�keysrK rN )r r rS �valuer r$ r) r r r r ` sN � � � � � �z*DocbookCodeGenerator.generate_expand_dictsc C s� | j D �]�}tt�|d||jf �d�| _| j�d� | j�d� | j�d� | j�d� | j�d� | j�d|j � | j�d � | j�d t�|j�|jf � | j�d t�|j�|j |jf � | j�d � | j�d � | j�d|j � | j�d|j � | j�d� t |j �dk�r&| � |� t |j�dk�r@| �|� t |j�dk�rZ| �|� | j�dt�|j� � | j�d� | j�d| �|jd� � t |j�dk�r�| j�d|j � |j�r�| j�d|j � | j�d� t |j �dk�r4| j�d|j � | j�d� |j D ]}| �||� �q| j�d� t |j�dk�r�| j�d|j � | j�d � |jD ]}| �||� �qh| j�d� t |j�dk�r�| j�d |j � | j�d � |jD ]}| �||� �q�| j�d� | j�d � | j�d � qd S )!Nz %s-%s.xml�wr z'<?xml version="1.0" encoding="utf-8"?> zA<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" zL "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ z]> z<refentry id="gdbus-%s"> z <refmeta>z] <refentrytitle role="top_of_page" id="gdbus-interface-%s.top_of_page">%s</refentrytitle> za <indexterm zone="gdbus-interface-%s.top_of_page"><primary sortas="%s">%s</primary></indexterm> z </refmeta>z <refnamediv>z <refname>%s</refname>z <refpurpose>%s</refpurpose>z </refnamediv>r z/<refsect1 role="desc" id="gdbus-interface-%s"> z/ <title role="desc.title">Description</title> z %s Tz% <para role="since">Since %s</para> z?<warning><para>The %s interface is deprecated.</para></warning>z </refsect1> z0<refsect1 role="details" id="gdbus-methods-%s"> z5 <title role="details.title">Method Details</title> z0<refsect1 role="details" id="gdbus-signals-%s"> z5 <title role="details.title">Signal Details</title> z3<refsect1 role="details" id="gdbus-properties-%s"> z7 <title role="details.title">Property Details</title> z </refentry> � )r �openr �joinr r r r r r> Zdoc_string_briefr r r/ r" r1 r& r3 r? r@ rA rB rC rD rE )r ZdocbookZoutdirr r r$ r r r �generate� s� �� ���� �� �� � � �� z DocbookCodeGenerator.generateN)�__name__� __module__� __qualname__r r! r% r+ r/ r1 r3 rC rD rE rT r? r r_ r r r r r # s 5)$ 7, +r )rP �osr r r r r r r r �<module> s codegen/__pycache__/dbustypes.cpython-39.opt-1.pyc 0000644 00000022505 15125157507 0016006 0 ustar 00 a ]x a�O � @ sp d dl mZ d dlmZ G dd� d�ZG dd� d�ZG dd� d�ZG d d � d �ZG d d � d �ZG d d� d�ZdS )� )�utils)� print_errorc @ s e Zd Zdd� Zdd� ZdS )� Annotationc C s || _ || _g | _d| _d S �N� )�key�value� annotations�since)�selfr r � r �(/usr/share/glib-2.0/codegen/dbustypes.py�__init__ s zAnnotation.__init__c C s� | j }t�| jd�}t�|�r*|�� | _n(|r2|}t�|��� �dd��dd�| _t | j �dkr�t� | j�| _ t | j �dkr�|j | _ | jD ]}|� ||||| � q�d S )N�org.gtk.GDBus.C.Name�-�_�.� ) r r �lookup_annotationr � is_ugly_case�lowerZ key_lower�camel_case_to_uscore�replace�lenr � lookup_since� post_process) r �interface_prefix�cns� cns_upper� cns_lower� containerr Zoverridden_key�ar r r r ! s( � ��� zAnnotation.post_processN��__name__� __module__� __qualname__r r r r r r r s r c @ s e Zd Zdd� Zdd� ZdS )�Argc C s" || _ || _g | _d| _d| _d S r )�name� signaturer � doc_stringr )r r' r( r r r r < s z Arg.__init__c C s^ t | j�dkr t�| j�| _t | j�dkr8t�| j�| _| jd u rLd| | _d| _d| _ d| _ d| _ d| _ d| _ d| j | _d| j | _d| _d | _d | _t�| jd ��s:| jd kr�d | _d | _ d| _ d| _ d | _ d | _d | _d| _d| _�nL| jdk�r4d| _d| _ d| _ d| _ d | _ d| _d| _d| _d| _�n| jdk�rzd| _d| _ d| _ d | _ d | _ d| _d| _d | _d | _�n�| jd k�r�d | _d!| _ d"| _ d#| _ d | _ d | _d | _d$| _d%| _�nz| jd&k�rd| _d| _ d'| _ d | _ d | _ d&| _d&| _d(| _d | _�n4| jd)k�rLd | _d | _ d*| _ d#| _ d | _ d)| _d)| _d+| _d%| _�n�| jd,k�r�d-| _d-| _ d.| _ d/| _ d | _ d,| _d,| _d0| _d1| _�n�| jd2k�r�d3| _d3| _ d4| _ d5| _ d | _ d2| _d2| _d6| _d7| _�nb| jd8k�r d9| _d9| _ d:| _ d;| _ d | _ d8| _d8| _d<| _d=| _�n | jd>k�rjd?| _d?| _ d@| _ dA| _ dB| _ dC| _ d>| _d>| _dD| _dE| _�n�| jdFk�r�d?| _d?| _ d@| _ dA| _ dB| _ dC| _ dF| _dF| _dD| _dE| _�n�| jdGk�rd?| _d?| _ d@| _ dA| _ dB| _ dC| _ dG| _dG| _dD| _dE| _�n8| jdHk�rLd?| _d?| _ d@| _ dA| _ dB| _ dC| _ dI| _dI| _dJ| _dE| _n�| jdKk�r�dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dP| _dP| _dQ| _dR| _dS| _n�| jdTk�r�dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dU| _dU| _dV| _dR| _dS| _nN| jdWk�r:dL| _dL| _ dA| _ dM| _ dN| _ dO| _ dX| _dX| _dY| _dR| _dS| _| jD ]}|�||||| � �q@d S )ZNr z unnamed_arg%dz GVariant *z GVariant **ZG_TYPE_VARIANTZg_variant_unref�@ZXXXZg_value_get_variantr z org.gtk.GDBus.C.ForceGVariant�bz gboolean z gboolean *ZG_TYPE_BOOLEANZg_variant_get_booleanZg_value_get_boolean�yzguchar zguchar *Z G_TYPE_UCHARZg_variant_get_byteZg_value_get_uchar�nzgint zgint16 zgint16 *Z G_TYPE_INTZg_variant_get_int16Zg_value_get_int�qzguint zguint16 z guint16 *Z G_TYPE_UINTZg_variant_get_uint16Zg_value_get_uint�izgint *Zg_variant_get_int32�uzguint *Zg_variant_get_uint32�xzgint64 zgint64 *Z G_TYPE_INT64Zg_variant_get_int64Zg_value_get_int64�tzguint64 z guint64 *Z G_TYPE_UINT64Zg_variant_get_uint64Zg_value_get_uint64�dzgdouble z gdouble *Z G_TYPE_DOUBLEZg_variant_get_doubleZg_value_get_double�sz const gchar *zgchar *zgchar **Z G_TYPE_STRINGZg_freeZg_variant_get_stringZg_value_get_string�o�gZayz^ayZg_variant_get_bytestring�aszconst gchar *const *z gchar ***Z G_TYPE_STRVZ g_strfreevz^asZg_variant_get_strvZg_value_get_boxedz(array zero-terminated=1)Zaoz^aoZg_variant_get_objvZaayz^aayZ g_variant_get_bytestring_array)r r) r � lookup_docsr r r r' Z ctype_in_gZctype_inZ ctype_in_dupZ ctype_outZgtypeZ free_funcr( Z format_inZ format_outZ gvariant_getZ gvalue_getZarray_annotationr r )r r r r r Z arg_numberr! r r r r C s� � zArg.post_processNr" r r r r r& ; s r& c @ s e Zd Zddd�Zdd� ZdS )�MethodTc C s: || _ || _g | _g | _g | _d| _d| _d| _d| _d S �Nr F) r' �h_type_implies_unix_fd�in_args�out_argsr r) r � deprecated�unix_fd)r r' r; r r r r s zMethod.__init__c C sx t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _d}| jD ]4} | �|||||� |d7 }| jr�d| jv r�d| _q�| jD ]4} | �|||||� |d7 }| jr�d| jv r�d| _q�t�| jd�d k�r>d| _t�| jd ��rTd| _| jD ]} | �||||| � �qZd S ) Nr r r r r �hT� org.freedesktop.DBus.Deprecated�truezorg.gtk.GDBus.C.UnixFD)r r) r r8 r r r r' r r r � name_lowerr r � name_hyphenr< r r; r( r? r= r> � r r r r r �containing_ifacer' �overridden_name� arg_countr! r r r r sH � �� zMethod.post_processN)Tr" r r r r r9 s r9 c @ s e Zd Zdd� Zdd� ZdS )�Signalc C s( || _ g | _g | _d| _d| _d| _d S r: )r' �argsr r) r r> �r r' r r r r G s zSignal.__init__c C s t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _d}| jD ] } | �|||||� |d7 }q�t�| jd�dkr�d| _| jD ]} | �||||| � q�d S ) Nr r r r r rA rB T)r r) r r8 r r r r' r r r rC r r rD rJ r r> rE r r r r O s6 � �� zSignal.post_processNr" r r r r rI F s rI c @ s e Zd Zdd� Zdd� ZdS )�Propertyc C s� || _ || _|| _g | _td| j�| _| j| j_d| _d| _| jdkrTd| _d| _n4| jdkrfd| _n"| jdkrxd| _ntd� | j�� d| _ d| _ d| _ d| _ d S ) Nr FZ readwriteT�read�writezInvalid access type "{}"r )r' r( �accessr r& �arg�readable�writabler �formatr) r r> �emits_changed_signal)r r' r( rO r r r r u s( zProperty.__init__c C s* t | j�dkr t�| j�| _t | j�dkrNt�| j�| _t | j�dkrN|j| _| j}t�| jd�}t� |�rx|� � | _ n |r�|}t� |�� � � dd�| _ | j � dd�| _| j dkr�d| _ | j| j_| j�||||d� t�| jd�dkr�d | _| jD ]}|�||||| � q�t�| jd �d v �r&d | _d S ) Nr r r r �type�type_rA rB Tz0org.freedesktop.DBus.Property.EmitsChangedSignal)Zfalse�constF)r r) r r8 r r r r' r r r rC r r rD rP r r> rT ) r r r r r rF r' rG r! r r r r � sB � �� ��zProperty.post_processNr" r r r r rL t s rL c @ s e Zd Zdd� Zdd� ZdS )� Interfacec C s: || _ g | _g | _g | _g | _d| _d| _d| _d| _d S r: ) r' �methods�signals� propertiesr r) �doc_string_briefr r> rK r r r r � s zInterface.__init__c C sN t | j�dkr t�| j�| _t | j�dkr8t�| j�| _t | j�dkrTt�| j�| _t |�dkr�t� |�r�|� dd�}|� � d }|� � d }q�|}t� |�� � d }t� |�� � d }n d}d}d}t�| jd�}t� |��r |� dd�}|| }|| _|| _|| _||� � | _|� � | _n||�r,|}n"| j}|�|��rN|t |�d � }|| _t�|�}t�|d | �}|| _|| _|t� |� | _t� |�� � | _| j� � � dd�| _t�| jd�dk�r�d | _| jD ]} | �||||| � �q�| jD ]} | �||||| � �q�| j D ]} | �||||| � �q| jD ]} | �||||| � �q0d S ) Nr r r r r r rA rB T) r r) r r8 r r\ Zlookup_brief_docsr r r r �upperr r r Zname_without_prefixZ camel_nameZns_upperrC Z name_upperr' � startswithZ strip_dotsrD r> rY r rZ r[ ) r r Z c_namespacer r r rG r' Z name_with_ns�mr4 �pr! r r r r � sl � �� zInterface.post_processNr" r r r r rX � s rX N) r r r r r& r9 rI rL rX r r r r �<module> s ! P<.I codegen/__pycache__/config.cpython-39.opt-1.pyc 0000644 00000000306 15125157507 0015224 0 ustar 00 a ]x aX � @ s d Z dZdZdS )z2.68.4� �D N)ZVERSIONZ MAJOR_VERSIONZ MINOR_VERSION� r r �%/usr/share/glib-2.0/codegen/config.py�<module> s codegen/__pycache__/__init__.cpython-39.pyc 0000644 00000000501 15125157507 0014554 0 ustar 00 a ]x a� � @ s@ d dl Z e j�d�Zedur<e�e j�e j�eddd��� dS )� NZUNINSTALLED_GLIB_BUILDDIRZgioz gdbus-2.0Zcodegen) �os�environ�getZbuilddir�__path__�append�path�abspath�join� r r �'/usr/share/glib-2.0/codegen/__init__.py�<module> s � codegen/__pycache__/config.cpython-39.pyc 0000644 00000000306 15125157507 0014265 0 ustar 00 a ]x aX � @ s d Z dZdZdS )z2.68.4� �D N)ZVERSIONZ MAJOR_VERSIONZ MINOR_VERSION� r r �%/usr/share/glib-2.0/codegen/config.py�<module> s codegen/codegen.py 0000644 00000701624 15125157507 0010150 0 ustar 00 # -*- Mode: Python -*- # coding=utf-8 # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2018 Red Hat, Inc. # Copyright (C) 2018 Iñigo Martínez <inigomartinez@gmail.com> # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> from . import config from . import utils from . import dbustypes from .utils import print_error LICENSE_STR = """/* * This file is generated by gdbus-codegen, do not modify it. * * The license of this code is the same as for the D-Bus interface description * it was derived from. Note that it links to GLib, so must comply with the * LGPL linking clauses. */\n""" # Disable line length warnings as wrapping the C code templates would be hard # flake8: noqa: E501 def generate_namespace(namespace): ns = namespace if len(namespace) > 0: if utils.is_ugly_case(namespace): ns = namespace.replace("_", "") ns_upper = namespace.upper() + "_" ns_lower = namespace.lower() + "_" else: ns_upper = utils.camel_case_to_uscore(namespace).upper() + "_" ns_lower = utils.camel_case_to_uscore(namespace).lower() + "_" else: ns_upper = "" ns_lower = "" return (ns, ns_upper, ns_lower) def generate_header_guard(header_name): # There might be more characters that are safe to use than these, but lets # stay conservative. safe_valid_chars = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ" return "".join( map(lambda c: c if c in safe_valid_chars else "_", header_name.upper()) ) class HeaderCodeGenerator: def __init__( self, ifaces, namespace, generate_objmanager, generate_autocleanup, header_name, input_files_basenames, use_pragma, glib_min_required, symbol_decorator, symbol_decorator_header, outfile, ): self.ifaces = ifaces self.namespace, self.ns_upper, self.ns_lower = generate_namespace(namespace) self.generate_objmanager = generate_objmanager self.generate_autocleanup = generate_autocleanup self.header_guard = generate_header_guard(header_name) self.input_files_basenames = input_files_basenames self.use_pragma = use_pragma self.glib_min_required = glib_min_required self.symbol_decorator = symbol_decorator self.symbol_decorator_header = symbol_decorator_header self.outfile = outfile # ---------------------------------------------------------------------------------------------------- def generate_header_preamble(self): basenames = ", ".join(self.input_files_basenames) self.outfile.write(LICENSE_STR.format(config.VERSION, basenames)) self.outfile.write("\n") if self.use_pragma: self.outfile.write("#pragma once\n") else: self.outfile.write("#ifndef __{!s}__\n".format(self.header_guard)) self.outfile.write("#define __{!s}__\n".format(self.header_guard)) if self.symbol_decorator_header is not None: self.outfile.write("\n") self.outfile.write('#include "%s"\n' % self.symbol_decorator_header) self.outfile.write("\n") self.outfile.write("#include <gio/gio.h>\n") self.outfile.write("\n") self.outfile.write("G_BEGIN_DECLS\n") self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def declare_types(self): for i in self.ifaces: self.outfile.write("\n") self.outfile.write( "/* ------------------------------------------------------------------------ */\n" ) self.outfile.write("/* Declarations for %s */\n" % i.name) self.outfile.write("\n") # First the GInterface self.outfile.write( "#define %sTYPE_%s (%s_get_type ())\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write( "#define %s%s(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s, %s))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %sIS_%s(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper) ) self.outfile.write( "#define %s%s_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_%s, %sIface))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write("\n") self.outfile.write("struct _%s;\n" % (i.camel_name)) self.outfile.write( "typedef struct _%s %s;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "typedef struct _%sIface %sIface;\n" % (i.camel_name, i.camel_name) ) self.outfile.write("\n") self.outfile.write("struct _%sIface\n" % (i.camel_name)) self.outfile.write("{\n") self.outfile.write(" GTypeInterface parent_iface;\n") function_pointers = {} # vfuncs for methods if len(i.methods) > 0: self.outfile.write("\n") for m in i.methods: key = (m.since, "_method_%s" % m.name_lower) value = " gboolean (*handle_%s) (\n" % (m.name_lower) value += " %s *object,\n" % (i.camel_name) value += " GDBusMethodInvocation *invocation" if m.unix_fd: value += ",\n GUnixFDList *fd_list" for a in m.in_args: value += ",\n %sarg_%s" % (a.ctype_in, a.name) value += ");\n\n" function_pointers[key] = value # vfuncs for signals if len(i.signals) > 0: self.outfile.write("\n") for s in i.signals: key = (s.since, "_signal_%s" % s.name_lower) value = " void (*%s) (\n" % (s.name_lower) value += " %s *object" % (i.camel_name) for a in s.args: value += ",\n %sarg_%s" % (a.ctype_in, a.name) value += ");\n\n" function_pointers[key] = value # vfuncs for properties if len(i.properties) > 0: self.outfile.write("\n") for p in i.properties: key = (p.since, "_prop_get_%s" % p.name_lower) value = " %s (*get_%s) (%s *object);\n\n" % ( p.arg.ctype_in, p.name_lower, i.camel_name, ) function_pointers[key] = value # Sort according to @since tag, then name.. this ensures # that the function pointers don't change order assuming # judicious use of @since # # Also use a proper version comparison function so e.g. # 10.0 comes after 2.0. # # See https://bugzilla.gnome.org/show_bug.cgi?id=647577#c5 # for discussion for key in sorted(function_pointers.keys(), key=utils.version_cmp_key): self.outfile.write("%s" % function_pointers[key]) self.outfile.write("};\n") self.outfile.write("\n") if self.generate_autocleanup == "all": self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%s, g_object_unref)\n" % (i.camel_name) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %s_get_type (void) G_GNUC_CONST;\n" % (i.name_lower) ) self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GDBusInterfaceInfo *%s_interface_info (void);\n" % (i.name_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "guint %s_override_properties (GObjectClass *klass, guint property_id_begin);\n" % (i.name_lower) ) self.outfile.write("\n") # Then method call completion functions if len(i.methods) > 0: self.outfile.write("\n") self.outfile.write("/* D-Bus method call completion functions: */\n") for m in i.methods: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if m.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_complete_%s (\n" " %s *object,\n" " GDBusMethodInvocation *invocation" % (i.name_lower, m.name_lower, i.camel_name) ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") for a in m.out_args: self.outfile.write(",\n %s%s" % (a.ctype_in, a.name)) self.outfile.write(");\n") self.outfile.write("\n") self.outfile.write("\n") # Then signal emission functions if len(i.signals) > 0: self.outfile.write("\n") self.outfile.write("/* D-Bus signal emissions functions: */\n") for s in i.signals: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if s.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_emit_%s (\n" " %s *object" % (i.name_lower, s.name_lower, i.camel_name) ) for a in s.args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) self.outfile.write(");\n") self.outfile.write("\n") self.outfile.write("\n") # Then method call declarations if len(i.methods) > 0: self.outfile.write("\n") self.outfile.write("/* D-Bus method calls: */\n") for m in i.methods: # async begin if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if m.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_call_%s (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) if self.glib_min_required >= (2, 64): self.outfile.write( ",\n GDBusCallFlags call_flags" ",\n gint timeout_msec" ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") self.outfile.write( ",\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data);\n" ) self.outfile.write("\n") # async finish if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if m.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "gboolean %s_call_%s_finish (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.out_args: self.outfile.write(",\n %sout_%s" % (a.ctype_out, a.name)) if m.unix_fd: self.outfile.write(",\n GUnixFDList **out_fd_list") self.outfile.write( ",\n" " GAsyncResult *res,\n" " GError **error);\n" ) self.outfile.write("\n") # sync if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if m.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "gboolean %s_call_%s_sync (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) if self.glib_min_required >= (2, 64): self.outfile.write( ",\n GDBusCallFlags call_flags" ",\n gint timeout_msec" ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") for a in m.out_args: self.outfile.write(",\n %sout_%s" % (a.ctype_out, a.name)) if m.unix_fd: self.outfile.write(",\n GUnixFDList **out_fd_list") self.outfile.write( ",\n" " GCancellable *cancellable,\n" " GError **error);\n" ) self.outfile.write("\n") self.outfile.write("\n") # Then the property accessor declarations if len(i.properties) > 0: self.outfile.write("\n") self.outfile.write("/* D-Bus property accessors: */\n") for p in i.properties: # getter if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if p.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s%s_get_%s (%s *object);\n" % (p.arg.ctype_in, i.name_lower, p.name_lower, i.camel_name) ) if p.arg.free_func is not None: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if p.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s%s_dup_%s (%s *object);\n" % ( p.arg.ctype_in_dup, i.name_lower, p.name_lower, i.camel_name, ) ) # setter if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if p.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_set_%s (%s *object, %svalue);\n" % (i.name_lower, p.name_lower, i.camel_name, p.arg.ctype_in) ) self.outfile.write("\n") # Then the proxy self.outfile.write("\n") self.outfile.write("/* ---- */\n") self.outfile.write("\n") self.outfile.write( "#define %sTYPE_%s_PROXY (%s_proxy_get_type ())\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write( "#define %s%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_PROXY, %sProxy))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %s%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_PROXY, %sProxyClass))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %s%s_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_PROXY, %sProxyClass))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %sIS_%s_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_PROXY))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper) ) self.outfile.write( "#define %sIS_%s_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_PROXY))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper) ) self.outfile.write("\n") self.outfile.write( "typedef struct _%sProxy %sProxy;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "typedef struct _%sProxyClass %sProxyClass;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "typedef struct _%sProxyPrivate %sProxyPrivate;\n" % (i.camel_name, i.camel_name) ) self.outfile.write("\n") self.outfile.write("struct _%sProxy\n" % (i.camel_name)) self.outfile.write("{\n") self.outfile.write(" /*< private >*/\n") self.outfile.write(" GDBusProxy parent_instance;\n") self.outfile.write(" %sProxyPrivate *priv;\n" % (i.camel_name)) self.outfile.write("};\n") self.outfile.write("\n") self.outfile.write("struct _%sProxyClass\n" % (i.camel_name)) self.outfile.write("{\n") self.outfile.write(" GDBusProxyClass parent_class;\n") self.outfile.write("};\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %s_proxy_get_type (void) G_GNUC_CONST;\n" % (i.name_lower) ) self.outfile.write("\n") if self.generate_autocleanup in ("objects", "all"): self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sProxy, g_object_unref)\n" % (i.camel_name) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_proxy_new (\n" " GDBusConnection *connection,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data);\n" % (i.name_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%s_proxy_new_finish (\n" " GAsyncResult *res,\n" " GError **error);\n" % (i.camel_name, i.name_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%s_proxy_new_sync (\n" " GDBusConnection *connection,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error);\n" % (i.camel_name, i.name_lower) ) self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %s_proxy_new_for_bus (\n" " GBusType bus_type,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data);\n" % (i.name_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%s_proxy_new_for_bus_finish (\n" " GAsyncResult *res,\n" " GError **error);\n" % (i.camel_name, i.name_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%s_proxy_new_for_bus_sync (\n" " GBusType bus_type,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error);\n" % (i.camel_name, i.name_lower) ) self.outfile.write("\n") # Then the skeleton self.outfile.write("\n") self.outfile.write("/* ---- */\n") self.outfile.write("\n") self.outfile.write( "#define %sTYPE_%s_SKELETON (%s_skeleton_get_type ())\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write( "#define %s%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_%s_SKELETON, %sSkeleton))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %s%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_%s_SKELETON, %sSkeletonClass))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %s%s_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_%s_SKELETON, %sSkeletonClass))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, i.camel_name) ) self.outfile.write( "#define %sIS_%s_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_%s_SKELETON))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper) ) self.outfile.write( "#define %sIS_%s_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_%s_SKELETON))\n" % (i.ns_upper, i.name_upper, i.ns_upper, i.name_upper) ) self.outfile.write("\n") self.outfile.write( "typedef struct _%sSkeleton %sSkeleton;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "typedef struct _%sSkeletonClass %sSkeletonClass;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "typedef struct _%sSkeletonPrivate %sSkeletonPrivate;\n" % (i.camel_name, i.camel_name) ) self.outfile.write("\n") self.outfile.write("struct _%sSkeleton\n" % (i.camel_name)) self.outfile.write("{\n") self.outfile.write(" /*< private >*/\n") self.outfile.write(" GDBusInterfaceSkeleton parent_instance;\n") self.outfile.write(" %sSkeletonPrivate *priv;\n" % (i.camel_name)) self.outfile.write("};\n") self.outfile.write("\n") self.outfile.write("struct _%sSkeletonClass\n" % (i.camel_name)) self.outfile.write("{\n") self.outfile.write(" GDBusInterfaceSkeletonClass parent_class;\n") self.outfile.write("};\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %s_skeleton_get_type (void) G_GNUC_CONST;\n" % (i.name_lower) ) self.outfile.write("\n") if self.generate_autocleanup in ("objects", "all"): self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sSkeleton, g_object_unref)\n" % (i.camel_name) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%s_skeleton_new (void);\n" % (i.camel_name, i.name_lower) ) self.outfile.write("\n") # Finally, the Object, ObjectProxy, ObjectSkeleton and ObjectManagerClient if self.generate_objmanager: self.outfile.write("\n") self.outfile.write("/* ---- */\n") self.outfile.write("\n") self.outfile.write( "#define %sTYPE_OBJECT (%sobject_get_type ())\n" % (self.ns_upper, self.ns_lower) ) self.outfile.write( "#define %sOBJECT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT, %sObject))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sIS_OBJECT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write( "#define %sOBJECT_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE ((o), %sTYPE_OBJECT, %sObject))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write("\n") self.outfile.write("struct _%sObject;\n" % (self.namespace)) self.outfile.write( "typedef struct _%sObject %sObject;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectIface %sObjectIface;\n" % (self.namespace, self.namespace) ) self.outfile.write("\n") self.outfile.write("struct _%sObjectIface\n" % (self.namespace)) self.outfile.write("{\n" " GTypeInterface parent_iface;\n" "};\n" "\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %sobject_get_type (void) G_GNUC_CONST;\n" "\n" % (self.ns_lower) ) if self.generate_autocleanup == "all": self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObject, g_object_unref)\n" % (self.namespace) ) self.outfile.write("#endif\n") self.outfile.write("\n") for i in self.ifaces: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%sobject_get_%s (%sObject *object);\n" % ( i.camel_name, self.ns_lower, i.name_upper.lower(), self.namespace, ) ) for i in self.ifaces: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "%s *%sobject_peek_%s (%sObject *object);\n" % ( i.camel_name, self.ns_lower, i.name_upper.lower(), self.namespace, ) ) self.outfile.write("\n") self.outfile.write( "#define %sTYPE_OBJECT_PROXY (%sobject_proxy_get_type ())\n" % (self.ns_upper, self.ns_lower) ) self.outfile.write( "#define %sOBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_PROXY, %sObjectProxy))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_PROXY, %sObjectProxyClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_PROXY, %sObjectProxyClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sIS_OBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_PROXY))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write( "#define %sIS_OBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_PROXY))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write("\n") self.outfile.write( "typedef struct _%sObjectProxy %sObjectProxy;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectProxyClass %sObjectProxyClass;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectProxyPrivate %sObjectProxyPrivate;\n" % (self.namespace, self.namespace) ) self.outfile.write("\n") self.outfile.write("struct _%sObjectProxy\n" % (self.namespace)) self.outfile.write("{\n") self.outfile.write(" /*< private >*/\n") self.outfile.write(" GDBusObjectProxy parent_instance;\n") self.outfile.write(" %sObjectProxyPrivate *priv;\n" % (self.namespace)) self.outfile.write("};\n") self.outfile.write("\n") self.outfile.write("struct _%sObjectProxyClass\n" % (self.namespace)) self.outfile.write("{\n") self.outfile.write(" GDBusObjectProxyClass parent_class;\n") self.outfile.write("};\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %sobject_proxy_get_type (void) G_GNUC_CONST;\n" % (self.ns_lower) ) self.outfile.write("\n") if self.generate_autocleanup in ("objects", "all"): self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectProxy, g_object_unref)\n" % (self.namespace) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "%sObjectProxy *%sobject_proxy_new (GDBusConnection *connection, const gchar *object_path);\n" % (self.namespace, self.ns_lower) ) self.outfile.write("\n") self.outfile.write( "#define %sTYPE_OBJECT_SKELETON (%sobject_skeleton_get_type ())\n" % (self.ns_upper, self.ns_lower) ) self.outfile.write( "#define %sOBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeleton))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_SKELETON, %sObjectSkeletonClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sIS_OBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_SKELETON))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write( "#define %sIS_OBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_SKELETON))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write("\n") self.outfile.write( "typedef struct _%sObjectSkeleton %sObjectSkeleton;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectSkeletonClass %sObjectSkeletonClass;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectSkeletonPrivate %sObjectSkeletonPrivate;\n" % (self.namespace, self.namespace) ) self.outfile.write("\n") self.outfile.write("struct _%sObjectSkeleton\n" % (self.namespace)) self.outfile.write("{\n") self.outfile.write(" /*< private >*/\n") self.outfile.write(" GDBusObjectSkeleton parent_instance;\n") self.outfile.write(" %sObjectSkeletonPrivate *priv;\n" % (self.namespace)) self.outfile.write("};\n") self.outfile.write("\n") self.outfile.write("struct _%sObjectSkeletonClass\n" % (self.namespace)) self.outfile.write("{\n") self.outfile.write(" GDBusObjectSkeletonClass parent_class;\n") self.outfile.write("};\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %sobject_skeleton_get_type (void) G_GNUC_CONST;\n" % (self.ns_lower) ) self.outfile.write("\n") if self.generate_autocleanup in ("objects", "all"): self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectSkeleton, g_object_unref)\n" % (self.namespace) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "%sObjectSkeleton *%sobject_skeleton_new (const gchar *object_path);\n" % (self.namespace, self.ns_lower) ) for i in self.ifaces: if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) if i.deprecated: self.outfile.write("G_GNUC_DEPRECATED ") self.outfile.write( "void %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_);\n" % ( self.ns_lower, i.name_upper.lower(), self.namespace, i.camel_name, ) ) self.outfile.write("\n") self.outfile.write("/* ---- */\n") self.outfile.write("\n") self.outfile.write( "#define %sTYPE_OBJECT_MANAGER_CLIENT (%sobject_manager_client_get_type ())\n" % (self.ns_upper, self.ns_lower) ) self.outfile.write( "#define %sOBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClient))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sOBJECT_MANAGER_CLIENT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), %sTYPE_OBJECT_MANAGER_CLIENT, %sObjectManagerClientClass))\n" % (self.ns_upper, self.ns_upper, self.namespace) ) self.outfile.write( "#define %sIS_OBJECT_MANAGER_CLIENT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), %sTYPE_OBJECT_MANAGER_CLIENT))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write( "#define %sIS_OBJECT_MANAGER_CLIENT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), %sTYPE_OBJECT_MANAGER_CLIENT))\n" % (self.ns_upper, self.ns_upper) ) self.outfile.write("\n") self.outfile.write( "typedef struct _%sObjectManagerClient %sObjectManagerClient;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectManagerClientClass %sObjectManagerClientClass;\n" % (self.namespace, self.namespace) ) self.outfile.write( "typedef struct _%sObjectManagerClientPrivate %sObjectManagerClientPrivate;\n" % (self.namespace, self.namespace) ) self.outfile.write("\n") self.outfile.write("struct _%sObjectManagerClient\n" % (self.namespace)) self.outfile.write("{\n") self.outfile.write(" /*< private >*/\n") self.outfile.write(" GDBusObjectManagerClient parent_instance;\n") self.outfile.write( " %sObjectManagerClientPrivate *priv;\n" % (self.namespace) ) self.outfile.write("};\n") self.outfile.write("\n") self.outfile.write( "struct _%sObjectManagerClientClass\n" % (self.namespace) ) self.outfile.write("{\n") self.outfile.write(" GDBusObjectManagerClientClass parent_class;\n") self.outfile.write("};\n") self.outfile.write("\n") if self.generate_autocleanup in ("objects", "all"): self.outfile.write("#if GLIB_CHECK_VERSION(2, 44, 0)\n") self.outfile.write( "G_DEFINE_AUTOPTR_CLEANUP_FUNC (%sObjectManagerClient, g_object_unref)\n" % (self.namespace) ) self.outfile.write("#endif\n") self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %sobject_manager_client_get_type (void) G_GNUC_CONST;\n" % (self.ns_lower) ) self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GType %sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager, const gchar *object_path, const gchar *interface_name, gpointer user_data);\n" % (self.ns_lower) ) self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "void %sobject_manager_client_new (\n" " GDBusConnection *connection,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data);\n" % (self.ns_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GDBusObjectManager *%sobject_manager_client_new_finish (\n" " GAsyncResult *res,\n" " GError **error);\n" % (self.ns_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GDBusObjectManager *%sobject_manager_client_new_sync (\n" " GDBusConnection *connection,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error);\n" % (self.ns_lower) ) self.outfile.write("\n") if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "void %sobject_manager_client_new_for_bus (\n" " GBusType bus_type,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data);\n" % (self.ns_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GDBusObjectManager *%sobject_manager_client_new_for_bus_finish (\n" " GAsyncResult *res,\n" " GError **error);\n" % (self.ns_lower) ) if self.symbol_decorator is not None: self.outfile.write("%s\n" % self.symbol_decorator) self.outfile.write( "GDBusObjectManager *%sobject_manager_client_new_for_bus_sync (\n" " GBusType bus_type,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error);\n" % (self.ns_lower) ) self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def generate_header_postamble(self): self.outfile.write("\n") self.outfile.write("G_END_DECLS\n") if not self.use_pragma: self.outfile.write("\n") self.outfile.write("#endif /* __{!s}__ */\n".format(self.header_guard)) # ---------------------------------------------------------------------------------------------------- def generate(self): self.generate_header_preamble() self.declare_types() self.generate_header_postamble() # ---------------------------------------------------------------------------------------------------- class InterfaceInfoHeaderCodeGenerator: def __init__( self, ifaces, namespace, header_name, input_files_basenames, use_pragma, glib_min_required, symbol_decorator, symbol_decorator_header, outfile, ): self.ifaces = ifaces self.namespace, self.ns_upper, self.ns_lower = generate_namespace(namespace) self.header_guard = generate_header_guard(header_name) self.input_files_basenames = input_files_basenames self.use_pragma = use_pragma self.glib_min_required = glib_min_required self.symbol_decorator = symbol_decorator if self.symbol_decorator is None: self.symbol_decorator = "" self.symbol_decorator_header = symbol_decorator_header self.outfile = outfile # ---------------------------------------------------------------------------------------------------- def generate_header_preamble(self): basenames = ", ".join(self.input_files_basenames) self.outfile.write(LICENSE_STR.format(config.VERSION, basenames)) self.outfile.write("\n") if self.use_pragma: self.outfile.write("#pragma once\n") else: self.outfile.write("#ifndef __{!s}__\n".format(self.header_guard)) self.outfile.write("#define __{!s}__\n".format(self.header_guard)) if self.symbol_decorator_header is not None: self.outfile.write("\n") self.outfile.write('#include "%s"\n' % self.symbol_decorator_header) self.outfile.write("\n") self.outfile.write("#include <gio/gio.h>\n") self.outfile.write("\n") self.outfile.write("G_BEGIN_DECLS\n") self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def declare_infos(self): for i in self.ifaces: self.outfile.write( "extern %s const GDBusInterfaceInfo %s_interface;\n" % (self.symbol_decorator, i.name_lower) ) # ---------------------------------------------------------------------------------------------------- def generate_header_postamble(self): self.outfile.write("\n") self.outfile.write("G_END_DECLS\n") if not self.use_pragma: self.outfile.write("\n") self.outfile.write("#endif /* __{!s}__ */\n".format(self.header_guard)) # ---------------------------------------------------------------------------------------------------- def generate(self): self.generate_header_preamble() self.declare_infos() self.generate_header_postamble() # ---------------------------------------------------------------------------------------------------- class InterfaceInfoBodyCodeGenerator: def __init__( self, ifaces, namespace, header_name, input_files_basenames, glib_min_required, symbol_decoration_define, outfile, ): self.ifaces = ifaces self.namespace, self.ns_upper, self.ns_lower = generate_namespace(namespace) self.header_name = header_name self.input_files_basenames = input_files_basenames self.glib_min_required = glib_min_required self.symbol_decoration_define = symbol_decoration_define self.outfile = outfile # ---------------------------------------------------------------------------------------------------- def generate_body_preamble(self): basenames = ", ".join(self.input_files_basenames) self.outfile.write(LICENSE_STR.format(config.VERSION, basenames)) if self.symbol_decoration_define is not None: self.outfile.write("\n") self.outfile.write("#define %s\n" % self.symbol_decoration_define) self.outfile.write("\n") self.outfile.write( "#ifdef HAVE_CONFIG_H\n" '# include "config.h"\n' "#endif\n" "\n" '#include "%s"\n' "\n" "#include <string.h>\n" % (self.header_name) ) self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def generate_array(self, array_name_lower, element_type, elements): self.outfile.write( "const %s * const %s[] =\n" % (element_type, array_name_lower) ) self.outfile.write("{\n") for (_, name) in elements: self.outfile.write(" &%s,\n" % name) self.outfile.write(" NULL,\n") self.outfile.write("};\n") self.outfile.write("\n") def define_annotations(self, array_name_lower, annotations): if len(annotations) == 0: return annotation_pointers = [] for a in annotations: # Skip internal annotations. if a.key.startswith("org.gtk.GDBus"): continue self.define_annotations( "%s__%s_annotations" % (array_name_lower, a.key_lower), a.annotations ) self.outfile.write( "const GDBusAnnotationInfo %s__%s_annotation =\n" % (array_name_lower, a.key_lower) ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % a.key) self.outfile.write(' (gchar *) "%s",\n' % a.value) if len(a.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s__%s_annotations,\n" % (array_name_lower, a.key_lower) ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") key = (a.since, "%s__%s_annotation" % (array_name_lower, a.key_lower)) annotation_pointers.append(key) self.generate_array( array_name_lower, "GDBusAnnotationInfo", annotation_pointers ) def define_args(self, array_name_lower, args): if len(args) == 0: return arg_pointers = [] for a in args: self.define_annotations( "%s__%s_arg_annotations" % (array_name_lower, a.name), a.annotations ) self.outfile.write( "const GDBusArgInfo %s__%s_arg =\n" % (array_name_lower, a.name) ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % a.name) self.outfile.write(' (gchar *) "%s",\n' % a.signature) if len(a.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s__%s_arg_annotations,\n" % (array_name_lower, a.name) ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") key = (a.since, "%s__%s_arg" % (array_name_lower, a.name)) arg_pointers.append(key) self.generate_array(array_name_lower, "GDBusArgInfo", arg_pointers) def define_infos(self): for i in self.ifaces: self.outfile.write( "/* ------------------------------------------------------------------------ */\n" ) self.outfile.write("/* Definitions for %s */\n" % i.name) self.outfile.write("\n") # GDBusMethodInfos. if len(i.methods) > 0: method_pointers = [] for m in i.methods: self.define_args( "%s_interface__%s_method_in_args" % (i.name_lower, m.name_lower), m.in_args, ) self.define_args( "%s_interface__%s_method_out_args" % (i.name_lower, m.name_lower), m.out_args, ) self.define_annotations( "%s_interface__%s_method_annotations" % (i.name_lower, m.name_lower), m.annotations, ) self.outfile.write( "const GDBusMethodInfo %s_interface__%s_method =\n" % (i.name_lower, m.name_lower) ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % m.name) if len(m.in_args) > 0: self.outfile.write( " (GDBusArgInfo **) %s_interface__%s_method_in_args,\n" % (i.name_lower, m.name_lower) ) else: self.outfile.write(" NULL, /* no in args */\n") if len(m.out_args) > 0: self.outfile.write( " (GDBusArgInfo **) %s_interface__%s_method_out_args,\n" % (i.name_lower, m.name_lower) ) else: self.outfile.write(" NULL, /* no out args */\n") if len(m.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s_interface__%s_method_annotations,\n" % (i.name_lower, m.name_lower) ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") key = ( m.since, "%s_interface__%s_method" % (i.name_lower, m.name_lower), ) method_pointers.append(key) self.generate_array( "%s_interface_methods" % i.name_lower, "GDBusMethodInfo", method_pointers, ) # GDBusSignalInfos. if len(i.signals) > 0: signal_pointers = [] for s in i.signals: self.define_args( "%s_interface__%s_signal_args" % (i.name_lower, s.name_lower), s.args, ) self.define_annotations( "%s_interface__%s_signal_annotations" % (i.name_lower, s.name_lower), s.annotations, ) self.outfile.write( "const GDBusSignalInfo %s_interface__%s_signal =\n" % (i.name_lower, s.name_lower) ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % s.name) if len(s.args) > 0: self.outfile.write( " (GDBusArgInfo **) %s_interface__%s_signal_args,\n" % (i.name_lower, s.name_lower) ) else: self.outfile.write(" NULL, /* no args */\n") if len(s.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s_interface__%s_signal_annotations,\n" % (i.name_lower, s.name_lower) ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") key = ( s.since, "%s_interface__%s_signal" % (i.name_lower, s.name_lower), ) signal_pointers.append(key) self.generate_array( "%s_interface_signals" % i.name_lower, "GDBusSignalInfo", signal_pointers, ) # GDBusPropertyInfos. if len(i.properties) > 0: property_pointers = [] for p in i.properties: if p.readable and p.writable: flags = "G_DBUS_PROPERTY_INFO_FLAGS_READABLE | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE" elif p.readable: flags = "G_DBUS_PROPERTY_INFO_FLAGS_READABLE" elif p.writable: flags = "G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE" else: flags = "G_DBUS_PROPERTY_INFO_FLAGS_NONE" self.define_annotations( "%s_interface__%s_property_annotations" % (i.name_lower, p.name_lower), p.annotations, ) self.outfile.write( "const GDBusPropertyInfo %s_interface__%s_property =\n" % (i.name_lower, p.name_lower) ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % p.name) self.outfile.write(' (gchar *) "%s",\n' % p.signature) self.outfile.write(" %s,\n" % flags) if len(p.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s_interface__%s_property_annotations,\n" % (i.name_lower, p.name_lower) ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") key = ( p.since, "%s_interface__%s_property" % (i.name_lower, p.name_lower), ) property_pointers.append(key) self.generate_array( "%s_interface_properties" % i.name_lower, "GDBusPropertyInfo", property_pointers, ) # Finally the GDBusInterfaceInfo. self.define_annotations( "%s_interface_annotations" % i.name_lower, i.annotations ) self.outfile.write( "const GDBusInterfaceInfo %s_interface =\n" % i.name_lower ) self.outfile.write("{\n") self.outfile.write(" -1, /* ref count */\n") self.outfile.write(' (gchar *) "%s",\n' % i.name) if len(i.methods) > 0: self.outfile.write( " (GDBusMethodInfo **) %s_interface_methods,\n" % i.name_lower ) else: self.outfile.write(" NULL, /* no methods */\n") if len(i.signals) > 0: self.outfile.write( " (GDBusSignalInfo **) %s_interface_signals,\n" % i.name_lower ) else: self.outfile.write(" NULL, /* no signals */\n") if len(i.properties) > 0: self.outfile.write( " (GDBusPropertyInfo **) %s_interface_properties,\n" % i.name_lower ) else: self.outfile.write("NULL, /* no properties */\n") if len(i.annotations) > 0: self.outfile.write( " (GDBusAnnotationInfo **) %s_interface_annotations,\n" % i.name_lower ) else: self.outfile.write(" NULL, /* no annotations */\n") self.outfile.write("};\n") self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def generate(self): self.generate_body_preamble() self.define_infos() # ---------------------------------------------------------------------------------------------------- class CodeGenerator: def __init__( self, ifaces, namespace, generate_objmanager, header_name, input_files_basenames, docbook_gen, glib_min_required, symbol_decoration_define, outfile, ): self.ifaces = ifaces self.namespace, self.ns_upper, self.ns_lower = generate_namespace(namespace) self.generate_objmanager = generate_objmanager self.header_name = header_name self.input_files_basenames = input_files_basenames self.docbook_gen = docbook_gen self.glib_min_required = glib_min_required self.symbol_decoration_define = symbol_decoration_define self.outfile = outfile # ---------------------------------------------------------------------------------------------------- def generate_body_preamble(self): basenames = ", ".join(self.input_files_basenames) self.outfile.write(LICENSE_STR.format(config.VERSION, basenames)) if self.symbol_decoration_define is not None: self.outfile.write("\n") self.outfile.write("#define %s\n" % self.symbol_decoration_define) self.outfile.write("\n") self.outfile.write( "#ifdef HAVE_CONFIG_H\n" '# include "config.h"\n' "#endif\n" "\n" '#include "%s"\n' "\n" "#include <string.h>\n" % (self.header_name) ) self.outfile.write( "#ifdef G_OS_UNIX\n" "# include <gio/gunixfdlist.h>\n" "#endif\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " GDBusArgInfo parent_struct;\n" " gboolean use_gvariant;\n" "} _ExtendedGDBusArgInfo;\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " GDBusMethodInfo parent_struct;\n" " const gchar *signal_name;\n" " gboolean pass_fdlist;\n" "} _ExtendedGDBusMethodInfo;\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " GDBusSignalInfo parent_struct;\n" " const gchar *signal_name;\n" "} _ExtendedGDBusSignalInfo;\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " GDBusPropertyInfo parent_struct;\n" " const gchar *hyphen_name;\n" " guint use_gvariant : 1;\n" " guint emits_changed_signal : 1;\n" "} _ExtendedGDBusPropertyInfo;\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " GDBusInterfaceInfo parent_struct;\n" " const gchar *hyphen_name;\n" "} _ExtendedGDBusInterfaceInfo;\n" "\n" ) self.outfile.write( "typedef struct\n" "{\n" " const _ExtendedGDBusPropertyInfo *info;\n" " guint prop_id;\n" " GValue orig_value; /* the value before the change */\n" "} ChangedProperty;\n" "\n" "static void\n" "_changed_property_free (ChangedProperty *data)\n" "{\n" " g_value_unset (&data->orig_value);\n" " g_free (data);\n" "}\n" "\n" ) self.outfile.write( "static gboolean\n" "_g_strv_equal0 (gchar **a, gchar **b)\n" "{\n" " gboolean ret = FALSE;\n" " guint n;\n" " if (a == NULL && b == NULL)\n" " {\n" " ret = TRUE;\n" " goto out;\n" " }\n" " if (a == NULL || b == NULL)\n" " goto out;\n" " if (g_strv_length (a) != g_strv_length (b))\n" " goto out;\n" " for (n = 0; a[n] != NULL; n++)\n" " if (g_strcmp0 (a[n], b[n]) != 0)\n" " goto out;\n" " ret = TRUE;\n" "out:\n" " return ret;\n" "}\n" "\n" ) self.outfile.write( "static gboolean\n" "_g_variant_equal0 (GVariant *a, GVariant *b)\n" "{\n" " gboolean ret = FALSE;\n" " if (a == NULL && b == NULL)\n" " {\n" " ret = TRUE;\n" " goto out;\n" " }\n" " if (a == NULL || b == NULL)\n" " goto out;\n" " ret = g_variant_equal (a, b);\n" "out:\n" " return ret;\n" "}\n" "\n" ) # simplified - only supports the types we use self.outfile.write( "G_GNUC_UNUSED static gboolean\n" "_g_value_equal (const GValue *a, const GValue *b)\n" "{\n" " gboolean ret = FALSE;\n" " g_assert (G_VALUE_TYPE (a) == G_VALUE_TYPE (b));\n" " switch (G_VALUE_TYPE (a))\n" " {\n" " case G_TYPE_BOOLEAN:\n" " ret = (g_value_get_boolean (a) == g_value_get_boolean (b));\n" " break;\n" " case G_TYPE_UCHAR:\n" " ret = (g_value_get_uchar (a) == g_value_get_uchar (b));\n" " break;\n" " case G_TYPE_INT:\n" " ret = (g_value_get_int (a) == g_value_get_int (b));\n" " break;\n" " case G_TYPE_UINT:\n" " ret = (g_value_get_uint (a) == g_value_get_uint (b));\n" " break;\n" " case G_TYPE_INT64:\n" " ret = (g_value_get_int64 (a) == g_value_get_int64 (b));\n" " break;\n" " case G_TYPE_UINT64:\n" " ret = (g_value_get_uint64 (a) == g_value_get_uint64 (b));\n" " break;\n" " case G_TYPE_DOUBLE:\n" " {\n" " /* Avoid -Wfloat-equal warnings by doing a direct bit compare */\n" " gdouble da = g_value_get_double (a);\n" " gdouble db = g_value_get_double (b);\n" " ret = memcmp (&da, &db, sizeof (gdouble)) == 0;\n" " }\n" " break;\n" " case G_TYPE_STRING:\n" " ret = (g_strcmp0 (g_value_get_string (a), g_value_get_string (b)) == 0);\n" " break;\n" " case G_TYPE_VARIANT:\n" " ret = _g_variant_equal0 (g_value_get_variant (a), g_value_get_variant (b));\n" " break;\n" " default:\n" " if (G_VALUE_TYPE (a) == G_TYPE_STRV)\n" " ret = _g_strv_equal0 (g_value_get_boxed (a), g_value_get_boxed (b));\n" " else\n" ' g_critical ("_g_value_equal() does not handle type %s", g_type_name (G_VALUE_TYPE (a)));\n' " break;\n" " }\n" " return ret;\n" "}\n" "\n" ) def generate_annotations(self, prefix, annotations): if annotations is None: return n = 0 for a in annotations: # self.generate_annotations('%s_%d'%(prefix, n), a.get_annotations()) # skip internal annotations if a.key.startswith("org.gtk.GDBus"): continue self.outfile.write( "static const GDBusAnnotationInfo %s_%d =\n" "{\n" " -1,\n" ' (gchar *) "%s",\n' ' (gchar *) "%s",\n' % (prefix, n, a.key, a.value) ) if len(a.annotations) == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &%s_%d_pointers\n" % (prefix, n) ) self.outfile.write("};\n" "\n") n += 1 if n > 0: self.outfile.write( "static const GDBusAnnotationInfo * const %s_pointers[] =\n" "{\n" % (prefix) ) m = 0 for a in annotations: if a.key.startswith("org.gtk.GDBus"): continue self.outfile.write(" &%s_%d,\n" % (prefix, m)) m += 1 self.outfile.write(" NULL\n" "};\n" "\n") return n def generate_args(self, prefix, args): for a in args: num_anno = self.generate_annotations( "%s_arg_%s_annotation_info" % (prefix, a.name), a.annotations ) self.outfile.write( "static const _ExtendedGDBusArgInfo %s_%s =\n" "{\n" " {\n" " -1,\n" ' (gchar *) "%s",\n' ' (gchar *) "%s",\n' % (prefix, a.name, a.name, a.signature) ) if num_anno == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &%s_arg_%s_annotation_info_pointers\n" % (prefix, a.name) ) self.outfile.write(" },\n") if not utils.lookup_annotation( a.annotations, "org.gtk.GDBus.C.ForceGVariant" ): self.outfile.write(" FALSE\n") else: self.outfile.write(" TRUE\n") self.outfile.write("};\n" "\n") if len(args) > 0: self.outfile.write( "static const GDBusArgInfo * const %s_pointers[] =\n" "{\n" % (prefix) ) for a in args: self.outfile.write(" &%s_%s.parent_struct,\n" % (prefix, a.name)) self.outfile.write(" NULL\n" "};\n" "\n") def generate_introspection_for_interface(self, i): self.outfile.write( "/* ---- Introspection data for %s ---- */\n" "\n" % (i.name) ) if len(i.methods) > 0: for m in i.methods: self.generate_args( "_%s_method_info_%s_IN_ARG" % (i.name_lower, m.name_lower), m.in_args, ) self.generate_args( "_%s_method_info_%s_OUT_ARG" % (i.name_lower, m.name_lower), m.out_args, ) num_anno = self.generate_annotations( "_%s_method_%s_annotation_info" % (i.name_lower, m.name_lower), m.annotations, ) self.outfile.write( "static const _ExtendedGDBusMethodInfo _%s_method_info_%s =\n" "{\n" " {\n" " -1,\n" ' (gchar *) "%s",\n' % (i.name_lower, m.name_lower, m.name) ) if len(m.in_args) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusArgInfo **) &_%s_method_info_%s_IN_ARG_pointers,\n" % (i.name_lower, m.name_lower) ) if len(m.out_args) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusArgInfo **) &_%s_method_info_%s_OUT_ARG_pointers,\n" % (i.name_lower, m.name_lower) ) if num_anno == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &_%s_method_%s_annotation_info_pointers\n" % (i.name_lower, m.name_lower) ) self.outfile.write( " },\n" ' "handle-%s",\n' " %s\n" % (m.name_hyphen, "TRUE" if m.unix_fd else "FALSE") ) self.outfile.write("};\n" "\n") self.outfile.write( "static const GDBusMethodInfo * const _%s_method_info_pointers[] =\n" "{\n" % (i.name_lower) ) for m in i.methods: self.outfile.write( " &_%s_method_info_%s.parent_struct,\n" % (i.name_lower, m.name_lower) ) self.outfile.write(" NULL\n" "};\n" "\n") # --- if len(i.signals) > 0: for s in i.signals: self.generate_args( "_%s_signal_info_%s_ARG" % (i.name_lower, s.name_lower), s.args ) num_anno = self.generate_annotations( "_%s_signal_%s_annotation_info" % (i.name_lower, s.name_lower), s.annotations, ) self.outfile.write( "static const _ExtendedGDBusSignalInfo _%s_signal_info_%s =\n" "{\n" " {\n" " -1,\n" ' (gchar *) "%s",\n' % (i.name_lower, s.name_lower, s.name) ) if len(s.args) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusArgInfo **) &_%s_signal_info_%s_ARG_pointers,\n" % (i.name_lower, s.name_lower) ) if num_anno == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &_%s_signal_%s_annotation_info_pointers\n" % (i.name_lower, s.name_lower) ) self.outfile.write(" },\n" ' "%s"\n' % (s.name_hyphen)) self.outfile.write("};\n" "\n") self.outfile.write( "static const GDBusSignalInfo * const _%s_signal_info_pointers[] =\n" "{\n" % (i.name_lower) ) for s in i.signals: self.outfile.write( " &_%s_signal_info_%s.parent_struct,\n" % (i.name_lower, s.name_lower) ) self.outfile.write(" NULL\n" "};\n" "\n") # --- if len(i.properties) > 0: for p in i.properties: if p.readable and p.writable: access = "G_DBUS_PROPERTY_INFO_FLAGS_READABLE | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE" elif p.readable: access = "G_DBUS_PROPERTY_INFO_FLAGS_READABLE" elif p.writable: access = "G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE" else: access = "G_DBUS_PROPERTY_INFO_FLAGS_NONE" num_anno = self.generate_annotations( "_%s_property_%s_annotation_info" % (i.name_lower, p.name_lower), p.annotations, ) self.outfile.write( "static const _ExtendedGDBusPropertyInfo _%s_property_info_%s =\n" "{\n" " {\n" " -1,\n" ' (gchar *) "%s",\n' ' (gchar *) "%s",\n' " %s,\n" % (i.name_lower, p.name_lower, p.name, p.arg.signature, access) ) if num_anno == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &_%s_property_%s_annotation_info_pointers\n" % (i.name_lower, p.name_lower) ) self.outfile.write(" },\n" ' "%s",\n' % (p.name_hyphen)) if not utils.lookup_annotation( p.annotations, "org.gtk.GDBus.C.ForceGVariant" ): self.outfile.write(" FALSE,\n") else: self.outfile.write(" TRUE,\n") if p.emits_changed_signal: self.outfile.write(" TRUE\n") else: self.outfile.write(" FALSE\n") self.outfile.write("};\n" "\n") self.outfile.write( "static const GDBusPropertyInfo * const _%s_property_info_pointers[] =\n" "{\n" % (i.name_lower) ) for p in i.properties: self.outfile.write( " &_%s_property_info_%s.parent_struct,\n" % (i.name_lower, p.name_lower) ) self.outfile.write(" NULL\n" "};\n" "\n") num_anno = self.generate_annotations( "_%s_annotation_info" % (i.name_lower), i.annotations ) self.outfile.write( "static const _ExtendedGDBusInterfaceInfo _%s_interface_info =\n" "{\n" " {\n" " -1,\n" ' (gchar *) "%s",\n' % (i.name_lower, i.name) ) if len(i.methods) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusMethodInfo **) &_%s_method_info_pointers,\n" % (i.name_lower) ) if len(i.signals) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusSignalInfo **) &_%s_signal_info_pointers,\n" % (i.name_lower) ) if len(i.properties) == 0: self.outfile.write(" NULL,\n") else: self.outfile.write( " (GDBusPropertyInfo **) &_%s_property_info_pointers,\n" % (i.name_lower) ) if num_anno == 0: self.outfile.write(" NULL\n") else: self.outfile.write( " (GDBusAnnotationInfo **) &_%s_annotation_info_pointers\n" % (i.name_lower) ) self.outfile.write(" },\n" ' "%s",\n' "};\n" "\n" % (i.name_hyphen)) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_interface_info:\n" " *\n" " * Gets a machine-readable description of the #%s D-Bus interface.\n" " *\n" " * Returns: (transfer none): A #GDBusInterfaceInfo. Do not free.\n" % (i.name_lower, i.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "GDBusInterfaceInfo *\n" "%s_interface_info (void)\n" "{\n" " return (GDBusInterfaceInfo *) &_%s_interface_info.parent_struct;\n" "}\n" "\n" % (i.name_lower, i.name_lower) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_override_properties:\n" " * @klass: The class structure for a #GObject derived class.\n" " * @property_id_begin: The property id to assign to the first overridden property.\n" " *\n" " * Overrides all #GObject properties in the #%s interface for a concrete class.\n" " * The properties are overridden in the order they are defined.\n" " *\n" " * Returns: The last property id.\n" % (i.name_lower, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "guint\n" "%s_override_properties (GObjectClass *klass" % (i.name_lower) ) if len(i.properties) == 0: self.outfile.write(" G_GNUC_UNUSED") self.outfile.write(", guint property_id_begin)\n" "{\n") for p in i.properties: self.outfile.write( ' g_object_class_override_property (klass, property_id_begin++, "%s");\n' % (p.name_hyphen) ) self.outfile.write(" return property_id_begin - 1;\n" "}\n" "\n") self.outfile.write("\n") # ---------------------------------------------------------------------------------------------------- def generate_interface(self, i): self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s:\n" " *\n" " * Abstract interface type for the D-Bus interface #%s.\n" % (i.camel_name, i.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sIface:\n" " * @parent_iface: The parent interface.\n" % (i.camel_name), False, ) ) doc_bits = {} if len(i.methods) > 0: for m in i.methods: key = (m.since, "_method_%s" % m.name_lower) value = "@handle_%s: " % (m.name_lower) value += "Handler for the #%s::handle-%s signal." % ( i.camel_name, m.name_hyphen, ) doc_bits[key] = value if len(i.signals) > 0: for s in i.signals: key = (s.since, "_signal_%s" % s.name_lower) value = "@%s: " % (s.name_lower) value += "Handler for the #%s::%s signal." % ( i.camel_name, s.name_hyphen, ) doc_bits[key] = value if len(i.properties) > 0: for p in i.properties: key = (p.since, "_prop_get_%s" % p.name_lower) value = "@get_%s: " % (p.name_lower) value += "Getter for the #%s:%s property." % ( i.camel_name, p.name_hyphen, ) doc_bits[key] = value for key in sorted(doc_bits.keys(), key=utils.version_cmp_key): self.outfile.write(" * %s\n" % doc_bits[key]) self.outfile.write( self.docbook_gen.expand( " *\n" " * Virtual table for the D-Bus interface #%s.\n" % (i.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( "typedef %sIface %sInterface;\n" % (i.camel_name, i.camel_name) ) self.outfile.write( "G_DEFINE_INTERFACE (%s, %s, G_TYPE_OBJECT)\n" % (i.camel_name, i.name_lower) ) self.outfile.write("\n") self.outfile.write( "static void\n" "%s_default_init (%sIface *iface" % (i.name_lower, i.camel_name) ) if len(i.methods) == 0 and len(i.signals) == 0 and len(i.properties) == 0: self.outfile.write(" G_GNUC_UNUSED)\n") else: self.outfile.write(")\n") self.outfile.write("{\n") if len(i.methods) > 0: self.outfile.write( " /* GObject signals for incoming D-Bus method calls: */\n" ) for m in i.methods: self.outfile.write( self.docbook_gen.expand( " /**\n" " * %s::handle-%s:\n" " * @object: A #%s.\n" " * @invocation: A #GDBusMethodInvocation.\n" % (i.camel_name, m.name_hyphen, i.camel_name), False, ) ) if m.unix_fd: self.outfile.write( " * @fd_list: (nullable): A #GUnixFDList or %NULL.\n" ) for a in m.in_args: self.outfile.write( " * @arg_%s: Argument passed by remote caller.\n" % (a.name) ) self.outfile.write( self.docbook_gen.expand( " *\n" " * Signal emitted when a remote caller is invoking the %s.%s() D-Bus method.\n" " *\n" " * If a signal handler returns %%TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call %s_complete_%s() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %%G_DBUS_ERROR_UNKNOWN_METHOD error is returned.\n" " *\n" " * Returns: %%G_DBUS_METHOD_INVOCATION_HANDLED or %%TRUE if the invocation was handled, %%G_DBUS_METHOD_INVOCATION_UNHANDLED or %%FALSE to let other signal handlers run.\n" % (i.name, m.name, i.name_lower, m.name_lower), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(m, self.outfile, 2) if m.unix_fd: extra_args = 2 else: extra_args = 1 self.outfile.write( ' g_signal_new ("handle-%s",\n' " G_TYPE_FROM_INTERFACE (iface),\n" " G_SIGNAL_RUN_LAST,\n" " G_STRUCT_OFFSET (%sIface, handle_%s),\n" " g_signal_accumulator_true_handled,\n" " NULL,\n" # accu_data " g_cclosure_marshal_generic,\n" " G_TYPE_BOOLEAN,\n" " %d,\n" " G_TYPE_DBUS_METHOD_INVOCATION" % ( m.name_hyphen, i.camel_name, m.name_lower, len(m.in_args) + extra_args, ) ) if m.unix_fd: self.outfile.write(", G_TYPE_UNIX_FD_LIST") for a in m.in_args: self.outfile.write(", %s" % (a.gtype)) self.outfile.write(");\n") self.outfile.write("\n") if len(i.signals) > 0: self.outfile.write(" /* GObject signals for received D-Bus signals: */\n") for s in i.signals: self.outfile.write( self.docbook_gen.expand( " /**\n" " * %s::%s:\n" " * @object: A #%s.\n" % (i.camel_name, s.name_hyphen, i.camel_name), False, ) ) for a in s.args: self.outfile.write(" * @arg_%s: Argument.\n" % (a.name)) self.outfile.write( self.docbook_gen.expand( " *\n" " * On the client-side, this signal is emitted whenever the D-Bus signal #%s::%s is received.\n" " *\n" " * On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.\n" % (i.name, s.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(s, self.outfile, 2) self.outfile.write( ' g_signal_new ("%s",\n' " G_TYPE_FROM_INTERFACE (iface),\n" " G_SIGNAL_RUN_LAST,\n" " G_STRUCT_OFFSET (%sIface, %s),\n" " NULL,\n" # accumulator " NULL,\n" # accu_data " g_cclosure_marshal_generic,\n" " G_TYPE_NONE,\n" " %d" % (s.name_hyphen, i.camel_name, s.name_lower, len(s.args)) ) for a in s.args: self.outfile.write(", %s" % (a.gtype)) self.outfile.write(");\n") self.outfile.write("\n") if len(i.properties) > 0: self.outfile.write(" /* GObject properties for D-Bus properties: */\n") for p in i.properties: if p.readable and p.writable: hint = "Since the D-Bus property for this #GObject property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side." elif p.readable: hint = "Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side." elif p.writable: hint = "Since the D-Bus property for this #GObject property is writable but not readable, it is meaningful to write to it on both the client- and service-side. It is only meaningful, however, to read from it on the service-side." else: print_error( 'Cannot handle property "{}" that neither readable nor writable'.format( p.name ) ) self.outfile.write( self.docbook_gen.expand( " /**\n" " * %s:%s:\n" " *\n" " * Represents the D-Bus property #%s:%s.\n" " *\n" " * %s\n" % (i.camel_name, p.name_hyphen, i.name, p.name, hint), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(p, self.outfile, 2) self.outfile.write(" g_object_interface_install_property (iface,\n") if p.arg.gtype == "G_TYPE_VARIANT": s = ( 'g_param_spec_variant ("%s", "%s", "%s", G_VARIANT_TYPE ("%s"), NULL' % (p.name_hyphen, p.name, p.name, p.arg.signature) ) elif p.arg.signature == "b": s = 'g_param_spec_boolean ("%s", "%s", "%s", FALSE' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "y": s = 'g_param_spec_uchar ("%s", "%s", "%s", 0, 255, 0' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "n": s = ( 'g_param_spec_int ("%s", "%s", "%s", G_MININT16, G_MAXINT16, 0' % (p.name_hyphen, p.name, p.name) ) elif p.arg.signature == "q": s = 'g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT16, 0' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "i": s = ( 'g_param_spec_int ("%s", "%s", "%s", G_MININT32, G_MAXINT32, 0' % (p.name_hyphen, p.name, p.name) ) elif p.arg.signature == "u": s = 'g_param_spec_uint ("%s", "%s", "%s", 0, G_MAXUINT32, 0' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "x": s = ( 'g_param_spec_int64 ("%s", "%s", "%s", G_MININT64, G_MAXINT64, 0' % (p.name_hyphen, p.name, p.name) ) elif p.arg.signature == "t": s = 'g_param_spec_uint64 ("%s", "%s", "%s", 0, G_MAXUINT64, 0' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "d": s = ( 'g_param_spec_double ("%s", "%s", "%s", -G_MAXDOUBLE, G_MAXDOUBLE, 0.0' % (p.name_hyphen, p.name, p.name) ) elif p.arg.signature == "s": s = 'g_param_spec_string ("%s", "%s", "%s", NULL' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "o": s = 'g_param_spec_string ("%s", "%s", "%s", NULL' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "g": s = 'g_param_spec_string ("%s", "%s", "%s", NULL' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "ay": s = 'g_param_spec_string ("%s", "%s", "%s", NULL' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "as": s = 'g_param_spec_boxed ("%s", "%s", "%s", G_TYPE_STRV' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "ao": s = 'g_param_spec_boxed ("%s", "%s", "%s", G_TYPE_STRV' % ( p.name_hyphen, p.name, p.name, ) elif p.arg.signature == "aay": s = 'g_param_spec_boxed ("%s", "%s", "%s", G_TYPE_STRV' % ( p.name_hyphen, p.name, p.name, ) else: print_error( 'Unsupported gtype "{}" for GParamSpec'.format(p.arg.gtype) ) flags = "G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS" if p.deprecated: flags = "G_PARAM_DEPRECATED | " + flags self.outfile.write(" %s, %s));" % (s, flags)) self.outfile.write("\n") self.outfile.write("}\n" "\n") # ---------------------------------------------------------------------------------------------------- def generate_property_accessors(self, i): for p in i.properties: # getter if p.readable and p.writable: hint = "Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side." elif p.readable: hint = "Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side." elif p.writable: hint = "Since this D-Bus property is not readable, it is only meaningful to use this function on the service-side." else: print_error( 'Cannot handle property "{}" that neither readable nor writable'.format( p.name ) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_get_%s: (skip)\n" " * @object: A #%s.\n" " *\n" " * Gets the value of the #%s:%s D-Bus property.\n" " *\n" " * %s\n" " *\n" % (i.name_lower, p.name_lower, i.camel_name, i.name, p.name, hint), False, ) ) if p.arg.free_func is not None: self.outfile.write( " * The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use %s_dup_%s() if on another thread.\n" " *\n" " * Returns: (transfer none) (nullable): The property value or %%NULL if the property is not set. Do not free the returned value, it belongs to @object.\n" % (i.name_lower, p.name_lower) ) else: self.outfile.write(" * Returns: The property value.\n") self.write_gtkdoc_deprecated_and_since_and_close(p, self.outfile, 0) self.outfile.write( "%s\n" "%s_get_%s (%s *object)\n" "{\n" % (p.arg.ctype_in, i.name_lower, p.name_lower, i.camel_name) ) self.outfile.write( " return %s%s_GET_IFACE (object)->get_%s (object);\n" % (i.ns_upper, i.name_upper, p.name_lower) ) self.outfile.write("}\n") self.outfile.write("\n") if p.arg.free_func is not None: self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_dup_%s: (skip)\n" " * @object: A #%s.\n" " *\n" " * Gets a copy of the #%s:%s D-Bus property.\n" " *\n" " * %s\n" " *\n" " * Returns: (transfer full) (nullable): The property value or %%NULL if the property is not set. The returned value should be freed with %s().\n" % ( i.name_lower, p.name_lower, i.camel_name, i.name, p.name, hint, p.arg.free_func, ), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(p, self.outfile, 0) self.outfile.write( "%s\n" "%s_dup_%s (%s *object)\n" "{\n" " %svalue;\n" % ( p.arg.ctype_in_dup, i.name_lower, p.name_lower, i.camel_name, p.arg.ctype_in_dup, ) ) self.outfile.write( ' g_object_get (G_OBJECT (object), "%s", &value, NULL);\n' % (p.name_hyphen) ) self.outfile.write(" return value;\n") self.outfile.write("}\n") self.outfile.write("\n") # setter if p.readable and p.writable: hint = "Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side." elif p.readable: hint = "Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side." elif p.writable: hint = "Since this D-Bus property is writable, it is meaningful to use this function on both the client- and service-side." else: print_error( 'Cannot handle property "{}" that neither readable nor writable'.format( p.name ) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_set_%s: (skip)\n" " * @object: A #%s.\n" " * @value: The value to set.\n" " *\n" " * Sets the #%s:%s D-Bus property to @value.\n" " *\n" " * %s\n" % (i.name_lower, p.name_lower, i.camel_name, i.name, p.name, hint), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(p, self.outfile, 0) self.outfile.write( "void\n" "%s_set_%s (%s *object, %svalue)\n" "{\n" % (i.name_lower, p.name_lower, i.camel_name, p.arg.ctype_in) ) self.outfile.write( ' g_object_set (G_OBJECT (object), "%s", value, NULL);\n' % (p.name_hyphen) ) self.outfile.write("}\n") self.outfile.write("\n") # --------------------------------------------------------------------------------------------------- def generate_signal_emitters(self, i): for s in i.signals: self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_emit_%s:\n" " * @object: A #%s.\n" % (i.name_lower, s.name_lower, i.camel_name), False, ) ) for a in s.args: self.outfile.write( " * @arg_%s: Argument to pass with the signal.\n" % (a.name) ) self.outfile.write( self.docbook_gen.expand( " *\n" " * Emits the #%s::%s D-Bus signal.\n" % (i.name, s.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(s, self.outfile, 0) self.outfile.write( "void\n" "%s_emit_%s (\n" " %s *object" % (i.name_lower, s.name_lower, i.camel_name) ) for a in s.args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) self.outfile.write( ")\n" "{\n" ' g_signal_emit_by_name (object, "%s"' % (s.name_hyphen) ) for a in s.args: self.outfile.write(", arg_%s" % a.name) self.outfile.write(");\n") self.outfile.write("}\n" "\n") # --------------------------------------------------------------------------------------------------- def generate_method_calls(self, i): for m in i.methods: # async begin self.outfile.write( "/**\n" " * %s_call_%s:\n" " * @proxy: A #%sProxy.\n" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write( " * @arg_%s: Argument to pass with the method invocation.\n" % (a.name) ) if self.glib_min_required >= (2, 64): self.outfile.write( " * @call_flags: Flags from the #GDBusCallFlags enumeration. If you want to allow interactive\n" " authorization be sure to set %G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION.\n" ' * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning "infinite") or\n' " -1 to use the proxy default timeout.\n" ) if m.unix_fd: self.outfile.write( " * @fd_list: (nullable): A #GUnixFDList or %NULL.\n" ) self.outfile.write( self.docbook_gen.expand( " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %%NULL.\n" " * @user_data: User data to pass to @callback.\n" " *\n" " * Asynchronously invokes the %s.%s() D-Bus method on @proxy.\n" " * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).\n" " * You can then call %s_call_%s_finish() to get the result of the operation.\n" " *\n" " * See %s_call_%s_sync() for the synchronous, blocking version of this method.\n" % ( i.name, m.name, i.name_lower, m.name_lower, i.name_lower, m.name_lower, ), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(m, self.outfile, 0) self.outfile.write( "void\n" "%s_call_%s (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) if self.glib_min_required >= (2, 64): self.outfile.write( ",\n GDBusCallFlags call_flags" ",\n gint timeout_msec" ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") self.outfile.write( ",\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data)\n" "{\n" ) if m.unix_fd: self.outfile.write( " g_dbus_proxy_call_with_unix_fd_list (G_DBUS_PROXY (proxy),\n" ) else: self.outfile.write(" g_dbus_proxy_call (G_DBUS_PROXY (proxy),\n") self.outfile.write(' "%s",\n' ' g_variant_new ("(' % (m.name)) for a in m.in_args: self.outfile.write("%s" % (a.format_in)) self.outfile.write(')"') for a in m.in_args: self.outfile.write(",\n arg_%s" % (a.name)) self.outfile.write("),\n") if self.glib_min_required >= (2, 64): self.outfile.write(" call_flags,\n" " timeout_msec,\n") else: self.outfile.write(" G_DBUS_CALL_FLAGS_NONE,\n" " -1,\n") if m.unix_fd: self.outfile.write(" fd_list,\n") self.outfile.write( " cancellable,\n" " callback,\n" " user_data);\n" ) self.outfile.write("}\n" "\n") # async finish self.outfile.write( "/**\n" " * %s_call_%s_finish:\n" " * @proxy: A #%sProxy.\n" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.out_args: self.outfile.write( " * @out_%s: (out) (optional)%s: Return location for return parameter or %%NULL to ignore.\n" % (a.name, " " + a.array_annotation if a.array_annotation else "") ) if m.unix_fd: self.outfile.write( " * @out_fd_list: (out) (optional): Return location for a #GUnixFDList or %NULL to ignore.\n" ) self.outfile.write( self.docbook_gen.expand( " * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_call_%s().\n" " * @error: Return location for error or %%NULL.\n" " *\n" " * Finishes an operation started with %s_call_%s().\n" " *\n" " * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set.\n" % (i.name_lower, m.name_lower, i.name_lower, m.name_lower), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(m, self.outfile, 0) self.outfile.write( "gboolean\n" "%s_call_%s_finish (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.out_args: self.outfile.write(",\n %sout_%s" % (a.ctype_out, a.name)) if m.unix_fd: self.outfile.write(",\n GUnixFDList **out_fd_list") self.outfile.write( ",\n" " GAsyncResult *res,\n" " GError **error)\n" "{\n" " GVariant *_ret;\n" ) if m.unix_fd: self.outfile.write( " _ret = g_dbus_proxy_call_with_unix_fd_list_finish (G_DBUS_PROXY (proxy), out_fd_list, res, error);\n" ) else: self.outfile.write( " _ret = g_dbus_proxy_call_finish (G_DBUS_PROXY (proxy), res, error);\n" ) self.outfile.write(" if (_ret == NULL)\n" " goto _out;\n") self.outfile.write(" g_variant_get (_ret,\n" ' "(') for a in m.out_args: self.outfile.write("%s" % (a.format_out)) self.outfile.write(')"') for a in m.out_args: self.outfile.write(",\n out_%s" % (a.name)) self.outfile.write(");\n" " g_variant_unref (_ret);\n") self.outfile.write("_out:\n" " return _ret != NULL;\n" "}\n" "\n") # sync self.outfile.write( "/**\n" " * %s_call_%s_sync:\n" " * @proxy: A #%sProxy.\n" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write( " * @arg_%s: Argument to pass with the method invocation.\n" % (a.name) ) if self.glib_min_required >= (2, 64): self.outfile.write( " * @call_flags: Flags from the #GDBusCallFlags enumeration. If you want to allow interactive\n" " authorization be sure to set %G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION.\n" ' * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning "infinite") or\n' " -1 to use the proxy default timeout.\n" ) if m.unix_fd: self.outfile.write( " * @fd_list: (nullable): A #GUnixFDList or %NULL.\n" ) for a in m.out_args: self.outfile.write( " * @out_%s: (out) (optional)%s: Return location for return parameter or %%NULL to ignore.\n" % (a.name, " " + a.array_annotation if a.array_annotation else "") ) if m.unix_fd: self.outfile.write( " * @out_fd_list: (out): Return location for a #GUnixFDList or %NULL.\n" ) self.outfile.write( self.docbook_gen.expand( " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @error: Return location for error or %%NULL.\n" " *\n" " * Synchronously invokes the %s.%s() D-Bus method on @proxy. The calling thread is blocked until a reply is received.\n" " *\n" " * See %s_call_%s() for the asynchronous version of this method.\n" " *\n" " * Returns: (skip): %%TRUE if the call succeeded, %%FALSE if @error is set.\n" % (i.name, m.name, i.name_lower, m.name_lower), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(m, self.outfile, 0) self.outfile.write( "gboolean\n" "%s_call_%s_sync (\n" " %s *proxy" % (i.name_lower, m.name_lower, i.camel_name) ) for a in m.in_args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) if self.glib_min_required >= (2, 64): self.outfile.write( ",\n GDBusCallFlags call_flags" ",\n gint timeout_msec" ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") for a in m.out_args: self.outfile.write(",\n %sout_%s" % (a.ctype_out, a.name)) if m.unix_fd: self.outfile.write(",\n GUnixFDList **out_fd_list") self.outfile.write( ",\n" " GCancellable *cancellable,\n" " GError **error)\n" "{\n" " GVariant *_ret;\n" ) if m.unix_fd: self.outfile.write( " _ret = g_dbus_proxy_call_with_unix_fd_list_sync (G_DBUS_PROXY (proxy),\n" ) else: self.outfile.write( " _ret = g_dbus_proxy_call_sync (G_DBUS_PROXY (proxy),\n" ) self.outfile.write(' "%s",\n' ' g_variant_new ("(' % (m.name)) for a in m.in_args: self.outfile.write("%s" % (a.format_in)) self.outfile.write(')"') for a in m.in_args: self.outfile.write(",\n arg_%s" % (a.name)) self.outfile.write("),\n") if self.glib_min_required >= (2, 64): self.outfile.write(" call_flags,\n" " timeout_msec,\n") else: self.outfile.write(" G_DBUS_CALL_FLAGS_NONE,\n" " -1,\n") if m.unix_fd: self.outfile.write(" fd_list,\n" " out_fd_list,\n") self.outfile.write( " cancellable,\n" " error);\n" " if (_ret == NULL)\n" " goto _out;\n" ) self.outfile.write(" g_variant_get (_ret,\n" ' "(') for a in m.out_args: self.outfile.write("%s" % (a.format_out)) self.outfile.write(')"') for a in m.out_args: self.outfile.write(",\n out_%s" % (a.name)) self.outfile.write(");\n" " g_variant_unref (_ret);\n") self.outfile.write("_out:\n" " return _ret != NULL;\n" "}\n" "\n") # --------------------------------------------------------------------------------------------------- def generate_method_completers(self, i): for m in i.methods: self.outfile.write( "/**\n" " * %s_complete_%s:\n" " * @object: A #%s.\n" " * @invocation: (transfer full): A #GDBusMethodInvocation.\n" % (i.name_lower, m.name_lower, i.camel_name) ) if m.unix_fd: self.outfile.write( " * @fd_list: (nullable): A #GUnixFDList or %NULL.\n" ) for a in m.out_args: self.outfile.write(" * @%s: Parameter to return.\n" % (a.name)) self.outfile.write( self.docbook_gen.expand( " *\n" " * Helper function used in service implementations to finish handling invocations of the %s.%s() D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.\n" " *\n" " * This method will free @invocation, you cannot use it afterwards.\n" % (i.name, m.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(m, self.outfile, 0) self.outfile.write( "void\n" "%s_complete_%s (\n" " %s *object G_GNUC_UNUSED,\n" " GDBusMethodInvocation *invocation" % (i.name_lower, m.name_lower, i.camel_name) ) if m.unix_fd: self.outfile.write(",\n GUnixFDList *fd_list") for a in m.out_args: self.outfile.write(",\n %s%s" % (a.ctype_in, a.name)) self.outfile.write(")\n" "{\n") if m.unix_fd: self.outfile.write( " g_dbus_method_invocation_return_value_with_unix_fd_list (invocation,\n" ' g_variant_new ("(' ) else: self.outfile.write( " g_dbus_method_invocation_return_value (invocation,\n" ' g_variant_new ("(' ) for a in m.out_args: self.outfile.write("%s" % (a.format_in)) self.outfile.write(')"') for a in m.out_args: self.outfile.write(",\n %s" % (a.name)) if m.unix_fd: self.outfile.write("),\n fd_list);\n") else: self.outfile.write("));\n") self.outfile.write("}\n" "\n") # --------------------------------------------------------------------------------------------------- def generate_proxy(self, i): # class boilerplate self.outfile.write( "/* ------------------------------------------------------------------------ */\n" "\n" ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sProxy:\n" " *\n" " * The #%sProxy structure contains only private data and should only be accessed using the provided API.\n" % (i.camel_name, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sProxyClass:\n" " * @parent_class: The parent class.\n" " *\n" " * Class structure for #%sProxy.\n" % (i.camel_name, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( "struct _%sProxyPrivate\n" "{\n" " GData *qdata;\n" "};\n" "\n" % i.camel_name ) self.outfile.write( "static void %s_proxy_iface_init (%sIface *iface);\n" "\n" % (i.name_lower, i.camel_name) ) self.outfile.write("#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38\n") self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sProxy, %s_proxy, G_TYPE_DBUS_PROXY,\n" % (i.camel_name, i.name_lower) ) self.outfile.write( " G_ADD_PRIVATE (%sProxy)\n" % (i.camel_name) ) self.outfile.write( " G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_proxy_iface_init))\n\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write("#else\n") self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sProxy, %s_proxy, G_TYPE_DBUS_PROXY,\n" % (i.camel_name, i.name_lower) ) self.outfile.write( " G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_proxy_iface_init))\n\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write("#endif\n") # finalize self.outfile.write( "static void\n" "%s_proxy_finalize (GObject *object)\n" "{\n" % (i.name_lower) ) self.outfile.write( " %sProxy *proxy = %s%s_PROXY (object);\n" % (i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write(" g_datalist_clear (&proxy->priv->qdata);\n") self.outfile.write( " G_OBJECT_CLASS (%s_proxy_parent_class)->finalize (object);\n" "}\n" "\n" % (i.name_lower) ) # property accessors # # Note that we are guaranteed that prop_id starts at 1 and is # laid out in the same order as introspection data pointers # self.outfile.write( "static void\n" "%s_proxy_get_property (GObject *object" % (i.name_lower) ) if len(i.properties) == 0: self.outfile.write( " G_GNUC_UNUSED,\n" " guint prop_id G_GNUC_UNUSED,\n" " GValue *value G_GNUC_UNUSED,\n" ) else: self.outfile.write( ",\n" " guint prop_id,\n" " GValue *value,\n" ) self.outfile.write(" GParamSpec *pspec G_GNUC_UNUSED)\n" "{\n") if len(i.properties) > 0: self.outfile.write( " const _ExtendedGDBusPropertyInfo *info;\n" " GVariant *variant;\n" " g_assert (prop_id != 0 && prop_id - 1 < %d);\n" " info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1];\n" " variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (object), info->parent_struct.name);\n" " if (info->use_gvariant)\n" " {\n" " g_value_set_variant (value, variant);\n" " }\n" " else\n" " {\n" # could be that we don't have the value in cache - in that case, we do # nothing and the user gets the default value for the GType " if (variant != NULL)\n" " g_dbus_gvariant_to_gvalue (variant, value);\n" " }\n" " if (variant != NULL)\n" " g_variant_unref (variant);\n" % (len(i.properties), i.name_lower) ) self.outfile.write("}\n" "\n") if len(i.properties) > 0: self.outfile.write( "static void\n" "%s_proxy_set_property_cb (GDBusProxy *proxy,\n" " GAsyncResult *res,\n" " gpointer user_data)\n" "{\n" % (i.name_lower) ) self.outfile.write( " const _ExtendedGDBusPropertyInfo *info = user_data;\n" " GError *error;\n" " GVariant *_ret;\n" " error = NULL;\n" " _ret = g_dbus_proxy_call_finish (proxy, res, &error);\n" " if (!_ret)\n" " {\n" " g_warning (\"Error setting property '%%s' on interface %s: %%s (%%s, %%d)\",\n" " info->parent_struct.name, \n" " error->message, g_quark_to_string (error->domain), error->code);\n" " g_error_free (error);\n" " }\n" " else\n" " {\n" " g_variant_unref (_ret);\n" " }\n" % (i.name) ) self.outfile.write("}\n" "\n") self.outfile.write("static void\n" "%s_proxy_set_property (" % (i.name_lower)) if len(i.properties) == 0: self.outfile.write( "GObject *object G_GNUC_UNUSED,\n" " guint prop_id G_GNUC_UNUSED,\n" " const GValue *value G_GNUC_UNUSED,\n" ) else: self.outfile.write( "GObject *object,\n" " guint prop_id,\n" " const GValue *value,\n" ) self.outfile.write(" GParamSpec *pspec G_GNUC_UNUSED)\n" "{\n") if len(i.properties) > 0: self.outfile.write( " const _ExtendedGDBusPropertyInfo *info;\n" " GVariant *variant;\n" " g_assert (prop_id != 0 && prop_id - 1 < %d);\n" " info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1];\n" " variant = g_dbus_gvalue_to_gvariant (value, G_VARIANT_TYPE (info->parent_struct.signature));\n" " g_dbus_proxy_call (G_DBUS_PROXY (object),\n" ' "org.freedesktop.DBus.Properties.Set",\n' ' g_variant_new ("(ssv)", "%s", info->parent_struct.name, variant),\n' " G_DBUS_CALL_FLAGS_NONE,\n" " -1,\n" " NULL, (GAsyncReadyCallback) %s_proxy_set_property_cb, (GDBusPropertyInfo *) &info->parent_struct);\n" " g_variant_unref (variant);\n" % (len(i.properties), i.name_lower, i.name, i.name_lower) ) self.outfile.write("}\n" "\n") # signal received self.outfile.write( "static void\n" "%s_proxy_g_signal (GDBusProxy *proxy,\n" " const gchar *sender_name G_GNUC_UNUSED,\n" " const gchar *signal_name,\n" " GVariant *parameters)\n" "{\n" % (i.name_lower) ) self.outfile.write( " _ExtendedGDBusSignalInfo *info;\n" " GVariantIter iter;\n" " GVariant *child;\n" " GValue *paramv;\n" " gsize num_params;\n" " gsize n;\n" " guint signal_id;\n" ) # Note: info could be NULL if we are talking to a newer version of the interface self.outfile.write( " info = (_ExtendedGDBusSignalInfo *) g_dbus_interface_info_lookup_signal ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, signal_name);\n" " if (info == NULL)\n" " return;\n" % (i.name_lower) ) self.outfile.write( " num_params = g_variant_n_children (parameters);\n" " paramv = g_new0 (GValue, num_params + 1);\n" " g_value_init (¶mv[0], %sTYPE_%s);\n" " g_value_set_object (¶mv[0], proxy);\n" % (i.ns_upper, i.name_upper) ) self.outfile.write( " g_variant_iter_init (&iter, parameters);\n" " n = 1;\n" " while ((child = g_variant_iter_next_value (&iter)) != NULL)\n" " {\n" " _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.args[n - 1];\n" " if (arg_info->use_gvariant)\n" " {\n" " g_value_init (¶mv[n], G_TYPE_VARIANT);\n" " g_value_set_variant (¶mv[n], child);\n" " n++;\n" " }\n" " else\n" " g_dbus_gvariant_to_gvalue (child, ¶mv[n++]);\n" " g_variant_unref (child);\n" " }\n" ) self.outfile.write( " signal_id = g_signal_lookup (info->signal_name, %sTYPE_%s);\n" % (i.ns_upper, i.name_upper) ) self.outfile.write(" g_signal_emitv (paramv, signal_id, 0, NULL);\n") self.outfile.write( " for (n = 0; n < num_params + 1; n++)\n" " g_value_unset (¶mv[n]);\n" " g_free (paramv);\n" ) self.outfile.write("}\n" "\n") # property changed self.outfile.write( "static void\n" "%s_proxy_g_properties_changed (GDBusProxy *_proxy,\n" " GVariant *changed_properties,\n" " const gchar *const *invalidated_properties)\n" "{\n" % (i.name_lower) ) # Note: info could be NULL if we are talking to a newer version of the interface self.outfile.write( " %sProxy *proxy = %s%s_PROXY (_proxy);\n" " guint n;\n" " const gchar *key;\n" " GVariantIter *iter;\n" " _ExtendedGDBusPropertyInfo *info;\n" ' g_variant_get (changed_properties, "a{sv}", &iter);\n' ' while (g_variant_iter_next (iter, "{&sv}", &key, NULL))\n' " {\n" " info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, key);\n" " g_datalist_remove_data (&proxy->priv->qdata, key);\n" " if (info != NULL)\n" " g_object_notify (G_OBJECT (proxy), info->hyphen_name);\n" " }\n" " g_variant_iter_free (iter);\n" " for (n = 0; invalidated_properties[n] != NULL; n++)\n" " {\n" " info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, invalidated_properties[n]);\n" " g_datalist_remove_data (&proxy->priv->qdata, invalidated_properties[n]);\n" " if (info != NULL)\n" " g_object_notify (G_OBJECT (proxy), info->hyphen_name);\n" " }\n" "}\n" "\n" % (i.camel_name, i.ns_upper, i.name_upper, i.name_lower, i.name_lower) ) # property vfuncs for p in i.properties: nul_value = "0" if p.arg.free_func is not None: nul_value = "NULL" self.outfile.write( "static %s\n" "%s_proxy_get_%s (%s *object)\n" "{\n" " %sProxy *proxy = %s%s_PROXY (object);\n" " GVariant *variant;\n" " %svalue = %s;\n" % ( p.arg.ctype_in, i.name_lower, p.name_lower, i.camel_name, i.camel_name, i.ns_upper, i.name_upper, p.arg.ctype_in, nul_value, ) ) # For some property types, we have to free the returned # value (or part of it, e.g. the container) because of how # GVariant works.. see https://bugzilla.gnome.org/show_bug.cgi?id=657100 # for details # free_container = False if ( p.arg.gvariant_get == "g_variant_get_strv" or p.arg.gvariant_get == "g_variant_get_objv" or p.arg.gvariant_get == "g_variant_get_bytestring_array" ): free_container = True # If already using an old value for strv, objv, bytestring_array (see below), # then just return that... that way the result from multiple consecutive calls # to the getter are valid as long as they're freed # if free_container: self.outfile.write( ' value = g_datalist_get_data (&proxy->priv->qdata, "%s");\n' " if (value != NULL)\n" " return value;\n" % (p.name) ) self.outfile.write( ' variant = g_dbus_proxy_get_cached_property (G_DBUS_PROXY (proxy), "%s");\n' % (p.name) ) if p.arg.gtype == "G_TYPE_VARIANT": self.outfile.write(" value = variant;\n") self.outfile.write(" if (variant != NULL)\n") self.outfile.write(" g_variant_unref (variant);\n") else: self.outfile.write(" if (variant != NULL)\n" " {\n") extra_len = "" if ( p.arg.gvariant_get == "g_variant_get_string" or p.arg.gvariant_get == "g_variant_get_strv" or p.arg.gvariant_get == "g_variant_get_objv" or p.arg.gvariant_get == "g_variant_get_bytestring_array" ): extra_len = ", NULL" self.outfile.write( " value = %s (variant%s);\n" % (p.arg.gvariant_get, extra_len) ) if free_container: self.outfile.write( ' g_datalist_set_data_full (&proxy->priv->qdata, "%s", (gpointer) value, g_free);\n' % (p.name) ) self.outfile.write(" g_variant_unref (variant);\n") self.outfile.write(" }\n") self.outfile.write(" return value;\n") self.outfile.write("}\n") self.outfile.write("\n") # class boilerplate self.outfile.write( "static void\n" "%s_proxy_init (%sProxy *proxy)\n" "{\n" "#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38\n" " proxy->priv = %s_proxy_get_instance_private (proxy);\n" "#else\n" " proxy->priv = G_TYPE_INSTANCE_GET_PRIVATE (proxy, %sTYPE_%s_PROXY, %sProxyPrivate);\n" "#endif\n\n" " g_dbus_proxy_set_interface_info (G_DBUS_PROXY (proxy), %s_interface_info ());\n" "}\n" "\n" % ( i.name_lower, i.camel_name, i.name_lower, i.ns_upper, i.name_upper, i.camel_name, i.name_lower, ) ) self.outfile.write( "static void\n" "%s_proxy_class_init (%sProxyClass *klass)\n" "{\n" " GObjectClass *gobject_class;\n" " GDBusProxyClass *proxy_class;\n" "\n" " gobject_class = G_OBJECT_CLASS (klass);\n" " gobject_class->finalize = %s_proxy_finalize;\n" " gobject_class->get_property = %s_proxy_get_property;\n" " gobject_class->set_property = %s_proxy_set_property;\n" "\n" " proxy_class = G_DBUS_PROXY_CLASS (klass);\n" " proxy_class->g_signal = %s_proxy_g_signal;\n" " proxy_class->g_properties_changed = %s_proxy_g_properties_changed;\n" "\n" % ( i.name_lower, i.camel_name, i.name_lower, i.name_lower, i.name_lower, i.name_lower, i.name_lower, ) ) if len(i.properties) > 0: self.outfile.write( " %s_override_properties (gobject_class, 1);\n\n" % (i.name_lower) ) self.outfile.write( "#if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38\n" " g_type_class_add_private (klass, sizeof (%sProxyPrivate));\n" "#endif\n" % (i.camel_name) ) self.outfile.write("}\n" "\n") self.outfile.write( "static void\n" "%s_proxy_iface_init (%sIface *iface" % (i.name_lower, i.camel_name) ) if len(i.properties) == 0: self.outfile.write(" G_GNUC_UNUSED)\n") else: self.outfile.write(")\n") self.outfile.write("{\n") for p in i.properties: self.outfile.write( " iface->get_%s = %s_proxy_get_%s;\n" % (p.name_lower, i.name_lower, p.name_lower) ) self.outfile.write("}\n" "\n") # constructors self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_proxy_new:\n" " * @connection: A #GDBusConnection.\n" " * @flags: Flags from the #GDBusProxyFlags enumeration.\n" " * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection.\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @callback: A #GAsyncReadyCallback to call when the request is satisfied.\n" " * @user_data: User data to pass to @callback.\n" " *\n" " * Asynchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new() for more details.\n" " *\n" " * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).\n" " * You can then call %s_proxy_new_finish() to get the result of the operation.\n" " *\n" " * See %s_proxy_new_sync() for the synchronous, blocking version of this constructor.\n" % (i.name_lower, i.name, i.name_lower, i.name_lower), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "void\n" "%s_proxy_new (\n" " GDBusConnection *connection,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data)\n" "{\n" ' g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL);\n' "}\n" "\n" % (i.name_lower, i.ns_upper, i.name_upper, i.name) ) self.outfile.write( "/**\n" " * %s_proxy_new_finish:\n" " * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new().\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Finishes an operation started with %s_proxy_new().\n" " *\n" " * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set.\n" % (i.name_lower, i.name_lower, i.name_lower, i.camel_name) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *\n" "%s_proxy_new_finish (\n" " GAsyncResult *res,\n" " GError **error)\n" "{\n" " GObject *ret;\n" " GObject *source_object;\n" " source_object = g_async_result_get_source_object (res);\n" " ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error);\n" " g_object_unref (source_object);\n" " if (ret != NULL)\n" " return %s%s (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (i.camel_name, i.name_lower, i.ns_upper, i.name_upper) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_proxy_new_sync:\n" " * @connection: A #GDBusConnection.\n" " * @flags: Flags from the #GDBusProxyFlags enumeration.\n" " * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection.\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Synchronously creates a proxy for the D-Bus interface #%s. See g_dbus_proxy_new_sync() for more details.\n" " *\n" " * The calling thread is blocked until a reply is received.\n" " *\n" " * See %s_proxy_new() for the asynchronous version of this constructor.\n" " *\n" " * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set.\n" % (i.name_lower, i.name, i.name_lower, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *\n" "%s_proxy_new_sync (\n" " GDBusConnection *connection,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error)\n" "{\n" " GInitable *ret;\n" ' ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-connection", connection, "g-object-path", object_path, "g-interface-name", "%s", NULL);\n' " if (ret != NULL)\n" " return %s%s (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % ( i.camel_name, i.name_lower, i.ns_upper, i.name_upper, i.name, i.ns_upper, i.name_upper, ) ) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_proxy_new_for_bus:\n" " * @bus_type: A #GBusType.\n" " * @flags: Flags from the #GDBusProxyFlags enumeration.\n" " * @name: A bus name (well-known or unique).\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @callback: A #GAsyncReadyCallback to call when the request is satisfied.\n" " * @user_data: User data to pass to @callback.\n" " *\n" " * Like %s_proxy_new() but takes a #GBusType instead of a #GDBusConnection.\n" " *\n" " * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).\n" " * You can then call %s_proxy_new_for_bus_finish() to get the result of the operation.\n" " *\n" " * See %s_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.\n" % (i.name_lower, i.name_lower, i.name_lower, i.name_lower), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "void\n" "%s_proxy_new_for_bus (\n" " GBusType bus_type,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data)\n" "{\n" ' g_async_initable_new_async (%sTYPE_%s_PROXY, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL);\n' "}\n" "\n" % (i.name_lower, i.ns_upper, i.name_upper, i.name) ) self.outfile.write( "/**\n" " * %s_proxy_new_for_bus_finish:\n" " * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %s_proxy_new_for_bus().\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Finishes an operation started with %s_proxy_new_for_bus().\n" " *\n" " * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set.\n" % (i.name_lower, i.name_lower, i.name_lower, i.camel_name) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *\n" "%s_proxy_new_for_bus_finish (\n" " GAsyncResult *res,\n" " GError **error)\n" "{\n" " GObject *ret;\n" " GObject *source_object;\n" " source_object = g_async_result_get_source_object (res);\n" " ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error);\n" " g_object_unref (source_object);\n" " if (ret != NULL)\n" " return %s%s (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (i.camel_name, i.name_lower, i.ns_upper, i.name_upper) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_proxy_new_for_bus_sync:\n" " * @bus_type: A #GBusType.\n" " * @flags: Flags from the #GDBusProxyFlags enumeration.\n" " * @name: A bus name (well-known or unique).\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Like %s_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.\n" " *\n" " * The calling thread is blocked until a reply is received.\n" " *\n" " * See %s_proxy_new_for_bus() for the asynchronous version of this constructor.\n" " *\n" " * Returns: (transfer full) (type %sProxy): The constructed proxy object or %%NULL if @error is set.\n" % (i.name_lower, i.name_lower, i.name_lower, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *\n" "%s_proxy_new_for_bus_sync (\n" " GBusType bus_type,\n" " GDBusProxyFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error)\n" "{\n" " GInitable *ret;\n" ' ret = g_initable_new (%sTYPE_%s_PROXY, cancellable, error, "g-flags", flags, "g-name", name, "g-bus-type", bus_type, "g-object-path", object_path, "g-interface-name", "%s", NULL);\n' " if (ret != NULL)\n" " return %s%s (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % ( i.camel_name, i.name_lower, i.ns_upper, i.name_upper, i.name, i.ns_upper, i.name_upper, ) ) self.outfile.write("\n") # --------------------------------------------------------------------------------------------------- def generate_skeleton(self, i): # class boilerplate self.outfile.write( "/* ------------------------------------------------------------------------ */\n" "\n" ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sSkeleton:\n" " *\n" " * The #%sSkeleton structure contains only private data and should only be accessed using the provided API.\n" % (i.camel_name, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sSkeletonClass:\n" " * @parent_class: The parent class.\n" " *\n" " * Class structure for #%sSkeleton.\n" % (i.camel_name, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write("\n") self.outfile.write( "struct _%sSkeletonPrivate\n" "{\n" " GValue *properties;\n" " GList *changed_properties;\n" " GSource *changed_properties_idle_source;\n" " GMainContext *context;\n" " GMutex lock;\n" "};\n" "\n" % i.camel_name ) self.outfile.write( "static void\n" "_%s_skeleton_handle_method_call (\n" " GDBusConnection *connection G_GNUC_UNUSED,\n" " const gchar *sender G_GNUC_UNUSED,\n" " const gchar *object_path G_GNUC_UNUSED,\n" " const gchar *interface_name,\n" " const gchar *method_name,\n" " GVariant *parameters,\n" " GDBusMethodInvocation *invocation,\n" " gpointer user_data)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (user_data);\n" " _ExtendedGDBusMethodInfo *info;\n" " GVariantIter iter;\n" " GVariant *child;\n" " GValue *paramv;\n" " gsize num_params;\n" " guint num_extra;\n" " gsize n;\n" " guint signal_id;\n" " GValue return_value = G_VALUE_INIT;\n" % (i.name_lower, i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( " info = (_ExtendedGDBusMethodInfo *) g_dbus_method_invocation_get_method_info (invocation);\n" " g_assert (info != NULL);\n" ) self.outfile.write( " num_params = g_variant_n_children (parameters);\n" " num_extra = info->pass_fdlist ? 3 : 2;" " paramv = g_new0 (GValue, num_params + num_extra);\n" " n = 0;\n" " g_value_init (¶mv[n], %sTYPE_%s);\n" " g_value_set_object (¶mv[n++], skeleton);\n" " g_value_init (¶mv[n], G_TYPE_DBUS_METHOD_INVOCATION);\n" " g_value_set_object (¶mv[n++], invocation);\n" " if (info->pass_fdlist)\n" " {\n" "#ifdef G_OS_UNIX\n" " g_value_init (¶mv[n], G_TYPE_UNIX_FD_LIST);\n" " g_value_set_object (¶mv[n++], g_dbus_message_get_unix_fd_list (g_dbus_method_invocation_get_message (invocation)));\n" "#else\n" " g_assert_not_reached ();\n" "#endif\n" " }\n" % (i.ns_upper, i.name_upper) ) self.outfile.write( " g_variant_iter_init (&iter, parameters);\n" " while ((child = g_variant_iter_next_value (&iter)) != NULL)\n" " {\n" " _ExtendedGDBusArgInfo *arg_info = (_ExtendedGDBusArgInfo *) info->parent_struct.in_args[n - num_extra];\n" " if (arg_info->use_gvariant)\n" " {\n" " g_value_init (¶mv[n], G_TYPE_VARIANT);\n" " g_value_set_variant (¶mv[n], child);\n" " n++;\n" " }\n" " else\n" " g_dbus_gvariant_to_gvalue (child, ¶mv[n++]);\n" " g_variant_unref (child);\n" " }\n" ) self.outfile.write( " signal_id = g_signal_lookup (info->signal_name, %sTYPE_%s);\n" % (i.ns_upper, i.name_upper) ) self.outfile.write( " g_value_init (&return_value, G_TYPE_BOOLEAN);\n" " g_signal_emitv (paramv, signal_id, 0, &return_value);\n" " if (!g_value_get_boolean (&return_value))\n" ' g_dbus_method_invocation_return_error (invocation, G_DBUS_ERROR, G_DBUS_ERROR_UNKNOWN_METHOD, "Method %s is not implemented on interface %s", method_name, interface_name);\n' " g_value_unset (&return_value);\n" ) self.outfile.write( " for (n = 0; n < num_params + num_extra; n++)\n" " g_value_unset (¶mv[n]);\n" " g_free (paramv);\n" ) self.outfile.write("}\n" "\n") self.outfile.write( "static GVariant *\n" "_%s_skeleton_handle_get_property (\n" " GDBusConnection *connection G_GNUC_UNUSED,\n" " const gchar *sender G_GNUC_UNUSED,\n" " const gchar *object_path G_GNUC_UNUSED,\n" " const gchar *interface_name G_GNUC_UNUSED,\n" " const gchar *property_name,\n" " GError **error,\n" " gpointer user_data)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (user_data);\n" " GValue value = G_VALUE_INIT;\n" " GParamSpec *pspec;\n" " _ExtendedGDBusPropertyInfo *info;\n" " GVariant *ret;\n" % (i.name_lower, i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( " ret = NULL;\n" " info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name);\n" " g_assert (info != NULL);\n" " pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name);\n" " if (pspec == NULL)\n" " {\n" ' g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name);\n' " }\n" " else\n" " {\n" " g_value_init (&value, pspec->value_type);\n" " g_object_get_property (G_OBJECT (skeleton), info->hyphen_name, &value);\n" " ret = g_dbus_gvalue_to_gvariant (&value, G_VARIANT_TYPE (info->parent_struct.signature));\n" " g_value_unset (&value);\n" " }\n" " return ret;\n" "}\n" "\n" % (i.name_lower) ) self.outfile.write( "static gboolean\n" "_%s_skeleton_handle_set_property (\n" " GDBusConnection *connection G_GNUC_UNUSED,\n" " const gchar *sender G_GNUC_UNUSED,\n" " const gchar *object_path G_GNUC_UNUSED,\n" " const gchar *interface_name G_GNUC_UNUSED,\n" " const gchar *property_name,\n" " GVariant *variant,\n" " GError **error,\n" " gpointer user_data)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (user_data);\n" " GValue value = G_VALUE_INIT;\n" " GParamSpec *pspec;\n" " _ExtendedGDBusPropertyInfo *info;\n" " gboolean ret;\n" % (i.name_lower, i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( " ret = FALSE;\n" " info = (_ExtendedGDBusPropertyInfo *) g_dbus_interface_info_lookup_property ((GDBusInterfaceInfo *) &_%s_interface_info.parent_struct, property_name);\n" " g_assert (info != NULL);\n" " pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (skeleton), info->hyphen_name);\n" " if (pspec == NULL)\n" " {\n" ' g_set_error (error, G_DBUS_ERROR, G_DBUS_ERROR_INVALID_ARGS, "No property with name %%s", property_name);\n' " }\n" " else\n" " {\n" " if (info->use_gvariant)\n" " g_value_set_variant (&value, variant);\n" " else\n" " g_dbus_gvariant_to_gvalue (variant, &value);\n" " g_object_set_property (G_OBJECT (skeleton), info->hyphen_name, &value);\n" " g_value_unset (&value);\n" " ret = TRUE;\n" " }\n" " return ret;\n" "}\n" "\n" % (i.name_lower) ) self.outfile.write( "static const GDBusInterfaceVTable _%s_skeleton_vtable =\n" "{\n" " _%s_skeleton_handle_method_call,\n" " _%s_skeleton_handle_get_property,\n" " _%s_skeleton_handle_set_property,\n" " {NULL}\n" "};\n" "\n" % (i.name_lower, i.name_lower, i.name_lower, i.name_lower) ) self.outfile.write( "static GDBusInterfaceInfo *\n" "%s_skeleton_dbus_interface_get_info (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED)\n" "{\n" " return %s_interface_info ();\n" % (i.name_lower, i.name_lower) ) self.outfile.write("}\n" "\n") self.outfile.write( "static GDBusInterfaceVTable *\n" "%s_skeleton_dbus_interface_get_vtable (GDBusInterfaceSkeleton *skeleton G_GNUC_UNUSED)\n" "{\n" " return (GDBusInterfaceVTable *) &_%s_skeleton_vtable;\n" % (i.name_lower, i.name_lower) ) self.outfile.write("}\n" "\n") self.outfile.write( "static GVariant *\n" "%s_skeleton_dbus_interface_get_properties (GDBusInterfaceSkeleton *_skeleton)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (_skeleton);\n" % (i.name_lower, i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( "\n" " GVariantBuilder builder;\n" " guint n;\n" ' g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}"));\n' " if (_%s_interface_info.parent_struct.properties == NULL)\n" " goto out;\n" " for (n = 0; _%s_interface_info.parent_struct.properties[n] != NULL; n++)\n" " {\n" " GDBusPropertyInfo *info = _%s_interface_info.parent_struct.properties[n];\n" " if (info->flags & G_DBUS_PROPERTY_INFO_FLAGS_READABLE)\n" " {\n" " GVariant *value;\n" ' value = _%s_skeleton_handle_get_property (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)), NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", info->name, NULL, skeleton);\n' " if (value != NULL)\n" " {\n" " g_variant_take_ref (value);\n" ' g_variant_builder_add (&builder, "{sv}", info->name, value);\n' " g_variant_unref (value);\n" " }\n" " }\n" " }\n" "out:\n" " return g_variant_builder_end (&builder);\n" "}\n" "\n" % (i.name_lower, i.name_lower, i.name_lower, i.name_lower, i.name) ) if len(i.properties) > 0: self.outfile.write( "static gboolean _%s_emit_changed (gpointer user_data);\n" "\n" % (i.name_lower) ) self.outfile.write( "static void\n" "%s_skeleton_dbus_interface_flush (GDBusInterfaceSkeleton *_skeleton" % (i.name_lower) ) if len(i.properties) == 0: self.outfile.write(" G_GNUC_UNUSED)\n") else: self.outfile.write(")\n") self.outfile.write("{\n") if len(i.properties) > 0: self.outfile.write( " %sSkeleton *skeleton = %s%s_SKELETON (_skeleton);\n" " gboolean emit_changed = FALSE;\n" "\n" " g_mutex_lock (&skeleton->priv->lock);\n" " if (skeleton->priv->changed_properties_idle_source != NULL)\n" " {\n" " g_source_destroy (skeleton->priv->changed_properties_idle_source);\n" " skeleton->priv->changed_properties_idle_source = NULL;\n" " emit_changed = TRUE;\n" " }\n" " g_mutex_unlock (&skeleton->priv->lock);\n" "\n" " if (emit_changed)\n" " _%s_emit_changed (skeleton);\n" % (i.camel_name, i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write("}\n" "\n") for s in i.signals: self.outfile.write( "static void\n" "_%s_on_signal_%s (\n" " %s *object" % (i.name_lower, s.name_lower, i.camel_name) ) for a in s.args: self.outfile.write(",\n %sarg_%s" % (a.ctype_in, a.name)) self.outfile.write( ")\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (object);\n\n" " GList *connections, *l;\n" " GVariant *signal_variant;\n" " connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton));\n" % (i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( "\n" ' signal_variant = g_variant_ref_sink (g_variant_new ("(' ) for a in s.args: self.outfile.write("%s" % (a.format_in)) self.outfile.write(')"') for a in s.args: self.outfile.write(",\n arg_%s" % (a.name)) self.outfile.write("));\n") self.outfile.write( " for (l = connections; l != NULL; l = l->next)\n" " {\n" " GDBusConnection *connection = l->data;\n" " g_dbus_connection_emit_signal (connection,\n" ' NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)), "%s", "%s",\n' " signal_variant, NULL);\n" " }\n" % (i.name, s.name) ) self.outfile.write(" g_variant_unref (signal_variant);\n") self.outfile.write(" g_list_free_full (connections, g_object_unref);\n") self.outfile.write("}\n" "\n") self.outfile.write( "static void %s_skeleton_iface_init (%sIface *iface);\n" % (i.name_lower, i.camel_name) ) self.outfile.write("#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38\n") self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sSkeleton, %s_skeleton, G_TYPE_DBUS_INTERFACE_SKELETON,\n" % (i.camel_name, i.name_lower) ) self.outfile.write( " G_ADD_PRIVATE (%sSkeleton)\n" % (i.camel_name) ) self.outfile.write( " G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_skeleton_iface_init))\n\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write("#else\n") self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sSkeleton, %s_skeleton, G_TYPE_DBUS_INTERFACE_SKELETON,\n" % (i.camel_name, i.name_lower) ) self.outfile.write( " G_IMPLEMENT_INTERFACE (%sTYPE_%s, %s_skeleton_iface_init))\n\n" % (i.ns_upper, i.name_upper, i.name_lower) ) self.outfile.write("#endif\n") # finalize self.outfile.write( "static void\n" "%s_skeleton_finalize (GObject *object)\n" "{\n" % (i.name_lower) ) self.outfile.write( " %sSkeleton *skeleton = %s%s_SKELETON (object);\n" % (i.camel_name, i.ns_upper, i.name_upper) ) if len(i.properties) > 0: self.outfile.write( " guint n;\n" " for (n = 0; n < %d; n++)\n" " g_value_unset (&skeleton->priv->properties[n]);\n" % (len(i.properties)) ) self.outfile.write(" g_free (skeleton->priv->properties);\n") self.outfile.write( " g_list_free_full (skeleton->priv->changed_properties, (GDestroyNotify) _changed_property_free);\n" ) self.outfile.write( " if (skeleton->priv->changed_properties_idle_source != NULL)\n" ) self.outfile.write( " g_source_destroy (skeleton->priv->changed_properties_idle_source);\n" ) self.outfile.write(" g_main_context_unref (skeleton->priv->context);\n") self.outfile.write(" g_mutex_clear (&skeleton->priv->lock);\n") self.outfile.write( " G_OBJECT_CLASS (%s_skeleton_parent_class)->finalize (object);\n" "}\n" "\n" % (i.name_lower) ) # property accessors (TODO: generate PropertiesChanged signals in setter) if len(i.properties) > 0: self.outfile.write( "static void\n" "%s_skeleton_get_property (GObject *object,\n" " guint prop_id,\n" " GValue *value,\n" " GParamSpec *pspec G_GNUC_UNUSED)\n" "{\n" % (i.name_lower) ) self.outfile.write( " %sSkeleton *skeleton = %s%s_SKELETON (object);\n" " g_assert (prop_id != 0 && prop_id - 1 < %d);\n" " g_mutex_lock (&skeleton->priv->lock);\n" " g_value_copy (&skeleton->priv->properties[prop_id - 1], value);\n" " g_mutex_unlock (&skeleton->priv->lock);\n" % (i.camel_name, i.ns_upper, i.name_upper, len(i.properties)) ) self.outfile.write("}\n" "\n") # if property is already scheduled then re-use entry.. though it could be # that the user did # # foo_set_prop_bar (object, ""); # foo_set_prop_bar (object, "blah"); # # say, every update... In this case, where nothing happens, we obviously # don't want a PropertiesChanged() event. We can easily check for this # by comparing against the _original value_ recorded before the first # change event. If the latest value is not different from the original # one, we can simply ignore the ChangedProperty # self.outfile.write( "static gboolean\n" "_%s_emit_changed (gpointer user_data)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (user_data);\n" % (i.name_lower, i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( " GList *l;\n" " GVariantBuilder builder;\n" " GVariantBuilder invalidated_builder;\n" " guint num_changes;\n" "\n" " g_mutex_lock (&skeleton->priv->lock);\n" ' g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}"));\n' ' g_variant_builder_init (&invalidated_builder, G_VARIANT_TYPE ("as"));\n' " for (l = skeleton->priv->changed_properties, num_changes = 0; l != NULL; l = l->next)\n" " {\n" " ChangedProperty *cp = l->data;\n" " GVariant *variant;\n" " const GValue *cur_value;\n" "\n" " cur_value = &skeleton->priv->properties[cp->prop_id - 1];\n" " if (!_g_value_equal (cur_value, &cp->orig_value))\n" " {\n" " variant = g_dbus_gvalue_to_gvariant (cur_value, G_VARIANT_TYPE (cp->info->parent_struct.signature));\n" ' g_variant_builder_add (&builder, "{sv}", cp->info->parent_struct.name, variant);\n' " g_variant_unref (variant);\n" " num_changes++;\n" " }\n" " }\n" " if (num_changes > 0)\n" " {\n" " GList *connections, *ll;\n" " GVariant *signal_variant;" "\n" ' signal_variant = g_variant_ref_sink (g_variant_new ("(sa{sv}as)", "%s",\n' " &builder, &invalidated_builder));\n" " connections = g_dbus_interface_skeleton_get_connections (G_DBUS_INTERFACE_SKELETON (skeleton));\n" " for (ll = connections; ll != NULL; ll = ll->next)\n" " {\n" " GDBusConnection *connection = ll->data;\n" "\n" " g_dbus_connection_emit_signal (connection,\n" " NULL, g_dbus_interface_skeleton_get_object_path (G_DBUS_INTERFACE_SKELETON (skeleton)),\n" ' "org.freedesktop.DBus.Properties",\n' ' "PropertiesChanged",\n' " signal_variant,\n" " NULL);\n" " }\n" " g_variant_unref (signal_variant);\n" " g_list_free_full (connections, g_object_unref);\n" " }\n" " else\n" " {\n" " g_variant_builder_clear (&builder);\n" " g_variant_builder_clear (&invalidated_builder);\n" " }\n" % (i.name) ) self.outfile.write( " g_list_free_full (skeleton->priv->changed_properties, (GDestroyNotify) _changed_property_free);\n" ) self.outfile.write(" skeleton->priv->changed_properties = NULL;\n") self.outfile.write( " skeleton->priv->changed_properties_idle_source = NULL;\n" ) self.outfile.write(" g_mutex_unlock (&skeleton->priv->lock);\n") self.outfile.write(" return FALSE;\n" "}\n" "\n") # holding lock while being called self.outfile.write( "static void\n" "_%s_schedule_emit_changed (%sSkeleton *skeleton, const _ExtendedGDBusPropertyInfo *info, guint prop_id, const GValue *orig_value)\n" "{\n" " ChangedProperty *cp;\n" " GList *l;\n" " cp = NULL;\n" " for (l = skeleton->priv->changed_properties; l != NULL; l = l->next)\n" " {\n" " ChangedProperty *i_cp = l->data;\n" " if (i_cp->info == info)\n" " {\n" " cp = i_cp;\n" " break;\n" " }\n" " }\n" % (i.name_lower, i.camel_name) ) self.outfile.write( " if (cp == NULL)\n" " {\n" " cp = g_new0 (ChangedProperty, 1);\n" " cp->prop_id = prop_id;\n" " cp->info = info;\n" " skeleton->priv->changed_properties = g_list_prepend (skeleton->priv->changed_properties, cp);\n" " g_value_init (&cp->orig_value, G_VALUE_TYPE (orig_value));\n" " g_value_copy (orig_value, &cp->orig_value);\n" " }\n" "}\n" "\n" ) # Postpone setting up the refresh source until the ::notify signal is emitted as # this allows use of g_object_freeze_notify()/g_object_thaw_notify() ... # This is useful when updating several properties from another thread than # where the idle will be emitted from self.outfile.write( "static void\n" "%s_skeleton_notify (GObject *object,\n" " GParamSpec *pspec G_GNUC_UNUSED)\n" "{\n" " %sSkeleton *skeleton = %s%s_SKELETON (object);\n" " g_mutex_lock (&skeleton->priv->lock);\n" " if (skeleton->priv->changed_properties != NULL &&\n" " skeleton->priv->changed_properties_idle_source == NULL)\n" " {\n" " skeleton->priv->changed_properties_idle_source = g_idle_source_new ();\n" " g_source_set_priority (skeleton->priv->changed_properties_idle_source, G_PRIORITY_DEFAULT);\n" " g_source_set_callback (skeleton->priv->changed_properties_idle_source, _%s_emit_changed, g_object_ref (skeleton), (GDestroyNotify) g_object_unref);\n" ' g_source_set_name (skeleton->priv->changed_properties_idle_source, "[generated] _%s_emit_changed");\n' " g_source_attach (skeleton->priv->changed_properties_idle_source, skeleton->priv->context);\n" " g_source_unref (skeleton->priv->changed_properties_idle_source);\n" " }\n" " g_mutex_unlock (&skeleton->priv->lock);\n" "}\n" "\n" % ( i.name_lower, i.camel_name, i.ns_upper, i.name_upper, i.name_lower, i.name_lower, ) ) self.outfile.write( "static void\n" "%s_skeleton_set_property (GObject *object,\n" " guint prop_id,\n" " const GValue *value,\n" " GParamSpec *pspec)\n" "{\n" % (i.name_lower) ) self.outfile.write( " const _ExtendedGDBusPropertyInfo *info;\n" " %sSkeleton *skeleton = %s%s_SKELETON (object);\n" " g_assert (prop_id != 0 && prop_id - 1 < %d);\n" " info = (const _ExtendedGDBusPropertyInfo *) _%s_property_info_pointers[prop_id - 1];\n" " g_mutex_lock (&skeleton->priv->lock);\n" " g_object_freeze_notify (object);\n" " if (!_g_value_equal (value, &skeleton->priv->properties[prop_id - 1]))\n" " {\n" " if (g_dbus_interface_skeleton_get_connection (G_DBUS_INTERFACE_SKELETON (skeleton)) != NULL &&\n" " info->emits_changed_signal)\n" " _%s_schedule_emit_changed (skeleton, info, prop_id, &skeleton->priv->properties[prop_id - 1]);\n" " g_value_copy (value, &skeleton->priv->properties[prop_id - 1]);\n" " g_object_notify_by_pspec (object, pspec);\n" " }\n" " g_mutex_unlock (&skeleton->priv->lock);\n" " g_object_thaw_notify (object);\n" % ( i.camel_name, i.ns_upper, i.name_upper, len(i.properties), i.name_lower, i.name_lower, ) ) self.outfile.write("}\n" "\n") self.outfile.write( "static void\n" "%s_skeleton_init (%sSkeleton *skeleton)\n" "{\n" "#if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38\n" " skeleton->priv = %s_skeleton_get_instance_private (skeleton);\n" "#else\n" " skeleton->priv = G_TYPE_INSTANCE_GET_PRIVATE (skeleton, %sTYPE_%s_SKELETON, %sSkeletonPrivate);\n" "#endif\n\n" % ( i.name_lower, i.camel_name, i.name_lower, i.ns_upper, i.name_upper, i.camel_name, ) ) self.outfile.write(" g_mutex_init (&skeleton->priv->lock);\n") self.outfile.write( " skeleton->priv->context = g_main_context_ref_thread_default ();\n" ) if len(i.properties) > 0: self.outfile.write( " skeleton->priv->properties = g_new0 (GValue, %d);\n" % (len(i.properties)) ) n = 0 for p in i.properties: self.outfile.write( " g_value_init (&skeleton->priv->properties[%d], %s);\n" % (n, p.arg.gtype) ) n += 1 self.outfile.write("}\n" "\n") # property vfuncs n = 0 for p in i.properties: self.outfile.write( "static %s\n" "%s_skeleton_get_%s (%s *object)\n" "{\n" % (p.arg.ctype_in, i.name_lower, p.name_lower, i.camel_name) ) self.outfile.write( " %sSkeleton *skeleton = %s%s_SKELETON (object);\n" % (i.camel_name, i.ns_upper, i.name_upper) ) self.outfile.write( " %svalue;\n" " g_mutex_lock (&skeleton->priv->lock);\n" " value = %s (&(skeleton->priv->properties[%d]));\n" " g_mutex_unlock (&skeleton->priv->lock);\n" % (p.arg.ctype_in_g, p.arg.gvalue_get, n) ) self.outfile.write(" return value;\n") self.outfile.write("}\n") self.outfile.write("\n") n += 1 self.outfile.write( "static void\n" "%s_skeleton_class_init (%sSkeletonClass *klass)\n" "{\n" " GObjectClass *gobject_class;\n" " GDBusInterfaceSkeletonClass *skeleton_class;\n" "\n" " gobject_class = G_OBJECT_CLASS (klass);\n" " gobject_class->finalize = %s_skeleton_finalize;\n" % (i.name_lower, i.camel_name, i.name_lower) ) if len(i.properties) > 0: self.outfile.write( " gobject_class->get_property = %s_skeleton_get_property;\n" " gobject_class->set_property = %s_skeleton_set_property;\n" " gobject_class->notify = %s_skeleton_notify;\n" "\n" % (i.name_lower, i.name_lower, i.name_lower) ) self.outfile.write( "\n" " %s_override_properties (gobject_class, 1);\n" % (i.name_lower) ) self.outfile.write( "\n" " skeleton_class = G_DBUS_INTERFACE_SKELETON_CLASS (klass);\n" ) self.outfile.write( " skeleton_class->get_info = %s_skeleton_dbus_interface_get_info;\n" % (i.name_lower) ) self.outfile.write( " skeleton_class->get_properties = %s_skeleton_dbus_interface_get_properties;\n" % (i.name_lower) ) self.outfile.write( " skeleton_class->flush = %s_skeleton_dbus_interface_flush;\n" % (i.name_lower) ) self.outfile.write( " skeleton_class->get_vtable = %s_skeleton_dbus_interface_get_vtable;\n" % (i.name_lower) ) self.outfile.write( "\n" "#if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38\n" " g_type_class_add_private (klass, sizeof (%sSkeletonPrivate));\n" "#endif\n" % (i.camel_name) ) self.outfile.write("}\n" "\n") self.outfile.write( "static void\n" "%s_skeleton_iface_init (%sIface *iface" % (i.name_lower, i.camel_name) ) if len(i.signals) == 0 and len(i.properties) == 0: self.outfile.write(" G_GNUC_UNUSED)\n") else: self.outfile.write(")\n") self.outfile.write("{\n") for s in i.signals: self.outfile.write( " iface->%s = _%s_on_signal_%s;\n" % (s.name_lower, i.name_lower, s.name_lower) ) for p in i.properties: self.outfile.write( " iface->get_%s = %s_skeleton_get_%s;\n" % (p.name_lower, i.name_lower, p.name_lower) ) self.outfile.write("}\n" "\n") # constructors self.outfile.write( self.docbook_gen.expand( "/**\n" " * %s_skeleton_new:\n" " *\n" " * Creates a skeleton object for the D-Bus interface #%s.\n" " *\n" " * Returns: (transfer full) (type %sSkeleton): The skeleton object.\n" % (i.name_lower, i.name, i.camel_name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *\n" "%s_skeleton_new (void)\n" "{\n" " return %s%s (g_object_new (%sTYPE_%s_SKELETON, NULL));\n" "}\n" "\n" % ( i.camel_name, i.name_lower, i.ns_upper, i.name_upper, i.ns_upper, i.name_upper, ) ) # --------------------------------------------------------------------------------------------------- def generate_object(self): self.outfile.write( "/* ------------------------------------------------------------------------\n" " * Code for Object, ObjectProxy and ObjectSkeleton\n" " * ------------------------------------------------------------------------\n" " */\n" "\n" ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * SECTION:%sObject\n" " * @title: %sObject\n" " * @short_description: Specialized GDBusObject types\n" " *\n" " * This section contains the #%sObject, #%sObjectProxy, and #%sObjectSkeleton types which make it easier to work with objects implementing generated types for D-Bus interfaces.\n" " */\n" % ( self.namespace, self.namespace, self.namespace, self.namespace, self.namespace, ), False, ) ) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObject:\n" " *\n" " * The #%sObject type is a specialized container of interfaces.\n" " */\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectIface:\n" " * @parent_iface: The parent interface.\n" " *\n" " * Virtual table for the #%sObject interface.\n" " */\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write("\n") self.outfile.write( "typedef %sObjectIface %sObjectInterface;\n" % (self.namespace, self.namespace) ) self.outfile.write( "G_DEFINE_INTERFACE_WITH_CODE (%sObject, %sobject, G_TYPE_OBJECT, g_type_interface_add_prerequisite (g_define_type_id, G_TYPE_DBUS_OBJECT);)\n" % (self.namespace, self.ns_lower) ) self.outfile.write("\n") self.outfile.write( "static void\n" "%sobject_default_init (%sObjectIface *iface)\n" "{\n" % (self.ns_lower, self.namespace) ) for i in self.ifaces: self.outfile.write( self.docbook_gen.expand( " /**\n" " * %sObject:%s:\n" " *\n" " * The #%s instance corresponding to the D-Bus interface #%s, if any.\n" " *\n" " * Connect to the #GObject::notify signal to get informed of property changes.\n" % (self.namespace, i.name_hyphen, i.camel_name, i.name), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 2) flags = "G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS" if i.deprecated: flags = "G_PARAM_DEPRECATED | " + flags self.outfile.write( ' g_object_interface_install_property (iface, g_param_spec_object ("%s", "%s", "%s", %sTYPE_%s, %s));\n' "\n" % ( i.name_hyphen, i.name_hyphen, i.name_hyphen, self.ns_upper, i.name_upper, flags, ) ) self.outfile.write("}\n" "\n") for i in self.ifaces: self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_get_%s:\n" " * @object: A #%sObject.\n" " *\n" " * Gets the #%s instance for the D-Bus interface #%s on @object, if any.\n" " *\n" " * Returns: (transfer full) (nullable): A #%s that must be freed with g_object_unref() or %%NULL if @object does not implement the interface.\n" % ( self.ns_lower, i.name_upper.lower(), self.namespace, i.camel_name, i.name, i.camel_name, ), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *%sobject_get_%s (%sObject *object)\n" % (i.camel_name, self.ns_lower, i.name_upper.lower(), self.namespace) ) self.outfile.write( "{\n" " GDBusInterface *ret;\n" ' ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s");\n' " if (ret == NULL)\n" " return NULL;\n" " return %s%s (ret);\n" "}\n" "\n" % (i.name, self.ns_upper, i.name_upper) ) self.outfile.write("\n") for i in self.ifaces: self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_peek_%s: (skip)\n" " * @object: A #%sObject.\n" " *\n" " * Like %sobject_get_%s() but doesn't increase the reference count on the returned object.\n" " *\n" " * It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.\n" " *\n" " * Returns: (transfer none) (nullable): A #%s or %%NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.\n" % ( self.ns_lower, i.name_upper.lower(), self.namespace, self.ns_lower, i.name_upper.lower(), i.camel_name, ), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "%s *%sobject_peek_%s (%sObject *object)\n" % (i.camel_name, self.ns_lower, i.name_upper.lower(), self.namespace) ) self.outfile.write( "{\n" " GDBusInterface *ret;\n" ' ret = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s");\n' " if (ret == NULL)\n" " return NULL;\n" " g_object_unref (ret);\n" " return %s%s (ret);\n" "}\n" "\n" % (i.name, self.ns_upper, i.name_upper) ) self.outfile.write("\n") # shared by ObjectProxy and ObjectSkeleton classes self.outfile.write( "static void\n" "%sobject_notify (GDBusObject *object, GDBusInterface *interface)\n" "{\n" " _ExtendedGDBusInterfaceInfo *info = (_ExtendedGDBusInterfaceInfo *) g_dbus_interface_get_info (interface);\n" " /* info can be NULL if the other end is using a D-Bus interface we don't know\n" " * anything about, for example old generated code in this process talking to\n" " * newer generated code in the other process. */\n" " if (info != NULL)\n" " g_object_notify (G_OBJECT (object), info->hyphen_name);\n" "}\n" "\n" % (self.ns_lower) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectProxy:\n" " *\n" " * The #%sObjectProxy structure contains only private data and should only be accessed using the provided API.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectProxyClass:\n" " * @parent_class: The parent class.\n" " *\n" " * Class structure for #%sObjectProxy.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") # class boilerplate self.outfile.write( "static void\n" "%sobject_proxy__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.ns_lower, self.namespace) ) self.outfile.write( "static void\n" "%sobject_proxy__g_dbus_object_iface_init (GDBusObjectIface *iface)\n" "{\n" " iface->interface_added = %sobject_notify;\n" " iface->interface_removed = %sobject_notify;\n" "}\n" "\n" % (self.ns_lower, self.ns_lower, self.ns_lower) ) self.outfile.write("\n") self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sObjectProxy, %sobject_proxy, G_TYPE_DBUS_OBJECT_PROXY,\n" " G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_proxy__%sobject_iface_init)\n" " G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_proxy__g_dbus_object_iface_init))\n" "\n" % ( self.namespace, self.ns_lower, self.ns_upper, self.ns_lower, self.ns_lower, self.ns_lower, ) ) # class boilerplate self.outfile.write( "static void\n" "%sobject_proxy_init (%sObjectProxy *object G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.namespace) ) self.outfile.write( "static void\n" "%sobject_proxy_set_property (GObject *gobject,\n" " guint prop_id,\n" " const GValue *value G_GNUC_UNUSED,\n" " GParamSpec *pspec)\n" "{\n" " G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);\n" % (self.ns_lower) ) self.outfile.write("}\n" "\n") self.outfile.write( "static void\n" "%sobject_proxy_get_property (GObject *gobject,\n" " guint prop_id,\n" " GValue *value,\n" " GParamSpec *pspec)\n" "{\n" " %sObjectProxy *object = %sOBJECT_PROXY (gobject);\n" " GDBusInterface *interface;\n" "\n" " switch (prop_id)\n" " {\n" % (self.ns_lower, self.namespace, self.ns_upper) ) n = 1 for i in self.ifaces: self.outfile.write( " case %d:\n" ' interface = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s");\n' " g_value_take_object (value, interface);\n" " break;\n" "\n" % (n, i.name) ) n += 1 self.outfile.write( " default:\n" " G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);\n" " break;\n" " }\n" "}\n" "\n" ) self.outfile.write( "static void\n" "%sobject_proxy_class_init (%sObjectProxyClass *klass)\n" "{\n" " GObjectClass *gobject_class = G_OBJECT_CLASS (klass);\n" "\n" " gobject_class->set_property = %sobject_proxy_set_property;\n" " gobject_class->get_property = %sobject_proxy_get_property;\n" "\n" % (self.ns_lower, self.namespace, self.ns_lower, self.ns_lower) ) n = 1 for i in self.ifaces: self.outfile.write( ' g_object_class_override_property (gobject_class, %d, "%s");' "\n" % (n, i.name_hyphen) ) n += 1 self.outfile.write("}\n" "\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_proxy_new:\n" " * @connection: A #GDBusConnection.\n" " * @object_path: An object path.\n" " *\n" " * Creates a new proxy object.\n" " *\n" " * Returns: (transfer full): The proxy object.\n" " */\n" % (self.ns_lower), False, ) ) self.outfile.write( "%sObjectProxy *\n" "%sobject_proxy_new (GDBusConnection *connection,\n" " const gchar *object_path)\n" "{\n" " g_return_val_if_fail (G_IS_DBUS_CONNECTION (connection), NULL);\n" " g_return_val_if_fail (g_variant_is_object_path (object_path), NULL);\n" ' return %sOBJECT_PROXY (g_object_new (%sTYPE_OBJECT_PROXY, "g-connection", connection, "g-object-path", object_path, NULL));\n' "}\n" "\n" % (self.namespace, self.ns_lower, self.ns_upper, self.ns_upper) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectSkeleton:\n" " *\n" " * The #%sObjectSkeleton structure contains only private data and should only be accessed using the provided API.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectSkeletonClass:\n" " * @parent_class: The parent class.\n" " *\n" " * Class structure for #%sObjectSkeleton.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") # class boilerplate self.outfile.write( "static void\n" "%sobject_skeleton__%sobject_iface_init (%sObjectIface *iface G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.ns_lower, self.namespace) ) self.outfile.write("\n") self.outfile.write( "static void\n" "%sobject_skeleton__g_dbus_object_iface_init (GDBusObjectIface *iface)\n" "{\n" " iface->interface_added = %sobject_notify;\n" " iface->interface_removed = %sobject_notify;\n" "}\n" "\n" % (self.ns_lower, self.ns_lower, self.ns_lower) ) self.outfile.write( "G_DEFINE_TYPE_WITH_CODE (%sObjectSkeleton, %sobject_skeleton, G_TYPE_DBUS_OBJECT_SKELETON,\n" " G_IMPLEMENT_INTERFACE (%sTYPE_OBJECT, %sobject_skeleton__%sobject_iface_init)\n" " G_IMPLEMENT_INTERFACE (G_TYPE_DBUS_OBJECT, %sobject_skeleton__g_dbus_object_iface_init))\n" "\n" % ( self.namespace, self.ns_lower, self.ns_upper, self.ns_lower, self.ns_lower, self.ns_lower, ) ) # class boilerplate self.outfile.write( "static void\n" "%sobject_skeleton_init (%sObjectSkeleton *object G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.namespace) ) self.outfile.write( "static void\n" "%sobject_skeleton_set_property (GObject *gobject,\n" " guint prop_id,\n" " const GValue *value,\n" " GParamSpec *pspec)\n" "{\n" " %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject);\n" " GDBusInterfaceSkeleton *interface;\n" "\n" " switch (prop_id)\n" " {\n" % (self.ns_lower, self.namespace, self.ns_upper) ) n = 1 for i in self.ifaces: self.outfile.write( " case %d:\n" " interface = g_value_get_object (value);\n" " if (interface != NULL)\n" " {\n" " g_warn_if_fail (%sIS_%s (interface));\n" " g_dbus_object_skeleton_add_interface (G_DBUS_OBJECT_SKELETON (object), interface);\n" " }\n" " else\n" " {\n" ' g_dbus_object_skeleton_remove_interface_by_name (G_DBUS_OBJECT_SKELETON (object), "%s");\n' " }\n" " break;\n" "\n" % (n, self.ns_upper, i.name_upper, i.name) ) n += 1 self.outfile.write( " default:\n" " G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);\n" " break;\n" " }\n" "}\n" "\n" ) self.outfile.write( "static void\n" "%sobject_skeleton_get_property (GObject *gobject,\n" " guint prop_id,\n" " GValue *value,\n" " GParamSpec *pspec)\n" "{\n" " %sObjectSkeleton *object = %sOBJECT_SKELETON (gobject);\n" " GDBusInterface *interface;\n" "\n" " switch (prop_id)\n" " {\n" % (self.ns_lower, self.namespace, self.ns_upper) ) n = 1 for i in self.ifaces: self.outfile.write( " case %d:\n" ' interface = g_dbus_object_get_interface (G_DBUS_OBJECT (object), "%s");\n' " g_value_take_object (value, interface);\n" " break;\n" "\n" % (n, i.name) ) n += 1 self.outfile.write( " default:\n" " G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);\n" " break;\n" " }\n" "}\n" "\n" ) self.outfile.write( "static void\n" "%sobject_skeleton_class_init (%sObjectSkeletonClass *klass)\n" "{\n" " GObjectClass *gobject_class = G_OBJECT_CLASS (klass);\n" "\n" " gobject_class->set_property = %sobject_skeleton_set_property;\n" " gobject_class->get_property = %sobject_skeleton_get_property;\n" "\n" % (self.ns_lower, self.namespace, self.ns_lower, self.ns_lower) ) n = 1 for i in self.ifaces: self.outfile.write( ' g_object_class_override_property (gobject_class, %d, "%s");' "\n" % (n, i.name_hyphen) ) n += 1 self.outfile.write("}\n" "\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_skeleton_new:\n" " * @object_path: An object path.\n" " *\n" " * Creates a new skeleton object.\n" " *\n" " * Returns: (transfer full): The skeleton object.\n" " */\n" % (self.ns_lower), False, ) ) self.outfile.write( "%sObjectSkeleton *\n" "%sobject_skeleton_new (const gchar *object_path)\n" "{\n" " g_return_val_if_fail (g_variant_is_object_path (object_path), NULL);\n" ' return %sOBJECT_SKELETON (g_object_new (%sTYPE_OBJECT_SKELETON, "g-object-path", object_path, NULL));\n' "}\n" "\n" % (self.namespace, self.ns_lower, self.ns_upper, self.ns_upper) ) for i in self.ifaces: self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_skeleton_set_%s:\n" " * @object: A #%sObjectSkeleton.\n" " * @interface_: (nullable): A #%s or %%NULL to clear the interface.\n" " *\n" " * Sets the #%s instance for the D-Bus interface #%s on @object.\n" % ( self.ns_lower, i.name_upper.lower(), self.namespace, i.camel_name, i.camel_name, i.name, ), False, ) ) self.write_gtkdoc_deprecated_and_since_and_close(i, self.outfile, 0) self.outfile.write( "void %sobject_skeleton_set_%s (%sObjectSkeleton *object, %s *interface_)\n" % (self.ns_lower, i.name_upper.lower(), self.namespace, i.camel_name) ) self.outfile.write( "{\n" ' g_object_set (G_OBJECT (object), "%s", interface_, NULL);\n' "}\n" "\n" % (i.name_hyphen) ) self.outfile.write("\n") def generate_object_manager_client(self): self.outfile.write( "/* ------------------------------------------------------------------------\n" " * Code for ObjectManager client\n" " * ------------------------------------------------------------------------\n" " */\n" "\n" ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * SECTION:%sObjectManagerClient\n" " * @title: %sObjectManagerClient\n" " * @short_description: Generated GDBusObjectManagerClient type\n" " *\n" " * This section contains a #GDBusObjectManagerClient that uses %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc.\n" " */\n" % (self.namespace, self.namespace, self.ns_lower), False, ) ) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectManagerClient:\n" " *\n" " * The #%sObjectManagerClient structure contains only private data and should only be accessed using the provided API.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sObjectManagerClientClass:\n" " * @parent_class: The parent class.\n" " *\n" " * Class structure for #%sObjectManagerClient.\n" % (self.namespace, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write("\n") # class boilerplate self.outfile.write( "G_DEFINE_TYPE (%sObjectManagerClient, %sobject_manager_client, G_TYPE_DBUS_OBJECT_MANAGER_CLIENT)\n" "\n" % (self.namespace, self.ns_lower) ) # class boilerplate self.outfile.write( "static void\n" "%sobject_manager_client_init (%sObjectManagerClient *manager G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.namespace) ) self.outfile.write( "static void\n" "%sobject_manager_client_class_init (%sObjectManagerClientClass *klass G_GNUC_UNUSED)\n" "{\n" "}\n" "\n" % (self.ns_lower, self.namespace) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_manager_client_get_proxy_type:\n" " * @manager: A #GDBusObjectManagerClient.\n" " * @object_path: The object path of the remote object (unused).\n" " * @interface_name: (nullable): Interface name of the remote object or %%NULL to get the object proxy #GType.\n" " * @user_data: User data (unused).\n" " *\n" " * A #GDBusProxyTypeFunc that maps @interface_name to the generated #GDBusObjectProxy derived and #GDBusProxy derived types.\n" " *\n" " * Returns: A #GDBusProxy derived #GType if @interface_name is not %%NULL, otherwise the #GType for #%sObjectProxy.\n" % (self.ns_lower, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write( "GType\n" "%sobject_manager_client_get_proxy_type (GDBusObjectManagerClient *manager G_GNUC_UNUSED, const gchar *object_path G_GNUC_UNUSED, const gchar *interface_name, gpointer user_data G_GNUC_UNUSED)\n" "{\n" % (self.ns_lower) ) self.outfile.write( " static gsize once_init_value = 0;\n" " static GHashTable *lookup_hash;\n" " GType ret;\n" "\n" " if (interface_name == NULL)\n" " return %sTYPE_OBJECT_PROXY;\n" " if (g_once_init_enter (&once_init_value))\n" " {\n" " lookup_hash = g_hash_table_new (g_str_hash, g_str_equal);\n" % (self.ns_upper) ) for i in self.ifaces: self.outfile.write( ' g_hash_table_insert (lookup_hash, (gpointer) "%s", GSIZE_TO_POINTER (%sTYPE_%s_PROXY));\n' % (i.name, i.ns_upper, i.name_upper) ) self.outfile.write(" g_once_init_leave (&once_init_value, 1);\n" " }\n") self.outfile.write( " ret = (GType) GPOINTER_TO_SIZE (g_hash_table_lookup (lookup_hash, interface_name));\n" " if (ret == (GType) 0)\n" " ret = G_TYPE_DBUS_PROXY;\n" ) self.outfile.write(" return ret;\n" "}\n" "\n") # constructors self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_manager_client_new:\n" " * @connection: A #GDBusConnection.\n" " * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration.\n" " * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection.\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @callback: A #GAsyncReadyCallback to call when the request is satisfied.\n" " * @user_data: User data to pass to @callback.\n" " *\n" " * Asynchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details.\n" " *\n" " * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).\n" " * You can then call %sobject_manager_client_new_finish() to get the result of the operation.\n" " *\n" " * See %sobject_manager_client_new_sync() for the synchronous, blocking version of this constructor.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.ns_lower), False, ) ) self.outfile.write(" */\n") self.outfile.write( "void\n" "%sobject_manager_client_new (\n" " GDBusConnection *connection,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data)\n" "{\n" ' g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL);\n' "}\n" "\n" % (self.ns_lower, self.ns_upper, self.ns_lower) ) self.outfile.write( "/**\n" " * %sobject_manager_client_new_finish:\n" " * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new().\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Finishes an operation started with %sobject_manager_client_new().\n" " *\n" " * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.namespace) ) self.outfile.write(" */\n") self.outfile.write( "GDBusObjectManager *\n" "%sobject_manager_client_new_finish (\n" " GAsyncResult *res,\n" " GError **error)\n" "{\n" " GObject *ret;\n" " GObject *source_object;\n" " source_object = g_async_result_get_source_object (res);\n" " ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error);\n" " g_object_unref (source_object);\n" " if (ret != NULL)\n" " return G_DBUS_OBJECT_MANAGER (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (self.ns_lower) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_manager_client_new_sync:\n" " * @connection: A #GDBusConnection.\n" " * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration.\n" " * @name: (nullable): A bus name (well-known or unique) or %%NULL if @connection is not a message bus connection.\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Synchronously creates #GDBusObjectManagerClient using %sobject_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details.\n" " *\n" " * The calling thread is blocked until a reply is received.\n" " *\n" " * See %sobject_manager_client_new() for the asynchronous version of this constructor.\n" " *\n" " * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write( "GDBusObjectManager *\n" "%sobject_manager_client_new_sync (\n" " GDBusConnection *connection,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error)\n" "{\n" " GInitable *ret;\n" ' ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "connection", connection, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL);\n' " if (ret != NULL)\n" " return G_DBUS_OBJECT_MANAGER (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (self.ns_lower, self.ns_upper, self.ns_lower) ) self.outfile.write("\n") self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_manager_client_new_for_bus:\n" " * @bus_type: A #GBusType.\n" " * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration.\n" " * @name: A bus name (well-known or unique).\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @callback: A #GAsyncReadyCallback to call when the request is satisfied.\n" " * @user_data: User data to pass to @callback.\n" " *\n" " * Like %sobject_manager_client_new() but takes a #GBusType instead of a #GDBusConnection.\n" " *\n" " * When the operation is finished, @callback will be invoked in the thread-default main loop of the thread you are calling this method from (see g_main_context_push_thread_default()).\n" " * You can then call %sobject_manager_client_new_for_bus_finish() to get the result of the operation.\n" " *\n" " * See %sobject_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.ns_lower), False, ) ) self.outfile.write(" */\n") self.outfile.write( "void\n" "%sobject_manager_client_new_for_bus (\n" " GBusType bus_type,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GAsyncReadyCallback callback,\n" " gpointer user_data)\n" "{\n" ' g_async_initable_new_async (%sTYPE_OBJECT_MANAGER_CLIENT, G_PRIORITY_DEFAULT, cancellable, callback, user_data, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL);\n' "}\n" "\n" % (self.ns_lower, self.ns_upper, self.ns_lower) ) self.outfile.write( "/**\n" " * %sobject_manager_client_new_for_bus_finish:\n" " * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to %sobject_manager_client_new_for_bus().\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Finishes an operation started with %sobject_manager_client_new_for_bus().\n" " *\n" " * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.namespace) ) self.outfile.write(" */\n") self.outfile.write( "GDBusObjectManager *\n" "%sobject_manager_client_new_for_bus_finish (\n" " GAsyncResult *res,\n" " GError **error)\n" "{\n" " GObject *ret;\n" " GObject *source_object;\n" " source_object = g_async_result_get_source_object (res);\n" " ret = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, error);\n" " g_object_unref (source_object);\n" " if (ret != NULL)\n" " return G_DBUS_OBJECT_MANAGER (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (self.ns_lower) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * %sobject_manager_client_new_for_bus_sync:\n" " * @bus_type: A #GBusType.\n" " * @flags: Flags from the #GDBusObjectManagerClientFlags enumeration.\n" " * @name: A bus name (well-known or unique).\n" " * @object_path: An object path.\n" " * @cancellable: (nullable): A #GCancellable or %%NULL.\n" " * @error: Return location for error or %%NULL\n" " *\n" " * Like %sobject_manager_client_new_sync() but takes a #GBusType instead of a #GDBusConnection.\n" " *\n" " * The calling thread is blocked until a reply is received.\n" " *\n" " * See %sobject_manager_client_new_for_bus() for the asynchronous version of this constructor.\n" " *\n" " * Returns: (transfer full) (type %sObjectManagerClient): The constructed object manager client or %%NULL if @error is set.\n" % (self.ns_lower, self.ns_lower, self.ns_lower, self.namespace), False, ) ) self.outfile.write(" */\n") self.outfile.write( "GDBusObjectManager *\n" "%sobject_manager_client_new_for_bus_sync (\n" " GBusType bus_type,\n" " GDBusObjectManagerClientFlags flags,\n" " const gchar *name,\n" " const gchar *object_path,\n" " GCancellable *cancellable,\n" " GError **error)\n" "{\n" " GInitable *ret;\n" ' ret = g_initable_new (%sTYPE_OBJECT_MANAGER_CLIENT, cancellable, error, "flags", flags, "name", name, "bus-type", bus_type, "object-path", object_path, "get-proxy-type-func", %sobject_manager_client_get_proxy_type, NULL);\n' " if (ret != NULL)\n" " return G_DBUS_OBJECT_MANAGER (ret);\n" " else\n" " return NULL;\n" "}\n" "\n" % (self.ns_lower, self.ns_upper, self.ns_lower) ) self.outfile.write("\n") # --------------------------------------------------------------------------------------------------- def write_gtkdoc_deprecated_and_since_and_close(self, obj, f, indent): if len(obj.since) > 0: f.write("%*s *\n" "%*s * Since: %s\n" % (indent, "", indent, "", obj.since)) if obj.deprecated: if isinstance(obj, dbustypes.Interface): thing = "The D-Bus interface" elif isinstance(obj, dbustypes.Method): thing = "The D-Bus method" elif isinstance(obj, dbustypes.Signal): thing = "The D-Bus signal" elif isinstance(obj, dbustypes.Property): thing = "The D-Bus property" else: print_error('Cannot handle object "{}"'.format(obj)) f.write( self.docbook_gen.expand( "%*s *\n" "%*s * Deprecated: %s has been deprecated.\n" % (indent, "", indent, "", thing), False, ) ) f.write("%*s */\n" % (indent, "")) # --------------------------------------------------------------------------------------------------- def generate_interface_intro(self, i): self.outfile.write( "/* ------------------------------------------------------------------------\n" " * Code for interface %s\n" " * ------------------------------------------------------------------------\n" " */\n" "\n" % (i.name) ) self.outfile.write( self.docbook_gen.expand( "/**\n" " * SECTION:%s\n" " * @title: %s\n" " * @short_description: Generated C code for the %s D-Bus interface\n" " *\n" " * This section contains code for working with the #%s D-Bus interface in C.\n" " */\n" % (i.camel_name, i.camel_name, i.name, i.name), False, ) ) self.outfile.write("\n") def generate(self): self.generate_body_preamble() for i in self.ifaces: self.generate_interface_intro(i) self.generate_introspection_for_interface(i) self.generate_interface(i) self.generate_property_accessors(i) self.generate_signal_emitters(i) self.generate_method_calls(i) self.generate_method_completers(i) self.generate_proxy(i) self.generate_skeleton(i) if self.generate_objmanager: self.generate_object() self.generate_object_manager_client() codegen/dbustypes.py 0000644 00000047701 15125157507 0010565 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> from . import utils from .utils import print_error class Annotation: def __init__(self, key, value): self.key = key self.value = value self.annotations = [] self.since = "" def post_process(self, interface_prefix, cns, cns_upper, cns_lower, container): key = self.key overridden_key = utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.Name" ) if utils.is_ugly_case(overridden_key): self.key_lower = overridden_key.lower() else: if overridden_key: key = overridden_key self.key_lower = ( utils.camel_case_to_uscore(key) .lower() .replace("-", "_") .replace(".", "_") ) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if len(self.since) == 0: self.since = container.since for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) class Arg: def __init__(self, name, signature): self.name = name self.signature = signature self.annotations = [] self.doc_string = "" self.since = "" def post_process(self, interface_prefix, cns, cns_upper, cns_lower, arg_number): if len(self.doc_string) == 0: self.doc_string = utils.lookup_docs(self.annotations) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if self.name is None: self.name = "unnamed_arg%d" % arg_number # default to GVariant self.ctype_in_g = "GVariant *" self.ctype_in = "GVariant *" self.ctype_in_dup = "GVariant *" self.ctype_out = "GVariant **" self.gtype = "G_TYPE_VARIANT" self.free_func = "g_variant_unref" self.format_in = "@" + self.signature self.format_out = "@" + self.signature self.gvariant_get = "XXX" self.gvalue_get = "g_value_get_variant" self.array_annotation = "" if not utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.ForceGVariant" ): if self.signature == "b": self.ctype_in_g = "gboolean " self.ctype_in = "gboolean " self.ctype_out = "gboolean *" self.gtype = "G_TYPE_BOOLEAN" self.free_func = None self.format_in = "b" self.format_out = "b" self.gvariant_get = "g_variant_get_boolean" self.gvalue_get = "g_value_get_boolean" elif self.signature == "y": self.ctype_in_g = "guchar " self.ctype_in = "guchar " self.ctype_out = "guchar *" self.gtype = "G_TYPE_UCHAR" self.free_func = None self.format_in = "y" self.format_out = "y" self.gvariant_get = "g_variant_get_byte" self.gvalue_get = "g_value_get_uchar" elif self.signature == "n": self.ctype_in_g = "gint " self.ctype_in = "gint16 " self.ctype_out = "gint16 *" self.gtype = "G_TYPE_INT" self.free_func = None self.format_in = "n" self.format_out = "n" self.gvariant_get = "g_variant_get_int16" self.gvalue_get = "g_value_get_int" elif self.signature == "q": self.ctype_in_g = "guint " self.ctype_in = "guint16 " self.ctype_out = "guint16 *" self.gtype = "G_TYPE_UINT" self.free_func = None self.format_in = "q" self.format_out = "q" self.gvariant_get = "g_variant_get_uint16" self.gvalue_get = "g_value_get_uint" elif self.signature == "i": self.ctype_in_g = "gint " self.ctype_in = "gint " self.ctype_out = "gint *" self.gtype = "G_TYPE_INT" self.free_func = None self.format_in = "i" self.format_out = "i" self.gvariant_get = "g_variant_get_int32" self.gvalue_get = "g_value_get_int" elif self.signature == "u": self.ctype_in_g = "guint " self.ctype_in = "guint " self.ctype_out = "guint *" self.gtype = "G_TYPE_UINT" self.free_func = None self.format_in = "u" self.format_out = "u" self.gvariant_get = "g_variant_get_uint32" self.gvalue_get = "g_value_get_uint" elif self.signature == "x": self.ctype_in_g = "gint64 " self.ctype_in = "gint64 " self.ctype_out = "gint64 *" self.gtype = "G_TYPE_INT64" self.free_func = None self.format_in = "x" self.format_out = "x" self.gvariant_get = "g_variant_get_int64" self.gvalue_get = "g_value_get_int64" elif self.signature == "t": self.ctype_in_g = "guint64 " self.ctype_in = "guint64 " self.ctype_out = "guint64 *" self.gtype = "G_TYPE_UINT64" self.free_func = None self.format_in = "t" self.format_out = "t" self.gvariant_get = "g_variant_get_uint64" self.gvalue_get = "g_value_get_uint64" elif self.signature == "d": self.ctype_in_g = "gdouble " self.ctype_in = "gdouble " self.ctype_out = "gdouble *" self.gtype = "G_TYPE_DOUBLE" self.free_func = None self.format_in = "d" self.format_out = "d" self.gvariant_get = "g_variant_get_double" self.gvalue_get = "g_value_get_double" elif self.signature == "s": self.ctype_in_g = "const gchar *" self.ctype_in = "const gchar *" self.ctype_in_dup = "gchar *" self.ctype_out = "gchar **" self.gtype = "G_TYPE_STRING" self.free_func = "g_free" self.format_in = "s" self.format_out = "s" self.gvariant_get = "g_variant_get_string" self.gvalue_get = "g_value_get_string" elif self.signature == "o": self.ctype_in_g = "const gchar *" self.ctype_in = "const gchar *" self.ctype_in_dup = "gchar *" self.ctype_out = "gchar **" self.gtype = "G_TYPE_STRING" self.free_func = "g_free" self.format_in = "o" self.format_out = "o" self.gvariant_get = "g_variant_get_string" self.gvalue_get = "g_value_get_string" elif self.signature == "g": self.ctype_in_g = "const gchar *" self.ctype_in = "const gchar *" self.ctype_in_dup = "gchar *" self.ctype_out = "gchar **" self.gtype = "G_TYPE_STRING" self.free_func = "g_free" self.format_in = "g" self.format_out = "g" self.gvariant_get = "g_variant_get_string" self.gvalue_get = "g_value_get_string" elif self.signature == "ay": self.ctype_in_g = "const gchar *" self.ctype_in = "const gchar *" self.ctype_in_dup = "gchar *" self.ctype_out = "gchar **" self.gtype = "G_TYPE_STRING" self.free_func = "g_free" self.format_in = "^ay" self.format_out = "^ay" self.gvariant_get = "g_variant_get_bytestring" self.gvalue_get = "g_value_get_string" elif self.signature == "as": self.ctype_in_g = "const gchar *const *" self.ctype_in = "const gchar *const *" self.ctype_in_dup = "gchar **" self.ctype_out = "gchar ***" self.gtype = "G_TYPE_STRV" self.free_func = "g_strfreev" self.format_in = "^as" self.format_out = "^as" self.gvariant_get = "g_variant_get_strv" self.gvalue_get = "g_value_get_boxed" self.array_annotation = "(array zero-terminated=1)" elif self.signature == "ao": self.ctype_in_g = "const gchar *const *" self.ctype_in = "const gchar *const *" self.ctype_in_dup = "gchar **" self.ctype_out = "gchar ***" self.gtype = "G_TYPE_STRV" self.free_func = "g_strfreev" self.format_in = "^ao" self.format_out = "^ao" self.gvariant_get = "g_variant_get_objv" self.gvalue_get = "g_value_get_boxed" self.array_annotation = "(array zero-terminated=1)" elif self.signature == "aay": self.ctype_in_g = "const gchar *const *" self.ctype_in = "const gchar *const *" self.ctype_in_dup = "gchar **" self.ctype_out = "gchar ***" self.gtype = "G_TYPE_STRV" self.free_func = "g_strfreev" self.format_in = "^aay" self.format_out = "^aay" self.gvariant_get = "g_variant_get_bytestring_array" self.gvalue_get = "g_value_get_boxed" self.array_annotation = "(array zero-terminated=1)" for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) class Method: def __init__(self, name, h_type_implies_unix_fd=True): self.name = name self.h_type_implies_unix_fd = h_type_implies_unix_fd self.in_args = [] self.out_args = [] self.annotations = [] self.doc_string = "" self.since = "" self.deprecated = False self.unix_fd = False def post_process( self, interface_prefix, cns, cns_upper, cns_lower, containing_iface ): if len(self.doc_string) == 0: self.doc_string = utils.lookup_docs(self.annotations) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if len(self.since) == 0: self.since = containing_iface.since name = self.name overridden_name = utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.Name" ) if utils.is_ugly_case(overridden_name): self.name_lower = overridden_name.lower() else: if overridden_name: name = overridden_name self.name_lower = utils.camel_case_to_uscore(name).lower().replace("-", "_") self.name_hyphen = self.name_lower.replace("_", "-") arg_count = 0 for a in self.in_args: a.post_process(interface_prefix, cns, cns_upper, cns_lower, arg_count) arg_count += 1 if self.h_type_implies_unix_fd and "h" in a.signature: self.unix_fd = True for a in self.out_args: a.post_process(interface_prefix, cns, cns_upper, cns_lower, arg_count) arg_count += 1 if self.h_type_implies_unix_fd and "h" in a.signature: self.unix_fd = True if ( utils.lookup_annotation(self.annotations, "org.freedesktop.DBus.Deprecated") == "true" ): self.deprecated = True if utils.lookup_annotation(self.annotations, "org.gtk.GDBus.C.UnixFD"): self.unix_fd = True for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) class Signal: def __init__(self, name): self.name = name self.args = [] self.annotations = [] self.doc_string = "" self.since = "" self.deprecated = False def post_process( self, interface_prefix, cns, cns_upper, cns_lower, containing_iface ): if len(self.doc_string) == 0: self.doc_string = utils.lookup_docs(self.annotations) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if len(self.since) == 0: self.since = containing_iface.since name = self.name overridden_name = utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.Name" ) if utils.is_ugly_case(overridden_name): self.name_lower = overridden_name.lower() else: if overridden_name: name = overridden_name self.name_lower = utils.camel_case_to_uscore(name).lower().replace("-", "_") self.name_hyphen = self.name_lower.replace("_", "-") arg_count = 0 for a in self.args: a.post_process(interface_prefix, cns, cns_upper, cns_lower, arg_count) arg_count += 1 if ( utils.lookup_annotation(self.annotations, "org.freedesktop.DBus.Deprecated") == "true" ): self.deprecated = True for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) class Property: def __init__(self, name, signature, access): self.name = name self.signature = signature self.access = access self.annotations = [] self.arg = Arg("value", self.signature) self.arg.annotations = self.annotations self.readable = False self.writable = False if self.access == "readwrite": self.readable = True self.writable = True elif self.access == "read": self.readable = True elif self.access == "write": self.writable = True else: print_error('Invalid access type "{}"'.format(self.access)) self.doc_string = "" self.since = "" self.deprecated = False self.emits_changed_signal = True def post_process( self, interface_prefix, cns, cns_upper, cns_lower, containing_iface ): if len(self.doc_string) == 0: self.doc_string = utils.lookup_docs(self.annotations) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if len(self.since) == 0: self.since = containing_iface.since name = self.name overridden_name = utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.Name" ) if utils.is_ugly_case(overridden_name): self.name_lower = overridden_name.lower() else: if overridden_name: name = overridden_name self.name_lower = utils.camel_case_to_uscore(name).lower().replace("-", "_") self.name_hyphen = self.name_lower.replace("_", "-") # don't clash with the GType getter, e.g.: # GType foo_bar_get_type (void); G_GNUC_CONST if self.name_lower == "type": self.name_lower = "type_" # recalculate arg self.arg.annotations = self.annotations self.arg.post_process(interface_prefix, cns, cns_upper, cns_lower, 0) if ( utils.lookup_annotation(self.annotations, "org.freedesktop.DBus.Deprecated") == "true" ): self.deprecated = True for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) # FIXME: for now we only support 'false' and 'const' on the signal itself, # see #674913 and # http://dbus.freedesktop.org/doc/dbus-specification.html#introspection-format # for details if utils.lookup_annotation( self.annotations, "org.freedesktop.DBus.Property.EmitsChangedSignal" ) in ("false", "const"): self.emits_changed_signal = False class Interface: def __init__(self, name): self.name = name self.methods = [] self.signals = [] self.properties = [] self.annotations = [] self.doc_string = "" self.doc_string_brief = "" self.since = "" self.deprecated = False def post_process(self, interface_prefix, c_namespace): if len(self.doc_string) == 0: self.doc_string = utils.lookup_docs(self.annotations) if len(self.doc_string_brief) == 0: self.doc_string_brief = utils.lookup_brief_docs(self.annotations) if len(self.since) == 0: self.since = utils.lookup_since(self.annotations) if len(c_namespace) > 0: if utils.is_ugly_case(c_namespace): cns = c_namespace.replace("_", "") cns_upper = c_namespace.upper() + "_" cns_lower = c_namespace.lower() + "_" else: cns = c_namespace cns_upper = utils.camel_case_to_uscore(c_namespace).upper() + "_" cns_lower = utils.camel_case_to_uscore(c_namespace).lower() + "_" else: cns = "" cns_upper = "" cns_lower = "" overridden_name = utils.lookup_annotation( self.annotations, "org.gtk.GDBus.C.Name" ) if utils.is_ugly_case(overridden_name): name = overridden_name.replace("_", "") name_with_ns = cns + name self.name_without_prefix = name self.camel_name = name_with_ns self.ns_upper = cns_upper self.name_lower = cns_lower + overridden_name.lower() self.name_upper = overridden_name.upper() # print_error('handle Ugly_Case "{}"'.format(overridden_name)) else: if overridden_name: name = overridden_name else: name = self.name if name.startswith(interface_prefix): name = name[len(interface_prefix) :] self.name_without_prefix = name name = utils.strip_dots(name) name_with_ns = utils.strip_dots(cns + "." + name) self.camel_name = name_with_ns self.ns_upper = cns_upper self.name_lower = cns_lower + utils.camel_case_to_uscore(name) self.name_upper = utils.camel_case_to_uscore(name).upper() self.name_hyphen = self.name_upper.lower().replace("_", "-") if ( utils.lookup_annotation(self.annotations, "org.freedesktop.DBus.Deprecated") == "true" ): self.deprecated = True for m in self.methods: m.post_process(interface_prefix, cns, cns_upper, cns_lower, self) for s in self.signals: s.post_process(interface_prefix, cns, cns_upper, cns_lower, self) for p in self.properties: p.post_process(interface_prefix, cns, cns_upper, cns_lower, self) for a in self.annotations: a.post_process(interface_prefix, cns, cns_upper, cns_lower, self) codegen/parser.py 0000644 00000031332 15125157507 0010030 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> import xml.parsers.expat from . import dbustypes from .utils import print_error class DBusXMLParser: STATE_TOP = "top" STATE_NODE = "node" STATE_INTERFACE = "interface" STATE_METHOD = "method" STATE_SIGNAL = "signal" STATE_PROPERTY = "property" STATE_ARG = "arg" STATE_ANNOTATION = "annotation" STATE_IGNORED = "ignored" def __init__(self, xml_data, h_type_implies_unix_fd=True): self._parser = xml.parsers.expat.ParserCreate() self._parser.CommentHandler = self.handle_comment self._parser.CharacterDataHandler = self.handle_char_data self._parser.StartElementHandler = self.handle_start_element self._parser.EndElementHandler = self.handle_end_element self.parsed_interfaces = [] self._cur_object = None self.state = DBusXMLParser.STATE_TOP self.state_stack = [] self._cur_object = None self._cur_object_stack = [] self.doc_comment_last_symbol = "" self._h_type_implies_unix_fd = h_type_implies_unix_fd self._parser.Parse(xml_data) COMMENT_STATE_BEGIN = "begin" COMMENT_STATE_PARAMS = "params" COMMENT_STATE_BODY = "body" COMMENT_STATE_SKIP = "skip" def handle_comment(self, data): comment_state = DBusXMLParser.COMMENT_STATE_BEGIN lines = data.split("\n") symbol = "" body = "" in_para = False params = {} for line in lines: orig_line = line line = line.lstrip() if comment_state == DBusXMLParser.COMMENT_STATE_BEGIN: if len(line) > 0: colon_index = line.find(": ") if colon_index == -1: if line.endswith(":"): symbol = line[0 : len(line) - 1] comment_state = DBusXMLParser.COMMENT_STATE_PARAMS else: comment_state = DBusXMLParser.COMMENT_STATE_SKIP else: symbol = line[0:colon_index] rest_of_line = line[colon_index + 2 :].strip() if len(rest_of_line) > 0: body += "<para>" + rest_of_line + "</para>" comment_state = DBusXMLParser.COMMENT_STATE_PARAMS elif comment_state == DBusXMLParser.COMMENT_STATE_PARAMS: if line.startswith("@"): colon_index = line.find(": ") if colon_index == -1: comment_state = DBusXMLParser.COMMENT_STATE_BODY if not in_para: body += "<para>" in_para = True body += orig_line + "\n" else: param = line[1:colon_index] docs = line[colon_index + 2 :] params[param] = docs else: comment_state = DBusXMLParser.COMMENT_STATE_BODY if len(line) > 0: if not in_para: body += "<para>" in_para = True body += orig_line + "\n" elif comment_state == DBusXMLParser.COMMENT_STATE_BODY: if len(line) > 0: if not in_para: body += "<para>" in_para = True body += orig_line + "\n" else: if in_para: body += "</para>" in_para = False if in_para: body += "</para>" if symbol != "": self.doc_comment_last_symbol = symbol self.doc_comment_params = params self.doc_comment_body = body def handle_char_data(self, data): # print 'char_data=%s'%data pass def handle_start_element(self, name, attrs): old_state = self.state old_cur_object = self._cur_object if self.state == DBusXMLParser.STATE_IGNORED: self.state = DBusXMLParser.STATE_IGNORED elif self.state == DBusXMLParser.STATE_TOP: if name == DBusXMLParser.STATE_NODE: self.state = DBusXMLParser.STATE_NODE else: self.state = DBusXMLParser.STATE_IGNORED elif self.state == DBusXMLParser.STATE_NODE: if name == DBusXMLParser.STATE_INTERFACE: self.state = DBusXMLParser.STATE_INTERFACE iface = dbustypes.Interface(attrs["name"]) self._cur_object = iface self.parsed_interfaces.append(iface) elif name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED # assign docs, if any if "name" in attrs and self.doc_comment_last_symbol == attrs["name"]: self._cur_object.doc_string = self.doc_comment_body if "short_description" in self.doc_comment_params: short_description = self.doc_comment_params["short_description"] self._cur_object.doc_string_brief = short_description if "since" in self.doc_comment_params: self._cur_object.since = self.doc_comment_params["since"].strip() elif self.state == DBusXMLParser.STATE_INTERFACE: if name == DBusXMLParser.STATE_METHOD: self.state = DBusXMLParser.STATE_METHOD method = dbustypes.Method( attrs["name"], h_type_implies_unix_fd=self._h_type_implies_unix_fd ) self._cur_object.methods.append(method) self._cur_object = method elif name == DBusXMLParser.STATE_SIGNAL: self.state = DBusXMLParser.STATE_SIGNAL signal = dbustypes.Signal(attrs["name"]) self._cur_object.signals.append(signal) self._cur_object = signal elif name == DBusXMLParser.STATE_PROPERTY: self.state = DBusXMLParser.STATE_PROPERTY prop = dbustypes.Property(attrs["name"], attrs["type"], attrs["access"]) self._cur_object.properties.append(prop) self._cur_object = prop elif name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED # assign docs, if any if "name" in attrs and self.doc_comment_last_symbol == attrs["name"]: self._cur_object.doc_string = self.doc_comment_body if "since" in self.doc_comment_params: self._cur_object.since = self.doc_comment_params["since"].strip() elif self.state == DBusXMLParser.STATE_METHOD: if name == DBusXMLParser.STATE_ARG: self.state = DBusXMLParser.STATE_ARG arg_name = None if "name" in attrs: arg_name = attrs["name"] arg = dbustypes.Arg(arg_name, attrs["type"]) direction = attrs.get("direction", "in") if direction == "in": self._cur_object.in_args.append(arg) elif direction == "out": self._cur_object.out_args.append(arg) else: print_error('Invalid direction "{}"'.format(direction)) self._cur_object = arg elif name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED # assign docs, if any if self.doc_comment_last_symbol == old_cur_object.name: if "name" in attrs and attrs["name"] in self.doc_comment_params: doc_string = self.doc_comment_params[attrs["name"]] if doc_string is not None: self._cur_object.doc_string = doc_string if "since" in self.doc_comment_params: self._cur_object.since = self.doc_comment_params[ "since" ].strip() elif self.state == DBusXMLParser.STATE_SIGNAL: if name == DBusXMLParser.STATE_ARG: self.state = DBusXMLParser.STATE_ARG arg_name = None if "name" in attrs: arg_name = attrs["name"] arg = dbustypes.Arg(arg_name, attrs["type"]) self._cur_object.args.append(arg) self._cur_object = arg elif name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED # assign docs, if any if self.doc_comment_last_symbol == old_cur_object.name: if "name" in attrs and attrs["name"] in self.doc_comment_params: doc_string = self.doc_comment_params[attrs["name"]] if doc_string is not None: self._cur_object.doc_string = doc_string if "since" in self.doc_comment_params: self._cur_object.since = self.doc_comment_params[ "since" ].strip() elif self.state == DBusXMLParser.STATE_PROPERTY: if name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED elif self.state == DBusXMLParser.STATE_ARG: if name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED elif self.state == DBusXMLParser.STATE_ANNOTATION: if name == DBusXMLParser.STATE_ANNOTATION: self.state = DBusXMLParser.STATE_ANNOTATION anno = dbustypes.Annotation(attrs["name"], attrs["value"]) self._cur_object.annotations.append(anno) self._cur_object = anno else: self.state = DBusXMLParser.STATE_IGNORED else: print_error( 'Unhandled state "{}" while entering element with name "{}"'.format( self.state, name ) ) self.state_stack.append(old_state) self._cur_object_stack.append(old_cur_object) def handle_end_element(self, name): self.state = self.state_stack.pop() self._cur_object = self._cur_object_stack.pop() def parse_dbus_xml(xml_data, h_type_implies_unix_fd): parser = DBusXMLParser(xml_data, h_type_implies_unix_fd) return parser.parsed_interfaces codegen/utils.py 0000644 00000007706 15125157507 0007704 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> import distutils.version import os import sys # pylint: disable=too-few-public-methods class Color: """ANSI Terminal colors""" GREEN = "\033[1;32m" BLUE = "\033[1;34m" YELLOW = "\033[1;33m" RED = "\033[1;31m" END = "\033[0m" def print_color(msg, color=Color.END, prefix="MESSAGE"): """Print a string with a color prefix""" if os.isatty(sys.stderr.fileno()): real_prefix = "{start}{prefix}{end}".format( start=color, prefix=prefix, end=Color.END ) else: real_prefix = prefix sys.stderr.write("{prefix}: {msg}\n".format(prefix=real_prefix, msg=msg)) def print_error(msg): """Print an error, and terminate""" print_color(msg, color=Color.RED, prefix="ERROR") sys.exit(1) def print_warning(msg, fatal=False): """Print a warning, and optionally terminate""" if fatal: color = Color.RED prefix = "ERROR" else: color = Color.YELLOW prefix = "WARNING" print_color(msg, color, prefix) if fatal: sys.exit(1) def print_info(msg): """Print a message""" print_color(msg, color=Color.GREEN, prefix="INFO") def strip_dots(s): ret = "" force_upper = False for c in s: if c == ".": force_upper = True else: if force_upper: ret += c.upper() force_upper = False else: ret += c return ret def dots_to_hyphens(s): return s.replace(".", "-") def camel_case_to_uscore(s): ret = "" insert_uscore = False prev_was_lower = False initial = True for c in s: # Keep initial underscores in camel case if initial and c == "_": ret += "_" continue initial = False if c.isupper(): if prev_was_lower: insert_uscore = True prev_was_lower = False else: prev_was_lower = True if insert_uscore: ret += "_" ret += c.lower() insert_uscore = False return ret def is_ugly_case(s): if s and s.find("_") > 0: return True return False def lookup_annotation(annotations, key): if annotations: for a in annotations: if a.key == key: return a.value return None def lookup_docs(annotations): s = lookup_annotation(annotations, "org.gtk.GDBus.DocString") if s is None: return "" else: return s def lookup_since(annotations): s = lookup_annotation(annotations, "org.gtk.GDBus.Since") if s is None: return "" else: return s def lookup_brief_docs(annotations): s = lookup_annotation(annotations, "org.gtk.GDBus.DocString.Short") if s is None: return "" else: return s def version_cmp_key(key): # If the 'since' version is 'UNRELEASED', compare higher than anything else # If it is empty put a 0 in its place as this will # allow LooseVersion to work and will always compare lower. if key[0] == "UNRELEASED": v = "9999" elif key[0]: v = str(key[0]) else: v = "0" return (distutils.version.LooseVersion(v), key[1]) codegen/config.py 0000644 00000001530 15125157507 0007776 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> VERSION = "2.68.4" MAJOR_VERSION = 2 MINOR_VERSION = 68 codegen/codegen_docbook.py 0000644 00000044300 15125157507 0011637 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> import re from os import path from . import utils # Disable line length warnings as wrapping the Docbook templates would be hard # flake8: noqa: E501 # ---------------------------------------------------------------------------------------------------- class DocbookCodeGenerator: def __init__(self, ifaces): self.ifaces = ifaces self.generate_expand_dicts() def print_method_prototype(self, i, m, in_synopsis): max_method_len = 0 if in_synopsis: for _m in i.methods: max_method_len = max(len(_m.name), max_method_len) else: max_method_len = max(len(m.name), max_method_len) max_signature_len = 0 if in_synopsis: for _m in i.methods: for a in _m.in_args: max_signature_len = max(len(a.signature), max_signature_len) for a in _m.out_args: max_signature_len = max(len(a.signature), max_signature_len) else: for a in m.in_args: max_signature_len = max(len(a.signature), max_signature_len) for a in m.out_args: max_signature_len = max(len(a.signature), max_signature_len) if in_synopsis: self.out.write( '<link linkend="gdbus-method-%s.%s">%s</link>%*s (' % ( utils.dots_to_hyphens(i.name), m.name, m.name, max_method_len - len(m.name), "", ) ) else: self.out.write("%s%*s (" % (m.name, max_method_len - len(m.name), "")) count = 0 for a in m.in_args: if count > 0: self.out.write(",\n%*s" % (max_method_len + 2, "")) self.out.write( "IN %s%*s %s" % (a.signature, max_signature_len - len(a.signature), "", a.name) ) count = count + 1 for a in m.out_args: if count > 0: self.out.write(",\n%*s" % (max_method_len + 2, "")) self.out.write( "OUT %s%*s %s" % (a.signature, max_signature_len - len(a.signature), "", a.name) ) count = count + 1 self.out.write(");\n") def print_signal_prototype(self, i, s, in_synopsis): max_signal_len = 0 if in_synopsis: for _s in i.signals: max_signal_len = max(len(_s.name), max_signal_len) else: max_signal_len = max(len(s.name), max_signal_len) max_signature_len = 0 if in_synopsis: for _s in i.signals: for a in _s.args: max_signature_len = max(len(a.signature), max_signature_len) else: for a in s.args: max_signature_len = max(len(a.signature), max_signature_len) if in_synopsis: self.out.write( '<link linkend="gdbus-signal-%s.%s">%s</link>%*s (' % ( utils.dots_to_hyphens(i.name), s.name, s.name, max_signal_len - len(s.name), "", ) ) else: self.out.write("%s%*s (" % (s.name, max_signal_len - len(s.name), "")) count = 0 for a in s.args: if count > 0: self.out.write(",\n%*s" % (max_signal_len + 2, "")) self.out.write( "%s%*s %s" % (a.signature, max_signature_len - len(a.signature), "", a.name) ) count = count + 1 self.out.write(");\n") def print_property_prototype(self, i, p, in_synopsis): max_property_len = 0 if in_synopsis: for _p in i.properties: max_property_len = max(len(_p.name), max_property_len) else: max_property_len = max(len(p.name), max_property_len) max_signature_len = 0 if in_synopsis: for _p in i.properties: max_signature_len = max(len(_p.signature), max_signature_len) else: max_signature_len = max(len(p.signature), max_signature_len) if in_synopsis: self.out.write( '<link linkend="gdbus-property-%s.%s">%s</link>%*s' % ( utils.dots_to_hyphens(i.name), p.name, p.name, max_property_len - len(p.name), "", ) ) else: self.out.write("%s%*s" % (p.name, max_property_len - len(p.name), "")) if p.readable and p.writable: access = "readwrite" elif p.readable: access = "readable " else: access = "writable " self.out.write(" %s %s\n" % (access, p.signature)) def print_synopsis_methods(self, i): self.out.write(' <refsynopsisdiv role="synopsis">\n') self.out.write(' <title role="synopsis.title">Methods</title>\n') self.out.write(" <synopsis>\n") for m in i.methods: self.print_method_prototype(i, m, in_synopsis=True) self.out.write("</synopsis>\n") self.out.write(" </refsynopsisdiv>\n") def print_synopsis_signals(self, i): self.out.write(' <refsect1 role="signal_proto">\n') self.out.write(' <title role="signal_proto.title">Signals</title>\n') self.out.write(" <synopsis>\n") for s in i.signals: self.print_signal_prototype(i, s, in_synopsis=True) self.out.write("</synopsis>\n") self.out.write(" </refsect1>\n") def print_synopsis_properties(self, i): self.out.write(' <refsect1 role="properties">\n') self.out.write(' <title role="properties.title">Properties</title>\n') self.out.write(" <synopsis>\n") for p in i.properties: self.print_property_prototype(i, p, in_synopsis=True) self.out.write("</synopsis>\n") self.out.write(" </refsect1>\n") def print_method(self, i, m): self.out.write( '<refsect2 role="method" id="gdbus-method-%s.%s">\n' % (utils.dots_to_hyphens(i.name), m.name) ) self.out.write(" <title>The %s() method</title>\n" % (m.name)) self.out.write( ' <indexterm zone="gdbus-method-%s.%s"><primary sortas="%s.%s">%s.%s()</primary></indexterm>\n' % ( utils.dots_to_hyphens(i.name), m.name, i.name_without_prefix, m.name, i.name, m.name, ) ) self.out.write("<programlisting>\n") self.print_method_prototype(i, m, in_synopsis=False) self.out.write("</programlisting>\n") self.out.write("%s\n" % (self.expand_paras(m.doc_string, True))) if m.in_args or m.out_args: self.out.write('<variablelist role="params">\n') for a in m.in_args: self.out.write("<varlistentry>\n") self.out.write( " <term><literal>IN %s <parameter>%s</parameter></literal>:</term>\n" % (a.signature, a.name) ) self.out.write( " <listitem>%s</listitem>\n" % (self.expand_paras(a.doc_string, True)) ) self.out.write("</varlistentry>\n") for a in m.out_args: self.out.write("<varlistentry>\n") self.out.write( " <term><literal>OUT %s <parameter>%s</parameter></literal>:</term>\n" % (a.signature, a.name) ) self.out.write( " <listitem>%s</listitem>\n" % (self.expand_paras(a.doc_string, True)) ) self.out.write("</varlistentry>\n") self.out.write("</variablelist>\n") if len(m.since) > 0: self.out.write('<para role="since">Since %s</para>\n' % (m.since)) if m.deprecated: self.out.write( "<warning><para>The %s() method is deprecated.</para></warning>" % (m.name) ) self.out.write("</refsect2>\n") def print_signal(self, i, s): self.out.write( '<refsect2 role="signal" id="gdbus-signal-%s.%s">\n' % (utils.dots_to_hyphens(i.name), s.name) ) self.out.write(' <title>The "%s" signal</title>\n' % (s.name)) self.out.write( ' <indexterm zone="gdbus-signal-%s.%s"><primary sortas="%s::%s">%s::%s</primary></indexterm>\n' % ( utils.dots_to_hyphens(i.name), s.name, i.name_without_prefix, s.name, i.name, s.name, ) ) self.out.write("<programlisting>\n") self.print_signal_prototype(i, s, in_synopsis=False) self.out.write("</programlisting>\n") self.out.write("%s\n" % (self.expand_paras(s.doc_string, True))) if s.args: self.out.write('<variablelist role="params">\n') for a in s.args: self.out.write("<varlistentry>\n") self.out.write( " <term><literal>%s <parameter>%s</parameter></literal>:</term>\n" % (a.signature, a.name) ) self.out.write( " <listitem>%s</listitem>\n" % (self.expand_paras(a.doc_string, True)) ) self.out.write("</varlistentry>\n") self.out.write("</variablelist>\n") if len(s.since) > 0: self.out.write('<para role="since">Since %s</para>\n' % (s.since)) if s.deprecated: self.out.write( '<warning><para>The "%s" signal is deprecated.</para></warning>' % (s.name) ) self.out.write("</refsect2>\n") def print_property(self, i, p): self.out.write( '<refsect2 role="property" id="gdbus-property-%s.%s">\n' % (utils.dots_to_hyphens(i.name), p.name) ) self.out.write(' <title>The "%s" property</title>\n' % (p.name)) self.out.write( ' <indexterm zone="gdbus-property-%s.%s"><primary sortas="%s:%s">%s:%s</primary></indexterm>\n' % ( utils.dots_to_hyphens(i.name), p.name, i.name_without_prefix, p.name, i.name, p.name, ) ) self.out.write("<programlisting>\n") self.print_property_prototype(i, p, in_synopsis=False) self.out.write("</programlisting>\n") self.out.write("%s\n" % (self.expand_paras(p.doc_string, True))) if len(p.since) > 0: self.out.write('<para role="since">Since %s</para>\n' % (p.since)) if p.deprecated: self.out.write( '<warning><para>The "%s" property is deprecated.</para></warning>' % (p.name) ) self.out.write("</refsect2>\n") def expand(self, s, expandParamsAndConstants): for key in self.expand_member_dict_keys: s = s.replace(key, self.expand_member_dict[key]) for key in self.expand_iface_dict_keys: s = s.replace(key, self.expand_iface_dict[key]) if expandParamsAndConstants: # replace @foo with <parameter>foo</parameter> s = re.sub( "@[a-zA-Z0-9_]*", lambda m: "<parameter>" + m.group(0)[1:] + "</parameter>", s, ) # replace e.g. %TRUE with <constant>TRUE</constant> s = re.sub( "%[a-zA-Z0-9_]*", lambda m: "<constant>" + m.group(0)[1:] + "</constant>", s, ) return s def expand_paras(self, s, expandParamsAndConstants): s = self.expand(s, expandParamsAndConstants).strip() if not s.startswith("<para"): s = "<para>%s</para>" % s return s def generate_expand_dicts(self): self.expand_member_dict = {} self.expand_iface_dict = {} for i in self.ifaces: key = "#%s" % (i.name) value = '<link linkend="gdbus-interface-%s.top_of_page">%s</link>' % ( utils.dots_to_hyphens(i.name), i.name, ) self.expand_iface_dict[key] = value for m in i.methods: key = "%s.%s()" % (i.name, m.name) value = '<link linkend="gdbus-method-%s.%s">%s()</link>' % ( utils.dots_to_hyphens(i.name), m.name, m.name, ) self.expand_member_dict[key] = value for s in i.signals: key = "#%s::%s" % (i.name, s.name) value = '<link linkend="gdbus-signal-%s.%s">"%s"</link>' % ( utils.dots_to_hyphens(i.name), s.name, s.name, ) self.expand_member_dict[key] = value for p in i.properties: key = "#%s:%s" % (i.name, p.name) value = '<link linkend="gdbus-property-%s.%s">"%s"</link>' % ( utils.dots_to_hyphens(i.name), p.name, p.name, ) self.expand_member_dict[key] = value # Make sure to expand the keys in reverse order so e.g. #org.foo.Iface:MediaCompat # is evaluated before #org.foo.Iface:Media ... self.expand_member_dict_keys = sorted( self.expand_member_dict.keys(), reverse=True ) self.expand_iface_dict_keys = sorted( self.expand_iface_dict.keys(), reverse=True ) def generate(self, docbook, outdir): for i in self.ifaces: self.out = open(path.join(outdir, "%s-%s.xml" % (docbook, i.name)), "w") self.out.write("") self.out.write('<?xml version="1.0" encoding="utf-8"?>\n') self.out.write( '<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"\n' ) self.out.write( ' "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [\n' ) self.out.write("]>\n") self.out.write('<refentry id="gdbus-%s">\n' % (i.name)) self.out.write(" <refmeta>") self.out.write( ' <refentrytitle role="top_of_page" id="gdbus-interface-%s.top_of_page">%s</refentrytitle>\n' % (utils.dots_to_hyphens(i.name), i.name) ) self.out.write( ' <indexterm zone="gdbus-interface-%s.top_of_page"><primary sortas="%s">%s</primary></indexterm>\n' % (utils.dots_to_hyphens(i.name), i.name_without_prefix, i.name) ) self.out.write(" </refmeta>") self.out.write(" <refnamediv>") self.out.write(" <refname>%s</refname>" % (i.name)) self.out.write(" <refpurpose>%s</refpurpose>" % (i.doc_string_brief)) self.out.write(" </refnamediv>") if len(i.methods) > 0: self.print_synopsis_methods(i) if len(i.signals) > 0: self.print_synopsis_signals(i) if len(i.properties) > 0: self.print_synopsis_properties(i) self.out.write( '<refsect1 role="desc" id="gdbus-interface-%s">\n' % (utils.dots_to_hyphens(i.name)) ) self.out.write(' <title role="desc.title">Description</title>\n') self.out.write(" %s\n" % (self.expand_paras(i.doc_string, True))) if len(i.since) > 0: self.out.write(' <para role="since">Since %s</para>\n' % (i.since)) if i.deprecated: self.out.write( "<warning><para>The %s interface is deprecated.</para></warning>" % (i.name) ) self.out.write("</refsect1>\n") if len(i.methods) > 0: self.out.write( '<refsect1 role="details" id="gdbus-methods-%s">\n' % (i.name) ) self.out.write(' <title role="details.title">Method Details</title>\n') for m in i.methods: self.print_method(i, m) self.out.write("</refsect1>\n") if len(i.signals) > 0: self.out.write( '<refsect1 role="details" id="gdbus-signals-%s">\n' % (i.name) ) self.out.write(' <title role="details.title">Signal Details</title>\n') for s in i.signals: self.print_signal(i, s) self.out.write("</refsect1>\n") if len(i.properties) > 0: self.out.write( '<refsect1 role="details" id="gdbus-properties-%s">\n' % (i.name) ) self.out.write( ' <title role="details.title">Property Details</title>\n' ) for s in i.properties: self.print_property(i, s) self.out.write("</refsect1>\n") self.out.write("</refentry>\n") self.out.write("\n") codegen/codegen_main.py 0000644 00000037624 15125157507 0011156 0 ustar 00 # -*- Mode: Python -*- # coding=utf-8 # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # Copyright (C) 2018 Iñigo Martínez <inigomartinez@gmail.com> # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> import argparse import os import sys from . import config from . import dbustypes from . import parser from . import codegen from . import codegen_docbook from .utils import print_error, print_warning def find_arg(arg_list, arg_name): for a in arg_list: if a.name == arg_name: return a return None def find_method(iface, method): for m in iface.methods: if m.name == method: return m return None def find_signal(iface, signal): for m in iface.signals: if m.name == signal: return m return None def find_prop(iface, prop): for m in iface.properties: if m.name == prop: return m return None def apply_annotation(iface_list, iface, method, signal, prop, arg, key, value): iface_obj = None for i in iface_list: if i.name == iface: iface_obj = i break if iface_obj is None: print_error('No interface "{}"'.format(iface)) target_obj = None if method: method_obj = find_method(iface_obj, method) if method_obj is None: print_error('No method "{}" on interface "{}"'.format(method, iface)) if arg: arg_obj = find_arg(method_obj.in_args, arg) if arg_obj is None: arg_obj = find_arg(method_obj.out_args, arg) if arg_obj is None: print_error( 'No arg "{}" on method "{}" on interface "{}"'.format( arg, method, iface ) ) target_obj = arg_obj else: target_obj = method_obj elif signal: signal_obj = find_signal(iface_obj, signal) if signal_obj is None: print_error('No signal "{}" on interface "{}"'.format(signal, iface)) if arg: arg_obj = find_arg(signal_obj.args, arg) if arg_obj is None: print_error( 'No arg "{}" on signal "{}" on interface "{}"'.format( arg, signal, iface ) ) target_obj = arg_obj else: target_obj = signal_obj elif prop: prop_obj = find_prop(iface_obj, prop) if prop_obj is None: print_error('No property "{}" on interface "{}"'.format(prop, iface)) target_obj = prop_obj else: target_obj = iface_obj target_obj.annotations.insert(0, dbustypes.Annotation(key, value)) def apply_annotations(iface_list, annotation_list): # apply annotations given on the command line for (what, key, value) in annotation_list: pos = what.find("::") if pos != -1: # signal iface = what[0:pos] signal = what[pos + 2 :] pos = signal.find("[") if pos != -1: arg = signal[pos + 1 :] signal = signal[0:pos] pos = arg.find("]") arg = arg[0:pos] apply_annotation(iface_list, iface, None, signal, None, arg, key, value) else: apply_annotation( iface_list, iface, None, signal, None, None, key, value ) else: pos = what.find(":") if pos != -1: # property iface = what[0:pos] prop = what[pos + 1 :] apply_annotation(iface_list, iface, None, None, prop, None, key, value) else: pos = what.find("()") if pos != -1: # method combined = what[0:pos] pos = combined.rfind(".") iface = combined[0:pos] method = combined[pos + 1 :] pos = what.find("[") if pos != -1: arg = what[pos + 1 :] pos = arg.find("]") arg = arg[0:pos] apply_annotation( iface_list, iface, method, None, None, arg, key, value ) else: apply_annotation( iface_list, iface, method, None, None, None, key, value ) else: # must be an interface iface = what apply_annotation( iface_list, iface, None, None, None, None, key, value ) def codegen_main(): arg_parser = argparse.ArgumentParser( description="D-Bus code and documentation generator" ) arg_parser.add_argument( "files", metavar="FILE", nargs="+", help="D-Bus introspection XML file" ) arg_parser.add_argument( "--xml-files", metavar="FILE", action="append", default=[], help=argparse.SUPPRESS, ) arg_parser.add_argument( "--interface-prefix", metavar="PREFIX", default="", help="String to strip from D-Bus interface names for code and docs", ) arg_parser.add_argument( "--c-namespace", metavar="NAMESPACE", default="", help="The namespace to use for generated C code", ) arg_parser.add_argument( "--c-generate-object-manager", action="store_true", help="Generate a GDBusObjectManagerClient subclass when generating C code", ) arg_parser.add_argument( "--c-generate-autocleanup", choices=["none", "objects", "all"], default="objects", help="Generate autocleanup support", ) arg_parser.add_argument( "--generate-docbook", metavar="OUTFILES", help="Generate Docbook in OUTFILES-org.Project.IFace.xml", ) arg_parser.add_argument( "--pragma-once", action="store_true", help='Use "pragma once" as the inclusion guard', ) arg_parser.add_argument( "--annotate", nargs=3, action="append", metavar="WHAT KEY VALUE", help="Add annotation (may be used several times)", ) arg_parser.add_argument( "--glib-min-required", metavar="VERSION", help="Minimum version of GLib to be supported by the outputted code " "(default: 2.30)", ) arg_parser.add_argument( "--glib-max-allowed", metavar="VERSION", help="Maximum version of GLib to be used by the outputted code " "(default: current GLib version)", ) arg_parser.add_argument( "--symbol-decorator", help="Macro used to decorate a symbol in the outputted header, " "possibly to export symbols", ) arg_parser.add_argument( "--symbol-decorator-header", help="Additional header required for decorator specified by " "--symbol-decorator", ) arg_parser.add_argument( "--symbol-decorator-define", help="Additional define required for decorator specified by " "--symbol-decorator", ) group = arg_parser.add_mutually_exclusive_group() group.add_argument( "--generate-c-code", metavar="OUTFILES", help="Generate C code in OUTFILES.[ch]" ) group.add_argument("--header", action="store_true", help="Generate C headers") group.add_argument("--body", action="store_true", help="Generate C code") group.add_argument( "--interface-info-header", action="store_true", help="Generate GDBusInterfaceInfo C header", ) group.add_argument( "--interface-info-body", action="store_true", help="Generate GDBusInterfaceInfo C code", ) group = arg_parser.add_mutually_exclusive_group() group.add_argument( "--output", metavar="FILE", help="Write output into the specified file" ) group.add_argument( "--output-directory", metavar="OUTDIR", default="", help="Location to output generated files", ) args = arg_parser.parse_args() if len(args.xml_files) > 0: print_warning( 'The "--xml-files" option is deprecated; use positional arguments instead' ) if ( args.generate_c_code is not None or args.generate_docbook is not None ) and args.output is not None: print_error( "Using --generate-c-code or --generate-docbook and " "--output at the same time is not allowed" ) if args.generate_c_code: header_name = args.generate_c_code + ".h" h_file = os.path.join(args.output_directory, header_name) args.header = True c_file = os.path.join(args.output_directory, args.generate_c_code + ".c") args.body = True elif args.header: if args.output is None: print_error("Using --header requires --output") h_file = args.output header_name = os.path.basename(h_file) elif args.body: if args.output is None: print_error("Using --body requires --output") c_file = args.output header_name = os.path.splitext(os.path.basename(c_file))[0] + ".h" elif args.interface_info_header: if args.output is None: print_error("Using --interface-info-header requires --output") if args.c_generate_object_manager: print_error( "--c-generate-object-manager is incompatible with " "--interface-info-header" ) h_file = args.output header_name = os.path.basename(h_file) elif args.interface_info_body: if args.output is None: print_error("Using --interface-info-body requires --output") if args.c_generate_object_manager: print_error( "--c-generate-object-manager is incompatible with " "--interface-info-body" ) c_file = args.output header_name = os.path.splitext(os.path.basename(c_file))[0] + ".h" # Check the minimum GLib version. The minimum --glib-min-required is 2.30, # because that’s when gdbus-codegen was introduced. Support 1, 2 or 3 # component versions, but ignore the micro component if it’s present. if args.glib_min_required: try: parts = args.glib_min_required.split(".", 3) glib_min_required = (int(parts[0]), int(parts[1] if len(parts) > 1 else 0)) # Ignore micro component, but still validate it: _ = int(parts[2] if len(parts) > 2 else 0) # noqa: F841 except (ValueError, IndexError): print_error( "Unrecognized --glib-min-required string ‘{}’".format( args.glib_min_required ) ) if glib_min_required < (2, 30): print_error( "Invalid --glib-min-required string ‘{}’: minimum " "version is 2.30".format(args.glib_min_required) ) else: glib_min_required = (2, 30) # And the maximum GLib version. if args.glib_max_allowed: try: parts = args.glib_max_allowed.split(".", 3) glib_max_allowed = (int(parts[0]), int(parts[1] if len(parts) > 1 else 0)) # Ignore micro component, but still validate it: _ = int(parts[2] if len(parts) > 2 else 0) # noqa: F841 except (ValueError, IndexError): print_error( "Unrecognized --glib-max-allowed string ‘{}’".format( args.glib_max_allowed ) ) else: glib_max_allowed = (config.MAJOR_VERSION, config.MINOR_VERSION) # Only allow --symbol-decorator-define and --symbol-decorator-header if # --symbol-decorator is used if args.symbol_decorator is None: if args.symbol_decorator_header or args.symbol_decorator_define: print_error( "--symbol-decorator-define and --symbol-decorator-header must " "be used with --symbol-decorator" ) # Round --glib-max-allowed up to the next stable release. glib_max_allowed = ( glib_max_allowed[0], glib_max_allowed[1] + (glib_max_allowed[1] % 2), ) if glib_max_allowed < glib_min_required: print_error( "Invalid versions: --glib-min-required ({}) must be " "less than or equal to --glib-max-allowed ({})".format( glib_min_required, glib_max_allowed ) ) all_ifaces = [] input_files_basenames = [] for fname in sorted(args.files + args.xml_files): with open(fname, "rb") as f: xml_data = f.read() parsed_ifaces = parser.parse_dbus_xml( xml_data, h_type_implies_unix_fd=(glib_min_required >= (2, 64)) ) all_ifaces.extend(parsed_ifaces) input_files_basenames.append(os.path.basename(fname)) if args.annotate is not None: apply_annotations(all_ifaces, args.annotate) for i in all_ifaces: i.post_process(args.interface_prefix, args.c_namespace) docbook = args.generate_docbook docbook_gen = codegen_docbook.DocbookCodeGenerator(all_ifaces) if docbook: docbook_gen.generate(docbook, args.output_directory) if args.header: with open(h_file, "w") as outfile: gen = codegen.HeaderCodeGenerator( all_ifaces, args.c_namespace, args.c_generate_object_manager, args.c_generate_autocleanup, header_name, input_files_basenames, args.pragma_once, glib_min_required, args.symbol_decorator, args.symbol_decorator_header, outfile, ) gen.generate() if args.body: with open(c_file, "w") as outfile: gen = codegen.CodeGenerator( all_ifaces, args.c_namespace, args.c_generate_object_manager, header_name, input_files_basenames, docbook_gen, glib_min_required, args.symbol_decorator_define, outfile, ) gen.generate() if args.interface_info_header: with open(h_file, "w") as outfile: gen = codegen.InterfaceInfoHeaderCodeGenerator( all_ifaces, args.c_namespace, header_name, input_files_basenames, args.pragma_once, glib_min_required, args.symbol_decorator, args.symbol_decorator_header, outfile, ) gen.generate() if args.interface_info_body: with open(c_file, "w") as outfile: gen = codegen.InterfaceInfoBodyCodeGenerator( all_ifaces, args.c_namespace, header_name, input_files_basenames, glib_min_required, args.symbol_decorator_define, outfile, ) gen.generate() sys.exit(0) if __name__ == "__main__": codegen_main() codegen/__init__.py 0000644 00000001746 15125157507 0010301 0 ustar 00 # -*- Mode: Python -*- # GDBus - GLib D-Bus Library # # Copyright (C) 2008-2011 Red Hat, Inc. # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General # Public License along with this library; if not, see <http://www.gnu.org/licenses/>. # # Author: David Zeuthen <davidz@redhat.com> import os builddir = os.environ.get("UNINSTALLED_GLIB_BUILDDIR") if builddir is not None: __path__.append( os.path.abspath(os.path.join(builddir, "gio", "gdbus-2.0", "codegen")) ) gmodule.h 0000644 00000010336 15125173650 0006361 0 ustar 00 /* GMODULE - GLIB wrapper code for dynamic module loading * Copyright (C) 1998 Tim Janik * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __GMODULE_H__ #define __GMODULE_H__ #include <glib.h> G_BEGIN_DECLS /* exporting and importing functions, this is special cased * to feature Windows dll stubs. */ #define G_MODULE_IMPORT extern #ifdef G_PLATFORM_WIN32 # define G_MODULE_EXPORT __declspec(dllexport) #elif __GNUC__ >= 4 # define G_MODULE_EXPORT __attribute__((visibility("default"))) #else /* !G_PLATFORM_WIN32 && __GNUC__ < 4 */ # define G_MODULE_EXPORT #endif /* !G_PLATFORM_WIN32 */ /** * GModuleFlags: * @G_MODULE_BIND_LAZY: specifies that symbols are only resolved when * needed. The default action is to bind all symbols when the module * is loaded. * @G_MODULE_BIND_LOCAL: specifies that symbols in the module should * not be added to the global name space. The default action on most * platforms is to place symbols in the module in the global name space, * which may cause conflicts with existing symbols. * @G_MODULE_BIND_MASK: mask for all flags. * * Flags passed to g_module_open(). * Note that these flags are not supported on all platforms. */ typedef enum { G_MODULE_BIND_LAZY = 1 << 0, G_MODULE_BIND_LOCAL = 1 << 1, G_MODULE_BIND_MASK = 0x03 } GModuleFlags; typedef struct _GModule GModule; typedef const gchar* (*GModuleCheckInit) (GModule *module); typedef void (*GModuleUnload) (GModule *module); /* return TRUE if dynamic module loading is supported */ GLIB_AVAILABLE_IN_ALL gboolean g_module_supported (void) G_GNUC_CONST; /* open a module 'file_name' and return handle, which is NULL on error */ GLIB_AVAILABLE_IN_ALL GModule* g_module_open (const gchar *file_name, GModuleFlags flags); /* close a previously opened module, returns TRUE on success */ GLIB_AVAILABLE_IN_ALL gboolean g_module_close (GModule *module); /* make a module resident so g_module_close on it will be ignored */ GLIB_AVAILABLE_IN_ALL void g_module_make_resident (GModule *module); /* query the last module error as a string */ GLIB_AVAILABLE_IN_ALL const gchar * g_module_error (void); /* retrieve a symbol pointer from 'module', returns TRUE on success */ GLIB_AVAILABLE_IN_ALL gboolean g_module_symbol (GModule *module, const gchar *symbol_name, gpointer *symbol); /* retrieve the file name from an existing module */ GLIB_AVAILABLE_IN_ALL const gchar * g_module_name (GModule *module); /* Build the actual file name containing a module. 'directory' is the * directory where the module file is supposed to be, or NULL or empty * in which case it should either be in the current directory or, on * some operating systems, in some standard place, for instance on the * PATH. Hence, to be absolutely sure to get the correct module, * always pass in a directory. The file name consists of the directory, * if supplied, and 'module_name' suitably decorated according to * the operating system's conventions (for instance lib*.so or *.dll). * * No checks are made that the file exists, or is of correct type. */ GLIB_AVAILABLE_IN_ALL gchar* g_module_build_path (const gchar *directory, const gchar *module_name); G_END_DECLS #endif /* __GMODULE_H__ */ glib.h 0000644 00000006517 15125173650 0005650 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_LIB_H__ #define __G_LIB_H__ #define __GLIB_H_INSIDE__ #include <glib/galloca.h> #include <glib/garray.h> #include <glib/gasyncqueue.h> #include <glib/gatomic.h> #include <glib/gbacktrace.h> #include <glib/gbase64.h> #include <glib/gbitlock.h> #include <glib/gbookmarkfile.h> #include <glib/gbytes.h> #include <glib/gcharset.h> #include <glib/gchecksum.h> #include <glib/gconvert.h> #include <glib/gdataset.h> #include <glib/gdate.h> #include <glib/gdatetime.h> #include <glib/gdir.h> #include <glib/genviron.h> #include <glib/gerror.h> #include <glib/gfileutils.h> #include <glib/ggettext.h> #include <glib/ghash.h> #include <glib/ghmac.h> #include <glib/ghook.h> #include <glib/ghostutils.h> #include <glib/giochannel.h> #include <glib/gkeyfile.h> #include <glib/glist.h> #include <glib/gmacros.h> #include <glib/gmain.h> #include <glib/gmappedfile.h> #include <glib/gmarkup.h> #include <glib/gmem.h> #include <glib/gmessages.h> #include <glib/gnode.h> #include <glib/goption.h> #include <glib/gpattern.h> #include <glib/gpoll.h> #include <glib/gprimes.h> #include <glib/gqsort.h> #include <glib/gquark.h> #include <glib/gqueue.h> #include <glib/grand.h> #include <glib/grcbox.h> #include <glib/grefcount.h> #include <glib/grefstring.h> #include <glib/gregex.h> #include <glib/gscanner.h> #include <glib/gsequence.h> #include <glib/gshell.h> #include <glib/gslice.h> #include <glib/gslist.h> #include <glib/gspawn.h> #include <glib/gstrfuncs.h> #include <glib/gstringchunk.h> #include <glib/gstring.h> #include <glib/gstrvbuilder.h> #include <glib/gtestutils.h> #include <glib/gthread.h> #include <glib/gthreadpool.h> #include <glib/gtimer.h> #include <glib/gtimezone.h> #include <glib/gtrashstack.h> #include <glib/gtree.h> #include <glib/gtypes.h> #include <glib/gunicode.h> #include <glib/guri.h> #include <glib/gutils.h> #include <glib/guuid.h> #include <glib/gvariant.h> #include <glib/gvarianttype.h> #include <glib/gversion.h> #include <glib/gversionmacros.h> #ifdef G_PLATFORM_WIN32 #include <glib/gwin32.h> #endif #include <glib/deprecated/gallocator.h> #include <glib/deprecated/gcache.h> #include <glib/deprecated/gcompletion.h> #include <glib/deprecated/gmain.h> #include <glib/deprecated/grel.h> #include <glib/deprecated/gthread.h> #include <glib/glib-autocleanups.h> #undef __GLIB_H_INSIDE__ #endif /* __G_LIB_H__ */ gobject/gsourceclosure.h 0000644 00000002373 15125173650 0011410 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2001 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SOURCECLOSURE_H__ #define __G_SOURCECLOSURE_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gclosure.h> #include <gobject/glib-types.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL void g_source_set_closure (GSource *source, GClosure *closure); GLIB_AVAILABLE_IN_ALL void g_source_set_dummy_callback (GSource *source); G_END_DECLS #endif /* __G_SOURCECLOSURE_H__ */ gobject/gobject.h 0000644 00000103132 15125173650 0007754 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_OBJECT_H__ #define __G_OBJECT_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> #include <gobject/gvalue.h> #include <gobject/gparam.h> #include <gobject/gclosure.h> #include <gobject/gsignal.h> #include <gobject/gboxed.h> #if defined(glib_typeof_2_68) && GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68 /* for glib_typeof */ #include <type_traits> #endif G_BEGIN_DECLS /* --- type macros --- */ /** * G_TYPE_IS_OBJECT: * @type: Type id to check * * Check if the passed in type id is a %G_TYPE_OBJECT or derived from it. * * Returns: %FALSE or %TRUE, indicating whether @type is a %G_TYPE_OBJECT. */ #define G_TYPE_IS_OBJECT(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_OBJECT) /** * G_OBJECT: * @object: Object which is subject to casting. * * Casts a #GObject or derived pointer into a (GObject*) pointer. * Depending on the current debugging level, this function may invoke * certain runtime checks to identify invalid casts. */ #define G_OBJECT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_OBJECT, GObject)) /** * G_OBJECT_CLASS: * @class: a valid #GObjectClass * * Casts a derived #GObjectClass structure into a #GObjectClass structure. */ #define G_OBJECT_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_OBJECT, GObjectClass)) /** * G_IS_OBJECT: * @object: Instance to check for being a %G_TYPE_OBJECT. * * Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_OBJECT. */ #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_42 #define G_IS_OBJECT(object) (G_TYPE_CHECK_INSTANCE_FUNDAMENTAL_TYPE ((object), G_TYPE_OBJECT)) #else #define G_IS_OBJECT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_OBJECT)) #endif /** * G_IS_OBJECT_CLASS: * @class: a #GObjectClass * * Checks whether @class "is a" valid #GObjectClass structure of type * %G_TYPE_OBJECT or derived. */ #define G_IS_OBJECT_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_OBJECT)) /** * G_OBJECT_GET_CLASS: * @object: a #GObject instance. * * Get the class structure associated to a #GObject instance. * * Returns: pointer to object class structure. */ #define G_OBJECT_GET_CLASS(object) (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_OBJECT, GObjectClass)) /** * G_OBJECT_TYPE: * @object: Object to return the type id for. * * Get the type id of an object. * * Returns: Type id of @object. */ #define G_OBJECT_TYPE(object) (G_TYPE_FROM_INSTANCE (object)) /** * G_OBJECT_TYPE_NAME: * @object: Object to return the type name for. * * Get the name of an object's type. * * Returns: Type name of @object. The string is owned by the type system and * should not be freed. */ #define G_OBJECT_TYPE_NAME(object) (g_type_name (G_OBJECT_TYPE (object))) /** * G_OBJECT_CLASS_TYPE: * @class: a valid #GObjectClass * * Get the type id of a class structure. * * Returns: Type id of @class. */ #define G_OBJECT_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class)) /** * G_OBJECT_CLASS_NAME: * @class: a valid #GObjectClass * * Return the name of a class structure's type. * * Returns: Type name of @class. The string is owned by the type system and * should not be freed. */ #define G_OBJECT_CLASS_NAME(class) (g_type_name (G_OBJECT_CLASS_TYPE (class))) /** * G_VALUE_HOLDS_OBJECT: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values derived from type %G_TYPE_OBJECT. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_OBJECT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT)) /* --- type macros --- */ /** * G_TYPE_INITIALLY_UNOWNED: * * The type for #GInitiallyUnowned. */ #define G_TYPE_INITIALLY_UNOWNED (g_initially_unowned_get_type()) /** * G_INITIALLY_UNOWNED: * @object: Object which is subject to casting. * * Casts a #GInitiallyUnowned or derived pointer into a (GInitiallyUnowned*) * pointer. Depending on the current debugging level, this function may invoke * certain runtime checks to identify invalid casts. */ #define G_INITIALLY_UNOWNED(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnowned)) /** * G_INITIALLY_UNOWNED_CLASS: * @class: a valid #GInitiallyUnownedClass * * Casts a derived #GInitiallyUnownedClass structure into a * #GInitiallyUnownedClass structure. */ #define G_INITIALLY_UNOWNED_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass)) /** * G_IS_INITIALLY_UNOWNED: * @object: Instance to check for being a %G_TYPE_INITIALLY_UNOWNED. * * Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_INITIALLY_UNOWNED. */ #define G_IS_INITIALLY_UNOWNED(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_INITIALLY_UNOWNED)) /** * G_IS_INITIALLY_UNOWNED_CLASS: * @class: a #GInitiallyUnownedClass * * Checks whether @class "is a" valid #GInitiallyUnownedClass structure of type * %G_TYPE_INITIALLY_UNOWNED or derived. */ #define G_IS_INITIALLY_UNOWNED_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_INITIALLY_UNOWNED)) /** * G_INITIALLY_UNOWNED_GET_CLASS: * @object: a #GInitiallyUnowned instance. * * Get the class structure associated to a #GInitiallyUnowned instance. * * Returns: pointer to object class structure. */ #define G_INITIALLY_UNOWNED_GET_CLASS(object) (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass)) /* GInitiallyUnowned ia a GObject with initially floating reference count */ /* --- typedefs & structures --- */ typedef struct _GObject GObject; typedef struct _GObjectClass GObjectClass; typedef struct _GObject GInitiallyUnowned; typedef struct _GObjectClass GInitiallyUnownedClass; typedef struct _GObjectConstructParam GObjectConstructParam; /** * GObjectGetPropertyFunc: * @object: a #GObject * @property_id: the numeric id under which the property was registered with * g_object_class_install_property(). * @value: a #GValue to return the property value in * @pspec: the #GParamSpec describing the property * * The type of the @get_property function of #GObjectClass. */ typedef void (*GObjectGetPropertyFunc) (GObject *object, guint property_id, GValue *value, GParamSpec *pspec); /** * GObjectSetPropertyFunc: * @object: a #GObject * @property_id: the numeric id under which the property was registered with * g_object_class_install_property(). * @value: the new value for the property * @pspec: the #GParamSpec describing the property * * The type of the @set_property function of #GObjectClass. */ typedef void (*GObjectSetPropertyFunc) (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec); /** * GObjectFinalizeFunc: * @object: the #GObject being finalized * * The type of the @finalize function of #GObjectClass. */ typedef void (*GObjectFinalizeFunc) (GObject *object); /** * GWeakNotify: * @data: data that was provided when the weak reference was established * @where_the_object_was: the object being disposed * * A #GWeakNotify function can be added to an object as a callback that gets * triggered when the object is finalized. Since the object is already being * disposed when the #GWeakNotify is called, there's not much you could do * with the object, apart from e.g. using its address as hash-index or the like. */ typedef void (*GWeakNotify) (gpointer data, GObject *where_the_object_was); /** * GObject: * * All the fields in the GObject structure are private * to the #GObject implementation and should never be accessed directly. */ struct _GObject { GTypeInstance g_type_instance; /*< private >*/ guint ref_count; /* (atomic) */ GData *qdata; }; /** * GObjectClass: * @g_type_class: the parent class * @constructor: the @constructor function is called by g_object_new () to * complete the object initialization after all the construction properties are * set. The first thing a @constructor implementation must do is chain up to the * @constructor of the parent class. Overriding @constructor should be rarely * needed, e.g. to handle construct properties, or to implement singletons. * @set_property: the generic setter for all properties of this type. Should be * overridden for every type with properties. If implementations of * @set_property don't emit property change notification explicitly, this will * be done implicitly by the type system. However, if the notify signal is * emitted explicitly, the type system will not emit it a second time. * @get_property: the generic getter for all properties of this type. Should be * overridden for every type with properties. * @dispose: the @dispose function is supposed to drop all references to other * objects, but keep the instance otherwise intact, so that client method * invocations still work. It may be run multiple times (due to reference * loops). Before returning, @dispose should chain up to the @dispose method * of the parent class. * @finalize: instance finalization function, should finish the finalization of * the instance begun in @dispose and chain up to the @finalize method of the * parent class. * @dispatch_properties_changed: emits property change notification for a bunch * of properties. Overriding @dispatch_properties_changed should be rarely * needed. * @notify: the class closure for the notify signal * @constructed: the @constructed function is called by g_object_new() as the * final step of the object creation process. At the point of the call, all * construction properties have been set on the object. The purpose of this * call is to allow for object initialisation steps that can only be performed * after construction properties have been set. @constructed implementors * should chain up to the @constructed call of their parent class to allow it * to complete its initialisation. * * The class structure for the GObject type. * * |[<!-- language="C" --> * // Example of implementing a singleton using a constructor. * static MySingleton *the_singleton = NULL; * * static GObject* * my_singleton_constructor (GType type, * guint n_construct_params, * GObjectConstructParam *construct_params) * { * GObject *object; * * if (!the_singleton) * { * object = G_OBJECT_CLASS (parent_class)->constructor (type, * n_construct_params, * construct_params); * the_singleton = MY_SINGLETON (object); * } * else * object = g_object_ref (G_OBJECT (the_singleton)); * * return object; * } * ]| */ struct _GObjectClass { GTypeClass g_type_class; /*< private >*/ GSList *construct_properties; /*< public >*/ /* seldom overridden */ GObject* (*constructor) (GType type, guint n_construct_properties, GObjectConstructParam *construct_properties); /* overridable methods */ void (*set_property) (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec); void (*get_property) (GObject *object, guint property_id, GValue *value, GParamSpec *pspec); void (*dispose) (GObject *object); void (*finalize) (GObject *object); /* seldom overridden */ void (*dispatch_properties_changed) (GObject *object, guint n_pspecs, GParamSpec **pspecs); /* signals */ void (*notify) (GObject *object, GParamSpec *pspec); /* called when done constructing */ void (*constructed) (GObject *object); /*< private >*/ gsize flags; /* padding */ gpointer pdummy[6]; }; /** * GObjectConstructParam: * @pspec: the #GParamSpec of the construct parameter * @value: the value to set the parameter to * * The GObjectConstructParam struct is an auxiliary * structure used to hand #GParamSpec/#GValue pairs to the @constructor of * a #GObjectClass. */ struct _GObjectConstructParam { GParamSpec *pspec; GValue *value; }; /** * GInitiallyUnowned: * * All the fields in the GInitiallyUnowned structure * are private to the #GInitiallyUnowned implementation and should never be * accessed directly. */ /** * GInitiallyUnownedClass: * * The class structure for the GInitiallyUnowned type. */ /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GType g_initially_unowned_get_type (void); GLIB_AVAILABLE_IN_ALL void g_object_class_install_property (GObjectClass *oclass, guint property_id, GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL GParamSpec* g_object_class_find_property (GObjectClass *oclass, const gchar *property_name); GLIB_AVAILABLE_IN_ALL GParamSpec**g_object_class_list_properties (GObjectClass *oclass, guint *n_properties); GLIB_AVAILABLE_IN_ALL void g_object_class_override_property (GObjectClass *oclass, guint property_id, const gchar *name); GLIB_AVAILABLE_IN_ALL void g_object_class_install_properties (GObjectClass *oclass, guint n_pspecs, GParamSpec **pspecs); GLIB_AVAILABLE_IN_ALL void g_object_interface_install_property (gpointer g_iface, GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL GParamSpec* g_object_interface_find_property (gpointer g_iface, const gchar *property_name); GLIB_AVAILABLE_IN_ALL GParamSpec**g_object_interface_list_properties (gpointer g_iface, guint *n_properties_p); GLIB_AVAILABLE_IN_ALL GType g_object_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gpointer g_object_new (GType object_type, const gchar *first_property_name, ...); GLIB_AVAILABLE_IN_2_54 GObject* g_object_new_with_properties (GType object_type, guint n_properties, const char *names[], const GValue values[]); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_54_FOR(g_object_new_with_properties) gpointer g_object_newv (GType object_type, guint n_parameters, GParameter *parameters); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL GObject* g_object_new_valist (GType object_type, const gchar *first_property_name, va_list var_args); GLIB_AVAILABLE_IN_ALL void g_object_set (gpointer object, const gchar *first_property_name, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL void g_object_get (gpointer object, const gchar *first_property_name, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL gpointer g_object_connect (gpointer object, const gchar *signal_spec, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL void g_object_disconnect (gpointer object, const gchar *signal_spec, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_2_54 void g_object_setv (GObject *object, guint n_properties, const gchar *names[], const GValue values[]); GLIB_AVAILABLE_IN_ALL void g_object_set_valist (GObject *object, const gchar *first_property_name, va_list var_args); GLIB_AVAILABLE_IN_2_54 void g_object_getv (GObject *object, guint n_properties, const gchar *names[], GValue values[]); GLIB_AVAILABLE_IN_ALL void g_object_get_valist (GObject *object, const gchar *first_property_name, va_list var_args); GLIB_AVAILABLE_IN_ALL void g_object_set_property (GObject *object, const gchar *property_name, const GValue *value); GLIB_AVAILABLE_IN_ALL void g_object_get_property (GObject *object, const gchar *property_name, GValue *value); GLIB_AVAILABLE_IN_ALL void g_object_freeze_notify (GObject *object); GLIB_AVAILABLE_IN_ALL void g_object_notify (GObject *object, const gchar *property_name); GLIB_AVAILABLE_IN_ALL void g_object_notify_by_pspec (GObject *object, GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL void g_object_thaw_notify (GObject *object); GLIB_AVAILABLE_IN_ALL gboolean g_object_is_floating (gpointer object); GLIB_AVAILABLE_IN_ALL gpointer g_object_ref_sink (gpointer object); GLIB_AVAILABLE_IN_ALL gpointer g_object_ref (gpointer object); GLIB_AVAILABLE_IN_ALL void g_object_unref (gpointer object); GLIB_AVAILABLE_IN_ALL void g_object_weak_ref (GObject *object, GWeakNotify notify, gpointer data); GLIB_AVAILABLE_IN_ALL void g_object_weak_unref (GObject *object, GWeakNotify notify, gpointer data); GLIB_AVAILABLE_IN_ALL void g_object_add_weak_pointer (GObject *object, gpointer *weak_pointer_location); GLIB_AVAILABLE_IN_ALL void g_object_remove_weak_pointer (GObject *object, gpointer *weak_pointer_location); #if defined(glib_typeof) && GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_56 && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) /* Make reference APIs type safe with macros */ #define g_object_ref(Obj) ((glib_typeof (Obj)) (g_object_ref) (Obj)) #define g_object_ref_sink(Obj) ((glib_typeof (Obj)) (g_object_ref_sink) (Obj)) #endif /** * GToggleNotify: * @data: Callback data passed to g_object_add_toggle_ref() * @object: The object on which g_object_add_toggle_ref() was called. * @is_last_ref: %TRUE if the toggle reference is now the * last reference to the object. %FALSE if the toggle * reference was the last reference and there are now other * references. * * A callback function used for notification when the state * of a toggle reference changes. See g_object_add_toggle_ref(). */ typedef void (*GToggleNotify) (gpointer data, GObject *object, gboolean is_last_ref); GLIB_AVAILABLE_IN_ALL void g_object_add_toggle_ref (GObject *object, GToggleNotify notify, gpointer data); GLIB_AVAILABLE_IN_ALL void g_object_remove_toggle_ref (GObject *object, GToggleNotify notify, gpointer data); GLIB_AVAILABLE_IN_ALL gpointer g_object_get_qdata (GObject *object, GQuark quark); GLIB_AVAILABLE_IN_ALL void g_object_set_qdata (GObject *object, GQuark quark, gpointer data); GLIB_AVAILABLE_IN_ALL void g_object_set_qdata_full (GObject *object, GQuark quark, gpointer data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL gpointer g_object_steal_qdata (GObject *object, GQuark quark); GLIB_AVAILABLE_IN_2_34 gpointer g_object_dup_qdata (GObject *object, GQuark quark, GDuplicateFunc dup_func, gpointer user_data); GLIB_AVAILABLE_IN_2_34 gboolean g_object_replace_qdata (GObject *object, GQuark quark, gpointer oldval, gpointer newval, GDestroyNotify destroy, GDestroyNotify *old_destroy); GLIB_AVAILABLE_IN_ALL gpointer g_object_get_data (GObject *object, const gchar *key); GLIB_AVAILABLE_IN_ALL void g_object_set_data (GObject *object, const gchar *key, gpointer data); GLIB_AVAILABLE_IN_ALL void g_object_set_data_full (GObject *object, const gchar *key, gpointer data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL gpointer g_object_steal_data (GObject *object, const gchar *key); GLIB_AVAILABLE_IN_2_34 gpointer g_object_dup_data (GObject *object, const gchar *key, GDuplicateFunc dup_func, gpointer user_data); GLIB_AVAILABLE_IN_2_34 gboolean g_object_replace_data (GObject *object, const gchar *key, gpointer oldval, gpointer newval, GDestroyNotify destroy, GDestroyNotify *old_destroy); GLIB_AVAILABLE_IN_ALL void g_object_watch_closure (GObject *object, GClosure *closure); GLIB_AVAILABLE_IN_ALL GClosure* g_cclosure_new_object (GCallback callback_func, GObject *object); GLIB_AVAILABLE_IN_ALL GClosure* g_cclosure_new_object_swap (GCallback callback_func, GObject *object); GLIB_AVAILABLE_IN_ALL GClosure* g_closure_new_object (guint sizeof_closure, GObject *object); GLIB_AVAILABLE_IN_ALL void g_value_set_object (GValue *value, gpointer v_object); GLIB_AVAILABLE_IN_ALL gpointer g_value_get_object (const GValue *value); GLIB_AVAILABLE_IN_ALL gpointer g_value_dup_object (const GValue *value); GLIB_AVAILABLE_IN_ALL gulong g_signal_connect_object (gpointer instance, const gchar *detailed_signal, GCallback c_handler, gpointer gobject, GConnectFlags connect_flags); /*< protected >*/ GLIB_AVAILABLE_IN_ALL void g_object_force_floating (GObject *object); GLIB_AVAILABLE_IN_ALL void g_object_run_dispose (GObject *object); GLIB_AVAILABLE_IN_ALL void g_value_take_object (GValue *value, gpointer v_object); GLIB_DEPRECATED_FOR(g_value_take_object) void g_value_set_object_take_ownership (GValue *value, gpointer v_object); GLIB_DEPRECATED gsize g_object_compat_control (gsize what, gpointer data); /* --- implementation macros --- */ #define G_OBJECT_WARN_INVALID_PSPEC(object, pname, property_id, pspec) \ G_STMT_START { \ GObject *_glib__object = (GObject*) (object); \ GParamSpec *_glib__pspec = (GParamSpec*) (pspec); \ guint _glib__property_id = (property_id); \ g_warning ("%s:%d: invalid %s id %u for \"%s\" of type '%s' in '%s'", \ __FILE__, __LINE__, \ (pname), \ _glib__property_id, \ _glib__pspec->name, \ g_type_name (G_PARAM_SPEC_TYPE (_glib__pspec)), \ G_OBJECT_TYPE_NAME (_glib__object)); \ } G_STMT_END /** * G_OBJECT_WARN_INVALID_PROPERTY_ID: * @object: the #GObject on which set_property() or get_property() was called * @property_id: the numeric id of the property * @pspec: the #GParamSpec of the property * * This macro should be used to emit a standard warning about unexpected * properties in set_property() and get_property() implementations. */ #define G_OBJECT_WARN_INVALID_PROPERTY_ID(object, property_id, pspec) \ G_OBJECT_WARN_INVALID_PSPEC ((object), "property", (property_id), (pspec)) GLIB_AVAILABLE_IN_ALL void g_clear_object (GObject **object_ptr); #define g_clear_object(object_ptr) g_clear_pointer ((object_ptr), g_object_unref) /** * g_set_object: (skip) * @object_ptr: (inout) (not optional) (nullable): a pointer to a #GObject reference * @new_object: (nullable) (transfer none): a pointer to the new #GObject to * assign to @object_ptr, or %NULL to clear the pointer * * Updates a #GObject pointer to refer to @new_object. It increments the * reference count of @new_object (if non-%NULL), decrements the reference * count of the current value of @object_ptr (if non-%NULL), and assigns * @new_object to @object_ptr. The assignment is not atomic. * * @object_ptr must not be %NULL, but can point to a %NULL value. * * A macro is also included that allows this function to be used without * pointer casts. The function itself is static inline, so its address may vary * between compilation units. * * One convenient usage of this function is in implementing property setters: * |[ * void * foo_set_bar (Foo *foo, * Bar *new_bar) * { * g_return_if_fail (IS_FOO (foo)); * g_return_if_fail (new_bar == NULL || IS_BAR (new_bar)); * * if (g_set_object (&foo->bar, new_bar)) * g_object_notify (foo, "bar"); * } * ]| * * Returns: %TRUE if the value of @object_ptr changed, %FALSE otherwise * * Since: 2.44 */ static inline gboolean (g_set_object) (GObject **object_ptr, GObject *new_object) { GObject *old_object = *object_ptr; /* rely on g_object_[un]ref() to check the pointers are actually GObjects; * elide a (object_ptr != NULL) check because most of the time we will be * operating on struct members with a constant offset, so a NULL check would * not catch bugs */ if (old_object == new_object) return FALSE; if (new_object != NULL) g_object_ref (new_object); *object_ptr = new_object; if (old_object != NULL) g_object_unref (old_object); return TRUE; } /* We need GCC for __extension__, which we need to sort out strict aliasing of @object_ptr */ #if defined(__GNUC__) #define g_set_object(object_ptr, new_object) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(object_ptr) == sizeof (new_object)); \ /* Only one access, please; work around type aliasing */ \ union { char *in; GObject **out; } _object_ptr; \ _object_ptr.in = (char *) (object_ptr); \ /* Check types match */ \ (void) (0 ? *(object_ptr) = (new_object), FALSE : FALSE); \ (g_set_object) (_object_ptr.out, (GObject *) new_object); \ })) \ GLIB_AVAILABLE_MACRO_IN_2_44 #else /* if !defined(__GNUC__) */ #define g_set_object(object_ptr, new_object) \ (/* Check types match. */ \ 0 ? *(object_ptr) = (new_object), FALSE : \ (g_set_object) ((GObject **) (object_ptr), (GObject *) (new_object)) \ ) #endif /* !defined(__GNUC__) */ /** * g_assert_finalize_object: (skip) * @object: (transfer full) (type GObject.Object): an object * * Assert that @object is non-%NULL, then release one reference to it with * g_object_unref() and assert that it has been finalized (i.e. that there * are no more references). * * If assertions are disabled via `G_DISABLE_ASSERT`, * this macro just calls g_object_unref() without any further checks. * * This macro should only be used in regression tests. * * Since: 2.62 */ static inline void (g_assert_finalize_object) (GObject *object) { gpointer weak_pointer = object; g_assert_true (G_IS_OBJECT (weak_pointer)); g_object_add_weak_pointer (object, &weak_pointer); g_object_unref (weak_pointer); g_assert_null (weak_pointer); } #ifdef G_DISABLE_ASSERT #define g_assert_finalize_object(object) g_object_unref (object) #else #define g_assert_finalize_object(object) (g_assert_finalize_object ((GObject *) object)) #endif /** * g_clear_weak_pointer: (skip) * @weak_pointer_location: The memory address of a pointer * * Clears a weak reference to a #GObject. * * @weak_pointer_location must not be %NULL. * * If the weak reference is %NULL then this function does nothing. * Otherwise, the weak reference to the object is removed for that location * and the pointer is set to %NULL. * * A macro is also included that allows this function to be used without * pointer casts. The function itself is static inline, so its address may vary * between compilation units. * * Since: 2.56 */ static inline void (g_clear_weak_pointer) (gpointer *weak_pointer_location) { GObject *object = (GObject *) *weak_pointer_location; if (object != NULL) { g_object_remove_weak_pointer (object, weak_pointer_location); *weak_pointer_location = NULL; } } #define g_clear_weak_pointer(weak_pointer_location) \ (/* Check types match. */ \ (g_clear_weak_pointer) ((gpointer *) (weak_pointer_location)) \ ) /** * g_set_weak_pointer: (skip) * @weak_pointer_location: the memory address of a pointer * @new_object: (nullable) (transfer none): a pointer to the new #GObject to * assign to it, or %NULL to clear the pointer * * Updates a pointer to weakly refer to @new_object. It assigns @new_object * to @weak_pointer_location and ensures that @weak_pointer_location will * automatically be set to %NULL if @new_object gets destroyed. The assignment * is not atomic. The weak reference is not thread-safe, see * g_object_add_weak_pointer() for details. * * @weak_pointer_location must not be %NULL. * * A macro is also included that allows this function to be used without * pointer casts. The function itself is static inline, so its address may vary * between compilation units. * * One convenient usage of this function is in implementing property setters: * |[ * void * foo_set_bar (Foo *foo, * Bar *new_bar) * { * g_return_if_fail (IS_FOO (foo)); * g_return_if_fail (new_bar == NULL || IS_BAR (new_bar)); * * if (g_set_weak_pointer (&foo->bar, new_bar)) * g_object_notify (foo, "bar"); * } * ]| * * Returns: %TRUE if the value of @weak_pointer_location changed, %FALSE otherwise * * Since: 2.56 */ static inline gboolean (g_set_weak_pointer) (gpointer *weak_pointer_location, GObject *new_object) { GObject *old_object = (GObject *) *weak_pointer_location; /* elide a (weak_pointer_location != NULL) check because most of the time we * will be operating on struct members with a constant offset, so a NULL * check would not catch bugs */ if (old_object == new_object) return FALSE; if (old_object != NULL) g_object_remove_weak_pointer (old_object, weak_pointer_location); *weak_pointer_location = new_object; if (new_object != NULL) g_object_add_weak_pointer (new_object, weak_pointer_location); return TRUE; } #define g_set_weak_pointer(weak_pointer_location, new_object) \ (/* Check types match. */ \ 0 ? *(weak_pointer_location) = (new_object), FALSE : \ (g_set_weak_pointer) ((gpointer *) (weak_pointer_location), (GObject *) (new_object)) \ ) typedef struct { /*<private>*/ union { gpointer p; } priv; } GWeakRef; GLIB_AVAILABLE_IN_ALL void g_weak_ref_init (GWeakRef *weak_ref, gpointer object); GLIB_AVAILABLE_IN_ALL void g_weak_ref_clear (GWeakRef *weak_ref); GLIB_AVAILABLE_IN_ALL gpointer g_weak_ref_get (GWeakRef *weak_ref); GLIB_AVAILABLE_IN_ALL void g_weak_ref_set (GWeakRef *weak_ref, gpointer object); G_END_DECLS #endif /* __G_OBJECT_H__ */ gobject/gvaluetypes.h 0000644 00000024015 15125173650 0010711 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1997-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gvaluetypes.h: GLib default values */ #ifndef __G_VALUETYPES_H__ #define __G_VALUETYPES_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gvalue.h> G_BEGIN_DECLS /* --- type macros --- */ /** * G_VALUE_HOLDS_CHAR: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_CHAR. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_CHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_CHAR)) /** * G_VALUE_HOLDS_UCHAR: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_UCHAR. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_UCHAR(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UCHAR)) /** * G_VALUE_HOLDS_BOOLEAN: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_BOOLEAN. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_BOOLEAN(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOOLEAN)) /** * G_VALUE_HOLDS_INT: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_INT. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_INT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT)) /** * G_VALUE_HOLDS_UINT: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_UINT. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_UINT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT)) /** * G_VALUE_HOLDS_LONG: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_LONG. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_LONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_LONG)) /** * G_VALUE_HOLDS_ULONG: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_ULONG. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_ULONG(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ULONG)) /** * G_VALUE_HOLDS_INT64: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_INT64. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_INT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT64)) /** * G_VALUE_HOLDS_UINT64: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_UINT64. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_UINT64(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT64)) /** * G_VALUE_HOLDS_FLOAT: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_FLOAT. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_FLOAT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLOAT)) /** * G_VALUE_HOLDS_DOUBLE: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_DOUBLE. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_DOUBLE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_DOUBLE)) /** * G_VALUE_HOLDS_STRING: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_STRING. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_STRING(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_STRING)) /** * G_VALUE_IS_INTERNED_STRING: * @value: a valid #GValue structure * * Checks whether @value contains a string which is canonical. * * Returns: %TRUE if the value contains a string in its canonical * representation, as returned by g_intern_string(). See also * g_value_set_interned_string(). * * Since: 2.66 */ #define G_VALUE_IS_INTERNED_STRING(value) (G_VALUE_HOLDS_STRING (value) && ((value)->data[1].v_uint & G_VALUE_INTERNED_STRING)) GLIB_AVAILABLE_MACRO_IN_2_66 /** * G_VALUE_HOLDS_POINTER: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_POINTER. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_POINTER(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_POINTER)) /** * G_TYPE_GTYPE: * * The type for #GType. */ #define G_TYPE_GTYPE (g_gtype_get_type()) /** * G_VALUE_HOLDS_GTYPE: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_GTYPE. * * Since: 2.12 * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_GTYPE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_GTYPE)) /** * G_VALUE_HOLDS_VARIANT: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values of type %G_TYPE_VARIANT. * * Returns: %TRUE on success. * * Since: 2.26 */ #define G_VALUE_HOLDS_VARIANT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_VARIANT)) /* --- prototypes --- */ GLIB_DEPRECATED_IN_2_32_FOR(g_value_set_schar) void g_value_set_char (GValue *value, gchar v_char); GLIB_DEPRECATED_IN_2_32_FOR(g_value_get_schar) gchar g_value_get_char (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_schar (GValue *value, gint8 v_char); GLIB_AVAILABLE_IN_ALL gint8 g_value_get_schar (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_uchar (GValue *value, guchar v_uchar); GLIB_AVAILABLE_IN_ALL guchar g_value_get_uchar (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_boolean (GValue *value, gboolean v_boolean); GLIB_AVAILABLE_IN_ALL gboolean g_value_get_boolean (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_int (GValue *value, gint v_int); GLIB_AVAILABLE_IN_ALL gint g_value_get_int (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_uint (GValue *value, guint v_uint); GLIB_AVAILABLE_IN_ALL guint g_value_get_uint (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_long (GValue *value, glong v_long); GLIB_AVAILABLE_IN_ALL glong g_value_get_long (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_ulong (GValue *value, gulong v_ulong); GLIB_AVAILABLE_IN_ALL gulong g_value_get_ulong (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_int64 (GValue *value, gint64 v_int64); GLIB_AVAILABLE_IN_ALL gint64 g_value_get_int64 (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_uint64 (GValue *value, guint64 v_uint64); GLIB_AVAILABLE_IN_ALL guint64 g_value_get_uint64 (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_float (GValue *value, gfloat v_float); GLIB_AVAILABLE_IN_ALL gfloat g_value_get_float (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_double (GValue *value, gdouble v_double); GLIB_AVAILABLE_IN_ALL gdouble g_value_get_double (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_string (GValue *value, const gchar *v_string); GLIB_AVAILABLE_IN_ALL void g_value_set_static_string (GValue *value, const gchar *v_string); GLIB_AVAILABLE_IN_2_66 void g_value_set_interned_string (GValue *value, const gchar *v_string); GLIB_AVAILABLE_IN_ALL const gchar * g_value_get_string (const GValue *value); GLIB_AVAILABLE_IN_ALL gchar* g_value_dup_string (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_pointer (GValue *value, gpointer v_pointer); GLIB_AVAILABLE_IN_ALL gpointer g_value_get_pointer (const GValue *value); GLIB_AVAILABLE_IN_ALL GType g_gtype_get_type (void); GLIB_AVAILABLE_IN_ALL void g_value_set_gtype (GValue *value, GType v_gtype); GLIB_AVAILABLE_IN_ALL GType g_value_get_gtype (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_variant (GValue *value, GVariant *variant); GLIB_AVAILABLE_IN_ALL void g_value_take_variant (GValue *value, GVariant *variant); GLIB_AVAILABLE_IN_ALL GVariant* g_value_get_variant (const GValue *value); GLIB_AVAILABLE_IN_ALL GVariant* g_value_dup_variant (const GValue *value); /* Convenience for registering new pointer types */ GLIB_AVAILABLE_IN_ALL GType g_pointer_type_register_static (const gchar *name); /* debugging aid, describe value contents as string */ GLIB_AVAILABLE_IN_ALL gchar* g_strdup_value_contents (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_take_string (GValue *value, gchar *v_string); GLIB_DEPRECATED_FOR(g_value_take_string) void g_value_set_string_take_ownership (GValue *value, gchar *v_string); /* humpf, need a C representable type name for G_TYPE_STRING */ /** * gchararray: * * A C representable type name for #G_TYPE_STRING. */ typedef gchar* gchararray; G_END_DECLS #endif /* __G_VALUETYPES_H__ */ gobject/gobject-autocleanups.h 0000644 00000002546 15125173650 0012464 0 ustar 00 /* * Copyright © 2015 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif G_DEFINE_AUTOPTR_CLEANUP_FUNC(GClosure, g_closure_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GEnumClass, g_type_class_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFlagsClass, g_type_class_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GObject, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInitiallyUnowned, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GParamSpec, g_param_spec_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTypeClass, g_type_class_unref) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GValue, g_value_unset) gobject/gclosure.h 0000644 00000025425 15125173650 0010172 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000-2001 Red Hat, Inc. * Copyright (C) 2005 Imendio AB * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_CLOSURE_H__ #define __G_CLOSURE_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> G_BEGIN_DECLS /* --- defines --- */ /** * G_CLOSURE_NEEDS_MARSHAL: * @closure: a #GClosure * * Check if the closure still needs a marshaller. See g_closure_set_marshal(). * * Returns: %TRUE if a #GClosureMarshal marshaller has not yet been set on * @closure. */ #define G_CLOSURE_NEEDS_MARSHAL(closure) (((GClosure*) (closure))->marshal == NULL) /** * G_CLOSURE_N_NOTIFIERS: * @cl: a #GClosure * * Get the total number of notifiers connected with the closure @cl. * The count includes the meta marshaller, the finalize and invalidate notifiers * and the marshal guards. Note that each guard counts as two notifiers. * See g_closure_set_meta_marshal(), g_closure_add_finalize_notifier(), * g_closure_add_invalidate_notifier() and g_closure_add_marshal_guards(). * * Returns: number of notifiers */ #define G_CLOSURE_N_NOTIFIERS(cl) (((cl)->n_guards << 1L) + \ (cl)->n_fnotifiers + (cl)->n_inotifiers) /** * G_CCLOSURE_SWAP_DATA: * @cclosure: a #GCClosure * * Checks whether the user data of the #GCClosure should be passed as the * first parameter to the callback. See g_cclosure_new_swap(). * * Returns: %TRUE if data has to be swapped. */ #define G_CCLOSURE_SWAP_DATA(cclosure) (((GClosure*) (cclosure))->derivative_flag) /** * G_CALLBACK: * @f: a function pointer. * * Cast a function pointer to a #GCallback. */ #define G_CALLBACK(f) ((GCallback) (f)) /* -- typedefs --- */ typedef struct _GClosure GClosure; typedef struct _GClosureNotifyData GClosureNotifyData; /** * GCallback: * * The type used for callback functions in structure definitions and function * signatures. This doesn't mean that all callback functions must take no * parameters and return void. The required signature of a callback function * is determined by the context in which is used (e.g. the signal to which it * is connected). Use G_CALLBACK() to cast the callback function to a #GCallback. */ typedef void (*GCallback) (void); /** * GClosureNotify: * @data: data specified when registering the notification callback * @closure: the #GClosure on which the notification is emitted * * The type used for the various notification callbacks which can be registered * on closures. */ typedef void (*GClosureNotify) (gpointer data, GClosure *closure); /** * GClosureMarshal: * @closure: the #GClosure to which the marshaller belongs * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @n_param_values: the length of the @param_values array * @param_values: (array length=n_param_values): an array of * #GValues holding the arguments on which to invoke the * callback of @closure * @invocation_hint: (nullable): the invocation hint given as the * last argument to g_closure_invoke() * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * * The type used for marshaller functions. */ typedef void (*GClosureMarshal) (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); /** * GVaClosureMarshal: * @closure: the #GClosure to which the marshaller belongs * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is * invoked. * @args: va_list of arguments to be passed to the closure. * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array * @param_types: (array length=n_params): the #GType of each argument from * @args. * * This is the signature of va_list marshaller functions, an optional * marshaller that can be used in some situations to avoid * marshalling the signal argument into GValues. */ typedef void (* GVaClosureMarshal) (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /** * GCClosure: * @closure: the #GClosure * @callback: the callback function * * A #GCClosure is a specialization of #GClosure for C function callbacks. */ typedef struct _GCClosure GCClosure; /* --- structures --- */ struct _GClosureNotifyData { gpointer data; GClosureNotify notify; }; /** * GClosure: * @in_marshal: Indicates whether the closure is currently being invoked with * g_closure_invoke() * @is_invalid: Indicates whether the closure has been invalidated by * g_closure_invalidate() * * A #GClosure represents a callback supplied by the programmer. */ struct _GClosure { /*< private >*/ guint ref_count : 15; /* (atomic) */ /* meta_marshal is not used anymore but must be zero for historical reasons as it was exposed in the G_CLOSURE_N_NOTIFIERS macro */ guint meta_marshal_nouse : 1; /* (atomic) */ guint n_guards : 1; /* (atomic) */ guint n_fnotifiers : 2; /* finalization notifiers (atomic) */ guint n_inotifiers : 8; /* invalidation notifiers (atomic) */ guint in_inotify : 1; /* (atomic) */ guint floating : 1; /* (atomic) */ /*< protected >*/ guint derivative_flag : 1; /* (atomic) */ /*< public >*/ guint in_marshal : 1; /* (atomic) */ guint is_invalid : 1; /* (atomic) */ /*< private >*/ void (*marshal) (GClosure *closure, GValue /*out*/ *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); /*< protected >*/ gpointer data; /*< private >*/ GClosureNotifyData *notifiers; /* invariants/constraints: * - ->marshal and ->data are _invalid_ as soon as ->is_invalid==TRUE * - invocation of all inotifiers occurs prior to fnotifiers * - order of inotifiers is random * inotifiers may _not_ free/invalidate parameter values (e.g. ->data) * - order of fnotifiers is random * - each notifier may only be removed before or during its invocation * - reference counting may only happen prior to fnotify invocation * (in that sense, fnotifiers are really finalization handlers) */ }; /* closure for C function calls, callback() is the user function */ struct _GCClosure { GClosure closure; gpointer callback; }; /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GClosure* g_cclosure_new (GCallback callback_func, gpointer user_data, GClosureNotify destroy_data); GLIB_AVAILABLE_IN_ALL GClosure* g_cclosure_new_swap (GCallback callback_func, gpointer user_data, GClosureNotify destroy_data); GLIB_AVAILABLE_IN_ALL GClosure* g_signal_type_cclosure_new (GType itype, guint struct_offset); /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GClosure* g_closure_ref (GClosure *closure); GLIB_AVAILABLE_IN_ALL void g_closure_sink (GClosure *closure); GLIB_AVAILABLE_IN_ALL void g_closure_unref (GClosure *closure); /* intimidating */ GLIB_AVAILABLE_IN_ALL GClosure* g_closure_new_simple (guint sizeof_closure, gpointer data); GLIB_AVAILABLE_IN_ALL void g_closure_add_finalize_notifier (GClosure *closure, gpointer notify_data, GClosureNotify notify_func); GLIB_AVAILABLE_IN_ALL void g_closure_remove_finalize_notifier (GClosure *closure, gpointer notify_data, GClosureNotify notify_func); GLIB_AVAILABLE_IN_ALL void g_closure_add_invalidate_notifier (GClosure *closure, gpointer notify_data, GClosureNotify notify_func); GLIB_AVAILABLE_IN_ALL void g_closure_remove_invalidate_notifier (GClosure *closure, gpointer notify_data, GClosureNotify notify_func); GLIB_AVAILABLE_IN_ALL void g_closure_add_marshal_guards (GClosure *closure, gpointer pre_marshal_data, GClosureNotify pre_marshal_notify, gpointer post_marshal_data, GClosureNotify post_marshal_notify); GLIB_AVAILABLE_IN_ALL void g_closure_set_marshal (GClosure *closure, GClosureMarshal marshal); GLIB_AVAILABLE_IN_ALL void g_closure_set_meta_marshal (GClosure *closure, gpointer marshal_data, GClosureMarshal meta_marshal); GLIB_AVAILABLE_IN_ALL void g_closure_invalidate (GClosure *closure); GLIB_AVAILABLE_IN_ALL void g_closure_invoke (GClosure *closure, GValue /*out*/ *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint); /* FIXME: OK: data_object::destroy -> closure_invalidate(); MIS: closure_invalidate() -> disconnect(closure); MIS: disconnect(closure) -> (unlink) closure_unref(); OK: closure_finalize() -> g_free (data_string); random remarks: - need marshaller repo with decent aliasing to base types - provide marshaller collection, virtually covering anything out there */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_generic (GClosure *closure, GValue *return_gvalue, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_generic_va (GClosure *closure, GValue *return_value, gpointer instance, va_list args_list, gpointer marshal_data, int n_params, GType *param_types); G_END_DECLS #endif /* __G_CLOSURE_H__ */ gobject/gvaluearray.h 0000644 00000006222 15125173650 0010663 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2001 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gvaluearray.h: GLib array type holding GValues */ #ifndef __G_VALUE_ARRAY_H__ #define __G_VALUE_ARRAY_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gvalue.h> G_BEGIN_DECLS /** * G_TYPE_VALUE_ARRAY: * * The type ID of the "GValueArray" type which is a boxed type, * used to pass around pointers to GValueArrays. * * Deprecated: 2.32: Use #GArray instead of #GValueArray */ #define G_TYPE_VALUE_ARRAY (g_value_array_get_type ()) GLIB_DEPRECATED_MACRO_IN_2_32_FOR(G_TYPE_ARRAY) /* --- typedefs & structs --- */ typedef struct _GValueArray GValueArray; /** * GValueArray: * @n_values: number of values contained in the array * @values: array of values * * A #GValueArray contains an array of #GValue elements. */ struct _GValueArray { guint n_values; GValue *values; /*< private >*/ guint n_prealloced; }; /* --- prototypes --- */ GLIB_DEPRECATED_IN_2_32_FOR(GArray) GType g_value_array_get_type (void) G_GNUC_CONST; GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValue* g_value_array_get_nth (GValueArray *value_array, guint index_); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_new (guint n_prealloced); GLIB_DEPRECATED_IN_2_32_FOR(GArray) void g_value_array_free (GValueArray *value_array); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_copy (const GValueArray *value_array); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_prepend (GValueArray *value_array, const GValue *value); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_append (GValueArray *value_array, const GValue *value); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_insert (GValueArray *value_array, guint index_, const GValue *value); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_remove (GValueArray *value_array, guint index_); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_sort (GValueArray *value_array, GCompareFunc compare_func); GLIB_DEPRECATED_IN_2_32_FOR(GArray) GValueArray* g_value_array_sort_with_data (GValueArray *value_array, GCompareDataFunc compare_func, gpointer user_data); G_END_DECLS #endif /* __G_VALUE_ARRAY_H__ */ gobject/gtypemodule.h 0000644 00000025125 15125173650 0010702 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_TYPE_MODULE_H__ #define __G_TYPE_MODULE_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gobject.h> #include <gobject/genums.h> G_BEGIN_DECLS typedef struct _GTypeModule GTypeModule; typedef struct _GTypeModuleClass GTypeModuleClass; #define G_TYPE_TYPE_MODULE (g_type_module_get_type ()) #define G_TYPE_MODULE(module) (G_TYPE_CHECK_INSTANCE_CAST ((module), G_TYPE_TYPE_MODULE, GTypeModule)) #define G_TYPE_MODULE_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_TYPE_MODULE, GTypeModuleClass)) #define G_IS_TYPE_MODULE(module) (G_TYPE_CHECK_INSTANCE_TYPE ((module), G_TYPE_TYPE_MODULE)) #define G_IS_TYPE_MODULE_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_TYPE_MODULE)) #define G_TYPE_MODULE_GET_CLASS(module) (G_TYPE_INSTANCE_GET_CLASS ((module), G_TYPE_TYPE_MODULE, GTypeModuleClass)) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTypeModule, g_object_unref) /** * GTypeModule: * @name: the name of the module * * The members of the GTypeModule structure should not * be accessed directly, except for the @name field. */ struct _GTypeModule { GObject parent_instance; guint use_count; GSList *type_infos; GSList *interface_infos; /*< public >*/ gchar *name; }; /** * GTypeModuleClass: * @parent_class: the parent class * @load: loads the module and registers one or more types using * g_type_module_register_type(). * @unload: unloads the module * * In order to implement dynamic loading of types based on #GTypeModule, * the @load and @unload functions in #GTypeModuleClass must be implemented. */ struct _GTypeModuleClass { GObjectClass parent_class; /*< public >*/ gboolean (* load) (GTypeModule *module); void (* unload) (GTypeModule *module); /*< private >*/ /* Padding for future expansion */ void (*reserved1) (void); void (*reserved2) (void); void (*reserved3) (void); void (*reserved4) (void); }; /** * G_DEFINE_DYNAMIC_TYPE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by '_'. * @T_P: The #GType of the parent type. * * A convenience macro for dynamic type implementations, which declares a * class initialization function, an instance initialization function (see * #GTypeInfo for information about these) and a static variable named * `t_n`_parent_class pointing to the parent class. Furthermore, * it defines a `*_get_type()` and a static `*_register_type()` functions * for use in your `module_init()`. * * See G_DEFINE_DYNAMIC_TYPE_EXTENDED() for an example. * * Since: 2.14 */ #define G_DEFINE_DYNAMIC_TYPE(TN, t_n, T_P) G_DEFINE_DYNAMIC_TYPE_EXTENDED (TN, t_n, T_P, 0, {}) /** * G_DEFINE_DYNAMIC_TYPE_EXTENDED: * @TypeName: The name of the new type, in Camel case. * @type_name: The name of the new type, in lowercase, with words * separated by '_'. * @TYPE_PARENT: The #GType of the parent type. * @flags: #GTypeFlags to pass to g_type_module_register_type() * @CODE: Custom code that gets inserted in the *_get_type() function. * * A more general version of G_DEFINE_DYNAMIC_TYPE() which * allows to specify #GTypeFlags and custom code. * * |[ * G_DEFINE_DYNAMIC_TYPE_EXTENDED (GtkGadget, * gtk_gadget, * GTK_TYPE_THING, * 0, * G_IMPLEMENT_INTERFACE_DYNAMIC (TYPE_GIZMO, * gtk_gadget_gizmo_init)); * ]| * expands to * |[ * static void gtk_gadget_init (GtkGadget *self); * static void gtk_gadget_class_init (GtkGadgetClass *klass); * static void gtk_gadget_class_finalize (GtkGadgetClass *klass); * * static gpointer gtk_gadget_parent_class = NULL; * static GType gtk_gadget_type_id = 0; * * static void gtk_gadget_class_intern_init (gpointer klass) * { * gtk_gadget_parent_class = g_type_class_peek_parent (klass); * gtk_gadget_class_init ((GtkGadgetClass*) klass); * } * * GType * gtk_gadget_get_type (void) * { * return gtk_gadget_type_id; * } * * static void * gtk_gadget_register_type (GTypeModule *type_module) * { * const GTypeInfo g_define_type_info = { * sizeof (GtkGadgetClass), * (GBaseInitFunc) NULL, * (GBaseFinalizeFunc) NULL, * (GClassInitFunc) gtk_gadget_class_intern_init, * (GClassFinalizeFunc) gtk_gadget_class_finalize, * NULL, // class_data * sizeof (GtkGadget), * 0, // n_preallocs * (GInstanceInitFunc) gtk_gadget_init, * NULL // value_table * }; * gtk_gadget_type_id = g_type_module_register_type (type_module, * GTK_TYPE_THING, * "GtkGadget", * &g_define_type_info, * (GTypeFlags) flags); * { * const GInterfaceInfo g_implement_interface_info = { * (GInterfaceInitFunc) gtk_gadget_gizmo_init * }; * g_type_module_add_interface (type_module, g_define_type_id, TYPE_GIZMO, &g_implement_interface_info); * } * } * ]| * * Since: 2.14 */ #define G_DEFINE_DYNAMIC_TYPE_EXTENDED(TypeName, type_name, TYPE_PARENT, flags, CODE) \ static void type_name##_init (TypeName *self); \ static void type_name##_class_init (TypeName##Class *klass); \ static void type_name##_class_finalize (TypeName##Class *klass); \ static gpointer type_name##_parent_class = NULL; \ static GType type_name##_type_id = 0; \ static gint TypeName##_private_offset; \ \ _G_DEFINE_TYPE_EXTENDED_CLASS_INIT(TypeName, type_name) \ \ G_GNUC_UNUSED \ static inline gpointer \ type_name##_get_instance_private (TypeName *self) \ { \ return (G_STRUCT_MEMBER_P (self, TypeName##_private_offset)); \ } \ \ GType \ type_name##_get_type (void) \ { \ return type_name##_type_id; \ } \ static void \ type_name##_register_type (GTypeModule *type_module) \ { \ GType g_define_type_id G_GNUC_UNUSED; \ const GTypeInfo g_define_type_info = { \ sizeof (TypeName##Class), \ (GBaseInitFunc) NULL, \ (GBaseFinalizeFunc) NULL, \ (GClassInitFunc)(void (*)(void)) type_name##_class_intern_init, \ (GClassFinalizeFunc)(void (*)(void)) type_name##_class_finalize, \ NULL, /* class_data */ \ sizeof (TypeName), \ 0, /* n_preallocs */ \ (GInstanceInitFunc)(void (*)(void)) type_name##_init, \ NULL /* value_table */ \ }; \ type_name##_type_id = g_type_module_register_type (type_module, \ TYPE_PARENT, \ #TypeName, \ &g_define_type_info, \ (GTypeFlags) flags); \ g_define_type_id = type_name##_type_id; \ { CODE ; } \ } /** * G_IMPLEMENT_INTERFACE_DYNAMIC: * @TYPE_IFACE: The #GType of the interface to add * @iface_init: The interface init function * * A convenience macro to ease interface addition in the @_C_ section * of G_DEFINE_DYNAMIC_TYPE_EXTENDED(). See G_DEFINE_DYNAMIC_TYPE_EXTENDED() * for an example. * * Note that this macro can only be used together with the * G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable * names from that macro. * * Since: 2.24 */ #define G_IMPLEMENT_INTERFACE_DYNAMIC(TYPE_IFACE, iface_init) { \ const GInterfaceInfo g_implement_interface_info = { \ (GInterfaceInitFunc)(void (*)(void)) iface_init, NULL, NULL \ }; \ g_type_module_add_interface (type_module, g_define_type_id, TYPE_IFACE, &g_implement_interface_info); \ } /** * G_ADD_PRIVATE_DYNAMIC: * @TypeName: the name of the type in CamelCase * * A convenience macro to ease adding private data to instances of a new dynamic * type in the @_C_ section of G_DEFINE_DYNAMIC_TYPE_EXTENDED(). See * G_ADD_PRIVATE() for details, it is similar but for static types. * * Note that this macro can only be used together with the * G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable * names from that macro. * * Since: 2.38 */ #define G_ADD_PRIVATE_DYNAMIC(TypeName) { \ TypeName##_private_offset = sizeof (TypeName##Private); \ } GLIB_AVAILABLE_IN_ALL GType g_type_module_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_type_module_use (GTypeModule *module); GLIB_AVAILABLE_IN_ALL void g_type_module_unuse (GTypeModule *module); GLIB_AVAILABLE_IN_ALL void g_type_module_set_name (GTypeModule *module, const gchar *name); GLIB_AVAILABLE_IN_ALL GType g_type_module_register_type (GTypeModule *module, GType parent_type, const gchar *type_name, const GTypeInfo *type_info, GTypeFlags flags); GLIB_AVAILABLE_IN_ALL void g_type_module_add_interface (GTypeModule *module, GType instance_type, GType interface_type, const GInterfaceInfo *interface_info); GLIB_AVAILABLE_IN_ALL GType g_type_module_register_enum (GTypeModule *module, const gchar *name, const GEnumValue *const_static_values); GLIB_AVAILABLE_IN_ALL GType g_type_module_register_flags (GTypeModule *module, const gchar *name, const GFlagsValue *const_static_values); G_END_DECLS #endif /* __G_TYPE_MODULE_H__ */ gobject/gobjectnotifyqueue.c 0000644 00000012614 15125173650 0012251 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* WARNING: * * This file is INSTALLED and other projects (outside of glib) * #include its contents. */ #ifndef __G_OBJECT_NOTIFY_QUEUE_H__ #define __G_OBJECT_NOTIFY_QUEUE_H__ #include <string.h> /* memset */ #include <glib-object.h> G_BEGIN_DECLS /* --- typedefs --- */ typedef struct _GObjectNotifyContext GObjectNotifyContext; typedef struct _GObjectNotifyQueue GObjectNotifyQueue; typedef void (*GObjectNotifyQueueDispatcher) (GObject *object, guint n_pspecs, GParamSpec **pspecs); /* --- structures --- */ struct _GObjectNotifyContext { GQuark quark_notify_queue; GObjectNotifyQueueDispatcher dispatcher; GTrashStack *_nqueue_trash; /* unused */ }; struct _GObjectNotifyQueue { GObjectNotifyContext *context; GSList *pspecs; guint16 n_pspecs; guint16 freeze_count; }; G_LOCK_DEFINE_STATIC(notify_lock); /* --- functions --- */ static void g_object_notify_queue_free (gpointer data) { GObjectNotifyQueue *nqueue = data; g_slist_free (nqueue->pspecs); g_slice_free (GObjectNotifyQueue, nqueue); } static inline GObjectNotifyQueue* g_object_notify_queue_freeze (GObject *object, GObjectNotifyContext *context) { GObjectNotifyQueue *nqueue; G_LOCK(notify_lock); nqueue = g_datalist_id_get_data (&object->qdata, context->quark_notify_queue); if (!nqueue) { nqueue = g_slice_new0 (GObjectNotifyQueue); nqueue->context = context; g_datalist_id_set_data_full (&object->qdata, context->quark_notify_queue, nqueue, g_object_notify_queue_free); } if (nqueue->freeze_count >= 65535) g_critical("Free queue for %s (%p) is larger than 65535," " called g_object_freeze_notify() too often." " Forgot to call g_object_thaw_notify() or infinite loop", G_OBJECT_TYPE_NAME (object), object); else nqueue->freeze_count++; G_UNLOCK(notify_lock); return nqueue; } static inline void g_object_notify_queue_thaw (GObject *object, GObjectNotifyQueue *nqueue) { GObjectNotifyContext *context = nqueue->context; GParamSpec *pspecs_mem[16], **pspecs, **free_me = NULL; GSList *slist; guint n_pspecs = 0; g_return_if_fail (nqueue->freeze_count > 0); g_return_if_fail (g_atomic_int_get(&object->ref_count) > 0); G_LOCK(notify_lock); /* Just make sure we never get into some nasty race condition */ if (G_UNLIKELY(nqueue->freeze_count == 0)) { G_UNLOCK(notify_lock); g_warning ("%s: property-changed notification for %s(%p) is not frozen", G_STRFUNC, G_OBJECT_TYPE_NAME (object), object); return; } nqueue->freeze_count--; if (nqueue->freeze_count) { G_UNLOCK(notify_lock); return; } pspecs = nqueue->n_pspecs > 16 ? free_me = g_new (GParamSpec*, nqueue->n_pspecs) : pspecs_mem; for (slist = nqueue->pspecs; slist; slist = slist->next) { pspecs[n_pspecs++] = slist->data; } g_datalist_id_set_data (&object->qdata, context->quark_notify_queue, NULL); G_UNLOCK(notify_lock); if (n_pspecs) context->dispatcher (object, n_pspecs, pspecs); g_free (free_me); } static inline void g_object_notify_queue_clear (GObject *object, GObjectNotifyQueue *nqueue) { g_return_if_fail (nqueue->freeze_count > 0); G_LOCK(notify_lock); g_slist_free (nqueue->pspecs); nqueue->pspecs = NULL; nqueue->n_pspecs = 0; G_UNLOCK(notify_lock); } static inline void g_object_notify_queue_add (GObject *object, GObjectNotifyQueue *nqueue, GParamSpec *pspec) { if (pspec->flags & G_PARAM_READABLE) { GParamSpec *redirect; G_LOCK(notify_lock); g_return_if_fail (nqueue->n_pspecs < 65535); redirect = g_param_spec_get_redirect_target (pspec); if (redirect) pspec = redirect; /* we do the deduping in _thaw */ if (g_slist_find (nqueue->pspecs, pspec) == NULL) { nqueue->pspecs = g_slist_prepend (nqueue->pspecs, pspec); nqueue->n_pspecs++; } G_UNLOCK(notify_lock); } } /* NB: This function is not threadsafe, do not ever use it if * you need a threadsafe notify queue. * Use g_object_notify_queue_freeze() to acquire the queue and * g_object_notify_queue_thaw() after you are done instead. */ static inline GObjectNotifyQueue* g_object_notify_queue_from_object (GObject *object, GObjectNotifyContext *context) { return g_datalist_id_get_data (&object->qdata, context->quark_notify_queue); } G_END_DECLS #endif /* __G_OBJECT_NOTIFY_QUEUE_H__ */ gobject/gparam.h 0000644 00000040220 15125173650 0007604 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1997-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gparam.h: GParamSpec base class implementation */ #ifndef __G_PARAM_H__ #define __G_PARAM_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gvalue.h> G_BEGIN_DECLS /* --- standard type macros --- */ /** * G_TYPE_IS_PARAM: * @type: a #GType ID * * Checks whether @type "is a" %G_TYPE_PARAM. */ #define G_TYPE_IS_PARAM(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_PARAM) /** * G_PARAM_SPEC: * @pspec: a valid #GParamSpec * * Casts a derived #GParamSpec object (e.g. of type #GParamSpecInt) into * a #GParamSpec object. */ #define G_PARAM_SPEC(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM, GParamSpec)) /** * G_IS_PARAM_SPEC: * @pspec: a #GParamSpec * * Checks whether @pspec "is a" valid #GParamSpec structure of type %G_TYPE_PARAM * or derived. */ #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_42 #define G_IS_PARAM_SPEC(pspec) (G_TYPE_CHECK_INSTANCE_FUNDAMENTAL_TYPE ((pspec), G_TYPE_PARAM)) #else #define G_IS_PARAM_SPEC(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM)) #endif /** * G_PARAM_SPEC_CLASS: * @pclass: a valid #GParamSpecClass * * Casts a derived #GParamSpecClass structure into a #GParamSpecClass structure. */ #define G_PARAM_SPEC_CLASS(pclass) (G_TYPE_CHECK_CLASS_CAST ((pclass), G_TYPE_PARAM, GParamSpecClass)) /** * G_IS_PARAM_SPEC_CLASS: * @pclass: a #GParamSpecClass * * Checks whether @pclass "is a" valid #GParamSpecClass structure of type * %G_TYPE_PARAM or derived. */ #define G_IS_PARAM_SPEC_CLASS(pclass) (G_TYPE_CHECK_CLASS_TYPE ((pclass), G_TYPE_PARAM)) /** * G_PARAM_SPEC_GET_CLASS: * @pspec: a valid #GParamSpec * * Retrieves the #GParamSpecClass of a #GParamSpec. */ #define G_PARAM_SPEC_GET_CLASS(pspec) (G_TYPE_INSTANCE_GET_CLASS ((pspec), G_TYPE_PARAM, GParamSpecClass)) /* --- convenience macros --- */ /** * G_PARAM_SPEC_TYPE: * @pspec: a valid #GParamSpec * * Retrieves the #GType of this @pspec. */ #define G_PARAM_SPEC_TYPE(pspec) (G_TYPE_FROM_INSTANCE (pspec)) /** * G_PARAM_SPEC_TYPE_NAME: * @pspec: a valid #GParamSpec * * Retrieves the #GType name of this @pspec. */ #define G_PARAM_SPEC_TYPE_NAME(pspec) (g_type_name (G_PARAM_SPEC_TYPE (pspec))) /** * G_PARAM_SPEC_VALUE_TYPE: * @pspec: a valid #GParamSpec * * Retrieves the #GType to initialize a #GValue for this parameter. */ #define G_PARAM_SPEC_VALUE_TYPE(pspec) (G_PARAM_SPEC (pspec)->value_type) /** * G_VALUE_HOLDS_PARAM: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values derived from type %G_TYPE_PARAM. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_PARAM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_PARAM)) /* --- flags --- */ /** * GParamFlags: * @G_PARAM_READABLE: the parameter is readable * @G_PARAM_WRITABLE: the parameter is writable * @G_PARAM_READWRITE: alias for %G_PARAM_READABLE | %G_PARAM_WRITABLE * @G_PARAM_CONSTRUCT: the parameter will be set upon object construction * @G_PARAM_CONSTRUCT_ONLY: the parameter can only be set upon object construction * @G_PARAM_LAX_VALIDATION: upon parameter conversion (see g_param_value_convert()) * strict validation is not required * @G_PARAM_STATIC_NAME: the string used as name when constructing the * parameter is guaranteed to remain valid and * unmodified for the lifetime of the parameter. * Since 2.8 * @G_PARAM_STATIC_NICK: the string used as nick when constructing the * parameter is guaranteed to remain valid and * unmmodified for the lifetime of the parameter. * Since 2.8 * @G_PARAM_STATIC_BLURB: the string used as blurb when constructing the * parameter is guaranteed to remain valid and * unmodified for the lifetime of the parameter. * Since 2.8 * @G_PARAM_EXPLICIT_NOTIFY: calls to g_object_set_property() for this * property will not automatically result in a "notify" signal being * emitted: the implementation must call g_object_notify() themselves * in case the property actually changes. Since: 2.42. * @G_PARAM_PRIVATE: internal * @G_PARAM_DEPRECATED: the parameter is deprecated and will be removed * in a future version. A warning will be generated if it is used * while running with G_ENABLE_DIAGNOSTIC=1. * Since 2.26 * * Through the #GParamFlags flag values, certain aspects of parameters * can be configured. See also #G_PARAM_STATIC_STRINGS. */ typedef enum { G_PARAM_READABLE = 1 << 0, G_PARAM_WRITABLE = 1 << 1, G_PARAM_READWRITE = (G_PARAM_READABLE | G_PARAM_WRITABLE), G_PARAM_CONSTRUCT = 1 << 2, G_PARAM_CONSTRUCT_ONLY = 1 << 3, G_PARAM_LAX_VALIDATION = 1 << 4, G_PARAM_STATIC_NAME = 1 << 5, G_PARAM_PRIVATE GLIB_DEPRECATED_ENUMERATOR_IN_2_26 = G_PARAM_STATIC_NAME, G_PARAM_STATIC_NICK = 1 << 6, G_PARAM_STATIC_BLURB = 1 << 7, /* User defined flags go here */ G_PARAM_EXPLICIT_NOTIFY = 1 << 30, /* Avoid warning with -Wpedantic for gcc6 */ G_PARAM_DEPRECATED = (gint)(1u << 31) } GParamFlags; /** * G_PARAM_STATIC_STRINGS: * * #GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB. * * Since 2.13.0 */ #define G_PARAM_STATIC_STRINGS (G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB) /* bits in the range 0xffffff00 are reserved for 3rd party usage */ /** * G_PARAM_MASK: * * Mask containing the bits of #GParamSpec.flags which are reserved for GLib. */ #define G_PARAM_MASK (0x000000ff) /** * G_PARAM_USER_SHIFT: * * Minimum shift count to be used for user defined flags, to be stored in * #GParamSpec.flags. The maximum allowed is 10. */ #define G_PARAM_USER_SHIFT (8) /* --- typedefs & structures --- */ typedef struct _GParamSpec GParamSpec; typedef struct _GParamSpecClass GParamSpecClass; typedef struct _GParameter GParameter GLIB_DEPRECATED_TYPE_IN_2_54; typedef struct _GParamSpecPool GParamSpecPool; /** * GParamSpec: (ref-func g_param_spec_ref_sink) (unref-func g_param_spec_uref) (set-value-func g_value_set_param) (get-value-func g_value_get_param) * @g_type_instance: private #GTypeInstance portion * @name: name of this parameter: always an interned string * @flags: #GParamFlags flags for this parameter * @value_type: the #GValue type for this parameter * @owner_type: #GType type that uses (introduces) this parameter * * All other fields of the GParamSpec struct are private and * should not be used directly. */ struct _GParamSpec { GTypeInstance g_type_instance; const gchar *name; /* interned string */ GParamFlags flags; GType value_type; GType owner_type; /* class or interface using this property */ /*< private >*/ gchar *_nick; gchar *_blurb; GData *qdata; guint ref_count; guint param_id; /* sort-criteria */ }; /** * GParamSpecClass: * @g_type_class: the parent class * @value_type: the #GValue type for this parameter * @finalize: The instance finalization function (optional), should chain * up to the finalize method of the parent class. * @value_set_default: Resets a @value to the default value for this type * (recommended, the default is g_value_reset()), see * g_param_value_set_default(). * @value_validate: Ensures that the contents of @value comply with the * specifications set out by this type (optional), see * g_param_value_validate(). * @values_cmp: Compares @value1 with @value2 according to this type * (recommended, the default is memcmp()), see g_param_values_cmp(). * * The class structure for the GParamSpec type. * Normally, GParamSpec classes are filled by * g_param_type_register_static(). */ struct _GParamSpecClass { GTypeClass g_type_class; GType value_type; void (*finalize) (GParamSpec *pspec); /* GParam methods */ void (*value_set_default) (GParamSpec *pspec, GValue *value); gboolean (*value_validate) (GParamSpec *pspec, GValue *value); gint (*values_cmp) (GParamSpec *pspec, const GValue *value1, const GValue *value2); /*< private >*/ gpointer dummy[4]; }; /** * GParameter: * @name: the parameter name * @value: the parameter value * * The GParameter struct is an auxiliary structure used * to hand parameter name/value pairs to g_object_newv(). * * Deprecated: 2.54: This type is not introspectable. */ struct _GParameter /* auxiliary structure for _setv() variants */ { const gchar *name; GValue value; } GLIB_DEPRECATED_TYPE_IN_2_54; /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_ref (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL void g_param_spec_unref (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL void g_param_spec_sink (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_ref_sink (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL gpointer g_param_spec_get_qdata (GParamSpec *pspec, GQuark quark); GLIB_AVAILABLE_IN_ALL void g_param_spec_set_qdata (GParamSpec *pspec, GQuark quark, gpointer data); GLIB_AVAILABLE_IN_ALL void g_param_spec_set_qdata_full (GParamSpec *pspec, GQuark quark, gpointer data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL gpointer g_param_spec_steal_qdata (GParamSpec *pspec, GQuark quark); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_get_redirect_target (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL void g_param_value_set_default (GParamSpec *pspec, GValue *value); GLIB_AVAILABLE_IN_ALL gboolean g_param_value_defaults (GParamSpec *pspec, const GValue *value); GLIB_AVAILABLE_IN_ALL gboolean g_param_value_validate (GParamSpec *pspec, GValue *value); GLIB_AVAILABLE_IN_ALL gboolean g_param_value_convert (GParamSpec *pspec, const GValue *src_value, GValue *dest_value, gboolean strict_validation); GLIB_AVAILABLE_IN_ALL gint g_param_values_cmp (GParamSpec *pspec, const GValue *value1, const GValue *value2); GLIB_AVAILABLE_IN_ALL const gchar * g_param_spec_get_name (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL const gchar * g_param_spec_get_nick (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL const gchar * g_param_spec_get_blurb (GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL void g_value_set_param (GValue *value, GParamSpec *param); GLIB_AVAILABLE_IN_ALL GParamSpec* g_value_get_param (const GValue *value); GLIB_AVAILABLE_IN_ALL GParamSpec* g_value_dup_param (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_take_param (GValue *value, GParamSpec *param); GLIB_DEPRECATED_FOR(g_value_take_param) void g_value_set_param_take_ownership (GValue *value, GParamSpec *param); GLIB_AVAILABLE_IN_2_36 const GValue * g_param_spec_get_default_value (GParamSpec *pspec); GLIB_AVAILABLE_IN_2_46 GQuark g_param_spec_get_name_quark (GParamSpec *pspec); /* --- convenience functions --- */ typedef struct _GParamSpecTypeInfo GParamSpecTypeInfo; /** * GParamSpecTypeInfo: * @instance_size: Size of the instance (object) structure. * @n_preallocs: Prior to GLib 2.10, it specified the number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching). Since GLib 2.10, it is ignored, since instances are allocated with the [slice allocator][glib-Memory-Slices] now. * @instance_init: Location of the instance initialization function (optional). * @value_type: The #GType of values conforming to this #GParamSpec * @finalize: The instance finalization function (optional). * @value_set_default: Resets a @value to the default value for @pspec * (recommended, the default is g_value_reset()), see * g_param_value_set_default(). * @value_validate: Ensures that the contents of @value comply with the * specifications set out by @pspec (optional), see * g_param_value_validate(). * @values_cmp: Compares @value1 with @value2 according to @pspec * (recommended, the default is memcmp()), see g_param_values_cmp(). * * This structure is used to provide the type system with the information * required to initialize and destruct (finalize) a parameter's class and * instances thereof. * The initialized structure is passed to the g_param_type_register_static() * The type system will perform a deep copy of this structure, so its memory * does not need to be persistent across invocation of * g_param_type_register_static(). */ struct _GParamSpecTypeInfo { /* type system portion */ guint16 instance_size; /* obligatory */ guint16 n_preallocs; /* optional */ void (*instance_init) (GParamSpec *pspec); /* optional */ /* class portion */ GType value_type; /* obligatory */ void (*finalize) (GParamSpec *pspec); /* optional */ void (*value_set_default) (GParamSpec *pspec, /* recommended */ GValue *value); gboolean (*value_validate) (GParamSpec *pspec, /* optional */ GValue *value); gint (*values_cmp) (GParamSpec *pspec, /* recommended */ const GValue *value1, const GValue *value2); }; GLIB_AVAILABLE_IN_ALL GType g_param_type_register_static (const gchar *name, const GParamSpecTypeInfo *pspec_info); GLIB_AVAILABLE_IN_2_66 gboolean g_param_spec_is_valid_name (const gchar *name); /* For registering builting types */ GType _g_param_type_register_static_constant (const gchar *name, const GParamSpecTypeInfo *pspec_info, GType opt_type); /* --- protected --- */ GLIB_AVAILABLE_IN_ALL gpointer g_param_spec_internal (GType param_type, const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpecPool* g_param_spec_pool_new (gboolean type_prefixing); GLIB_AVAILABLE_IN_ALL void g_param_spec_pool_insert (GParamSpecPool *pool, GParamSpec *pspec, GType owner_type); GLIB_AVAILABLE_IN_ALL void g_param_spec_pool_remove (GParamSpecPool *pool, GParamSpec *pspec); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_pool_lookup (GParamSpecPool *pool, const gchar *param_name, GType owner_type, gboolean walk_ancestors); GLIB_AVAILABLE_IN_ALL GList* g_param_spec_pool_list_owned (GParamSpecPool *pool, GType owner_type); GLIB_AVAILABLE_IN_ALL GParamSpec** g_param_spec_pool_list (GParamSpecPool *pool, GType owner_type, guint *n_pspecs_p); /* contracts: * * gboolean value_validate (GParamSpec *pspec, * GValue *value): * modify value contents in the least destructive way, so * that it complies with pspec's requirements (i.e. * according to minimum/maximum ranges etc...). return * whether modification was necessary. * * gint values_cmp (GParamSpec *pspec, * const GValue *value1, * const GValue *value2): * return value1 - value2, i.e. (-1) if value1 < value2, * (+1) if value1 > value2, and (0) otherwise (equality) */ G_END_DECLS #endif /* __G_PARAM_H__ */ gobject/glib-types.h 0000644 00000021543 15125173650 0010423 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000-2001 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __GLIB_TYPES_H__ #define __GLIB_TYPES_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) && !defined(GLIB_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <glib.h> G_BEGIN_DECLS /* A hack necesssary to preprocess this file with g-ir-scanner */ #ifdef __GI_SCANNER__ typedef gsize GType; #endif /* --- GLib boxed types --- */ /** * G_TYPE_DATE: * * The #GType for #GDate. */ #define G_TYPE_DATE (g_date_get_type ()) /** * G_TYPE_STRV: * * The #GType for a boxed type holding a %NULL-terminated array of strings. * * The code fragments in the following example show the use of a property of * type #G_TYPE_STRV with g_object_class_install_property(), g_object_set() * and g_object_get(). * * |[ * g_object_class_install_property (object_class, * PROP_AUTHORS, * g_param_spec_boxed ("authors", * _("Authors"), * _("List of authors"), * G_TYPE_STRV, * G_PARAM_READWRITE)); * * gchar *authors[] = { "Owen", "Tim", NULL }; * g_object_set (obj, "authors", authors, NULL); * * gchar *writers[]; * g_object_get (obj, "authors", &writers, NULL); * /* do something with writers */ * g_strfreev (writers); * ]| * * Since: 2.4 */ #define G_TYPE_STRV (g_strv_get_type ()) /** * G_TYPE_GSTRING: * * The #GType for #GString. */ #define G_TYPE_GSTRING (g_gstring_get_type ()) /** * G_TYPE_HASH_TABLE: * * The #GType for a boxed type holding a #GHashTable reference. * * Since: 2.10 */ #define G_TYPE_HASH_TABLE (g_hash_table_get_type ()) /** * G_TYPE_REGEX: * * The #GType for a boxed type holding a #GRegex reference. * * Since: 2.14 */ #define G_TYPE_REGEX (g_regex_get_type ()) /** * G_TYPE_MATCH_INFO: * * The #GType for a boxed type holding a #GMatchInfo reference. * * Since: 2.30 */ #define G_TYPE_MATCH_INFO (g_match_info_get_type ()) /** * G_TYPE_ARRAY: * * The #GType for a boxed type holding a #GArray reference. * * Since: 2.22 */ #define G_TYPE_ARRAY (g_array_get_type ()) /** * G_TYPE_BYTE_ARRAY: * * The #GType for a boxed type holding a #GByteArray reference. * * Since: 2.22 */ #define G_TYPE_BYTE_ARRAY (g_byte_array_get_type ()) /** * G_TYPE_PTR_ARRAY: * * The #GType for a boxed type holding a #GPtrArray reference. * * Since: 2.22 */ #define G_TYPE_PTR_ARRAY (g_ptr_array_get_type ()) /** * G_TYPE_BYTES: * * The #GType for #GBytes. * * Since: 2.32 */ #define G_TYPE_BYTES (g_bytes_get_type ()) /** * G_TYPE_VARIANT_TYPE: * * The #GType for a boxed type holding a #GVariantType. * * Since: 2.24 */ #define G_TYPE_VARIANT_TYPE (g_variant_type_get_gtype ()) /** * G_TYPE_ERROR: * * The #GType for a boxed type holding a #GError. * * Since: 2.26 */ #define G_TYPE_ERROR (g_error_get_type ()) /** * G_TYPE_DATE_TIME: * * The #GType for a boxed type holding a #GDateTime. * * Since: 2.26 */ #define G_TYPE_DATE_TIME (g_date_time_get_type ()) /** * G_TYPE_TIME_ZONE: * * The #GType for a boxed type holding a #GTimeZone. * * Since: 2.34 */ #define G_TYPE_TIME_ZONE (g_time_zone_get_type ()) /** * G_TYPE_IO_CHANNEL: * * The #GType for #GIOChannel. */ #define G_TYPE_IO_CHANNEL (g_io_channel_get_type ()) /** * G_TYPE_IO_CONDITION: * * The #GType for #GIOCondition. */ #define G_TYPE_IO_CONDITION (g_io_condition_get_type ()) /** * G_TYPE_VARIANT_BUILDER: * * The #GType for a boxed type holding a #GVariantBuilder. * * Since: 2.30 */ #define G_TYPE_VARIANT_BUILDER (g_variant_builder_get_type ()) /** * G_TYPE_VARIANT_DICT: * * The #GType for a boxed type holding a #GVariantDict. * * Since: 2.40 */ #define G_TYPE_VARIANT_DICT (g_variant_dict_get_type ()) /** * G_TYPE_MAIN_LOOP: * * The #GType for a boxed type holding a #GMainLoop. * * Since: 2.30 */ #define G_TYPE_MAIN_LOOP (g_main_loop_get_type ()) /** * G_TYPE_MAIN_CONTEXT: * * The #GType for a boxed type holding a #GMainContext. * * Since: 2.30 */ #define G_TYPE_MAIN_CONTEXT (g_main_context_get_type ()) /** * G_TYPE_SOURCE: * * The #GType for a boxed type holding a #GSource. * * Since: 2.30 */ #define G_TYPE_SOURCE (g_source_get_type ()) /** * G_TYPE_POLLFD: * * The #GType for a boxed type holding a #GPollFD. * * Since: 2.36 */ #define G_TYPE_POLLFD (g_pollfd_get_type ()) /** * G_TYPE_MARKUP_PARSE_CONTEXT: * * The #GType for a boxed type holding a #GMarkupParseContext. * * Since: 2.36 */ #define G_TYPE_MARKUP_PARSE_CONTEXT (g_markup_parse_context_get_type ()) /** * G_TYPE_KEY_FILE: * * The #GType for a boxed type holding a #GKeyFile. * * Since: 2.32 */ #define G_TYPE_KEY_FILE (g_key_file_get_type ()) /** * G_TYPE_MAPPED_FILE: * * The #GType for a boxed type holding a #GMappedFile. * * Since: 2.40 */ #define G_TYPE_MAPPED_FILE (g_mapped_file_get_type ()) /** * G_TYPE_THREAD: * * The #GType for a boxed type holding a #GThread. * * Since: 2.36 */ #define G_TYPE_THREAD (g_thread_get_type ()) /** * G_TYPE_CHECKSUM: * * The #GType for a boxed type holding a #GChecksum. * * Since: 2.36 */ #define G_TYPE_CHECKSUM (g_checksum_get_type ()) /** * G_TYPE_OPTION_GROUP: * * The #GType for a boxed type holding a #GOptionGroup. * * Since: 2.44 */ #define G_TYPE_OPTION_GROUP (g_option_group_get_type ()) /** * G_TYPE_URI: * * The #GType for a boxed type holding a #GUri. * * Since: 2.66 */ #define G_TYPE_URI (g_uri_get_type ()) /** * G_TYPE_TREE: * * The #GType for #GTree. * * Since: 2.68 */ #define G_TYPE_TREE (g_tree_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_date_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_strv_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_gstring_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_hash_table_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_array_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_byte_array_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_ptr_array_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_bytes_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_variant_type_get_gtype (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_regex_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_30 GType g_match_info_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_error_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_date_time_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_time_zone_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_io_channel_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_io_condition_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_variant_builder_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_40 GType g_variant_dict_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_key_file_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_30 GType g_main_loop_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_30 GType g_main_context_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_30 GType g_source_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_36 GType g_pollfd_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_36 GType g_thread_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_36 GType g_checksum_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_36 GType g_markup_parse_context_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_40 GType g_mapped_file_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_44 GType g_option_group_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_66 GType g_uri_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_68 GType g_tree_get_type (void) G_GNUC_CONST; GLIB_DEPRECATED_FOR('G_TYPE_VARIANT') GType g_variant_get_gtype (void) G_GNUC_CONST; G_END_DECLS #endif /* __GLIB_TYPES_H__ */ gobject/glib-enumtypes.h 0000644 00000001766 15125173650 0011315 0 ustar 00 /* This file is generated by glib-mkenums, do not modify it. This code is licensed under the same license as the containing project. Note that it links to GLib, so must comply with the LGPL linking clauses. */ #ifndef __GOBJECT_ENUM_TYPES_H__ #define __GOBJECT_ENUM_TYPES_H__ #include <glib-object.h> G_BEGIN_DECLS /* enumerations from "../gobject/../glib/gunicode.h" */ GLIB_AVAILABLE_IN_2_60 GType g_unicode_type_get_type (void) G_GNUC_CONST; #define G_TYPE_UNICODE_TYPE (g_unicode_type_get_type ()) GLIB_AVAILABLE_IN_2_60 GType g_unicode_break_type_get_type (void) G_GNUC_CONST; #define G_TYPE_UNICODE_BREAK_TYPE (g_unicode_break_type_get_type ()) GLIB_AVAILABLE_IN_2_60 GType g_unicode_script_get_type (void) G_GNUC_CONST; #define G_TYPE_UNICODE_SCRIPT (g_unicode_script_get_type ()) GLIB_AVAILABLE_IN_2_60 GType g_normalize_mode_get_type (void) G_GNUC_CONST; #define G_TYPE_NORMALIZE_MODE (g_normalize_mode_get_type ()) G_END_DECLS #endif /* __GOBJECT_ENUM_TYPES_H__ */ /* Generated data ends here */ gobject/gvalue.h 0000644 00000013631 15125173650 0007626 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1997-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gvalue.h: generic GValue functions */ #ifndef __G_VALUE_H__ #define __G_VALUE_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> G_BEGIN_DECLS /* --- type macros --- */ /** * G_TYPE_IS_VALUE: * @type: A #GType value. * * Checks whether the passed in type ID can be used for g_value_init(). * That is, this macro checks whether this type provides an implementation * of the #GTypeValueTable functions required for a type to create a #GValue of. * * Returns: Whether @type is suitable as a #GValue type. */ #define G_TYPE_IS_VALUE(type) (g_type_check_is_value_type (type)) /** * G_IS_VALUE: * @value: A #GValue structure. * * Checks if @value is a valid and initialized #GValue structure. * * Returns: %TRUE on success. */ #define G_IS_VALUE(value) (G_TYPE_CHECK_VALUE (value)) /** * G_VALUE_TYPE: * @value: A #GValue structure. * * Get the type identifier of @value. * * Returns: the #GType. */ #define G_VALUE_TYPE(value) (((GValue*) (value))->g_type) /** * G_VALUE_TYPE_NAME: * @value: A #GValue structure. * * Gets the type name of @value. * * Returns: the type name. */ #define G_VALUE_TYPE_NAME(value) (g_type_name (G_VALUE_TYPE (value))) /** * G_VALUE_HOLDS: * @value: A #GValue structure. * @type: A #GType value. * * Checks if @value holds (or contains) a value of @type. * This macro will also check for @value != %NULL and issue a * warning if the check fails. * * Returns: %TRUE if @value holds the @type. */ #define G_VALUE_HOLDS(value,type) (G_TYPE_CHECK_VALUE_TYPE ((value), (type))) /* --- typedefs & structures --- */ /** * GValueTransform: * @src_value: Source value. * @dest_value: Target value. * * The type of value transformation functions which can be registered with * g_value_register_transform_func(). * * @dest_value will be initialized to the correct destination type. */ typedef void (*GValueTransform) (const GValue *src_value, GValue *dest_value); /** * GValue: * * An opaque structure used to hold different types of values. * The data within the structure has protected scope: it is accessible only * to functions within a #GTypeValueTable structure, or implementations of * the g_value_*() API. That is, code portions which implement new fundamental * types. * #GValue users cannot make any assumptions about how data is stored * within the 2 element @data union, and the @g_type member should * only be accessed through the G_VALUE_TYPE() macro. */ struct _GValue { /*< private >*/ GType g_type; /* public for GTypeValueTable methods */ union { gint v_int; guint v_uint; glong v_long; gulong v_ulong; gint64 v_int64; guint64 v_uint64; gfloat v_float; gdouble v_double; gpointer v_pointer; } data[2]; }; /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GValue* g_value_init (GValue *value, GType g_type); GLIB_AVAILABLE_IN_ALL void g_value_copy (const GValue *src_value, GValue *dest_value); GLIB_AVAILABLE_IN_ALL GValue* g_value_reset (GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_unset (GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_instance (GValue *value, gpointer instance); GLIB_AVAILABLE_IN_2_42 void g_value_init_from_instance (GValue *value, gpointer instance); /* --- private --- */ GLIB_AVAILABLE_IN_ALL gboolean g_value_fits_pointer (const GValue *value); GLIB_AVAILABLE_IN_ALL gpointer g_value_peek_pointer (const GValue *value); /* --- implementation details --- */ GLIB_AVAILABLE_IN_ALL gboolean g_value_type_compatible (GType src_type, GType dest_type); GLIB_AVAILABLE_IN_ALL gboolean g_value_type_transformable (GType src_type, GType dest_type); GLIB_AVAILABLE_IN_ALL gboolean g_value_transform (const GValue *src_value, GValue *dest_value); GLIB_AVAILABLE_IN_ALL void g_value_register_transform_func (GType src_type, GType dest_type, GValueTransform transform_func); /** * G_VALUE_NOCOPY_CONTENTS: * * If passed to G_VALUE_COLLECT(), allocated data won't be copied * but used verbatim. This does not affect ref-counted types like * objects. This does not affect usage of g_value_copy(), the data will * be copied if it is not ref-counted. */ #define G_VALUE_NOCOPY_CONTENTS (1 << 27) /** * G_VALUE_INTERNED_STRING: * * For string values, indicates that the string contained is canonical and will * exist for the duration of the process. See g_value_set_interned_string(). * * Since: 2.66 */ #define G_VALUE_INTERNED_STRING (1 << 28) GLIB_AVAILABLE_MACRO_IN_2_66 /** * G_VALUE_INIT: * * A #GValue must be initialized before it can be used. This macro can * be used as initializer instead of an explicit `{ 0 }` when declaring * a variable, but it cannot be assigned to a variable. * * |[ * GValue value = G_VALUE_INIT; * ]| * * Since: 2.30 */ #define G_VALUE_INIT { 0, { { 0 } } } G_END_DECLS #endif /* __G_VALUE_H__ */ gobject/gbinding.h 0000644 00000014676 15125173650 0010136 0 ustar 00 /* gbinding.h: Binding for object properties * * Copyright (C) 2010 Intel Corp. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Emmanuele Bassi <ebassi@linux.intel.com> */ #ifndef __G_BINDING_H__ #define __G_BINDING_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <glib.h> #include <gobject/gobject.h> G_BEGIN_DECLS #define G_TYPE_BINDING_FLAGS (g_binding_flags_get_type ()) #define G_TYPE_BINDING (g_binding_get_type ()) #define G_BINDING(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_BINDING, GBinding)) #define G_IS_BINDING(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_BINDING)) /** * GBinding: * * GBinding is an opaque structure whose members * cannot be accessed directly. * * Since: 2.26 */ typedef struct _GBinding GBinding; /** * GBindingTransformFunc: * @binding: a #GBinding * @from_value: the #GValue containing the value to transform * @to_value: the #GValue in which to store the transformed value * @user_data: data passed to the transform function * * A function to be called to transform @from_value to @to_value. If * this is the @transform_to function of a binding, then @from_value * is the @source_property on the @source object, and @to_value is the * @target_property on the @target object. If this is the * @transform_from function of a %G_BINDING_BIDIRECTIONAL binding, * then those roles are reversed. * * Returns: %TRUE if the transformation was successful, and %FALSE * otherwise * * Since: 2.26 */ typedef gboolean (* GBindingTransformFunc) (GBinding *binding, const GValue *from_value, GValue *to_value, gpointer user_data); /** * GBindingFlags: * @G_BINDING_DEFAULT: The default binding; if the source property * changes, the target property is updated with its value. * @G_BINDING_BIDIRECTIONAL: Bidirectional binding; if either the * property of the source or the property of the target changes, * the other is updated. * @G_BINDING_SYNC_CREATE: Synchronize the values of the source and * target properties when creating the binding; the direction of * the synchronization is always from the source to the target. * @G_BINDING_INVERT_BOOLEAN: If the two properties being bound are * booleans, setting one to %TRUE will result in the other being * set to %FALSE and vice versa. This flag will only work for * boolean properties, and cannot be used when passing custom * transformation functions to g_object_bind_property_full(). * * Flags to be passed to g_object_bind_property() or * g_object_bind_property_full(). * * This enumeration can be extended at later date. * * Since: 2.26 */ typedef enum { /*< prefix=G_BINDING >*/ G_BINDING_DEFAULT = 0, G_BINDING_BIDIRECTIONAL = 1 << 0, G_BINDING_SYNC_CREATE = 1 << 1, G_BINDING_INVERT_BOOLEAN = 1 << 2 } GBindingFlags; GLIB_AVAILABLE_IN_ALL GType g_binding_flags_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_binding_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GBindingFlags g_binding_get_flags (GBinding *binding); GLIB_DEPRECATED_IN_2_68_FOR(g_binding_dup_source) GObject * g_binding_get_source (GBinding *binding); GLIB_AVAILABLE_IN_2_68 GObject * g_binding_dup_source (GBinding *binding); GLIB_DEPRECATED_IN_2_68_FOR(g_binding_dup_target) GObject * g_binding_get_target (GBinding *binding); GLIB_AVAILABLE_IN_2_68 GObject * g_binding_dup_target (GBinding *binding); GLIB_AVAILABLE_IN_ALL const gchar * g_binding_get_source_property (GBinding *binding); GLIB_AVAILABLE_IN_ALL const gchar * g_binding_get_target_property (GBinding *binding); GLIB_AVAILABLE_IN_2_38 void g_binding_unbind (GBinding *binding); GLIB_AVAILABLE_IN_ALL GBinding *g_object_bind_property (gpointer source, const gchar *source_property, gpointer target, const gchar *target_property, GBindingFlags flags); GLIB_AVAILABLE_IN_ALL GBinding *g_object_bind_property_full (gpointer source, const gchar *source_property, gpointer target, const gchar *target_property, GBindingFlags flags, GBindingTransformFunc transform_to, GBindingTransformFunc transform_from, gpointer user_data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL GBinding *g_object_bind_property_with_closures (gpointer source, const gchar *source_property, gpointer target, const gchar *target_property, GBindingFlags flags, GClosure *transform_to, GClosure *transform_from); G_END_DECLS #endif /* __G_BINDING_H__ */ gobject/gparamspecs.h 0000644 00000104043 15125173650 0010646 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1997-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gparamspecs.h: GLib default param specs */ #ifndef __G_PARAMSPECS_H__ #define __G_PARAMSPECS_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gvalue.h> #include <gobject/genums.h> #include <gobject/gboxed.h> #include <gobject/gobject.h> G_BEGIN_DECLS /* --- type macros --- */ /** * G_TYPE_PARAM_CHAR: * * The #GType of #GParamSpecChar. */ #define G_TYPE_PARAM_CHAR (g_param_spec_types[0]) /** * G_IS_PARAM_SPEC_CHAR: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_CHAR. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CHAR)) /** * G_PARAM_SPEC_CHAR: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecChar. */ #define G_PARAM_SPEC_CHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CHAR, GParamSpecChar)) /** * G_TYPE_PARAM_UCHAR: * * The #GType of #GParamSpecUChar. */ #define G_TYPE_PARAM_UCHAR (g_param_spec_types[1]) /** * G_IS_PARAM_SPEC_UCHAR: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UCHAR. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UCHAR)) /** * G_PARAM_SPEC_UCHAR: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecUChar. */ #define G_PARAM_SPEC_UCHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UCHAR, GParamSpecUChar)) /** * G_TYPE_PARAM_BOOLEAN: * * The #GType of #GParamSpecBoolean. */ #define G_TYPE_PARAM_BOOLEAN (g_param_spec_types[2]) /** * G_IS_PARAM_SPEC_BOOLEAN: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOOLEAN. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOOLEAN)) /** * G_PARAM_SPEC_BOOLEAN: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecBoolean. */ #define G_PARAM_SPEC_BOOLEAN(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOOLEAN, GParamSpecBoolean)) /** * G_TYPE_PARAM_INT: * * The #GType of #GParamSpecInt. */ #define G_TYPE_PARAM_INT (g_param_spec_types[3]) /** * G_IS_PARAM_SPEC_INT: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT)) /** * G_PARAM_SPEC_INT: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecInt. */ #define G_PARAM_SPEC_INT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT, GParamSpecInt)) /** * G_TYPE_PARAM_UINT: * * The #GType of #GParamSpecUInt. */ #define G_TYPE_PARAM_UINT (g_param_spec_types[4]) /** * G_IS_PARAM_SPEC_UINT: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT)) /** * G_PARAM_SPEC_UINT: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecUInt. */ #define G_PARAM_SPEC_UINT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT, GParamSpecUInt)) /** * G_TYPE_PARAM_LONG: * * The #GType of #GParamSpecLong. */ #define G_TYPE_PARAM_LONG (g_param_spec_types[5]) /** * G_IS_PARAM_SPEC_LONG: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_LONG. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_LONG)) /** * G_PARAM_SPEC_LONG: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecLong. */ #define G_PARAM_SPEC_LONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_LONG, GParamSpecLong)) /** * G_TYPE_PARAM_ULONG: * * The #GType of #GParamSpecULong. */ #define G_TYPE_PARAM_ULONG (g_param_spec_types[6]) /** * G_IS_PARAM_SPEC_ULONG: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ULONG. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ULONG)) /** * G_PARAM_SPEC_ULONG: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecULong. */ #define G_PARAM_SPEC_ULONG(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ULONG, GParamSpecULong)) /** * G_TYPE_PARAM_INT64: * * The #GType of #GParamSpecInt64. */ #define G_TYPE_PARAM_INT64 (g_param_spec_types[7]) /** * G_IS_PARAM_SPEC_INT64: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT64. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT64)) /** * G_PARAM_SPEC_INT64: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecInt64. */ #define G_PARAM_SPEC_INT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT64, GParamSpecInt64)) /** * G_TYPE_PARAM_UINT64: * * The #GType of #GParamSpecUInt64. */ #define G_TYPE_PARAM_UINT64 (g_param_spec_types[8]) /** * G_IS_PARAM_SPEC_UINT64: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT64. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT64)) /** * G_PARAM_SPEC_UINT64: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecUInt64. */ #define G_PARAM_SPEC_UINT64(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT64, GParamSpecUInt64)) /** * G_TYPE_PARAM_UNICHAR: * * The #GType of #GParamSpecUnichar. */ #define G_TYPE_PARAM_UNICHAR (g_param_spec_types[9]) /** * G_PARAM_SPEC_UNICHAR: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecUnichar. */ #define G_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UNICHAR, GParamSpecUnichar)) /** * G_IS_PARAM_SPEC_UNICHAR: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UNICHAR. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_UNICHAR(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UNICHAR)) /** * G_TYPE_PARAM_ENUM: * * The #GType of #GParamSpecEnum. */ #define G_TYPE_PARAM_ENUM (g_param_spec_types[10]) /** * G_IS_PARAM_SPEC_ENUM: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ENUM. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ENUM)) /** * G_PARAM_SPEC_ENUM: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecEnum. */ #define G_PARAM_SPEC_ENUM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ENUM, GParamSpecEnum)) /** * G_TYPE_PARAM_FLAGS: * * The #GType of #GParamSpecFlags. */ #define G_TYPE_PARAM_FLAGS (g_param_spec_types[11]) /** * G_IS_PARAM_SPEC_FLAGS: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLAGS. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLAGS)) /** * G_PARAM_SPEC_FLAGS: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecFlags. */ #define G_PARAM_SPEC_FLAGS(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLAGS, GParamSpecFlags)) /** * G_TYPE_PARAM_FLOAT: * * The #GType of #GParamSpecFloat. */ #define G_TYPE_PARAM_FLOAT (g_param_spec_types[12]) /** * G_IS_PARAM_SPEC_FLOAT: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLOAT. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLOAT)) /** * G_PARAM_SPEC_FLOAT: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecFloat. */ #define G_PARAM_SPEC_FLOAT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLOAT, GParamSpecFloat)) /** * G_TYPE_PARAM_DOUBLE: * * The #GType of #GParamSpecDouble. */ #define G_TYPE_PARAM_DOUBLE (g_param_spec_types[13]) /** * G_IS_PARAM_SPEC_DOUBLE: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_DOUBLE. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_DOUBLE)) /** * G_PARAM_SPEC_DOUBLE: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecDouble. */ #define G_PARAM_SPEC_DOUBLE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_DOUBLE, GParamSpecDouble)) /** * G_TYPE_PARAM_STRING: * * The #GType of #GParamSpecString. */ #define G_TYPE_PARAM_STRING (g_param_spec_types[14]) /** * G_IS_PARAM_SPEC_STRING: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_STRING. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_STRING)) /** * G_PARAM_SPEC_STRING: * @pspec: a valid #GParamSpec instance * * Casts a #GParamSpec instance into a #GParamSpecString. */ #define G_PARAM_SPEC_STRING(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_STRING, GParamSpecString)) /** * G_TYPE_PARAM_PARAM: * * The #GType of #GParamSpecParam. */ #define G_TYPE_PARAM_PARAM (g_param_spec_types[15]) /** * G_IS_PARAM_SPEC_PARAM: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_PARAM. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_PARAM)) /** * G_PARAM_SPEC_PARAM: * @pspec: a valid #GParamSpec instance * * Casts a #GParamSpec instance into a #GParamSpecParam. */ #define G_PARAM_SPEC_PARAM(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_PARAM, GParamSpecParam)) /** * G_TYPE_PARAM_BOXED: * * The #GType of #GParamSpecBoxed. */ #define G_TYPE_PARAM_BOXED (g_param_spec_types[16]) /** * G_IS_PARAM_SPEC_BOXED: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOXED. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOXED)) /** * G_PARAM_SPEC_BOXED: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecBoxed. */ #define G_PARAM_SPEC_BOXED(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOXED, GParamSpecBoxed)) /** * G_TYPE_PARAM_POINTER: * * The #GType of #GParamSpecPointer. */ #define G_TYPE_PARAM_POINTER (g_param_spec_types[17]) /** * G_IS_PARAM_SPEC_POINTER: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_POINTER. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_POINTER)) /** * G_PARAM_SPEC_POINTER: * @pspec: a valid #GParamSpec instance * * Casts a #GParamSpec instance into a #GParamSpecPointer. */ #define G_PARAM_SPEC_POINTER(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_POINTER, GParamSpecPointer)) /** * G_TYPE_PARAM_VALUE_ARRAY: * * The #GType of #GParamSpecValueArray. * * Deprecated: 2.32: Use #GArray instead of #GValueArray */ #define G_TYPE_PARAM_VALUE_ARRAY (g_param_spec_types[18]) GLIB_DEPRECATED_MACRO_IN_2_32 /** * G_IS_PARAM_SPEC_VALUE_ARRAY: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VALUE_ARRAY. * * Returns: %TRUE on success. * * Deprecated: 2.32: Use #GArray instead of #GValueArray */ #define G_IS_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VALUE_ARRAY)) GLIB_DEPRECATED_MACRO_IN_2_32 /** * G_PARAM_SPEC_VALUE_ARRAY: * @pspec: a valid #GParamSpec instance * * Cast a #GParamSpec instance into a #GParamSpecValueArray. * * Deprecated: 2.32: Use #GArray instead of #GValueArray */ #define G_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VALUE_ARRAY, GParamSpecValueArray)) GLIB_DEPRECATED_MACRO_IN_2_32 /** * G_TYPE_PARAM_OBJECT: * * The #GType of #GParamSpecObject. */ #define G_TYPE_PARAM_OBJECT (g_param_spec_types[19]) /** * G_IS_PARAM_SPEC_OBJECT: * @pspec: a valid #GParamSpec instance * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OBJECT. * * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OBJECT)) /** * G_PARAM_SPEC_OBJECT: * @pspec: a valid #GParamSpec instance * * Casts a #GParamSpec instance into a #GParamSpecObject. */ #define G_PARAM_SPEC_OBJECT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OBJECT, GParamSpecObject)) /** * G_TYPE_PARAM_OVERRIDE: * * The #GType of #GParamSpecOverride. * * Since: 2.4 */ #define G_TYPE_PARAM_OVERRIDE (g_param_spec_types[20]) /** * G_IS_PARAM_SPEC_OVERRIDE: * @pspec: a #GParamSpec * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OVERRIDE. * * Since: 2.4 * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OVERRIDE)) /** * G_PARAM_SPEC_OVERRIDE: * @pspec: a #GParamSpec * * Casts a #GParamSpec into a #GParamSpecOverride. * * Since: 2.4 */ #define G_PARAM_SPEC_OVERRIDE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OVERRIDE, GParamSpecOverride)) /** * G_TYPE_PARAM_GTYPE: * * The #GType of #GParamSpecGType. * * Since: 2.10 */ #define G_TYPE_PARAM_GTYPE (g_param_spec_types[21]) /** * G_IS_PARAM_SPEC_GTYPE: * @pspec: a #GParamSpec * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_GTYPE. * * Since: 2.10 * Returns: %TRUE on success. */ #define G_IS_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_GTYPE)) /** * G_PARAM_SPEC_GTYPE: * @pspec: a #GParamSpec * * Casts a #GParamSpec into a #GParamSpecGType. * * Since: 2.10 */ #define G_PARAM_SPEC_GTYPE(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_GTYPE, GParamSpecGType)) /** * G_TYPE_PARAM_VARIANT: * * The #GType of #GParamSpecVariant. * * Since: 2.26 */ #define G_TYPE_PARAM_VARIANT (g_param_spec_types[22]) /** * G_IS_PARAM_SPEC_VARIANT: * @pspec: a #GParamSpec * * Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VARIANT. * * Returns: %TRUE on success * * Since: 2.26 */ #define G_IS_PARAM_SPEC_VARIANT(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VARIANT)) /** * G_PARAM_SPEC_VARIANT: * @pspec: a #GParamSpec * * Casts a #GParamSpec into a #GParamSpecVariant. * * Since: 2.26 */ #define G_PARAM_SPEC_VARIANT(pspec) (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VARIANT, GParamSpecVariant)) /* --- typedefs & structures --- */ typedef struct _GParamSpecChar GParamSpecChar; typedef struct _GParamSpecUChar GParamSpecUChar; typedef struct _GParamSpecBoolean GParamSpecBoolean; typedef struct _GParamSpecInt GParamSpecInt; typedef struct _GParamSpecUInt GParamSpecUInt; typedef struct _GParamSpecLong GParamSpecLong; typedef struct _GParamSpecULong GParamSpecULong; typedef struct _GParamSpecInt64 GParamSpecInt64; typedef struct _GParamSpecUInt64 GParamSpecUInt64; typedef struct _GParamSpecUnichar GParamSpecUnichar; typedef struct _GParamSpecEnum GParamSpecEnum; typedef struct _GParamSpecFlags GParamSpecFlags; typedef struct _GParamSpecFloat GParamSpecFloat; typedef struct _GParamSpecDouble GParamSpecDouble; typedef struct _GParamSpecString GParamSpecString; typedef struct _GParamSpecParam GParamSpecParam; typedef struct _GParamSpecBoxed GParamSpecBoxed; typedef struct _GParamSpecPointer GParamSpecPointer; typedef struct _GParamSpecValueArray GParamSpecValueArray; typedef struct _GParamSpecObject GParamSpecObject; typedef struct _GParamSpecOverride GParamSpecOverride; typedef struct _GParamSpecGType GParamSpecGType; typedef struct _GParamSpecVariant GParamSpecVariant; /** * GParamSpecChar: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for character properties. */ struct _GParamSpecChar { GParamSpec parent_instance; gint8 minimum; gint8 maximum; gint8 default_value; }; /** * GParamSpecUChar: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for unsigned character properties. */ struct _GParamSpecUChar { GParamSpec parent_instance; guint8 minimum; guint8 maximum; guint8 default_value; }; /** * GParamSpecBoolean: * @parent_instance: private #GParamSpec portion * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for boolean properties. */ struct _GParamSpecBoolean { GParamSpec parent_instance; gboolean default_value; }; /** * GParamSpecInt: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for integer properties. */ struct _GParamSpecInt { GParamSpec parent_instance; gint minimum; gint maximum; gint default_value; }; /** * GParamSpecUInt: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for unsigned integer properties. */ struct _GParamSpecUInt { GParamSpec parent_instance; guint minimum; guint maximum; guint default_value; }; /** * GParamSpecLong: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for long integer properties. */ struct _GParamSpecLong { GParamSpec parent_instance; glong minimum; glong maximum; glong default_value; }; /** * GParamSpecULong: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for unsigned long integer properties. */ struct _GParamSpecULong { GParamSpec parent_instance; gulong minimum; gulong maximum; gulong default_value; }; /** * GParamSpecInt64: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for 64bit integer properties. */ struct _GParamSpecInt64 { GParamSpec parent_instance; gint64 minimum; gint64 maximum; gint64 default_value; }; /** * GParamSpecUInt64: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for unsigned 64bit integer properties. */ struct _GParamSpecUInt64 { GParamSpec parent_instance; guint64 minimum; guint64 maximum; guint64 default_value; }; /** * GParamSpecUnichar: * @parent_instance: private #GParamSpec portion * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for unichar (unsigned integer) properties. */ struct _GParamSpecUnichar { GParamSpec parent_instance; gunichar default_value; }; /** * GParamSpecEnum: * @parent_instance: private #GParamSpec portion * @enum_class: the #GEnumClass for the enum * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for enum * properties. */ struct _GParamSpecEnum { GParamSpec parent_instance; GEnumClass *enum_class; gint default_value; }; /** * GParamSpecFlags: * @parent_instance: private #GParamSpec portion * @flags_class: the #GFlagsClass for the flags * @default_value: default value for the property specified * * A #GParamSpec derived structure that contains the meta data for flags * properties. */ struct _GParamSpecFlags { GParamSpec parent_instance; GFlagsClass *flags_class; guint default_value; }; /** * GParamSpecFloat: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * @epsilon: values closer than @epsilon will be considered identical * by g_param_values_cmp(); the default value is 1e-30. * * A #GParamSpec derived structure that contains the meta data for float properties. */ struct _GParamSpecFloat { GParamSpec parent_instance; gfloat minimum; gfloat maximum; gfloat default_value; gfloat epsilon; }; /** * GParamSpecDouble: * @parent_instance: private #GParamSpec portion * @minimum: minimum value for the property specified * @maximum: maximum value for the property specified * @default_value: default value for the property specified * @epsilon: values closer than @epsilon will be considered identical * by g_param_values_cmp(); the default value is 1e-90. * * A #GParamSpec derived structure that contains the meta data for double properties. */ struct _GParamSpecDouble { GParamSpec parent_instance; gdouble minimum; gdouble maximum; gdouble default_value; gdouble epsilon; }; /** * GParamSpecString: * @parent_instance: private #GParamSpec portion * @default_value: default value for the property specified * @cset_first: a string containing the allowed values for the first byte * @cset_nth: a string containing the allowed values for the subsequent bytes * @substitutor: the replacement byte for bytes which don't match @cset_first or @cset_nth. * @null_fold_if_empty: replace empty string by %NULL * @ensure_non_null: replace %NULL strings by an empty string * * A #GParamSpec derived structure that contains the meta data for string * properties. */ struct _GParamSpecString { GParamSpec parent_instance; gchar *default_value; gchar *cset_first; gchar *cset_nth; gchar substitutor; guint null_fold_if_empty : 1; guint ensure_non_null : 1; }; /** * GParamSpecParam: * @parent_instance: private #GParamSpec portion * * A #GParamSpec derived structure that contains the meta data for %G_TYPE_PARAM * properties. */ struct _GParamSpecParam { GParamSpec parent_instance; }; /** * GParamSpecBoxed: * @parent_instance: private #GParamSpec portion * * A #GParamSpec derived structure that contains the meta data for boxed properties. */ struct _GParamSpecBoxed { GParamSpec parent_instance; }; /** * GParamSpecPointer: * @parent_instance: private #GParamSpec portion * * A #GParamSpec derived structure that contains the meta data for pointer properties. */ struct _GParamSpecPointer { GParamSpec parent_instance; }; /** * GParamSpecValueArray: * @parent_instance: private #GParamSpec portion * @element_spec: a #GParamSpec describing the elements contained in arrays of this property, may be %NULL * @fixed_n_elements: if greater than 0, arrays of this property will always have this many elements * * A #GParamSpec derived structure that contains the meta data for #GValueArray properties. */ struct _GParamSpecValueArray { GParamSpec parent_instance; GParamSpec *element_spec; guint fixed_n_elements; }; /** * GParamSpecObject: * @parent_instance: private #GParamSpec portion * * A #GParamSpec derived structure that contains the meta data for object properties. */ struct _GParamSpecObject { GParamSpec parent_instance; }; /** * GParamSpecOverride: * * This is a type of #GParamSpec type that simply redirects operations to * another paramspec. All operations other than getting or * setting the value are redirected, including accessing the nick and * blurb, validating a value, and so forth. See * g_param_spec_get_redirect_target() for retrieving the overridden * property. #GParamSpecOverride is used in implementing * g_object_class_override_property(), and will not be directly useful * unless you are implementing a new base type similar to GObject. * * Since: 2.4 */ struct _GParamSpecOverride { /*< private >*/ GParamSpec parent_instance; GParamSpec *overridden; }; /** * GParamSpecGType: * @parent_instance: private #GParamSpec portion * @is_a_type: a #GType whose subtypes can occur as values * * A #GParamSpec derived structure that contains the meta data for #GType properties. * * Since: 2.10 */ struct _GParamSpecGType { GParamSpec parent_instance; GType is_a_type; }; /** * GParamSpecVariant: * @parent_instance: private #GParamSpec portion * @type: a #GVariantType, or %NULL * @default_value: a #GVariant, or %NULL * * A #GParamSpec derived structure that contains the meta data for #GVariant properties. * * When comparing values with g_param_values_cmp(), scalar values with the same * type will be compared with g_variant_compare(). Other non-%NULL variants will * be checked for equality with g_variant_equal(), and their sort order is * otherwise undefined. %NULL is ordered before non-%NULL variants. Two %NULL * values compare equal. * * Since: 2.26 */ struct _GParamSpecVariant { GParamSpec parent_instance; GVariantType *type; GVariant *default_value; /*< private >*/ gpointer padding[4]; }; /* --- GParamSpec prototypes --- */ GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_char (const gchar *name, const gchar *nick, const gchar *blurb, gint8 minimum, gint8 maximum, gint8 default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_uchar (const gchar *name, const gchar *nick, const gchar *blurb, guint8 minimum, guint8 maximum, guint8 default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_boolean (const gchar *name, const gchar *nick, const gchar *blurb, gboolean default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_int (const gchar *name, const gchar *nick, const gchar *blurb, gint minimum, gint maximum, gint default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_uint (const gchar *name, const gchar *nick, const gchar *blurb, guint minimum, guint maximum, guint default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_long (const gchar *name, const gchar *nick, const gchar *blurb, glong minimum, glong maximum, glong default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_ulong (const gchar *name, const gchar *nick, const gchar *blurb, gulong minimum, gulong maximum, gulong default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_int64 (const gchar *name, const gchar *nick, const gchar *blurb, gint64 minimum, gint64 maximum, gint64 default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_uint64 (const gchar *name, const gchar *nick, const gchar *blurb, guint64 minimum, guint64 maximum, guint64 default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_unichar (const gchar *name, const gchar *nick, const gchar *blurb, gunichar default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_enum (const gchar *name, const gchar *nick, const gchar *blurb, GType enum_type, gint default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_flags (const gchar *name, const gchar *nick, const gchar *blurb, GType flags_type, guint default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_float (const gchar *name, const gchar *nick, const gchar *blurb, gfloat minimum, gfloat maximum, gfloat default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_double (const gchar *name, const gchar *nick, const gchar *blurb, gdouble minimum, gdouble maximum, gdouble default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_string (const gchar *name, const gchar *nick, const gchar *blurb, const gchar *default_value, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_param (const gchar *name, const gchar *nick, const gchar *blurb, GType param_type, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_boxed (const gchar *name, const gchar *nick, const gchar *blurb, GType boxed_type, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_pointer (const gchar *name, const gchar *nick, const gchar *blurb, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_value_array (const gchar *name, const gchar *nick, const gchar *blurb, GParamSpec *element_spec, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_object (const gchar *name, const gchar *nick, const gchar *blurb, GType object_type, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_override (const gchar *name, GParamSpec *overridden); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_gtype (const gchar *name, const gchar *nick, const gchar *blurb, GType is_a_type, GParamFlags flags); GLIB_AVAILABLE_IN_ALL GParamSpec* g_param_spec_variant (const gchar *name, const gchar *nick, const gchar *blurb, const GVariantType *type, GVariant *default_value, GParamFlags flags); /* --- internal --- */ /* We prefix variable declarations so they can * properly get exported in windows dlls. */ #ifndef GOBJECT_VAR # ifdef G_PLATFORM_WIN32 # ifdef GOBJECT_STATIC_COMPILATION # define GOBJECT_VAR extern # else /* !GOBJECT_STATIC_COMPILATION */ # ifdef GOBJECT_COMPILATION # ifdef DLL_EXPORT # define GOBJECT_VAR extern __declspec(dllexport) # else /* !DLL_EXPORT */ # define GOBJECT_VAR extern # endif /* !DLL_EXPORT */ # else /* !GOBJECT_COMPILATION */ # define GOBJECT_VAR extern __declspec(dllimport) # endif /* !GOBJECT_COMPILATION */ # endif /* !GOBJECT_STATIC_COMPILATION */ # else /* !G_PLATFORM_WIN32 */ # define GOBJECT_VAR _GLIB_EXTERN # endif /* !G_PLATFORM_WIN32 */ #endif /* GOBJECT_VAR */ GOBJECT_VAR GType *g_param_spec_types; G_END_DECLS #endif /* __G_PARAMSPECS_H__ */ gobject/gsignal.h 0000644 00000061655 15125173650 0010000 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000-2001 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SIGNAL_H__ #define __G_SIGNAL_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gclosure.h> #include <gobject/gvalue.h> #include <gobject/gparam.h> #include <gobject/gmarshal.h> G_BEGIN_DECLS /* --- typedefs --- */ typedef struct _GSignalQuery GSignalQuery; typedef struct _GSignalInvocationHint GSignalInvocationHint; /** * GSignalCMarshaller: * * This is the signature of marshaller functions, required to marshall * arrays of parameter values to signal emissions into C language callback * invocations. It is merely an alias to #GClosureMarshal since the #GClosure * mechanism takes over responsibility of actual function invocation for the * signal system. */ typedef GClosureMarshal GSignalCMarshaller; /** * GSignalCVaMarshaller: * * This is the signature of va_list marshaller functions, an optional * marshaller that can be used in some situations to avoid * marshalling the signal argument into GValues. */ typedef GVaClosureMarshal GSignalCVaMarshaller; /** * GSignalEmissionHook: * @ihint: Signal invocation hint, see #GSignalInvocationHint. * @n_param_values: the number of parameters to the function, including * the instance on which the signal was emitted. * @param_values: (array length=n_param_values): the instance on which * the signal was emitted, followed by the parameters of the emission. * @data: user data associated with the hook. * * A simple function pointer to get invoked when the signal is emitted. This * allows you to tie a hook to the signal type, so that it will trap all * emissions of that signal, from any object. * * You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. * * Returns: whether it wants to stay connected. If it returns %FALSE, the signal * hook is disconnected (and destroyed). */ typedef gboolean (*GSignalEmissionHook) (GSignalInvocationHint *ihint, guint n_param_values, const GValue *param_values, gpointer data); /** * GSignalAccumulator: * @ihint: Signal invocation hint, see #GSignalInvocationHint. * @return_accu: Accumulator to collect callback return values in, this * is the return value of the current signal emission. * @handler_return: A #GValue holding the return value of the signal handler. * @data: Callback data that was specified when creating the signal. * * The signal accumulator is a special callback function that can be used * to collect return values of the various callbacks that are called * during a signal emission. The signal accumulator is specified at signal * creation time, if it is left %NULL, no accumulation of callback return * values is performed. The return value of signal emissions is then the * value returned by the last callback. * * Returns: The accumulator function returns whether the signal emission * should be aborted. Returning %FALSE means to abort the * current emission and %TRUE is returned for continuation. */ typedef gboolean (*GSignalAccumulator) (GSignalInvocationHint *ihint, GValue *return_accu, const GValue *handler_return, gpointer data); /* --- run, match and connect types --- */ /** * GSignalFlags: * @G_SIGNAL_RUN_FIRST: Invoke the object method handler in the first emission stage. * @G_SIGNAL_RUN_LAST: Invoke the object method handler in the third emission stage. * @G_SIGNAL_RUN_CLEANUP: Invoke the object method handler in the last emission stage. * @G_SIGNAL_NO_RECURSE: Signals being emitted for an object while currently being in * emission for this very object will not be emitted recursively, * but instead cause the first emission to be restarted. * @G_SIGNAL_DETAILED: This signal supports "::detail" appendices to the signal name * upon handler connections and emissions. * @G_SIGNAL_ACTION: Action signals are signals that may freely be emitted on alive * objects from user code via g_signal_emit() and friends, without * the need of being embedded into extra code that performs pre or * post emission adjustments on the object. They can also be thought * of as object methods which can be called generically by * third-party code. * @G_SIGNAL_NO_HOOKS: No emissions hooks are supported for this signal. * @G_SIGNAL_MUST_COLLECT: Varargs signal emission will always collect the * arguments, even if there are no signal handlers connected. Since 2.30. * @G_SIGNAL_DEPRECATED: The signal is deprecated and will be removed * in a future version. A warning will be generated if it is connected while * running with G_ENABLE_DIAGNOSTIC=1. Since 2.32. * @G_SIGNAL_ACCUMULATOR_FIRST_RUN: Only used in #GSignalAccumulator accumulator * functions for the #GSignalInvocationHint::run_type field to mark the first * call to the accumulator function for a signal emission. Since 2.68. * * The signal flags are used to specify a signal's behaviour, the overall * signal description outlines how especially the RUN flags control the * stages of a signal emission. */ typedef enum { G_SIGNAL_RUN_FIRST = 1 << 0, G_SIGNAL_RUN_LAST = 1 << 1, G_SIGNAL_RUN_CLEANUP = 1 << 2, G_SIGNAL_NO_RECURSE = 1 << 3, G_SIGNAL_DETAILED = 1 << 4, G_SIGNAL_ACTION = 1 << 5, G_SIGNAL_NO_HOOKS = 1 << 6, G_SIGNAL_MUST_COLLECT = 1 << 7, G_SIGNAL_DEPRECATED = 1 << 8, /* normal signal flags until 1 << 16 */ G_SIGNAL_ACCUMULATOR_FIRST_RUN = 1 << 17, } GSignalFlags; /** * G_SIGNAL_FLAGS_MASK: * * A mask for all #GSignalFlags bits. */ #define G_SIGNAL_FLAGS_MASK 0x1ff /** * GConnectFlags: * @G_CONNECT_AFTER: whether the handler should be called before or after the * default handler of the signal. * @G_CONNECT_SWAPPED: whether the instance and data should be swapped when * calling the handler; see g_signal_connect_swapped() for an example. * * The connection flags are used to specify the behaviour of a signal's * connection. */ typedef enum { G_CONNECT_AFTER = 1 << 0, G_CONNECT_SWAPPED = 1 << 1 } GConnectFlags; /** * GSignalMatchType: * @G_SIGNAL_MATCH_ID: The signal id must be equal. * @G_SIGNAL_MATCH_DETAIL: The signal detail must be equal. * @G_SIGNAL_MATCH_CLOSURE: The closure must be the same. * @G_SIGNAL_MATCH_FUNC: The C closure callback must be the same. * @G_SIGNAL_MATCH_DATA: The closure data must be the same. * @G_SIGNAL_MATCH_UNBLOCKED: Only unblocked signals may be matched. * * The match types specify what g_signal_handlers_block_matched(), * g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() * match signals by. */ typedef enum { G_SIGNAL_MATCH_ID = 1 << 0, G_SIGNAL_MATCH_DETAIL = 1 << 1, G_SIGNAL_MATCH_CLOSURE = 1 << 2, G_SIGNAL_MATCH_FUNC = 1 << 3, G_SIGNAL_MATCH_DATA = 1 << 4, G_SIGNAL_MATCH_UNBLOCKED = 1 << 5 } GSignalMatchType; /** * G_SIGNAL_MATCH_MASK: * * A mask for all #GSignalMatchType bits. */ #define G_SIGNAL_MATCH_MASK 0x3f /** * G_SIGNAL_TYPE_STATIC_SCOPE: * * This macro flags signal argument types for which the signal system may * assume that instances thereof remain persistent across all signal emissions * they are used in. This is only useful for non ref-counted, value-copy types. * * To flag a signal argument in this way, add `| G_SIGNAL_TYPE_STATIC_SCOPE` * to the corresponding argument of g_signal_new(). * |[ * g_signal_new ("size_request", * G_TYPE_FROM_CLASS (gobject_class), * G_SIGNAL_RUN_FIRST, * G_STRUCT_OFFSET (GtkWidgetClass, size_request), * NULL, NULL, * _gtk_marshal_VOID__BOXED, * G_TYPE_NONE, 1, * GTK_TYPE_REQUISITION | G_SIGNAL_TYPE_STATIC_SCOPE); * ]| */ #define G_SIGNAL_TYPE_STATIC_SCOPE (G_TYPE_FLAG_RESERVED_ID_BIT) /* --- signal information --- */ /** * GSignalInvocationHint: * @signal_id: The signal id of the signal invoking the callback * @detail: The detail passed on for this emission * @run_type: The stage the signal emission is currently in, this * field will contain one of %G_SIGNAL_RUN_FIRST, * %G_SIGNAL_RUN_LAST or %G_SIGNAL_RUN_CLEANUP and %G_SIGNAL_ACCUMULATOR_FIRST_RUN. * %G_SIGNAL_ACCUMULATOR_FIRST_RUN is only set for the first run of the accumulator * function for a signal emission. * * The #GSignalInvocationHint structure is used to pass on additional information * to callbacks during a signal emission. */ struct _GSignalInvocationHint { guint signal_id; GQuark detail; GSignalFlags run_type; }; /** * GSignalQuery: * @signal_id: The signal id of the signal being queried, or 0 if the * signal to be queried was unknown. * @signal_name: The signal name. * @itype: The interface/instance type that this signal can be emitted for. * @signal_flags: The signal flags as passed in to g_signal_new(). * @return_type: The return type for user callbacks. * @n_params: The number of parameters that user callbacks take. * @param_types: (array length=n_params): The individual parameter types for * user callbacks, note that the effective callback signature is: * |[<!-- language="C" --> * @return_type callback (#gpointer data1, * [param_types param_names,] * gpointer data2); * ]| * * A structure holding in-depth information for a specific signal. It is * filled in by the g_signal_query() function. */ struct _GSignalQuery { guint signal_id; const gchar *signal_name; GType itype; GSignalFlags signal_flags; GType return_type; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */ guint n_params; const GType *param_types; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */ }; /* --- signals --- */ GLIB_AVAILABLE_IN_ALL guint g_signal_newv (const gchar *signal_name, GType itype, GSignalFlags signal_flags, GClosure *class_closure, GSignalAccumulator accumulator, gpointer accu_data, GSignalCMarshaller c_marshaller, GType return_type, guint n_params, GType *param_types); GLIB_AVAILABLE_IN_ALL guint g_signal_new_valist (const gchar *signal_name, GType itype, GSignalFlags signal_flags, GClosure *class_closure, GSignalAccumulator accumulator, gpointer accu_data, GSignalCMarshaller c_marshaller, GType return_type, guint n_params, va_list args); GLIB_AVAILABLE_IN_ALL guint g_signal_new (const gchar *signal_name, GType itype, GSignalFlags signal_flags, guint class_offset, GSignalAccumulator accumulator, gpointer accu_data, GSignalCMarshaller c_marshaller, GType return_type, guint n_params, ...); GLIB_AVAILABLE_IN_ALL guint g_signal_new_class_handler (const gchar *signal_name, GType itype, GSignalFlags signal_flags, GCallback class_handler, GSignalAccumulator accumulator, gpointer accu_data, GSignalCMarshaller c_marshaller, GType return_type, guint n_params, ...); GLIB_AVAILABLE_IN_ALL void g_signal_set_va_marshaller (guint signal_id, GType instance_type, GSignalCVaMarshaller va_marshaller); GLIB_AVAILABLE_IN_ALL void g_signal_emitv (const GValue *instance_and_params, guint signal_id, GQuark detail, GValue *return_value); GLIB_AVAILABLE_IN_ALL void g_signal_emit_valist (gpointer instance, guint signal_id, GQuark detail, va_list var_args); GLIB_AVAILABLE_IN_ALL void g_signal_emit (gpointer instance, guint signal_id, GQuark detail, ...); GLIB_AVAILABLE_IN_ALL void g_signal_emit_by_name (gpointer instance, const gchar *detailed_signal, ...); GLIB_AVAILABLE_IN_ALL guint g_signal_lookup (const gchar *name, GType itype); GLIB_AVAILABLE_IN_ALL const gchar * g_signal_name (guint signal_id); GLIB_AVAILABLE_IN_ALL void g_signal_query (guint signal_id, GSignalQuery *query); GLIB_AVAILABLE_IN_ALL guint* g_signal_list_ids (GType itype, guint *n_ids); GLIB_AVAILABLE_IN_2_66 gboolean g_signal_is_valid_name (const gchar *name); GLIB_AVAILABLE_IN_ALL gboolean g_signal_parse_name (const gchar *detailed_signal, GType itype, guint *signal_id_p, GQuark *detail_p, gboolean force_detail_quark); GLIB_AVAILABLE_IN_ALL GSignalInvocationHint* g_signal_get_invocation_hint (gpointer instance); /* --- signal emissions --- */ GLIB_AVAILABLE_IN_ALL void g_signal_stop_emission (gpointer instance, guint signal_id, GQuark detail); GLIB_AVAILABLE_IN_ALL void g_signal_stop_emission_by_name (gpointer instance, const gchar *detailed_signal); GLIB_AVAILABLE_IN_ALL gulong g_signal_add_emission_hook (guint signal_id, GQuark detail, GSignalEmissionHook hook_func, gpointer hook_data, GDestroyNotify data_destroy); GLIB_AVAILABLE_IN_ALL void g_signal_remove_emission_hook (guint signal_id, gulong hook_id); /* --- signal handlers --- */ GLIB_AVAILABLE_IN_ALL gboolean g_signal_has_handler_pending (gpointer instance, guint signal_id, GQuark detail, gboolean may_be_blocked); GLIB_AVAILABLE_IN_ALL gulong g_signal_connect_closure_by_id (gpointer instance, guint signal_id, GQuark detail, GClosure *closure, gboolean after); GLIB_AVAILABLE_IN_ALL gulong g_signal_connect_closure (gpointer instance, const gchar *detailed_signal, GClosure *closure, gboolean after); GLIB_AVAILABLE_IN_ALL gulong g_signal_connect_data (gpointer instance, const gchar *detailed_signal, GCallback c_handler, gpointer data, GClosureNotify destroy_data, GConnectFlags connect_flags); GLIB_AVAILABLE_IN_ALL void g_signal_handler_block (gpointer instance, gulong handler_id); GLIB_AVAILABLE_IN_ALL void g_signal_handler_unblock (gpointer instance, gulong handler_id); GLIB_AVAILABLE_IN_ALL void g_signal_handler_disconnect (gpointer instance, gulong handler_id); GLIB_AVAILABLE_IN_ALL gboolean g_signal_handler_is_connected (gpointer instance, gulong handler_id); GLIB_AVAILABLE_IN_ALL gulong g_signal_handler_find (gpointer instance, GSignalMatchType mask, guint signal_id, GQuark detail, GClosure *closure, gpointer func, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_signal_handlers_block_matched (gpointer instance, GSignalMatchType mask, guint signal_id, GQuark detail, GClosure *closure, gpointer func, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_signal_handlers_unblock_matched (gpointer instance, GSignalMatchType mask, guint signal_id, GQuark detail, GClosure *closure, gpointer func, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_signal_handlers_disconnect_matched (gpointer instance, GSignalMatchType mask, guint signal_id, GQuark detail, GClosure *closure, gpointer func, gpointer data); GLIB_AVAILABLE_IN_2_62 void g_clear_signal_handler (gulong *handler_id_ptr, gpointer instance); #define g_clear_signal_handler(handler_id_ptr, instance) \ G_STMT_START { \ gpointer const _instance = (instance); \ gulong *const _handler_id_ptr = (handler_id_ptr); \ const gulong _handler_id = *_handler_id_ptr; \ \ if (_handler_id > 0) \ { \ *_handler_id_ptr = 0; \ g_signal_handler_disconnect (_instance, _handler_id); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_62 /* --- overriding and chaining --- */ GLIB_AVAILABLE_IN_ALL void g_signal_override_class_closure (guint signal_id, GType instance_type, GClosure *class_closure); GLIB_AVAILABLE_IN_ALL void g_signal_override_class_handler (const gchar *signal_name, GType instance_type, GCallback class_handler); GLIB_AVAILABLE_IN_ALL void g_signal_chain_from_overridden (const GValue *instance_and_params, GValue *return_value); GLIB_AVAILABLE_IN_ALL void g_signal_chain_from_overridden_handler (gpointer instance, ...); /* --- convenience --- */ /** * g_signal_connect: * @instance: the instance to connect to. * @detailed_signal: a string of the form "signal-name::detail". * @c_handler: the #GCallback to connect. * @data: data to pass to @c_handler calls. * * Connects a #GCallback function to a signal for a particular object. * * The handler will be called before the default handler of the signal. * * See [memory management of signal handlers][signal-memory-management] for * details on how to handle the return value and memory management of @data. * * Returns: the handler ID, of type #gulong (always greater than 0 for successful connections) */ #define g_signal_connect(instance, detailed_signal, c_handler, data) \ g_signal_connect_data ((instance), (detailed_signal), (c_handler), (data), NULL, (GConnectFlags) 0) /** * g_signal_connect_after: * @instance: the instance to connect to. * @detailed_signal: a string of the form "signal-name::detail". * @c_handler: the #GCallback to connect. * @data: data to pass to @c_handler calls. * * Connects a #GCallback function to a signal for a particular object. * * The handler will be called after the default handler of the signal. * * Returns: the handler ID, of type #gulong (always greater than 0 for successful connections) */ #define g_signal_connect_after(instance, detailed_signal, c_handler, data) \ g_signal_connect_data ((instance), (detailed_signal), (c_handler), (data), NULL, G_CONNECT_AFTER) /** * g_signal_connect_swapped: * @instance: the instance to connect to. * @detailed_signal: a string of the form "signal-name::detail". * @c_handler: the #GCallback to connect. * @data: data to pass to @c_handler calls. * * Connects a #GCallback function to a signal for a particular object. * * The instance on which the signal is emitted and @data will be swapped when * calling the handler. This is useful when calling pre-existing functions to * operate purely on the @data, rather than the @instance: swapping the * parameters avoids the need to write a wrapper function. * * For example, this allows the shorter code: * |[<!-- language="C" --> * g_signal_connect_swapped (button, "clicked", * (GCallback) gtk_widget_hide, other_widget); * ]| * * Rather than the cumbersome: * |[<!-- language="C" --> * static void * button_clicked_cb (GtkButton *button, GtkWidget *other_widget) * { * gtk_widget_hide (other_widget); * } * * ... * * g_signal_connect (button, "clicked", * (GCallback) button_clicked_cb, other_widget); * ]| * * Returns: the handler ID, of type #gulong (always greater than 0 for successful connections) */ #define g_signal_connect_swapped(instance, detailed_signal, c_handler, data) \ g_signal_connect_data ((instance), (detailed_signal), (c_handler), (data), NULL, G_CONNECT_SWAPPED) /** * g_signal_handlers_disconnect_by_func: * @instance: The instance to remove handlers from. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * * Disconnects all handlers on an instance that match @func and @data. * * Returns: The number of handlers that matched. */ #define g_signal_handlers_disconnect_by_func(instance, func, data) \ g_signal_handlers_disconnect_matched ((instance), \ (GSignalMatchType) (G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA), \ 0, 0, NULL, (func), (data)) /** * g_signal_handlers_disconnect_by_data: * @instance: The instance to remove handlers from * @data: the closure data of the handlers' closures * * Disconnects all handlers on an instance that match @data. * * Returns: The number of handlers that matched. * * Since: 2.32 */ #define g_signal_handlers_disconnect_by_data(instance, data) \ g_signal_handlers_disconnect_matched ((instance), G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, (data)) /** * g_signal_handlers_block_by_func: * @instance: The instance to block handlers from. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * * Blocks all handlers on an instance that match @func and @data. * * Returns: The number of handlers that matched. */ #define g_signal_handlers_block_by_func(instance, func, data) \ g_signal_handlers_block_matched ((instance), \ (GSignalMatchType) (G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA), \ 0, 0, NULL, (func), (data)) /** * g_signal_handlers_unblock_by_func: * @instance: The instance to unblock handlers from. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * * Unblocks all handlers on an instance that match @func and @data. * * Returns: The number of handlers that matched. */ #define g_signal_handlers_unblock_by_func(instance, func, data) \ g_signal_handlers_unblock_matched ((instance), \ (GSignalMatchType) (G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA), \ 0, 0, NULL, (func), (data)) GLIB_AVAILABLE_IN_ALL gboolean g_signal_accumulator_true_handled (GSignalInvocationHint *ihint, GValue *return_accu, const GValue *handler_return, gpointer dummy); GLIB_AVAILABLE_IN_ALL gboolean g_signal_accumulator_first_wins (GSignalInvocationHint *ihint, GValue *return_accu, const GValue *handler_return, gpointer dummy); /*< private >*/ GLIB_AVAILABLE_IN_ALL void g_signal_handlers_destroy (gpointer instance); void _g_signals_destroy (GType itype); G_END_DECLS #endif /* __G_SIGNAL_H__ */ gobject/gvaluecollector.h 0000644 00000023133 15125173650 0011533 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * gvaluecollector.h: GValue varargs stubs */ /** * SECTION:value_collection * @Short_description: Converting varargs to generic values * @Title: Varargs Value Collection * * The macros in this section provide the varargs parsing support needed * in variadic GObject functions such as g_object_new() or g_object_set(). * They currently support the collection of integral types, floating point * types and pointers. */ #ifndef __G_VALUE_COLLECTOR_H__ #define __G_VALUE_COLLECTOR_H__ #include <glib-object.h> G_BEGIN_DECLS /* we may want to add aggregate types here some day, if requested * by users. the basic C types are covered already, everything * smaller than an int is promoted to an integer and floats are * always promoted to doubles for varargs call constructions. */ enum /*< skip >*/ { G_VALUE_COLLECT_INT = 'i', G_VALUE_COLLECT_LONG = 'l', G_VALUE_COLLECT_INT64 = 'q', G_VALUE_COLLECT_DOUBLE = 'd', G_VALUE_COLLECT_POINTER = 'p' }; /* vararg union holding actual values collected */ /** * GTypeCValue: * @v_int: the field for holding integer values * @v_long: the field for holding long integer values * @v_int64: the field for holding 64 bit integer values * @v_double: the field for holding floating point values * @v_pointer: the field for holding pointers * * A union holding one collected value. */ union _GTypeCValue { gint v_int; glong v_long; gint64 v_int64; gdouble v_double; gpointer v_pointer; }; /** * G_VALUE_COLLECT_INIT: * @value: a #GValue return location. @value must contain only 0 bytes. * @_value_type: the #GType to use for @value. * @var_args: the va_list variable; it may be evaluated multiple times * @flags: flags which are passed on to the collect_value() function of * the #GTypeValueTable of @value. * @__error: a #gchar** variable that will be modified to hold a g_new() * allocated error messages if something fails * * Collects a variable argument value from a va_list. We have to * implement the varargs collection as a macro, because on some systems * va_list variables cannot be passed by reference. * * Since: 2.24 */ #define G_VALUE_COLLECT_INIT(value, _value_type, var_args, flags, __error) \ G_STMT_START { \ GValue *g_vci_val = (value); \ guint g_vci_flags = (flags); \ GTypeValueTable *g_vci_vtab = g_type_value_table_peek (_value_type); \ const gchar *g_vci_collect_format = g_vci_vtab->collect_format; \ GTypeCValue g_vci_cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \ guint g_vci_n_values = 0; \ \ g_vci_val->g_type = _value_type; /* value_meminit() from gvalue.c */ \ while (*g_vci_collect_format) \ { \ GTypeCValue *g_vci_cvalue = g_vci_cvalues + g_vci_n_values++; \ \ switch (*g_vci_collect_format++) \ { \ case G_VALUE_COLLECT_INT: \ g_vci_cvalue->v_int = va_arg ((var_args), gint); \ break; \ case G_VALUE_COLLECT_LONG: \ g_vci_cvalue->v_long = va_arg ((var_args), glong); \ break; \ case G_VALUE_COLLECT_INT64: \ g_vci_cvalue->v_int64 = va_arg ((var_args), gint64); \ break; \ case G_VALUE_COLLECT_DOUBLE: \ g_vci_cvalue->v_double = va_arg ((var_args), gdouble); \ break; \ case G_VALUE_COLLECT_POINTER: \ g_vci_cvalue->v_pointer = va_arg ((var_args), gpointer); \ break; \ default: \ g_assert_not_reached (); \ } \ } \ *(__error) = g_vci_vtab->collect_value (g_vci_val, \ g_vci_n_values, \ g_vci_cvalues, \ g_vci_flags); \ } G_STMT_END /** * G_VALUE_COLLECT: * @value: a #GValue return location. @value is supposed to be initialized * according to the value type to be collected * @var_args: the va_list variable; it may be evaluated multiple times * @flags: flags which are passed on to the collect_value() function of * the #GTypeValueTable of @value. * @__error: a #gchar** variable that will be modified to hold a g_new() * allocated error messages if something fails * * Collects a variable argument value from a va_list. We have to * implement the varargs collection as a macro, because on some systems * va_list variables cannot be passed by reference. * * Note: If you are creating the @value argument just before calling this macro, * you should use the #G_VALUE_COLLECT_INIT variant and pass the uninitialized * #GValue. That variant is faster than #G_VALUE_COLLECT. */ #define G_VALUE_COLLECT(value, var_args, flags, __error) G_STMT_START { \ GValue *g_vc_value = (value); \ GType g_vc_value_type = G_VALUE_TYPE (g_vc_value); \ GTypeValueTable *g_vc_vtable = g_type_value_table_peek (g_vc_value_type); \ \ if (g_vc_vtable->value_free) \ g_vc_vtable->value_free (g_vc_value); \ memset (g_vc_value->data, 0, sizeof (g_vc_value->data)); \ \ G_VALUE_COLLECT_INIT(value, g_vc_value_type, var_args, flags, __error); \ } G_STMT_END /** * G_VALUE_COLLECT_SKIP: * @_value_type: the #GType of the value to skip * @var_args: the va_list variable; it may be evaluated multiple times * * Skip an argument of type @_value_type from @var_args. */ #define G_VALUE_COLLECT_SKIP(_value_type, var_args) \ G_STMT_START { \ GTypeValueTable *g_vcs_vtable = g_type_value_table_peek (_value_type); \ const gchar *g_vcs_collect_format = g_vcs_vtable->collect_format; \ \ while (*g_vcs_collect_format) \ { \ switch (*g_vcs_collect_format++) \ { \ case G_VALUE_COLLECT_INT: \ va_arg ((var_args), gint); \ break; \ case G_VALUE_COLLECT_LONG: \ va_arg ((var_args), glong); \ break; \ case G_VALUE_COLLECT_INT64: \ va_arg ((var_args), gint64); \ break; \ case G_VALUE_COLLECT_DOUBLE: \ va_arg ((var_args), gdouble); \ break; \ case G_VALUE_COLLECT_POINTER: \ va_arg ((var_args), gpointer); \ break; \ default: \ g_assert_not_reached (); \ } \ } \ } G_STMT_END /** * G_VALUE_LCOPY: * @value: a #GValue to store into the @var_args; this must be initialized * and set * @var_args: the va_list variable; it may be evaluated multiple times * @flags: flags which are passed on to the lcopy_value() function of * the #GTypeValueTable of @value. * @__error: a #gchar** variable that will be modified to hold a g_new() * allocated error message if something fails * * Stores a value’s value into one or more argument locations from a va_list. * This is the inverse of G_VALUE_COLLECT(). */ #define G_VALUE_LCOPY(value, var_args, flags, __error) \ G_STMT_START { \ const GValue *g_vl_value = (value); \ guint g_vl_flags = (flags); \ GType g_vl_value_type = G_VALUE_TYPE (g_vl_value); \ GTypeValueTable *g_vl_vtable = g_type_value_table_peek (g_vl_value_type); \ const gchar *g_vl_lcopy_format = g_vl_vtable->lcopy_format; \ GTypeCValue g_vl_cvalues[G_VALUE_COLLECT_FORMAT_MAX_LENGTH] = { { 0, }, }; \ guint g_vl_n_values = 0; \ \ while (*g_vl_lcopy_format) \ { \ GTypeCValue *g_vl_cvalue = g_vl_cvalues + g_vl_n_values++; \ \ switch (*g_vl_lcopy_format++) \ { \ case G_VALUE_COLLECT_INT: \ g_vl_cvalue->v_int = va_arg ((var_args), gint); \ break; \ case G_VALUE_COLLECT_LONG: \ g_vl_cvalue->v_long = va_arg ((var_args), glong); \ break; \ case G_VALUE_COLLECT_INT64: \ g_vl_cvalue->v_int64 = va_arg ((var_args), gint64); \ break; \ case G_VALUE_COLLECT_DOUBLE: \ g_vl_cvalue->v_double = va_arg ((var_args), gdouble); \ break; \ case G_VALUE_COLLECT_POINTER: \ g_vl_cvalue->v_pointer = va_arg ((var_args), gpointer); \ break; \ default: \ g_assert_not_reached (); \ } \ } \ *(__error) = g_vl_vtable->lcopy_value (g_vl_value, \ g_vl_n_values, \ g_vl_cvalues, \ g_vl_flags); \ } G_STMT_END /** * G_VALUE_COLLECT_FORMAT_MAX_LENGTH: * * The maximal number of #GTypeCValues which can be collected for a * single #GValue. */ #define G_VALUE_COLLECT_FORMAT_MAX_LENGTH (8) G_END_DECLS #endif /* __G_VALUE_COLLECTOR_H__ */ gobject/gmarshal.h 0000644 00000052521 15125173650 0010142 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_MARSHAL_H__ #define __G_MARSHAL_H__ G_BEGIN_DECLS /* VOID:VOID */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__VOID (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__VOIDv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:BOOLEAN */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__BOOLEAN (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__BOOLEANv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:CHAR */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__CHAR (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__CHARv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:UCHAR */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UCHAR (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UCHARv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:INT */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__INT (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__INTv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:UINT */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UINT (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UINTv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:LONG */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__LONG (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__LONGv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:ULONG */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__ULONG (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__ULONGv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:ENUM */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__ENUM (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__ENUMv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:FLAGS */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__FLAGS (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__FLAGSv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:FLOAT */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__FLOAT (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__FLOATv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:DOUBLE */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__DOUBLE (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__DOUBLEv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:STRING */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__STRING (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__STRINGv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:PARAM */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__PARAM (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__PARAMv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:BOXED */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__BOXED (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__BOXEDv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:POINTER */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__POINTER (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__POINTERv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:OBJECT */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__OBJECT (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__OBJECTv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:VARIANT */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__VARIANT (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__VARIANTv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* VOID:UINT,POINTER */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UINT_POINTER (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_VOID__UINT_POINTERv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* BOOL:FLAGS */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_BOOLEAN__FLAGS (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_BOOLEAN__FLAGSv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /** * g_cclosure_marshal_BOOL__FLAGS: * @closure: A #GClosure. * @return_value: A #GValue to store the return value. May be %NULL * if the callback of closure doesn't return a value. * @n_param_values: The length of the @param_values array. * @param_values: An array of #GValues holding the arguments * on which to invoke the callback of closure. * @invocation_hint: The invocation hint given as the last argument to * g_closure_invoke(). * @marshal_data: Additional data specified when registering the * marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * * An old alias for g_cclosure_marshal_BOOLEAN__FLAGS(). */ #define g_cclosure_marshal_BOOL__FLAGS g_cclosure_marshal_BOOLEAN__FLAGS /* STRING:OBJECT,POINTER */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_STRING__OBJECT_POINTER (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_STRING__OBJECT_POINTERv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /* BOOL:BOXED,BOXED */ GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_BOOLEAN__BOXED_BOXED (GClosure *closure, GValue *return_value, guint n_param_values, const GValue *param_values, gpointer invocation_hint, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_cclosure_marshal_BOOLEAN__BOXED_BOXEDv (GClosure *closure, GValue *return_value, gpointer instance, va_list args, gpointer marshal_data, int n_params, GType *param_types); /** * g_cclosure_marshal_BOOL__BOXED_BOXED: * @closure: A #GClosure. * @return_value: A #GValue to store the return value. May be %NULL * if the callback of closure doesn't return a value. * @n_param_values: The length of the @param_values array. * @param_values: An array of #GValues holding the arguments * on which to invoke the callback of closure. * @invocation_hint: The invocation hint given as the last argument to * g_closure_invoke(). * @marshal_data: Additional data specified when registering the * marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * * An old alias for g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). */ #define g_cclosure_marshal_BOOL__BOXED_BOXED g_cclosure_marshal_BOOLEAN__BOXED_BOXED G_END_DECLS #endif /* __G_MARSHAL_H__ */ gobject/gtype.h 0000644 00000264707 15125173650 0007507 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_TYPE_H__ #define __G_TYPE_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <glib.h> G_BEGIN_DECLS /* Basic Type Macros */ /** * G_TYPE_FUNDAMENTAL: * @type: A #GType value. * * The fundamental type which is the ancestor of @type. * Fundamental types are types that serve as ultimate bases for the derived types, * thus they are the roots of distinct inheritance hierarchies. */ #define G_TYPE_FUNDAMENTAL(type) (g_type_fundamental (type)) /** * G_TYPE_FUNDAMENTAL_MAX: * * An integer constant that represents the number of identifiers reserved * for types that are assigned at compile-time. */ #define G_TYPE_FUNDAMENTAL_MAX (255 << G_TYPE_FUNDAMENTAL_SHIFT) /* Constant fundamental types, */ /** * G_TYPE_INVALID: * * An invalid #GType used as error return value in some functions which return * a #GType. */ #define G_TYPE_INVALID G_TYPE_MAKE_FUNDAMENTAL (0) /** * G_TYPE_NONE: * * A fundamental type which is used as a replacement for the C * void return type. */ #define G_TYPE_NONE G_TYPE_MAKE_FUNDAMENTAL (1) /** * G_TYPE_INTERFACE: * * The fundamental type from which all interfaces are derived. */ #define G_TYPE_INTERFACE G_TYPE_MAKE_FUNDAMENTAL (2) /** * G_TYPE_CHAR: * * The fundamental type corresponding to #gchar. * The type designated by G_TYPE_CHAR is unconditionally an 8-bit signed integer. * This may or may not be the same type a the C type "gchar". */ #define G_TYPE_CHAR G_TYPE_MAKE_FUNDAMENTAL (3) /** * G_TYPE_UCHAR: * * The fundamental type corresponding to #guchar. */ #define G_TYPE_UCHAR G_TYPE_MAKE_FUNDAMENTAL (4) /** * G_TYPE_BOOLEAN: * * The fundamental type corresponding to #gboolean. */ #define G_TYPE_BOOLEAN G_TYPE_MAKE_FUNDAMENTAL (5) /** * G_TYPE_INT: * * The fundamental type corresponding to #gint. */ #define G_TYPE_INT G_TYPE_MAKE_FUNDAMENTAL (6) /** * G_TYPE_UINT: * * The fundamental type corresponding to #guint. */ #define G_TYPE_UINT G_TYPE_MAKE_FUNDAMENTAL (7) /** * G_TYPE_LONG: * * The fundamental type corresponding to #glong. */ #define G_TYPE_LONG G_TYPE_MAKE_FUNDAMENTAL (8) /** * G_TYPE_ULONG: * * The fundamental type corresponding to #gulong. */ #define G_TYPE_ULONG G_TYPE_MAKE_FUNDAMENTAL (9) /** * G_TYPE_INT64: * * The fundamental type corresponding to #gint64. */ #define G_TYPE_INT64 G_TYPE_MAKE_FUNDAMENTAL (10) /** * G_TYPE_UINT64: * * The fundamental type corresponding to #guint64. */ #define G_TYPE_UINT64 G_TYPE_MAKE_FUNDAMENTAL (11) /** * G_TYPE_ENUM: * * The fundamental type from which all enumeration types are derived. */ #define G_TYPE_ENUM G_TYPE_MAKE_FUNDAMENTAL (12) /** * G_TYPE_FLAGS: * * The fundamental type from which all flags types are derived. */ #define G_TYPE_FLAGS G_TYPE_MAKE_FUNDAMENTAL (13) /** * G_TYPE_FLOAT: * * The fundamental type corresponding to #gfloat. */ #define G_TYPE_FLOAT G_TYPE_MAKE_FUNDAMENTAL (14) /** * G_TYPE_DOUBLE: * * The fundamental type corresponding to #gdouble. */ #define G_TYPE_DOUBLE G_TYPE_MAKE_FUNDAMENTAL (15) /** * G_TYPE_STRING: * * The fundamental type corresponding to nul-terminated C strings. */ #define G_TYPE_STRING G_TYPE_MAKE_FUNDAMENTAL (16) /** * G_TYPE_POINTER: * * The fundamental type corresponding to #gpointer. */ #define G_TYPE_POINTER G_TYPE_MAKE_FUNDAMENTAL (17) /** * G_TYPE_BOXED: * * The fundamental type from which all boxed types are derived. */ #define G_TYPE_BOXED G_TYPE_MAKE_FUNDAMENTAL (18) /** * G_TYPE_PARAM: * * The fundamental type from which all #GParamSpec types are derived. */ #define G_TYPE_PARAM G_TYPE_MAKE_FUNDAMENTAL (19) /** * G_TYPE_OBJECT: * * The fundamental type for #GObject. */ #define G_TYPE_OBJECT G_TYPE_MAKE_FUNDAMENTAL (20) /** * G_TYPE_VARIANT: * * The fundamental type corresponding to #GVariant. * * All floating #GVariant instances passed through the #GType system are * consumed. * * Note that callbacks in closures, and signal handlers * for signals of return type %G_TYPE_VARIANT, must never return floating * variants. * * Note: GLib 2.24 did include a boxed type with this name. It was replaced * with this fundamental type in 2.26. * * Since: 2.26 */ #define G_TYPE_VARIANT G_TYPE_MAKE_FUNDAMENTAL (21) /* Reserved fundamental type numbers to create new fundamental * type IDs with G_TYPE_MAKE_FUNDAMENTAL(). * * Open an issue on https://gitlab.gnome.org/GNOME/glib/issues/new for * reservations. */ /** * G_TYPE_FUNDAMENTAL_SHIFT: * * Shift value used in converting numbers to type IDs. */ #define G_TYPE_FUNDAMENTAL_SHIFT (2) /** * G_TYPE_MAKE_FUNDAMENTAL: * @x: the fundamental type number. * * Get the type ID for the fundamental type number @x. * Use g_type_fundamental_next() instead of this macro to create new fundamental * types. * * Returns: the GType */ #define G_TYPE_MAKE_FUNDAMENTAL(x) ((GType) ((x) << G_TYPE_FUNDAMENTAL_SHIFT)) /** * G_TYPE_RESERVED_GLIB_FIRST: * * First fundamental type number to create a new fundamental type id with * G_TYPE_MAKE_FUNDAMENTAL() reserved for GLib. */ #define G_TYPE_RESERVED_GLIB_FIRST (22) /** * G_TYPE_RESERVED_GLIB_LAST: * * Last fundamental type number reserved for GLib. */ #define G_TYPE_RESERVED_GLIB_LAST (31) /** * G_TYPE_RESERVED_BSE_FIRST: * * First fundamental type number to create a new fundamental type id with * G_TYPE_MAKE_FUNDAMENTAL() reserved for BSE. */ #define G_TYPE_RESERVED_BSE_FIRST (32) /** * G_TYPE_RESERVED_BSE_LAST: * * Last fundamental type number reserved for BSE. */ #define G_TYPE_RESERVED_BSE_LAST (48) /** * G_TYPE_RESERVED_USER_FIRST: * * First available fundamental type number to create new fundamental * type id with G_TYPE_MAKE_FUNDAMENTAL(). */ #define G_TYPE_RESERVED_USER_FIRST (49) /* Type Checking Macros */ /** * G_TYPE_IS_FUNDAMENTAL: * @type: A #GType value * * Checks if @type is a fundamental type. * * Returns: %TRUE on success */ #define G_TYPE_IS_FUNDAMENTAL(type) ((type) <= G_TYPE_FUNDAMENTAL_MAX) /** * G_TYPE_IS_DERIVED: * @type: A #GType value * * Checks if @type is derived (or in object-oriented terminology: * inherited) from another type (this holds true for all non-fundamental * types). * * Returns: %TRUE on success */ #define G_TYPE_IS_DERIVED(type) ((type) > G_TYPE_FUNDAMENTAL_MAX) /** * G_TYPE_IS_INTERFACE: * @type: A #GType value * * Checks if @type is an interface type. * An interface type provides a pure API, the implementation * of which is provided by another type (which is then said to conform * to the interface). GLib interfaces are somewhat analogous to Java * interfaces and C++ classes containing only pure virtual functions, * with the difference that GType interfaces are not derivable (but see * g_type_interface_add_prerequisite() for an alternative). * * Returns: %TRUE on success */ #define G_TYPE_IS_INTERFACE(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_INTERFACE) /** * G_TYPE_IS_CLASSED: * @type: A #GType value * * Checks if @type is a classed type. * * Returns: %TRUE on success */ #define G_TYPE_IS_CLASSED(type) (g_type_test_flags ((type), G_TYPE_FLAG_CLASSED)) /** * G_TYPE_IS_INSTANTIATABLE: * @type: A #GType value * * Checks if @type can be instantiated. Instantiation is the * process of creating an instance (object) of this type. * * Returns: %TRUE on success */ #define G_TYPE_IS_INSTANTIATABLE(type) (g_type_test_flags ((type), G_TYPE_FLAG_INSTANTIATABLE)) /** * G_TYPE_IS_DERIVABLE: * @type: A #GType value * * Checks if @type is a derivable type. A derivable type can * be used as the base class of a flat (single-level) class hierarchy. * * Returns: %TRUE on success */ #define G_TYPE_IS_DERIVABLE(type) (g_type_test_flags ((type), G_TYPE_FLAG_DERIVABLE)) /** * G_TYPE_IS_DEEP_DERIVABLE: * @type: A #GType value * * Checks if @type is a deep derivable type. A deep derivable type * can be used as the base class of a deep (multi-level) class hierarchy. * * Returns: %TRUE on success */ #define G_TYPE_IS_DEEP_DERIVABLE(type) (g_type_test_flags ((type), G_TYPE_FLAG_DEEP_DERIVABLE)) /** * G_TYPE_IS_ABSTRACT: * @type: A #GType value * * Checks if @type is an abstract type. An abstract type cannot be * instantiated and is normally used as an abstract base class for * derived classes. * * Returns: %TRUE on success */ #define G_TYPE_IS_ABSTRACT(type) (g_type_test_flags ((type), G_TYPE_FLAG_ABSTRACT)) /** * G_TYPE_IS_VALUE_ABSTRACT: * @type: A #GType value * * Checks if @type is an abstract value type. An abstract value type introduces * a value table, but can't be used for g_value_init() and is normally used as * an abstract base type for derived value types. * * Returns: %TRUE on success */ #define G_TYPE_IS_VALUE_ABSTRACT(type) (g_type_test_flags ((type), G_TYPE_FLAG_VALUE_ABSTRACT)) /** * G_TYPE_IS_VALUE_TYPE: * @type: A #GType value * * Checks if @type is a value type and can be used with g_value_init(). * * Returns: %TRUE on success */ #define G_TYPE_IS_VALUE_TYPE(type) (g_type_check_is_value_type (type)) /** * G_TYPE_HAS_VALUE_TABLE: * @type: A #GType value * * Checks if @type has a #GTypeValueTable. * * Returns: %TRUE on success */ #define G_TYPE_HAS_VALUE_TABLE(type) (g_type_value_table_peek (type) != NULL) /* Typedefs */ /** * GType: * * A numerical value which represents the unique identifier of a registered * type. */ #if GLIB_SIZEOF_SIZE_T != GLIB_SIZEOF_LONG || !defined __cplusplus typedef gsize GType; #else /* for historic reasons, C++ links against gulong GTypes */ typedef gulong GType; #endif typedef struct _GValue GValue; typedef union _GTypeCValue GTypeCValue; typedef struct _GTypePlugin GTypePlugin; typedef struct _GTypeClass GTypeClass; typedef struct _GTypeInterface GTypeInterface; typedef struct _GTypeInstance GTypeInstance; typedef struct _GTypeInfo GTypeInfo; typedef struct _GTypeFundamentalInfo GTypeFundamentalInfo; typedef struct _GInterfaceInfo GInterfaceInfo; typedef struct _GTypeValueTable GTypeValueTable; typedef struct _GTypeQuery GTypeQuery; /* Basic Type Structures */ /** * GTypeClass: * * An opaque structure used as the base of all classes. */ struct _GTypeClass { /*< private >*/ GType g_type; }; /** * GTypeInstance: * * An opaque structure used as the base of all type instances. */ struct _GTypeInstance { /*< private >*/ GTypeClass *g_class; }; /** * GTypeInterface: * * An opaque structure used as the base of all interface types. */ struct _GTypeInterface { /*< private >*/ GType g_type; /* iface type */ GType g_instance_type; }; /** * GTypeQuery: * @type: the #GType value of the type * @type_name: the name of the type * @class_size: the size of the class structure * @instance_size: the size of the instance structure * * A structure holding information for a specific type. * It is filled in by the g_type_query() function. */ struct _GTypeQuery { GType type; const gchar *type_name; guint class_size; guint instance_size; }; /* Casts, checks and accessors for structured types * usage of these macros is reserved to type implementations only */ /*< protected >*/ /** * G_TYPE_CHECK_INSTANCE: * @instance: Location of a #GTypeInstance structure * * Checks if @instance is a valid #GTypeInstance structure, * otherwise issues a warning and returns %FALSE. %NULL is not a valid * #GTypeInstance. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_INSTANCE(instance) (_G_TYPE_CHI ((GTypeInstance*) (instance))) /** * G_TYPE_CHECK_INSTANCE_CAST: * @instance: (nullable): Location of a #GTypeInstance structure * @g_type: The type to be returned * @c_type: The corresponding C type of @g_type * * Checks that @instance is an instance of the type identified by @g_type * and issues a warning if this is not the case. Returns @instance casted * to a pointer to @c_type. * * No warning will be issued if @instance is %NULL, and %NULL will be returned. * * This macro should only be used in type implementations. */ #define G_TYPE_CHECK_INSTANCE_CAST(instance, g_type, c_type) (_G_TYPE_CIC ((instance), (g_type), c_type)) /** * G_TYPE_CHECK_INSTANCE_TYPE: * @instance: (nullable): Location of a #GTypeInstance structure. * @g_type: The type to be checked * * Checks if @instance is an instance of the type identified by @g_type. If * @instance is %NULL, %FALSE will be returned. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_INSTANCE_TYPE(instance, g_type) (_G_TYPE_CIT ((instance), (g_type))) /** * G_TYPE_CHECK_INSTANCE_FUNDAMENTAL_TYPE: * @instance: (nullable): Location of a #GTypeInstance structure. * @g_type: The fundamental type to be checked * * Checks if @instance is an instance of the fundamental type identified by @g_type. * If @instance is %NULL, %FALSE will be returned. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_INSTANCE_FUNDAMENTAL_TYPE(instance, g_type) (_G_TYPE_CIFT ((instance), (g_type))) /** * G_TYPE_INSTANCE_GET_CLASS: * @instance: Location of the #GTypeInstance structure * @g_type: The #GType of the class to be returned * @c_type: The C type of the class structure * * Get the class structure of a given @instance, casted * to a specified ancestor type @g_type of the instance. * * Note that while calling a GInstanceInitFunc(), the class pointer * gets modified, so it might not always return the expected pointer. * * This macro should only be used in type implementations. * * Returns: a pointer to the class structure */ #define G_TYPE_INSTANCE_GET_CLASS(instance, g_type, c_type) (_G_TYPE_IGC ((instance), (g_type), c_type)) /** * G_TYPE_INSTANCE_GET_INTERFACE: * @instance: Location of the #GTypeInstance structure * @g_type: The #GType of the interface to be returned * @c_type: The C type of the interface structure * * Get the interface structure for interface @g_type of a given @instance. * * This macro should only be used in type implementations. * * Returns: a pointer to the interface structure */ #define G_TYPE_INSTANCE_GET_INTERFACE(instance, g_type, c_type) (_G_TYPE_IGI ((instance), (g_type), c_type)) /** * G_TYPE_CHECK_CLASS_CAST: * @g_class: Location of a #GTypeClass structure * @g_type: The type to be returned * @c_type: The corresponding C type of class structure of @g_type * * Checks that @g_class is a class structure of the type identified by @g_type * and issues a warning if this is not the case. Returns @g_class casted * to a pointer to @c_type. %NULL is not a valid class structure. * * This macro should only be used in type implementations. */ #define G_TYPE_CHECK_CLASS_CAST(g_class, g_type, c_type) (_G_TYPE_CCC ((g_class), (g_type), c_type)) /** * G_TYPE_CHECK_CLASS_TYPE: * @g_class: (nullable): Location of a #GTypeClass structure * @g_type: The type to be checked * * Checks if @g_class is a class structure of the type identified by * @g_type. If @g_class is %NULL, %FALSE will be returned. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_CLASS_TYPE(g_class, g_type) (_G_TYPE_CCT ((g_class), (g_type))) /** * G_TYPE_CHECK_VALUE: * @value: a #GValue * * Checks if @value has been initialized to hold values * of a value type. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_VALUE(value) (_G_TYPE_CHV ((value))) /** * G_TYPE_CHECK_VALUE_TYPE: * @value: a #GValue * @g_type: The type to be checked * * Checks if @value has been initialized to hold values * of type @g_type. * * This macro should only be used in type implementations. * * Returns: %TRUE on success */ #define G_TYPE_CHECK_VALUE_TYPE(value, g_type) (_G_TYPE_CVH ((value), (g_type))) /** * G_TYPE_FROM_INSTANCE: * @instance: Location of a valid #GTypeInstance structure * * Get the type identifier from a given @instance structure. * * This macro should only be used in type implementations. * * Returns: the #GType */ #define G_TYPE_FROM_INSTANCE(instance) (G_TYPE_FROM_CLASS (((GTypeInstance*) (instance))->g_class)) /** * G_TYPE_FROM_CLASS: * @g_class: Location of a valid #GTypeClass structure * * Get the type identifier from a given @class structure. * * This macro should only be used in type implementations. * * Returns: the #GType */ #define G_TYPE_FROM_CLASS(g_class) (((GTypeClass*) (g_class))->g_type) /** * G_TYPE_FROM_INTERFACE: * @g_iface: Location of a valid #GTypeInterface structure * * Get the type identifier from a given @interface structure. * * This macro should only be used in type implementations. * * Returns: the #GType */ #define G_TYPE_FROM_INTERFACE(g_iface) (((GTypeInterface*) (g_iface))->g_type) /** * G_TYPE_INSTANCE_GET_PRIVATE: * @instance: the instance of a type deriving from @private_type * @g_type: the type identifying which private data to retrieve * @c_type: The C type for the private structure * * Gets the private structure for a particular type. * The private structure must have been registered in the * class_init function with g_type_class_add_private(). * * This macro should only be used in type implementations. * * Since: 2.4 * Deprecated: 2.58: Use %G_ADD_PRIVATE and the generated * `your_type_get_instance_private()` function instead * Returns: (not nullable): a pointer to the private data structure */ #define G_TYPE_INSTANCE_GET_PRIVATE(instance, g_type, c_type) ((c_type*) g_type_instance_get_private ((GTypeInstance*) (instance), (g_type))) GLIB_DEPRECATED_MACRO_IN_2_58_FOR(G_ADD_PRIVATE) /** * G_TYPE_CLASS_GET_PRIVATE: * @klass: the class of a type deriving from @private_type * @g_type: the type identifying which private data to retrieve * @c_type: The C type for the private structure * * Gets the private class structure for a particular type. * The private structure must have been registered in the * get_type() function with g_type_add_class_private(). * * This macro should only be used in type implementations. * * Since: 2.24 * Returns: (not nullable): a pointer to the private data structure */ #define G_TYPE_CLASS_GET_PRIVATE(klass, g_type, c_type) ((c_type*) g_type_class_get_private ((GTypeClass*) (klass), (g_type))) /** * GTypeDebugFlags: * @G_TYPE_DEBUG_NONE: Print no messages * @G_TYPE_DEBUG_OBJECTS: Print messages about object bookkeeping * @G_TYPE_DEBUG_SIGNALS: Print messages about signal emissions * @G_TYPE_DEBUG_MASK: Mask covering all debug flags * @G_TYPE_DEBUG_INSTANCE_COUNT: Keep a count of instances of each type * * These flags used to be passed to g_type_init_with_debug_flags() which * is now deprecated. * * If you need to enable debugging features, use the GOBJECT_DEBUG * environment variable. * * Deprecated: 2.36: g_type_init() is now done automatically */ typedef enum /*< skip >*/ { G_TYPE_DEBUG_NONE = 0, G_TYPE_DEBUG_OBJECTS = 1 << 0, G_TYPE_DEBUG_SIGNALS = 1 << 1, G_TYPE_DEBUG_INSTANCE_COUNT = 1 << 2, G_TYPE_DEBUG_MASK = 0x07 } GTypeDebugFlags GLIB_DEPRECATED_TYPE_IN_2_36; /* --- prototypes --- */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_36 void g_type_init (void); GLIB_DEPRECATED_IN_2_36 void g_type_init_with_debug_flags (GTypeDebugFlags debug_flags); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL const gchar * g_type_name (GType type); GLIB_AVAILABLE_IN_ALL GQuark g_type_qname (GType type); GLIB_AVAILABLE_IN_ALL GType g_type_from_name (const gchar *name); GLIB_AVAILABLE_IN_ALL GType g_type_parent (GType type); GLIB_AVAILABLE_IN_ALL guint g_type_depth (GType type); GLIB_AVAILABLE_IN_ALL GType g_type_next_base (GType leaf_type, GType root_type); GLIB_AVAILABLE_IN_ALL gboolean g_type_is_a (GType type, GType is_a_type); GLIB_AVAILABLE_IN_ALL gpointer g_type_class_ref (GType type); GLIB_AVAILABLE_IN_ALL gpointer g_type_class_peek (GType type); GLIB_AVAILABLE_IN_ALL gpointer g_type_class_peek_static (GType type); GLIB_AVAILABLE_IN_ALL void g_type_class_unref (gpointer g_class); GLIB_AVAILABLE_IN_ALL gpointer g_type_class_peek_parent (gpointer g_class); GLIB_AVAILABLE_IN_ALL gpointer g_type_interface_peek (gpointer instance_class, GType iface_type); GLIB_AVAILABLE_IN_ALL gpointer g_type_interface_peek_parent (gpointer g_iface); GLIB_AVAILABLE_IN_ALL gpointer g_type_default_interface_ref (GType g_type); GLIB_AVAILABLE_IN_ALL gpointer g_type_default_interface_peek (GType g_type); GLIB_AVAILABLE_IN_ALL void g_type_default_interface_unref (gpointer g_iface); /* g_free() the returned arrays */ GLIB_AVAILABLE_IN_ALL GType* g_type_children (GType type, guint *n_children); GLIB_AVAILABLE_IN_ALL GType* g_type_interfaces (GType type, guint *n_interfaces); /* per-type _static_ data */ GLIB_AVAILABLE_IN_ALL void g_type_set_qdata (GType type, GQuark quark, gpointer data); GLIB_AVAILABLE_IN_ALL gpointer g_type_get_qdata (GType type, GQuark quark); GLIB_AVAILABLE_IN_ALL void g_type_query (GType type, GTypeQuery *query); GLIB_AVAILABLE_IN_2_44 int g_type_get_instance_count (GType type); /* --- type registration --- */ /** * GBaseInitFunc: * @g_class: (type GObject.TypeClass): The #GTypeClass structure to initialize * * A callback function used by the type system to do base initialization * of the class structures of derived types. It is called as part of the * initialization process of all derived classes and should reallocate * or reset all dynamic class members copied over from the parent class. * For example, class members (such as strings) that are not sufficiently * handled by a plain memory copy of the parent class into the derived class * have to be altered. See GClassInitFunc() for a discussion of the class * initialization process. */ typedef void (*GBaseInitFunc) (gpointer g_class); /** * GBaseFinalizeFunc: * @g_class: (type GObject.TypeClass): The #GTypeClass structure to finalize * * A callback function used by the type system to finalize those portions * of a derived types class structure that were setup from the corresponding * GBaseInitFunc() function. Class finalization basically works the inverse * way in which class initialization is performed. * See GClassInitFunc() for a discussion of the class initialization process. */ typedef void (*GBaseFinalizeFunc) (gpointer g_class); /** * GClassInitFunc: * @g_class: (type GObject.TypeClass): The #GTypeClass structure to initialize. * @class_data: The @class_data member supplied via the #GTypeInfo structure. * * A callback function used by the type system to initialize the class * of a specific type. This function should initialize all static class * members. * * The initialization process of a class involves: * * - Copying common members from the parent class over to the * derived class structure. * - Zero initialization of the remaining members not copied * over from the parent class. * - Invocation of the GBaseInitFunc() initializers of all parent * types and the class' type. * - Invocation of the class' GClassInitFunc() initializer. * * Since derived classes are partially initialized through a memory copy * of the parent class, the general rule is that GBaseInitFunc() and * GBaseFinalizeFunc() should take care of necessary reinitialization * and release of those class members that were introduced by the type * that specified these GBaseInitFunc()/GBaseFinalizeFunc(). * GClassInitFunc() should only care about initializing static * class members, while dynamic class members (such as allocated strings * or reference counted resources) are better handled by a GBaseInitFunc() * for this type, so proper initialization of the dynamic class members * is performed for class initialization of derived types as well. * * An example may help to correspond the intend of the different class * initializers: * * |[<!-- language="C" --> * typedef struct { * GObjectClass parent_class; * gint static_integer; * gchar *dynamic_string; * } TypeAClass; * static void * type_a_base_class_init (TypeAClass *class) * { * class->dynamic_string = g_strdup ("some string"); * } * static void * type_a_base_class_finalize (TypeAClass *class) * { * g_free (class->dynamic_string); * } * static void * type_a_class_init (TypeAClass *class) * { * class->static_integer = 42; * } * * typedef struct { * TypeAClass parent_class; * gfloat static_float; * GString *dynamic_gstring; * } TypeBClass; * static void * type_b_base_class_init (TypeBClass *class) * { * class->dynamic_gstring = g_string_new ("some other string"); * } * static void * type_b_base_class_finalize (TypeBClass *class) * { * g_string_free (class->dynamic_gstring); * } * static void * type_b_class_init (TypeBClass *class) * { * class->static_float = 3.14159265358979323846; * } * ]| * Initialization of TypeBClass will first cause initialization of * TypeAClass (derived classes reference their parent classes, see * g_type_class_ref() on this). * * Initialization of TypeAClass roughly involves zero-initializing its fields, * then calling its GBaseInitFunc() type_a_base_class_init() to allocate * its dynamic members (dynamic_string), and finally calling its GClassInitFunc() * type_a_class_init() to initialize its static members (static_integer). * The first step in the initialization process of TypeBClass is then * a plain memory copy of the contents of TypeAClass into TypeBClass and * zero-initialization of the remaining fields in TypeBClass. * The dynamic members of TypeAClass within TypeBClass now need * reinitialization which is performed by calling type_a_base_class_init() * with an argument of TypeBClass. * * After that, the GBaseInitFunc() of TypeBClass, type_b_base_class_init() * is called to allocate the dynamic members of TypeBClass (dynamic_gstring), * and finally the GClassInitFunc() of TypeBClass, type_b_class_init(), * is called to complete the initialization process with the static members * (static_float). * * Corresponding finalization counter parts to the GBaseInitFunc() functions * have to be provided to release allocated resources at class finalization * time. */ typedef void (*GClassInitFunc) (gpointer g_class, gpointer class_data); /** * GClassFinalizeFunc: * @g_class: (type GObject.TypeClass): The #GTypeClass structure to finalize * @class_data: The @class_data member supplied via the #GTypeInfo structure * * A callback function used by the type system to finalize a class. * This function is rarely needed, as dynamically allocated class resources * should be handled by GBaseInitFunc() and GBaseFinalizeFunc(). * Also, specification of a GClassFinalizeFunc() in the #GTypeInfo * structure of a static type is invalid, because classes of static types * will never be finalized (they are artificially kept alive when their * reference count drops to zero). */ typedef void (*GClassFinalizeFunc) (gpointer g_class, gpointer class_data); /** * GInstanceInitFunc: * @instance: The instance to initialize * @g_class: (type GObject.TypeClass): The class of the type the instance is * created for * * A callback function used by the type system to initialize a new * instance of a type. This function initializes all instance members and * allocates any resources required by it. * * Initialization of a derived instance involves calling all its parent * types instance initializers, so the class member of the instance * is altered during its initialization to always point to the class that * belongs to the type the current initializer was introduced for. * * The extended members of @instance are guaranteed to have been filled with * zeros before this function is called. */ typedef void (*GInstanceInitFunc) (GTypeInstance *instance, gpointer g_class); /** * GInterfaceInitFunc: * @g_iface: (type GObject.TypeInterface): The interface structure to initialize * @iface_data: The @interface_data supplied via the #GInterfaceInfo structure * * A callback function used by the type system to initialize a new * interface. This function should initialize all internal data and * allocate any resources required by the interface. * * The members of @iface_data are guaranteed to have been filled with * zeros before this function is called. */ typedef void (*GInterfaceInitFunc) (gpointer g_iface, gpointer iface_data); /** * GInterfaceFinalizeFunc: * @g_iface: (type GObject.TypeInterface): The interface structure to finalize * @iface_data: The @interface_data supplied via the #GInterfaceInfo structure * * A callback function used by the type system to finalize an interface. * This function should destroy any internal data and release any resources * allocated by the corresponding GInterfaceInitFunc() function. */ typedef void (*GInterfaceFinalizeFunc) (gpointer g_iface, gpointer iface_data); /** * GTypeClassCacheFunc: * @cache_data: data that was given to the g_type_add_class_cache_func() call * @g_class: (type GObject.TypeClass): The #GTypeClass structure which is * unreferenced * * A callback function which is called when the reference count of a class * drops to zero. It may use g_type_class_ref() to prevent the class from * being freed. You should not call g_type_class_unref() from a * #GTypeClassCacheFunc function to prevent infinite recursion, use * g_type_class_unref_uncached() instead. * * The functions have to check the class id passed in to figure * whether they actually want to cache the class of this type, since all * classes are routed through the same #GTypeClassCacheFunc chain. * * Returns: %TRUE to stop further #GTypeClassCacheFuncs from being * called, %FALSE to continue */ typedef gboolean (*GTypeClassCacheFunc) (gpointer cache_data, GTypeClass *g_class); /** * GTypeInterfaceCheckFunc: * @check_data: data passed to g_type_add_interface_check() * @g_iface: (type GObject.TypeInterface): the interface that has been * initialized * * A callback called after an interface vtable is initialized. * See g_type_add_interface_check(). * * Since: 2.4 */ typedef void (*GTypeInterfaceCheckFunc) (gpointer check_data, gpointer g_iface); /** * GTypeFundamentalFlags: * @G_TYPE_FLAG_CLASSED: Indicates a classed type * @G_TYPE_FLAG_INSTANTIATABLE: Indicates an instantiatable type (implies classed) * @G_TYPE_FLAG_DERIVABLE: Indicates a flat derivable type * @G_TYPE_FLAG_DEEP_DERIVABLE: Indicates a deep derivable type (implies derivable) * * Bit masks used to check or determine specific characteristics of a * fundamental type. */ typedef enum /*< skip >*/ { G_TYPE_FLAG_CLASSED = (1 << 0), G_TYPE_FLAG_INSTANTIATABLE = (1 << 1), G_TYPE_FLAG_DERIVABLE = (1 << 2), G_TYPE_FLAG_DEEP_DERIVABLE = (1 << 3) } GTypeFundamentalFlags; /** * GTypeFlags: * @G_TYPE_FLAG_ABSTRACT: Indicates an abstract type. No instances can be * created for an abstract type * @G_TYPE_FLAG_VALUE_ABSTRACT: Indicates an abstract value type, i.e. a type * that introduces a value table, but can't be used for * g_value_init() * * Bit masks used to check or determine characteristics of a type. */ typedef enum /*< skip >*/ { G_TYPE_FLAG_ABSTRACT = (1 << 4), G_TYPE_FLAG_VALUE_ABSTRACT = (1 << 5) } GTypeFlags; /** * GTypeInfo: * @class_size: Size of the class structure (required for interface, classed and instantiatable types) * @base_init: Location of the base initialization function (optional) * @base_finalize: Location of the base finalization function (optional) * @class_init: Location of the class initialization function for * classed and instantiatable types. Location of the default vtable * inititalization function for interface types. (optional) This function * is used both to fill in virtual functions in the class or default vtable, * and to do type-specific setup such as registering signals and object * properties. * @class_finalize: Location of the class finalization function for * classed and instantiatable types. Location of the default vtable * finalization function for interface types. (optional) * @class_data: User-supplied data passed to the class init/finalize functions * @instance_size: Size of the instance (object) structure (required for instantiatable types only) * @n_preallocs: Prior to GLib 2.10, it specified the number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching). Since GLib 2.10, it is ignored, since instances are allocated with the [slice allocator][glib-Memory-Slices] now. * @instance_init: Location of the instance initialization function (optional, for instantiatable types only) * @value_table: A #GTypeValueTable function table for generic handling of GValues * of this type (usually only useful for fundamental types) * * This structure is used to provide the type system with the information * required to initialize and destruct (finalize) a type's class and * its instances. * * The initialized structure is passed to the g_type_register_static() function * (or is copied into the provided #GTypeInfo structure in the * g_type_plugin_complete_type_info()). The type system will perform a deep * copy of this structure, so its memory does not need to be persistent * across invocation of g_type_register_static(). */ struct _GTypeInfo { /* interface types, classed types, instantiated types */ guint16 class_size; GBaseInitFunc base_init; GBaseFinalizeFunc base_finalize; /* interface types, classed types, instantiated types */ GClassInitFunc class_init; GClassFinalizeFunc class_finalize; gconstpointer class_data; /* instantiated types */ guint16 instance_size; guint16 n_preallocs; GInstanceInitFunc instance_init; /* value handling */ const GTypeValueTable *value_table; }; /** * GTypeFundamentalInfo: * @type_flags: #GTypeFundamentalFlags describing the characteristics of the fundamental type * * A structure that provides information to the type system which is * used specifically for managing fundamental types. */ struct _GTypeFundamentalInfo { GTypeFundamentalFlags type_flags; }; /** * GInterfaceInfo: * @interface_init: location of the interface initialization function * @interface_finalize: location of the interface finalization function * @interface_data: user-supplied data passed to the interface init/finalize functions * * A structure that provides information to the type system which is * used specifically for managing interface types. */ struct _GInterfaceInfo { GInterfaceInitFunc interface_init; GInterfaceFinalizeFunc interface_finalize; gpointer interface_data; }; /** * GTypeValueTable: * @value_init: Default initialize @values contents by poking values * directly into the value->data array. The data array of * the #GValue passed into this function was zero-filled * with `memset()`, so no care has to be taken to free any * old contents. E.g. for the implementation of a string * value that may never be %NULL, the implementation might * look like: * |[<!-- language="C" --> * value->data[0].v_pointer = g_strdup (""); * ]| * @value_free: Free any old contents that might be left in the * data array of the passed in @value. No resources may * remain allocated through the #GValue contents after * this function returns. E.g. for our above string type: * |[<!-- language="C" --> * // only free strings without a specific flag for static storage * if (!(value->data[1].v_uint & G_VALUE_NOCOPY_CONTENTS)) * g_free (value->data[0].v_pointer); * ]| * @value_copy: @dest_value is a #GValue with zero-filled data section * and @src_value is a properly setup #GValue of same or * derived type. * The purpose of this function is to copy the contents of * @src_value into @dest_value in a way, that even after * @src_value has been freed, the contents of @dest_value * remain valid. String type example: * |[<!-- language="C" --> * dest_value->data[0].v_pointer = g_strdup (src_value->data[0].v_pointer); * ]| * @value_peek_pointer: If the value contents fit into a pointer, such as objects * or strings, return this pointer, so the caller can peek at * the current contents. To extend on our above string example: * |[<!-- language="C" --> * return value->data[0].v_pointer; * ]| * @collect_format: A string format describing how to collect the contents of * this value bit-by-bit. Each character in the format represents * an argument to be collected, and the characters themselves indicate * the type of the argument. Currently supported arguments are: * - 'i' - Integers. passed as collect_values[].v_int. * - 'l' - Longs. passed as collect_values[].v_long. * - 'd' - Doubles. passed as collect_values[].v_double. * - 'p' - Pointers. passed as collect_values[].v_pointer. * It should be noted that for variable argument list construction, * ANSI C promotes every type smaller than an integer to an int, and * floats to doubles. So for collection of short int or char, 'i' * needs to be used, and for collection of floats 'd'. * @collect_value: The collect_value() function is responsible for converting the * values collected from a variable argument list into contents * suitable for storage in a GValue. This function should setup * @value similar to value_init(); e.g. for a string value that * does not allow %NULL pointers, it needs to either spew an error, * or do an implicit conversion by storing an empty string. * The @value passed in to this function has a zero-filled data * array, so just like for value_init() it is guaranteed to not * contain any old contents that might need freeing. * @n_collect_values is exactly the string length of @collect_format, * and @collect_values is an array of unions #GTypeCValue with * length @n_collect_values, containing the collected values * according to @collect_format. * @collect_flags is an argument provided as a hint by the caller. * It may contain the flag %G_VALUE_NOCOPY_CONTENTS indicating, * that the collected value contents may be considered "static" * for the duration of the @value lifetime. * Thus an extra copy of the contents stored in @collect_values is * not required for assignment to @value. * For our above string example, we continue with: * |[<!-- language="C" --> * if (!collect_values[0].v_pointer) * value->data[0].v_pointer = g_strdup (""); * else if (collect_flags & G_VALUE_NOCOPY_CONTENTS) * { * value->data[0].v_pointer = collect_values[0].v_pointer; * // keep a flag for the value_free() implementation to not free this string * value->data[1].v_uint = G_VALUE_NOCOPY_CONTENTS; * } * else * value->data[0].v_pointer = g_strdup (collect_values[0].v_pointer); * return NULL; * ]| * It should be noted, that it is generally a bad idea to follow the * #G_VALUE_NOCOPY_CONTENTS hint for reference counted types. Due to * reentrancy requirements and reference count assertions performed * by the signal emission code, reference counts should always be * incremented for reference counted contents stored in the value->data * array. To deviate from our string example for a moment, and taking * a look at an exemplary implementation for collect_value() of * #GObject: * |[<!-- language="C" --> * GObject *object = G_OBJECT (collect_values[0].v_pointer); * g_return_val_if_fail (object != NULL, * g_strdup_printf ("Object passed as invalid NULL pointer")); * // never honour G_VALUE_NOCOPY_CONTENTS for ref-counted types * value->data[0].v_pointer = g_object_ref (object); * return NULL; * ]| * The reference count for valid objects is always incremented, * regardless of @collect_flags. For invalid objects, the example * returns a newly allocated string without altering @value. * Upon success, collect_value() needs to return %NULL. If, however, * an error condition occurred, collect_value() may spew an * error by returning a newly allocated non-%NULL string, giving * a suitable description of the error condition. * The calling code makes no assumptions about the @value * contents being valid upon error returns, @value * is simply thrown away without further freeing. As such, it is * a good idea to not allocate #GValue contents, prior to returning * an error, however, collect_values() is not obliged to return * a correctly setup @value for error returns, simply because * any non-%NULL return is considered a fatal condition so further * program behaviour is undefined. * @lcopy_format: Format description of the arguments to collect for @lcopy_value, * analogous to @collect_format. Usually, @lcopy_format string consists * only of 'p's to provide lcopy_value() with pointers to storage locations. * @lcopy_value: This function is responsible for storing the @value contents into * arguments passed through a variable argument list which got * collected into @collect_values according to @lcopy_format. * @n_collect_values equals the string length of @lcopy_format, * and @collect_flags may contain %G_VALUE_NOCOPY_CONTENTS. * In contrast to collect_value(), lcopy_value() is obliged to * always properly support %G_VALUE_NOCOPY_CONTENTS. * Similar to collect_value() the function may prematurely abort * by returning a newly allocated string describing an error condition. * To complete the string example: * |[<!-- language="C" --> * gchar **string_p = collect_values[0].v_pointer; * g_return_val_if_fail (string_p != NULL, * g_strdup_printf ("string location passed as NULL")); * if (collect_flags & G_VALUE_NOCOPY_CONTENTS) * *string_p = value->data[0].v_pointer; * else * *string_p = g_strdup (value->data[0].v_pointer); * ]| * And an illustrative version of lcopy_value() for * reference-counted types: * |[<!-- language="C" --> * GObject **object_p = collect_values[0].v_pointer; * g_return_val_if_fail (object_p != NULL, * g_strdup_printf ("object location passed as NULL")); * if (!value->data[0].v_pointer) * *object_p = NULL; * else if (collect_flags & G_VALUE_NOCOPY_CONTENTS) // always honour * *object_p = value->data[0].v_pointer; * else * *object_p = g_object_ref (value->data[0].v_pointer); * return NULL; * ]| * * The #GTypeValueTable provides the functions required by the #GValue * implementation, to serve as a container for values of a type. */ struct _GTypeValueTable { void (*value_init) (GValue *value); void (*value_free) (GValue *value); void (*value_copy) (const GValue *src_value, GValue *dest_value); /* varargs functionality (optional) */ gpointer (*value_peek_pointer) (const GValue *value); const gchar *collect_format; gchar* (*collect_value) (GValue *value, guint n_collect_values, GTypeCValue *collect_values, guint collect_flags); const gchar *lcopy_format; gchar* (*lcopy_value) (const GValue *value, guint n_collect_values, GTypeCValue *collect_values, guint collect_flags); }; GLIB_AVAILABLE_IN_ALL GType g_type_register_static (GType parent_type, const gchar *type_name, const GTypeInfo *info, GTypeFlags flags); GLIB_AVAILABLE_IN_ALL GType g_type_register_static_simple (GType parent_type, const gchar *type_name, guint class_size, GClassInitFunc class_init, guint instance_size, GInstanceInitFunc instance_init, GTypeFlags flags); GLIB_AVAILABLE_IN_ALL GType g_type_register_dynamic (GType parent_type, const gchar *type_name, GTypePlugin *plugin, GTypeFlags flags); GLIB_AVAILABLE_IN_ALL GType g_type_register_fundamental (GType type_id, const gchar *type_name, const GTypeInfo *info, const GTypeFundamentalInfo *finfo, GTypeFlags flags); GLIB_AVAILABLE_IN_ALL void g_type_add_interface_static (GType instance_type, GType interface_type, const GInterfaceInfo *info); GLIB_AVAILABLE_IN_ALL void g_type_add_interface_dynamic (GType instance_type, GType interface_type, GTypePlugin *plugin); GLIB_AVAILABLE_IN_ALL void g_type_interface_add_prerequisite (GType interface_type, GType prerequisite_type); GLIB_AVAILABLE_IN_ALL GType*g_type_interface_prerequisites (GType interface_type, guint *n_prerequisites); GLIB_AVAILABLE_IN_2_68 GType g_type_interface_instantiatable_prerequisite (GType interface_type); GLIB_DEPRECATED_IN_2_58 void g_type_class_add_private (gpointer g_class, gsize private_size); GLIB_AVAILABLE_IN_2_38 gint g_type_add_instance_private (GType class_type, gsize private_size); GLIB_AVAILABLE_IN_ALL gpointer g_type_instance_get_private (GTypeInstance *instance, GType private_type); GLIB_AVAILABLE_IN_2_38 void g_type_class_adjust_private_offset (gpointer g_class, gint *private_size_or_offset); GLIB_AVAILABLE_IN_ALL void g_type_add_class_private (GType class_type, gsize private_size); GLIB_AVAILABLE_IN_ALL gpointer g_type_class_get_private (GTypeClass *klass, GType private_type); GLIB_AVAILABLE_IN_2_38 gint g_type_class_get_instance_private_offset (gpointer g_class); GLIB_AVAILABLE_IN_2_34 void g_type_ensure (GType type); GLIB_AVAILABLE_IN_2_36 guint g_type_get_type_registration_serial (void); /* --- GType boilerplate --- */ /** * G_DECLARE_FINAL_TYPE: * @ModuleObjName: The name of the new type, in camel case (like `GtkWidget`) * @module_obj_name: The name of the new type in lowercase, with words * separated by `_` (like `gtk_widget`) * @MODULE: The name of the module, in all caps (like `GTK`) * @OBJ_NAME: The bare name of the type, in all caps (like `WIDGET`) * @ParentName: the name of the parent type, in camel case (like `GtkWidget`) * * A convenience macro for emitting the usual declarations in the header file for a type which is not (at the * present time) intended to be subclassed. * * You might use it in a header as follows: * * |[ * #ifndef _myapp_window_h_ * #define _myapp_window_h_ * * #include <gtk/gtk.h> * * #define MY_APP_TYPE_WINDOW my_app_window_get_type () * G_DECLARE_FINAL_TYPE (MyAppWindow, my_app_window, MY_APP, WINDOW, GtkWindow) * * MyAppWindow * my_app_window_new (void); * * ... * * #endif * ]| * * This results in the following things happening: * * - the usual `my_app_window_get_type()` function is declared with a return type of #GType * * - the `MyAppWindow` type is defined as a `typedef` of `struct _MyAppWindow`. The struct itself is not * defined and should be defined from the .c file before G_DEFINE_TYPE() is used. * * - the `MY_APP_WINDOW()` cast is emitted as `static inline` function along with the `MY_APP_IS_WINDOW()` type * checking function * * - the `MyAppWindowClass` type is defined as a struct containing `GtkWindowClass`. This is done for the * convenience of the person defining the type and should not be considered to be part of the ABI. In * particular, without a firm declaration of the instance structure, it is not possible to subclass the type * and therefore the fact that the size of the class structure is exposed is not a concern and it can be * freely changed at any point in the future. * * - g_autoptr() support being added for your type, based on the type of your parent class * * You can only use this function if your parent type also supports g_autoptr(). * * Because the type macro (`MY_APP_TYPE_WINDOW` in the above example) is not a callable, you must continue to * manually define this as a macro for yourself. * * The declaration of the `_get_type()` function is the first thing emitted by the macro. This allows this macro * to be used in the usual way with export control and API versioning macros. * * If you want to declare your own class structure, use G_DECLARE_DERIVABLE_TYPE(). * * If you are writing a library, it is important to note that it is possible to convert a type from using * G_DECLARE_FINAL_TYPE() to G_DECLARE_DERIVABLE_TYPE() without breaking API or ABI. As a precaution, you * should therefore use G_DECLARE_FINAL_TYPE() until you are sure that it makes sense for your class to be * subclassed. Once a class structure has been exposed it is not possible to change its size or remove or * reorder items without breaking the API and/or ABI. * * Since: 2.44 **/ #define G_DECLARE_FINAL_TYPE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, ParentName) \ GType module_obj_name##_get_type (void); \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ typedef struct _##ModuleObjName ModuleObjName; \ typedef struct { ParentName##Class parent_class; } ModuleObjName##Class; \ \ _GLIB_DEFINE_AUTOPTR_CHAINUP (ModuleObjName, ParentName) \ G_DEFINE_AUTOPTR_CLEANUP_FUNC (ModuleObjName##Class, g_type_class_unref) \ \ G_GNUC_UNUSED static inline ModuleObjName * MODULE##_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_CAST (ptr, module_obj_name##_get_type (), ModuleObjName); } \ G_GNUC_UNUSED static inline gboolean MODULE##_IS_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_TYPE (ptr, module_obj_name##_get_type ()); } \ G_GNUC_END_IGNORE_DEPRECATIONS /** * G_DECLARE_DERIVABLE_TYPE: * @ModuleObjName: The name of the new type, in camel case (like `GtkWidget`) * @module_obj_name: The name of the new type in lowercase, with words * separated by `_` (like `gtk_widget`) * @MODULE: The name of the module, in all caps (like `GTK`) * @OBJ_NAME: The bare name of the type, in all caps (like `WIDGET`) * @ParentName: the name of the parent type, in camel case (like `GtkWidget`) * * A convenience macro for emitting the usual declarations in the * header file for a type which is intended to be subclassed. * * You might use it in a header as follows: * * |[ * #ifndef _gtk_frobber_h_ * #define _gtk_frobber_h_ * * #define GTK_TYPE_FROBBER gtk_frobber_get_type () * GDK_AVAILABLE_IN_3_12 * G_DECLARE_DERIVABLE_TYPE (GtkFrobber, gtk_frobber, GTK, FROBBER, GtkWidget) * * struct _GtkFrobberClass * { * GtkWidgetClass parent_class; * * void (* handle_frob) (GtkFrobber *frobber, * guint n_frobs); * * gpointer padding[12]; * }; * * GtkWidget * gtk_frobber_new (void); * * ... * * #endif * ]| * * This results in the following things happening: * * - the usual `gtk_frobber_get_type()` function is declared with a return type of #GType * * - the `GtkFrobber` struct is created with `GtkWidget` as the first and only item. You are expected to use * a private structure from your .c file to store your instance variables. * * - the `GtkFrobberClass` type is defined as a typedef to `struct _GtkFrobberClass`, which is left undefined. * You should do this from the header file directly after you use the macro. * * - the `GTK_FROBBER()` and `GTK_FROBBER_CLASS()` casts are emitted as `static inline` functions along with * the `GTK_IS_FROBBER()` and `GTK_IS_FROBBER_CLASS()` type checking functions and `GTK_FROBBER_GET_CLASS()` * function. * * - g_autoptr() support being added for your type, based on the type of your parent class * * You can only use this function if your parent type also supports g_autoptr(). * * Because the type macro (`GTK_TYPE_FROBBER` in the above example) is not a callable, you must continue to * manually define this as a macro for yourself. * * The declaration of the `_get_type()` function is the first thing emitted by the macro. This allows this macro * to be used in the usual way with export control and API versioning macros. * * If you are writing a library, it is important to note that it is possible to convert a type from using * G_DECLARE_FINAL_TYPE() to G_DECLARE_DERIVABLE_TYPE() without breaking API or ABI. As a precaution, you * should therefore use G_DECLARE_FINAL_TYPE() until you are sure that it makes sense for your class to be * subclassed. Once a class structure has been exposed it is not possible to change its size or remove or * reorder items without breaking the API and/or ABI. If you want to declare your own class structure, use * G_DECLARE_DERIVABLE_TYPE(). If you want to declare a class without exposing the class or instance * structures, use G_DECLARE_FINAL_TYPE(). * * If you must use G_DECLARE_DERIVABLE_TYPE() you should be sure to include some padding at the bottom of your * class structure to leave space for the addition of future virtual functions. * * Since: 2.44 **/ #define G_DECLARE_DERIVABLE_TYPE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, ParentName) \ GType module_obj_name##_get_type (void); \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ typedef struct _##ModuleObjName ModuleObjName; \ typedef struct _##ModuleObjName##Class ModuleObjName##Class; \ struct _##ModuleObjName { ParentName parent_instance; }; \ \ _GLIB_DEFINE_AUTOPTR_CHAINUP (ModuleObjName, ParentName) \ G_DEFINE_AUTOPTR_CLEANUP_FUNC (ModuleObjName##Class, g_type_class_unref) \ \ G_GNUC_UNUSED static inline ModuleObjName * MODULE##_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_CAST (ptr, module_obj_name##_get_type (), ModuleObjName); } \ G_GNUC_UNUSED static inline ModuleObjName##Class * MODULE##_##OBJ_NAME##_CLASS (gpointer ptr) { \ return G_TYPE_CHECK_CLASS_CAST (ptr, module_obj_name##_get_type (), ModuleObjName##Class); } \ G_GNUC_UNUSED static inline gboolean MODULE##_IS_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_TYPE (ptr, module_obj_name##_get_type ()); } \ G_GNUC_UNUSED static inline gboolean MODULE##_IS_##OBJ_NAME##_CLASS (gpointer ptr) { \ return G_TYPE_CHECK_CLASS_TYPE (ptr, module_obj_name##_get_type ()); } \ G_GNUC_UNUSED static inline ModuleObjName##Class * MODULE##_##OBJ_NAME##_GET_CLASS (gpointer ptr) { \ return G_TYPE_INSTANCE_GET_CLASS (ptr, module_obj_name##_get_type (), ModuleObjName##Class); } \ G_GNUC_END_IGNORE_DEPRECATIONS /** * G_DECLARE_INTERFACE: * @ModuleObjName: The name of the new type, in camel case (like `GtkWidget`) * @module_obj_name: The name of the new type in lowercase, with words * separated by `_` (like `gtk_widget`) * @MODULE: The name of the module, in all caps (like `GTK`) * @OBJ_NAME: The bare name of the type, in all caps (like `WIDGET`) * @PrerequisiteName: the name of the prerequisite type, in camel case (like `GtkWidget`) * * A convenience macro for emitting the usual declarations in the header file for a #GInterface type. * * You might use it in a header as follows: * * |[ * #ifndef _my_model_h_ * #define _my_model_h_ * * #define MY_TYPE_MODEL my_model_get_type () * GDK_AVAILABLE_IN_3_12 * G_DECLARE_INTERFACE (MyModel, my_model, MY, MODEL, GObject) * * struct _MyModelInterface * { * GTypeInterface g_iface; * * gpointer (* get_item) (MyModel *model); * }; * * gpointer my_model_get_item (MyModel *model); * * ... * * #endif * ]| * * This results in the following things happening: * * - the usual `my_model_get_type()` function is declared with a return type of #GType * * - the `MyModelInterface` type is defined as a typedef to `struct _MyModelInterface`, * which is left undefined. You should do this from the header file directly after * you use the macro. * * - the `MY_MODEL()` cast is emitted as `static inline` functions along with * the `MY_IS_MODEL()` type checking function and `MY_MODEL_GET_IFACE()` function. * * - g_autoptr() support being added for your type, based on your prerequisite type. * * You can only use this function if your prerequisite type also supports g_autoptr(). * * Because the type macro (`MY_TYPE_MODEL` in the above example) is not a callable, you must continue to * manually define this as a macro for yourself. * * The declaration of the `_get_type()` function is the first thing emitted by the macro. This allows this macro * to be used in the usual way with export control and API versioning macros. * * Since: 2.44 **/ #define G_DECLARE_INTERFACE(ModuleObjName, module_obj_name, MODULE, OBJ_NAME, PrerequisiteName) \ GType module_obj_name##_get_type (void); \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ typedef struct _##ModuleObjName ModuleObjName; \ typedef struct _##ModuleObjName##Interface ModuleObjName##Interface; \ \ _GLIB_DEFINE_AUTOPTR_CHAINUP (ModuleObjName, PrerequisiteName) \ \ G_GNUC_UNUSED static inline ModuleObjName * MODULE##_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_CAST (ptr, module_obj_name##_get_type (), ModuleObjName); } \ G_GNUC_UNUSED static inline gboolean MODULE##_IS_##OBJ_NAME (gpointer ptr) { \ return G_TYPE_CHECK_INSTANCE_TYPE (ptr, module_obj_name##_get_type ()); } \ G_GNUC_UNUSED static inline ModuleObjName##Interface * MODULE##_##OBJ_NAME##_GET_IFACE (gpointer ptr) { \ return G_TYPE_INSTANCE_GET_INTERFACE (ptr, module_obj_name##_get_type (), ModuleObjName##Interface); } \ G_GNUC_END_IGNORE_DEPRECATIONS /** * G_DEFINE_TYPE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * * A convenience macro for type implementations, which declares a class * initialization function, an instance initialization function (see #GTypeInfo * for information about these) and a static variable named `t_n_parent_class` * pointing to the parent class. Furthermore, it defines a `*_get_type()` function. * See G_DEFINE_TYPE_EXTENDED() for an example. * * Since: 2.4 */ #define G_DEFINE_TYPE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, {}) /** * G_DEFINE_TYPE_WITH_CODE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type in lowercase, with words separated by `_`. * @T_P: The #GType of the parent type. * @_C_: Custom code that gets inserted in the `*_get_type()` function. * * A convenience macro for type implementations. * Similar to G_DEFINE_TYPE(), but allows you to insert custom code into the * `*_get_type()` function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). * See G_DEFINE_TYPE_EXTENDED() for an example. * * Since: 2.4 */ #define G_DEFINE_TYPE_WITH_CODE(TN, t_n, T_P, _C_) _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, 0) {_C_;} _G_DEFINE_TYPE_EXTENDED_END() /** * G_DEFINE_TYPE_WITH_PRIVATE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * * A convenience macro for type implementations, which declares a class * initialization function, an instance initialization function (see #GTypeInfo * for information about these), a static variable named `t_n_parent_class` * pointing to the parent class, and adds private instance data to the type. * Furthermore, it defines a `*_get_type()` function. See G_DEFINE_TYPE_EXTENDED() * for an example. * * Note that private structs added with this macros must have a struct * name of the form `TN ## Private`. * * The private instance data can be retrieved using the automatically generated * getter function `t_n_get_instance_private()`. * * See also: G_ADD_PRIVATE() * * Since: 2.38 */ #define G_DEFINE_TYPE_WITH_PRIVATE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, G_ADD_PRIVATE (TN)) /** * G_DEFINE_ABSTRACT_TYPE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * * A convenience macro for type implementations. * Similar to G_DEFINE_TYPE(), but defines an abstract type. * See G_DEFINE_TYPE_EXTENDED() for an example. * * Since: 2.4 */ #define G_DEFINE_ABSTRACT_TYPE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, G_TYPE_FLAG_ABSTRACT, {}) /** * G_DEFINE_ABSTRACT_TYPE_WITH_CODE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * @_C_: Custom code that gets inserted in the `type_name_get_type()` function. * * A convenience macro for type implementations. * Similar to G_DEFINE_TYPE_WITH_CODE(), but defines an abstract type and * allows you to insert custom code into the `*_get_type()` function, e.g. * interface implementations via G_IMPLEMENT_INTERFACE(). * See G_DEFINE_TYPE_EXTENDED() for an example. * * Since: 2.4 */ #define G_DEFINE_ABSTRACT_TYPE_WITH_CODE(TN, t_n, T_P, _C_) _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, G_TYPE_FLAG_ABSTRACT) {_C_;} _G_DEFINE_TYPE_EXTENDED_END() /** * G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * * Similar to G_DEFINE_TYPE_WITH_PRIVATE(), but defines an abstract type. * See G_DEFINE_TYPE_EXTENDED() for an example. * * Since: 2.38 */ #define G_DEFINE_ABSTRACT_TYPE_WITH_PRIVATE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, G_TYPE_FLAG_ABSTRACT, G_ADD_PRIVATE (TN)) /** * G_DEFINE_TYPE_EXTENDED: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words * separated by `_`. * @T_P: The #GType of the parent type. * @_f_: #GTypeFlags to pass to g_type_register_static() * @_C_: Custom code that gets inserted in the `*_get_type()` function. * * The most general convenience macro for type implementations, on which * G_DEFINE_TYPE(), etc are based. * * |[<!-- language="C" --> * G_DEFINE_TYPE_EXTENDED (GtkGadget, * gtk_gadget, * GTK_TYPE_WIDGET, * 0, * G_ADD_PRIVATE (GtkGadget) * G_IMPLEMENT_INTERFACE (TYPE_GIZMO, * gtk_gadget_gizmo_init)); * ]| * expands to * |[<!-- language="C" --> * static void gtk_gadget_init (GtkGadget *self); * static void gtk_gadget_class_init (GtkGadgetClass *klass); * static gpointer gtk_gadget_parent_class = NULL; * static gint GtkGadget_private_offset; * static void gtk_gadget_class_intern_init (gpointer klass) * { * gtk_gadget_parent_class = g_type_class_peek_parent (klass); * if (GtkGadget_private_offset != 0) * g_type_class_adjust_private_offset (klass, &GtkGadget_private_offset); * gtk_gadget_class_init ((GtkGadgetClass*) klass); * } * static inline gpointer gtk_gadget_get_instance_private (GtkGadget *self) * { * return (G_STRUCT_MEMBER_P (self, GtkGadget_private_offset)); * } * * GType * gtk_gadget_get_type (void) * { * static gsize static_g_define_type_id = 0; * if (g_once_init_enter (&static_g_define_type_id)) * { * GType g_define_type_id = * g_type_register_static_simple (GTK_TYPE_WIDGET, * g_intern_static_string ("GtkGadget"), * sizeof (GtkGadgetClass), * (GClassInitFunc) gtk_gadget_class_intern_init, * sizeof (GtkGadget), * (GInstanceInitFunc) gtk_gadget_init, * 0); * { * GtkGadget_private_offset = * g_type_add_instance_private (g_define_type_id, sizeof (GtkGadgetPrivate)); * } * { * const GInterfaceInfo g_implement_interface_info = { * (GInterfaceInitFunc) gtk_gadget_gizmo_init * }; * g_type_add_interface_static (g_define_type_id, TYPE_GIZMO, &g_implement_interface_info); * } * g_once_init_leave (&static_g_define_type_id, g_define_type_id); * } * return static_g_define_type_id; * } * ]| * The only pieces which have to be manually provided are the definitions of * the instance and class structure and the definitions of the instance and * class init functions. * * Since: 2.4 */ #define G_DEFINE_TYPE_EXTENDED(TN, t_n, T_P, _f_, _C_) _G_DEFINE_TYPE_EXTENDED_BEGIN (TN, t_n, T_P, _f_) {_C_;} _G_DEFINE_TYPE_EXTENDED_END() /** * G_DEFINE_INTERFACE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words separated by `_`. * @T_P: The #GType of the prerequisite type for the interface, or %G_TYPE_INVALID * for no prerequisite type. * * A convenience macro for #GTypeInterface definitions, which declares * a default vtable initialization function and defines a `*_get_type()` * function. * * The macro expects the interface initialization function to have the * name `t_n ## _default_init`, and the interface structure to have the * name `TN ## Interface`. * * The initialization function has signature * `static void t_n ## _default_init (TypeName##Interface *klass);`, rather than * the full #GInterfaceInitFunc signature, for brevity and convenience. If you * need to use an initialization function with an `iface_data` argument, you * must write the #GTypeInterface definitions manually. * * Since: 2.24 */ #define G_DEFINE_INTERFACE(TN, t_n, T_P) G_DEFINE_INTERFACE_WITH_CODE(TN, t_n, T_P, ;) /** * G_DEFINE_INTERFACE_WITH_CODE: * @TN: The name of the new type, in Camel case. * @t_n: The name of the new type, in lowercase, with words separated by `_`. * @T_P: The #GType of the prerequisite type for the interface, or %G_TYPE_INVALID * for no prerequisite type. * @_C_: Custom code that gets inserted in the `*_get_type()` function. * * A convenience macro for #GTypeInterface definitions. Similar to * G_DEFINE_INTERFACE(), but allows you to insert custom code into the * `*_get_type()` function, e.g. additional interface implementations * via G_IMPLEMENT_INTERFACE(), or additional prerequisite types. See * G_DEFINE_TYPE_EXTENDED() for a similar example using * G_DEFINE_TYPE_WITH_CODE(). * * Since: 2.24 */ #define G_DEFINE_INTERFACE_WITH_CODE(TN, t_n, T_P, _C_) _G_DEFINE_INTERFACE_EXTENDED_BEGIN(TN, t_n, T_P) {_C_;} _G_DEFINE_INTERFACE_EXTENDED_END() /** * G_IMPLEMENT_INTERFACE: * @TYPE_IFACE: The #GType of the interface to add * @iface_init: (type GInterfaceInitFunc): The interface init function, of type #GInterfaceInitFunc * * A convenience macro to ease interface addition in the `_C_` section * of G_DEFINE_TYPE_WITH_CODE() or G_DEFINE_ABSTRACT_TYPE_WITH_CODE(). * See G_DEFINE_TYPE_EXTENDED() for an example. * * Note that this macro can only be used together with the `G_DEFINE_TYPE_*` * macros, since it depends on variable names from those macros. * * Since: 2.4 */ #define G_IMPLEMENT_INTERFACE(TYPE_IFACE, iface_init) { \ const GInterfaceInfo g_implement_interface_info = { \ (GInterfaceInitFunc)(void (*)(void)) iface_init, NULL, NULL \ }; \ g_type_add_interface_static (g_define_type_id, TYPE_IFACE, &g_implement_interface_info); \ } /** * G_ADD_PRIVATE: * @TypeName: the name of the type in CamelCase * * A convenience macro to ease adding private data to instances of a new type * in the @_C_ section of G_DEFINE_TYPE_WITH_CODE() or * G_DEFINE_ABSTRACT_TYPE_WITH_CODE(). * * For instance: * * |[<!-- language="C" --> * typedef struct _MyObject MyObject; * typedef struct _MyObjectClass MyObjectClass; * * typedef struct { * gint foo; * gint bar; * } MyObjectPrivate; * * G_DEFINE_TYPE_WITH_CODE (MyObject, my_object, G_TYPE_OBJECT, * G_ADD_PRIVATE (MyObject)) * ]| * * Will add `MyObjectPrivate` as the private data to any instance of the * `MyObject` type. * * `G_DEFINE_TYPE_*` macros will automatically create a private function * based on the arguments to this macro, which can be used to safely * retrieve the private data from an instance of the type; for instance: * * |[<!-- language="C" --> * gint * my_object_get_foo (MyObject *obj) * { * MyObjectPrivate *priv = my_object_get_instance_private (obj); * * g_return_val_if_fail (MY_IS_OBJECT (obj), 0); * * return priv->foo; * } * * void * my_object_set_bar (MyObject *obj, * gint bar) * { * MyObjectPrivate *priv = my_object_get_instance_private (obj); * * g_return_if_fail (MY_IS_OBJECT (obj)); * * if (priv->bar != bar) * priv->bar = bar; * } * ]| * * Note that this macro can only be used together with the `G_DEFINE_TYPE_*` * macros, since it depends on variable names from those macros. * * Also note that private structs added with these macros must have a struct * name of the form `TypeNamePrivate`. * * It is safe to call the `_get_instance_private` function on %NULL or invalid * objects since it's only adding an offset to the instance pointer. In that * case the returned pointer must not be dereferenced. * * Since: 2.38 */ #define G_ADD_PRIVATE(TypeName) { \ TypeName##_private_offset = \ g_type_add_instance_private (g_define_type_id, sizeof (TypeName##Private)); \ } /** * G_PRIVATE_OFFSET: * @TypeName: the name of the type in CamelCase * @field: the name of the field in the private data structure * * Evaluates to the offset of the @field inside the instance private data * structure for @TypeName. * * Note that this macro can only be used together with the `G_DEFINE_TYPE_*` * and G_ADD_PRIVATE() macros, since it depends on variable names from * those macros. * * Since: 2.38 */ #define G_PRIVATE_OFFSET(TypeName, field) \ (TypeName##_private_offset + (G_STRUCT_OFFSET (TypeName##Private, field))) /** * G_PRIVATE_FIELD_P: * @TypeName: the name of the type in CamelCase * @inst: the instance of @TypeName you wish to access * @field_name: the name of the field in the private data structure * * Evaluates to a pointer to the @field_name inside the @inst private data * structure for @TypeName. * * Note that this macro can only be used together with the `G_DEFINE_TYPE_*` * and G_ADD_PRIVATE() macros, since it depends on variable names from * those macros. * * Since: 2.38 */ #define G_PRIVATE_FIELD_P(TypeName, inst, field_name) \ G_STRUCT_MEMBER_P (inst, G_PRIVATE_OFFSET (TypeName, field_name)) /** * G_PRIVATE_FIELD: * @TypeName: the name of the type in CamelCase * @inst: the instance of @TypeName you wish to access * @field_type: the type of the field in the private data structure * @field_name: the name of the field in the private data structure * * Evaluates to the @field_name inside the @inst private data * structure for @TypeName. * * Note that this macro can only be used together with the `G_DEFINE_TYPE_*` * and G_ADD_PRIVATE() macros, since it depends on variable names from * those macros. * * Since: 2.38 */ #define G_PRIVATE_FIELD(TypeName, inst, field_type, field_name) \ G_STRUCT_MEMBER (field_type, inst, G_PRIVATE_OFFSET (TypeName, field_name)) /* we need to have this macro under conditional expansion, as it references * a function that has been added in 2.38. see bug: * https://bugzilla.gnome.org/show_bug.cgi?id=703191 */ #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 #define _G_DEFINE_TYPE_EXTENDED_CLASS_INIT(TypeName, type_name) \ static void type_name##_class_intern_init (gpointer klass) \ { \ type_name##_parent_class = g_type_class_peek_parent (klass); \ if (TypeName##_private_offset != 0) \ g_type_class_adjust_private_offset (klass, &TypeName##_private_offset); \ type_name##_class_init ((TypeName##Class*) klass); \ } #else #define _G_DEFINE_TYPE_EXTENDED_CLASS_INIT(TypeName, type_name) \ static void type_name##_class_intern_init (gpointer klass) \ { \ type_name##_parent_class = g_type_class_peek_parent (klass); \ type_name##_class_init ((TypeName##Class*) klass); \ } #endif /* GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_38 */ /* Added for _G_DEFINE_TYPE_EXTENDED_WITH_PRELUDE */ #define _G_DEFINE_TYPE_EXTENDED_BEGIN_PRE(TypeName, type_name, TYPE_PARENT) \ \ static void type_name##_init (TypeName *self); \ static void type_name##_class_init (TypeName##Class *klass); \ static GType type_name##_get_type_once (void); \ static gpointer type_name##_parent_class = NULL; \ static gint TypeName##_private_offset; \ \ _G_DEFINE_TYPE_EXTENDED_CLASS_INIT(TypeName, type_name) \ \ G_GNUC_UNUSED \ static inline gpointer \ type_name##_get_instance_private (TypeName *self) \ { \ return (G_STRUCT_MEMBER_P (self, TypeName##_private_offset)); \ } \ \ GType \ type_name##_get_type (void) \ { \ static gsize static_g_define_type_id = 0; /* Prelude goes here */ /* Added for _G_DEFINE_TYPE_EXTENDED_WITH_PRELUDE */ #define _G_DEFINE_TYPE_EXTENDED_BEGIN_REGISTER(TypeName, type_name, TYPE_PARENT, flags) \ if (g_once_init_enter (&static_g_define_type_id)) \ { \ GType g_define_type_id = type_name##_get_type_once (); \ g_once_init_leave (&static_g_define_type_id, g_define_type_id); \ } \ return static_g_define_type_id; \ } /* closes type_name##_get_type() */ \ \ G_GNUC_NO_INLINE \ static GType \ type_name##_get_type_once (void) \ { \ GType g_define_type_id = \ g_type_register_static_simple (TYPE_PARENT, \ g_intern_static_string (#TypeName), \ sizeof (TypeName##Class), \ (GClassInitFunc)(void (*)(void)) type_name##_class_intern_init, \ sizeof (TypeName), \ (GInstanceInitFunc)(void (*)(void)) type_name##_init, \ (GTypeFlags) flags); \ { /* custom code follows */ #define _G_DEFINE_TYPE_EXTENDED_END() \ /* following custom code */ \ } \ return g_define_type_id; \ } /* closes type_name##_get_type_once() */ /* This was defined before we had G_DEFINE_TYPE_WITH_CODE_AND_PRELUDE, it's simplest * to keep it. */ #define _G_DEFINE_TYPE_EXTENDED_BEGIN(TypeName, type_name, TYPE_PARENT, flags) \ _G_DEFINE_TYPE_EXTENDED_BEGIN_PRE(TypeName, type_name, TYPE_PARENT) \ _G_DEFINE_TYPE_EXTENDED_BEGIN_REGISTER(TypeName, type_name, TYPE_PARENT, flags) \ #define _G_DEFINE_INTERFACE_EXTENDED_BEGIN(TypeName, type_name, TYPE_PREREQ) \ \ static void type_name##_default_init (TypeName##Interface *klass); \ \ GType \ type_name##_get_type (void) \ { \ static gsize static_g_define_type_id = 0; \ if (g_once_init_enter (&static_g_define_type_id)) \ { \ GType g_define_type_id = \ g_type_register_static_simple (G_TYPE_INTERFACE, \ g_intern_static_string (#TypeName), \ sizeof (TypeName##Interface), \ (GClassInitFunc)(void (*)(void)) type_name##_default_init, \ 0, \ (GInstanceInitFunc)NULL, \ (GTypeFlags) 0); \ if (TYPE_PREREQ != G_TYPE_INVALID) \ g_type_interface_add_prerequisite (g_define_type_id, TYPE_PREREQ); \ { /* custom code follows */ #define _G_DEFINE_INTERFACE_EXTENDED_END() \ /* following custom code */ \ } \ g_once_init_leave (&static_g_define_type_id, g_define_type_id); \ } \ return static_g_define_type_id; \ } /* closes type_name##_get_type() */ /** * G_DEFINE_BOXED_TYPE: * @TypeName: The name of the new type, in Camel case * @type_name: The name of the new type, in lowercase, with words * separated by `_` * @copy_func: the #GBoxedCopyFunc for the new type * @free_func: the #GBoxedFreeFunc for the new type * * A convenience macro for boxed type implementations, which defines a * type_name_get_type() function registering the boxed type. * * Since: 2.26 */ #define G_DEFINE_BOXED_TYPE(TypeName, type_name, copy_func, free_func) G_DEFINE_BOXED_TYPE_WITH_CODE (TypeName, type_name, copy_func, free_func, {}) /** * G_DEFINE_BOXED_TYPE_WITH_CODE: * @TypeName: The name of the new type, in Camel case * @type_name: The name of the new type, in lowercase, with words * separated by `_` * @copy_func: the #GBoxedCopyFunc for the new type * @free_func: the #GBoxedFreeFunc for the new type * @_C_: Custom code that gets inserted in the `*_get_type()` function * * A convenience macro for boxed type implementations. * Similar to G_DEFINE_BOXED_TYPE(), but allows to insert custom code into the * `type_name_get_type()` function, e.g. to register value transformations with * g_value_register_transform_func(), for instance: * * |[<!-- language="C" --> * G_DEFINE_BOXED_TYPE_WITH_CODE (GdkRectangle, gdk_rectangle, * gdk_rectangle_copy, * gdk_rectangle_free, * register_rectangle_transform_funcs (g_define_type_id)) * ]| * * Similarly to the %G_DEFINE_TYPE family of macros, the #GType of the newly * defined boxed type is exposed in the `g_define_type_id` variable. * * Since: 2.26 */ #define G_DEFINE_BOXED_TYPE_WITH_CODE(TypeName, type_name, copy_func, free_func, _C_) _G_DEFINE_BOXED_TYPE_BEGIN (TypeName, type_name, copy_func, free_func) {_C_;} _G_DEFINE_TYPE_EXTENDED_END() /* Only use this in non-C++ on GCC >= 2.7, except for Darwin/ppc64. * See https://bugzilla.gnome.org/show_bug.cgi?id=647145 */ #if !defined (__cplusplus) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)) && !(defined (__APPLE__) && defined (__ppc64__)) #define _G_DEFINE_BOXED_TYPE_BEGIN(TypeName, type_name, copy_func, free_func) \ static GType type_name##_get_type_once (void); \ \ GType \ type_name##_get_type (void) \ { \ static gsize static_g_define_type_id = 0; \ if (g_once_init_enter (&static_g_define_type_id)) \ { \ GType g_define_type_id = type_name##_get_type_once (); \ g_once_init_leave (&static_g_define_type_id, g_define_type_id); \ } \ return static_g_define_type_id; \ } \ \ G_GNUC_NO_INLINE \ static GType \ type_name##_get_type_once (void) \ { \ GType (* _g_register_boxed) \ (const gchar *, \ union \ { \ TypeName * (*do_copy_type) (TypeName *); \ TypeName * (*do_const_copy_type) (const TypeName *); \ GBoxedCopyFunc do_copy_boxed; \ } __attribute__((__transparent_union__)), \ union \ { \ void (* do_free_type) (TypeName *); \ GBoxedFreeFunc do_free_boxed; \ } __attribute__((__transparent_union__)) \ ) = g_boxed_type_register_static; \ GType g_define_type_id = \ _g_register_boxed (g_intern_static_string (#TypeName), copy_func, free_func); \ { /* custom code follows */ #else #define _G_DEFINE_BOXED_TYPE_BEGIN(TypeName, type_name, copy_func, free_func) \ static GType type_name##_get_type_once (void); \ \ GType \ type_name##_get_type (void) \ { \ static gsize static_g_define_type_id = 0; \ if (g_once_init_enter (&static_g_define_type_id)) \ { \ GType g_define_type_id = type_name##_get_type_once (); \ g_once_init_leave (&static_g_define_type_id, g_define_type_id); \ } \ return static_g_define_type_id; \ } \ \ G_GNUC_NO_INLINE \ static GType \ type_name##_get_type_once (void) \ { \ GType g_define_type_id = \ g_boxed_type_register_static (g_intern_static_string (#TypeName), \ (GBoxedCopyFunc) copy_func, \ (GBoxedFreeFunc) free_func); \ { /* custom code follows */ #endif /* __GNUC__ */ /** * G_DEFINE_POINTER_TYPE: * @TypeName: The name of the new type, in Camel case * @type_name: The name of the new type, in lowercase, with words * separated by `_` * * A convenience macro for pointer type implementations, which defines a * `type_name_get_type()` function registering the pointer type. * * Since: 2.26 */ #define G_DEFINE_POINTER_TYPE(TypeName, type_name) G_DEFINE_POINTER_TYPE_WITH_CODE (TypeName, type_name, {}) /** * G_DEFINE_POINTER_TYPE_WITH_CODE: * @TypeName: The name of the new type, in Camel case * @type_name: The name of the new type, in lowercase, with words * separated by `_` * @_C_: Custom code that gets inserted in the `*_get_type()` function * * A convenience macro for pointer type implementations. * Similar to G_DEFINE_POINTER_TYPE(), but allows to insert * custom code into the `type_name_get_type()` function. * * Since: 2.26 */ #define G_DEFINE_POINTER_TYPE_WITH_CODE(TypeName, type_name, _C_) _G_DEFINE_POINTER_TYPE_BEGIN (TypeName, type_name) {_C_;} _G_DEFINE_TYPE_EXTENDED_END() #define _G_DEFINE_POINTER_TYPE_BEGIN(TypeName, type_name) \ static GType type_name##_get_type_once (void); \ \ GType \ type_name##_get_type (void) \ { \ static gsize static_g_define_type_id = 0; \ if (g_once_init_enter (&static_g_define_type_id)) \ { \ GType g_define_type_id = type_name##_get_type_once (); \ g_once_init_leave (&static_g_define_type_id, g_define_type_id); \ } \ return static_g_define_type_id; \ } \ \ G_GNUC_NO_INLINE \ static GType \ type_name##_get_type_once (void) \ { \ GType g_define_type_id = \ g_pointer_type_register_static (g_intern_static_string (#TypeName)); \ { /* custom code follows */ /* --- protected (for fundamental type implementations) --- */ GLIB_AVAILABLE_IN_ALL GTypePlugin* g_type_get_plugin (GType type); GLIB_AVAILABLE_IN_ALL GTypePlugin* g_type_interface_get_plugin (GType instance_type, GType interface_type); GLIB_AVAILABLE_IN_ALL GType g_type_fundamental_next (void); GLIB_AVAILABLE_IN_ALL GType g_type_fundamental (GType type_id); GLIB_AVAILABLE_IN_ALL GTypeInstance* g_type_create_instance (GType type); GLIB_AVAILABLE_IN_ALL void g_type_free_instance (GTypeInstance *instance); GLIB_AVAILABLE_IN_ALL void g_type_add_class_cache_func (gpointer cache_data, GTypeClassCacheFunc cache_func); GLIB_AVAILABLE_IN_ALL void g_type_remove_class_cache_func (gpointer cache_data, GTypeClassCacheFunc cache_func); GLIB_AVAILABLE_IN_ALL void g_type_class_unref_uncached (gpointer g_class); GLIB_AVAILABLE_IN_ALL void g_type_add_interface_check (gpointer check_data, GTypeInterfaceCheckFunc check_func); GLIB_AVAILABLE_IN_ALL void g_type_remove_interface_check (gpointer check_data, GTypeInterfaceCheckFunc check_func); GLIB_AVAILABLE_IN_ALL GTypeValueTable* g_type_value_table_peek (GType type); /*< private >*/ GLIB_AVAILABLE_IN_ALL gboolean g_type_check_instance (GTypeInstance *instance) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL GTypeInstance* g_type_check_instance_cast (GTypeInstance *instance, GType iface_type); GLIB_AVAILABLE_IN_ALL gboolean g_type_check_instance_is_a (GTypeInstance *instance, GType iface_type) G_GNUC_PURE; GLIB_AVAILABLE_IN_2_42 gboolean g_type_check_instance_is_fundamentally_a (GTypeInstance *instance, GType fundamental_type) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL GTypeClass* g_type_check_class_cast (GTypeClass *g_class, GType is_a_type); GLIB_AVAILABLE_IN_ALL gboolean g_type_check_class_is_a (GTypeClass *g_class, GType is_a_type) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gboolean g_type_check_is_value_type (GType type) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_type_check_value (const GValue *value) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gboolean g_type_check_value_holds (const GValue *value, GType type) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gboolean g_type_test_flags (GType type, guint flags) G_GNUC_CONST; /* --- debugging functions --- */ GLIB_AVAILABLE_IN_ALL const gchar * g_type_name_from_instance (GTypeInstance *instance); GLIB_AVAILABLE_IN_ALL const gchar * g_type_name_from_class (GTypeClass *g_class); /* --- implementation bits --- */ #ifndef G_DISABLE_CAST_CHECKS # define _G_TYPE_CIC(ip, gt, ct) \ ((ct*) g_type_check_instance_cast ((GTypeInstance*) ip, gt)) # define _G_TYPE_CCC(cp, gt, ct) \ ((ct*) g_type_check_class_cast ((GTypeClass*) cp, gt)) #else /* G_DISABLE_CAST_CHECKS */ # define _G_TYPE_CIC(ip, gt, ct) ((ct*) ip) # define _G_TYPE_CCC(cp, gt, ct) ((ct*) cp) #endif /* G_DISABLE_CAST_CHECKS */ #define _G_TYPE_CHI(ip) (g_type_check_instance ((GTypeInstance*) ip)) #define _G_TYPE_CHV(vl) (g_type_check_value ((GValue*) vl)) #define _G_TYPE_IGC(ip, gt, ct) ((ct*) (((GTypeInstance*) ip)->g_class)) #define _G_TYPE_IGI(ip, gt, ct) ((ct*) g_type_interface_peek (((GTypeInstance*) ip)->g_class, gt)) #define _G_TYPE_CIFT(ip, ft) (g_type_check_instance_is_fundamentally_a ((GTypeInstance*) ip, ft)) #ifdef __GNUC__ # define _G_TYPE_CIT(ip, gt) (G_GNUC_EXTENSION ({ \ GTypeInstance *__inst = (GTypeInstance*) ip; GType __t = gt; gboolean __r; \ if (!__inst) \ __r = FALSE; \ else if (__inst->g_class && __inst->g_class->g_type == __t) \ __r = TRUE; \ else \ __r = g_type_check_instance_is_a (__inst, __t); \ __r; \ })) # define _G_TYPE_CCT(cp, gt) (G_GNUC_EXTENSION ({ \ GTypeClass *__class = (GTypeClass*) cp; GType __t = gt; gboolean __r; \ if (!__class) \ __r = FALSE; \ else if (__class->g_type == __t) \ __r = TRUE; \ else \ __r = g_type_check_class_is_a (__class, __t); \ __r; \ })) # define _G_TYPE_CVH(vl, gt) (G_GNUC_EXTENSION ({ \ const GValue *__val = (const GValue*) vl; GType __t = gt; gboolean __r; \ if (!__val) \ __r = FALSE; \ else if (__val->g_type == __t) \ __r = TRUE; \ else \ __r = g_type_check_value_holds (__val, __t); \ __r; \ })) #else /* !__GNUC__ */ # define _G_TYPE_CIT(ip, gt) (g_type_check_instance_is_a ((GTypeInstance*) ip, gt)) # define _G_TYPE_CCT(cp, gt) (g_type_check_class_is_a ((GTypeClass*) cp, gt)) # define _G_TYPE_CVH(vl, gt) (g_type_check_value_holds ((const GValue*) vl, gt)) #endif /* !__GNUC__ */ /** * G_TYPE_FLAG_RESERVED_ID_BIT: * * A bit in the type number that's supposed to be left untouched. */ #define G_TYPE_FLAG_RESERVED_ID_BIT ((GType) (1 << 0)) G_END_DECLS #endif /* __G_TYPE_H__ */ gobject/gtypeplugin.h 0000644 00000011547 15125173650 0010716 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_TYPE_PLUGIN_H__ #define __G_TYPE_PLUGIN_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> G_BEGIN_DECLS /* --- type macros --- */ #define G_TYPE_TYPE_PLUGIN (g_type_plugin_get_type ()) #define G_TYPE_PLUGIN(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), G_TYPE_TYPE_PLUGIN, GTypePlugin)) #define G_TYPE_PLUGIN_CLASS(vtable) (G_TYPE_CHECK_CLASS_CAST ((vtable), G_TYPE_TYPE_PLUGIN, GTypePluginClass)) #define G_IS_TYPE_PLUGIN(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_TYPE_PLUGIN)) #define G_IS_TYPE_PLUGIN_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), G_TYPE_TYPE_PLUGIN)) #define G_TYPE_PLUGIN_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), G_TYPE_TYPE_PLUGIN, GTypePluginClass)) /* --- typedefs & structures --- */ typedef struct _GTypePluginClass GTypePluginClass; /** * GTypePluginUse: * @plugin: the #GTypePlugin whose use count should be increased * * The type of the @use_plugin function of #GTypePluginClass, which gets called * to increase the use count of @plugin. */ typedef void (*GTypePluginUse) (GTypePlugin *plugin); /** * GTypePluginUnuse: * @plugin: the #GTypePlugin whose use count should be decreased * * The type of the @unuse_plugin function of #GTypePluginClass. */ typedef void (*GTypePluginUnuse) (GTypePlugin *plugin); /** * GTypePluginCompleteTypeInfo: * @plugin: the #GTypePlugin * @g_type: the #GType whose info is completed * @info: the #GTypeInfo struct to fill in * @value_table: the #GTypeValueTable to fill in * * The type of the @complete_type_info function of #GTypePluginClass. */ typedef void (*GTypePluginCompleteTypeInfo) (GTypePlugin *plugin, GType g_type, GTypeInfo *info, GTypeValueTable *value_table); /** * GTypePluginCompleteInterfaceInfo: * @plugin: the #GTypePlugin * @instance_type: the #GType of an instantiatable type to which the interface * is added * @interface_type: the #GType of the interface whose info is completed * @info: the #GInterfaceInfo to fill in * * The type of the @complete_interface_info function of #GTypePluginClass. */ typedef void (*GTypePluginCompleteInterfaceInfo) (GTypePlugin *plugin, GType instance_type, GType interface_type, GInterfaceInfo *info); /** * GTypePlugin: * * The GTypePlugin typedef is used as a placeholder * for objects that implement the GTypePlugin interface. */ /** * GTypePluginClass: * @use_plugin: Increases the use count of the plugin. * @unuse_plugin: Decreases the use count of the plugin. * @complete_type_info: Fills in the #GTypeInfo and * #GTypeValueTable structs for the type. The structs are initialized * with `memset(s, 0, sizeof (s))` before calling this function. * @complete_interface_info: Fills in missing parts of the #GInterfaceInfo * for the interface. The structs is initialized with * `memset(s, 0, sizeof (s))` before calling this function. * * The #GTypePlugin interface is used by the type system in order to handle * the lifecycle of dynamically loaded types. */ struct _GTypePluginClass { /*< private >*/ GTypeInterface base_iface; /*< public >*/ GTypePluginUse use_plugin; GTypePluginUnuse unuse_plugin; GTypePluginCompleteTypeInfo complete_type_info; GTypePluginCompleteInterfaceInfo complete_interface_info; }; /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GType g_type_plugin_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL void g_type_plugin_use (GTypePlugin *plugin); GLIB_AVAILABLE_IN_ALL void g_type_plugin_unuse (GTypePlugin *plugin); GLIB_AVAILABLE_IN_ALL void g_type_plugin_complete_type_info (GTypePlugin *plugin, GType g_type, GTypeInfo *info, GTypeValueTable *value_table); GLIB_AVAILABLE_IN_ALL void g_type_plugin_complete_interface_info (GTypePlugin *plugin, GType instance_type, GType interface_type, GInterfaceInfo *info); G_END_DECLS #endif /* __G_TYPE_PLUGIN_H__ */ gobject/genums.h 0000644 00000017551 15125173650 0007646 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998-1999, 2000-2001 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_ENUMS_H__ #define __G_ENUMS_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> G_BEGIN_DECLS /* --- type macros --- */ /** * G_TYPE_IS_ENUM: * @type: a #GType ID. * * Checks whether @type "is a" %G_TYPE_ENUM. * * Returns: %TRUE if @type "is a" %G_TYPE_ENUM. */ #define G_TYPE_IS_ENUM(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM) /** * G_ENUM_CLASS: * @class: a valid #GEnumClass * * Casts a derived #GEnumClass structure into a #GEnumClass structure. */ #define G_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_ENUM, GEnumClass)) /** * G_IS_ENUM_CLASS: * @class: a #GEnumClass * * Checks whether @class "is a" valid #GEnumClass structure of type %G_TYPE_ENUM * or derived. */ #define G_IS_ENUM_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_ENUM)) /** * G_ENUM_CLASS_TYPE: * @class: a #GEnumClass * * Get the type identifier from a given #GEnumClass structure. * * Returns: the #GType */ #define G_ENUM_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class)) /** * G_ENUM_CLASS_TYPE_NAME: * @class: a #GEnumClass * * Get the static type name from a given #GEnumClass structure. * * Returns: the type name. */ #define G_ENUM_CLASS_TYPE_NAME(class) (g_type_name (G_ENUM_CLASS_TYPE (class))) /** * G_TYPE_IS_FLAGS: * @type: a #GType ID. * * Checks whether @type "is a" %G_TYPE_FLAGS. * * Returns: %TRUE if @type "is a" %G_TYPE_FLAGS. */ #define G_TYPE_IS_FLAGS(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS) /** * G_FLAGS_CLASS: * @class: a valid #GFlagsClass * * Casts a derived #GFlagsClass structure into a #GFlagsClass structure. */ #define G_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_FLAGS, GFlagsClass)) /** * G_IS_FLAGS_CLASS: * @class: a #GFlagsClass * * Checks whether @class "is a" valid #GFlagsClass structure of type %G_TYPE_FLAGS * or derived. */ #define G_IS_FLAGS_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_FLAGS)) /** * G_FLAGS_CLASS_TYPE: * @class: a #GFlagsClass * * Get the type identifier from a given #GFlagsClass structure. * * Returns: the #GType */ #define G_FLAGS_CLASS_TYPE(class) (G_TYPE_FROM_CLASS (class)) /** * G_FLAGS_CLASS_TYPE_NAME: * @class: a #GFlagsClass * * Get the static type name from a given #GFlagsClass structure. * * Returns: the type name. */ #define G_FLAGS_CLASS_TYPE_NAME(class) (g_type_name (G_FLAGS_CLASS_TYPE (class))) /** * G_VALUE_HOLDS_ENUM: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values derived from type %G_TYPE_ENUM. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_ENUM(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ENUM)) /** * G_VALUE_HOLDS_FLAGS: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values derived from type %G_TYPE_FLAGS. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_FLAGS(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLAGS)) /* --- enum/flag values & classes --- */ typedef struct _GEnumClass GEnumClass; typedef struct _GFlagsClass GFlagsClass; typedef struct _GEnumValue GEnumValue; typedef struct _GFlagsValue GFlagsValue; /** * GEnumClass: * @g_type_class: the parent class * @minimum: the smallest possible value. * @maximum: the largest possible value. * @n_values: the number of possible values. * @values: an array of #GEnumValue structs describing the * individual values. * * The class of an enumeration type holds information about its * possible values. */ struct _GEnumClass { GTypeClass g_type_class; /*< public >*/ gint minimum; gint maximum; guint n_values; GEnumValue *values; }; /** * GFlagsClass: * @g_type_class: the parent class * @mask: a mask covering all possible values. * @n_values: the number of possible values. * @values: an array of #GFlagsValue structs describing the * individual values. * * The class of a flags type holds information about its * possible values. */ struct _GFlagsClass { GTypeClass g_type_class; /*< public >*/ guint mask; guint n_values; GFlagsValue *values; }; /** * GEnumValue: * @value: the enum value * @value_name: the name of the value * @value_nick: the nickname of the value * * A structure which contains a single enum value, its name, and its * nickname. */ struct _GEnumValue { gint value; const gchar *value_name; const gchar *value_nick; }; /** * GFlagsValue: * @value: the flags value * @value_name: the name of the value * @value_nick: the nickname of the value * * A structure which contains a single flags value, its name, and its * nickname. */ struct _GFlagsValue { guint value; const gchar *value_name; const gchar *value_nick; }; /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL GEnumValue* g_enum_get_value (GEnumClass *enum_class, gint value); GLIB_AVAILABLE_IN_ALL GEnumValue* g_enum_get_value_by_name (GEnumClass *enum_class, const gchar *name); GLIB_AVAILABLE_IN_ALL GEnumValue* g_enum_get_value_by_nick (GEnumClass *enum_class, const gchar *nick); GLIB_AVAILABLE_IN_ALL GFlagsValue* g_flags_get_first_value (GFlagsClass *flags_class, guint value); GLIB_AVAILABLE_IN_ALL GFlagsValue* g_flags_get_value_by_name (GFlagsClass *flags_class, const gchar *name); GLIB_AVAILABLE_IN_ALL GFlagsValue* g_flags_get_value_by_nick (GFlagsClass *flags_class, const gchar *nick); GLIB_AVAILABLE_IN_2_54 gchar *g_enum_to_string (GType g_enum_type, gint value); GLIB_AVAILABLE_IN_2_54 gchar *g_flags_to_string (GType flags_type, guint value); GLIB_AVAILABLE_IN_ALL void g_value_set_enum (GValue *value, gint v_enum); GLIB_AVAILABLE_IN_ALL gint g_value_get_enum (const GValue *value); GLIB_AVAILABLE_IN_ALL void g_value_set_flags (GValue *value, guint v_flags); GLIB_AVAILABLE_IN_ALL guint g_value_get_flags (const GValue *value); /* --- registration functions --- */ /* const_static_values is a NULL terminated array of enum/flags * values that is taken over! */ GLIB_AVAILABLE_IN_ALL GType g_enum_register_static (const gchar *name, const GEnumValue *const_static_values); GLIB_AVAILABLE_IN_ALL GType g_flags_register_static (const gchar *name, const GFlagsValue *const_static_values); /* functions to complete the type information * for enums/flags implemented by plugins */ GLIB_AVAILABLE_IN_ALL void g_enum_complete_type_info (GType g_enum_type, GTypeInfo *info, const GEnumValue *const_values); GLIB_AVAILABLE_IN_ALL void g_flags_complete_type_info (GType g_flags_type, GTypeInfo *info, const GFlagsValue *const_values); G_END_DECLS #endif /* __G_ENUMS_H__ */ gobject/gboxed.h 0000644 00000007575 15125173650 0007625 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 2000-2001 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_BOXED_H__ #define __G_BOXED_H__ #if !defined (__GLIB_GOBJECT_H_INSIDE__) && !defined (GOBJECT_COMPILATION) #error "Only <glib-object.h> can be included directly." #endif #include <gobject/gtype.h> #ifndef __GI_SCANNER__ #include <gobject/glib-types.h> #endif G_BEGIN_DECLS /* --- type macros --- */ #define G_TYPE_IS_BOXED(type) (G_TYPE_FUNDAMENTAL (type) == G_TYPE_BOXED) /** * G_VALUE_HOLDS_BOXED: * @value: a valid #GValue structure * * Checks whether the given #GValue can hold values derived * from type %G_TYPE_BOXED. * * Returns: %TRUE on success. */ #define G_VALUE_HOLDS_BOXED(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOXED)) /* --- typedefs --- */ /** * GBoxedCopyFunc: * @boxed: (not nullable): The boxed structure to be copied. * * This function is provided by the user and should produce a copy * of the passed in boxed structure. * * Returns: (not nullable): The newly created copy of the boxed structure. */ typedef gpointer (*GBoxedCopyFunc) (gpointer boxed); /** * GBoxedFreeFunc: * @boxed: (not nullable): The boxed structure to be freed. * * This function is provided by the user and should free the boxed * structure passed. */ typedef void (*GBoxedFreeFunc) (gpointer boxed); /* --- prototypes --- */ GLIB_AVAILABLE_IN_ALL gpointer g_boxed_copy (GType boxed_type, gconstpointer src_boxed); GLIB_AVAILABLE_IN_ALL void g_boxed_free (GType boxed_type, gpointer boxed); GLIB_AVAILABLE_IN_ALL void g_value_set_boxed (GValue *value, gconstpointer v_boxed); GLIB_AVAILABLE_IN_ALL void g_value_set_static_boxed (GValue *value, gconstpointer v_boxed); GLIB_AVAILABLE_IN_ALL void g_value_take_boxed (GValue *value, gconstpointer v_boxed); GLIB_DEPRECATED_FOR(g_value_take_boxed) void g_value_set_boxed_take_ownership (GValue *value, gconstpointer v_boxed); GLIB_AVAILABLE_IN_ALL gpointer g_value_get_boxed (const GValue *value); GLIB_AVAILABLE_IN_ALL gpointer g_value_dup_boxed (const GValue *value); /* --- convenience --- */ GLIB_AVAILABLE_IN_ALL GType g_boxed_type_register_static (const gchar *name, GBoxedCopyFunc boxed_copy, GBoxedFreeFunc boxed_free); /* --- GObject boxed types --- */ /** * G_TYPE_CLOSURE: * * The #GType for #GClosure. */ #define G_TYPE_CLOSURE (g_closure_get_type ()) /** * G_TYPE_VALUE: * * The type ID of the "GValue" type which is a boxed type, * used to pass around pointers to GValues. */ #define G_TYPE_VALUE (g_value_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_closure_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GType g_value_get_type (void) G_GNUC_CONST; G_END_DECLS #endif /* __G_BOXED_H__ */ glib/gpattern.h 0000644 00000003366 15125173650 0007473 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997, 1999 Peter Mattis, Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_PATTERN_H__ #define __G_PATTERN_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GPatternSpec GPatternSpec; GLIB_AVAILABLE_IN_ALL GPatternSpec* g_pattern_spec_new (const gchar *pattern); GLIB_AVAILABLE_IN_ALL void g_pattern_spec_free (GPatternSpec *pspec); GLIB_AVAILABLE_IN_ALL gboolean g_pattern_spec_equal (GPatternSpec *pspec1, GPatternSpec *pspec2); GLIB_AVAILABLE_IN_ALL gboolean g_pattern_match (GPatternSpec *pspec, guint string_length, const gchar *string, const gchar *string_reversed); GLIB_AVAILABLE_IN_ALL gboolean g_pattern_match_string (GPatternSpec *pspec, const gchar *string); GLIB_AVAILABLE_IN_ALL gboolean g_pattern_match_simple (const gchar *pattern, const gchar *string); G_END_DECLS #endif /* __G_PATTERN_H__ */ glib/grand.h 0000644 00000006155 15125173650 0006741 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_RAND_H__ #define __G_RAND_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GRand GRand; /* GRand - a good and fast random number generator: Mersenne Twister * see http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html for more info. * The range functions return a value in the interval [begin, end). * int -> [0..2^32-1] * int_range -> [begin..end-1] * double -> [0..1) * double_range -> [begin..end) */ GLIB_AVAILABLE_IN_ALL GRand* g_rand_new_with_seed (guint32 seed); GLIB_AVAILABLE_IN_ALL GRand* g_rand_new_with_seed_array (const guint32 *seed, guint seed_length); GLIB_AVAILABLE_IN_ALL GRand* g_rand_new (void); GLIB_AVAILABLE_IN_ALL void g_rand_free (GRand *rand_); GLIB_AVAILABLE_IN_ALL GRand* g_rand_copy (GRand *rand_); GLIB_AVAILABLE_IN_ALL void g_rand_set_seed (GRand *rand_, guint32 seed); GLIB_AVAILABLE_IN_ALL void g_rand_set_seed_array (GRand *rand_, const guint32 *seed, guint seed_length); #define g_rand_boolean(rand_) ((g_rand_int (rand_) & (1 << 15)) != 0) GLIB_AVAILABLE_IN_ALL guint32 g_rand_int (GRand *rand_); GLIB_AVAILABLE_IN_ALL gint32 g_rand_int_range (GRand *rand_, gint32 begin, gint32 end); GLIB_AVAILABLE_IN_ALL gdouble g_rand_double (GRand *rand_); GLIB_AVAILABLE_IN_ALL gdouble g_rand_double_range (GRand *rand_, gdouble begin, gdouble end); GLIB_AVAILABLE_IN_ALL void g_random_set_seed (guint32 seed); #define g_random_boolean() ((g_random_int () & (1 << 15)) != 0) GLIB_AVAILABLE_IN_ALL guint32 g_random_int (void); GLIB_AVAILABLE_IN_ALL gint32 g_random_int_range (gint32 begin, gint32 end); GLIB_AVAILABLE_IN_ALL gdouble g_random_double (void); GLIB_AVAILABLE_IN_ALL gdouble g_random_double_range (gdouble begin, gdouble end); G_END_DECLS #endif /* __G_RAND_H__ */ glib/gtimer.h 0000644 00000005020 15125173650 0007123 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_TIMER_H__ #define __G_TIMER_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS /* Timer */ /* microseconds per second */ typedef struct _GTimer GTimer; #define G_USEC_PER_SEC 1000000 GLIB_AVAILABLE_IN_ALL GTimer* g_timer_new (void); GLIB_AVAILABLE_IN_ALL void g_timer_destroy (GTimer *timer); GLIB_AVAILABLE_IN_ALL void g_timer_start (GTimer *timer); GLIB_AVAILABLE_IN_ALL void g_timer_stop (GTimer *timer); GLIB_AVAILABLE_IN_ALL void g_timer_reset (GTimer *timer); GLIB_AVAILABLE_IN_ALL void g_timer_continue (GTimer *timer); GLIB_AVAILABLE_IN_ALL gdouble g_timer_elapsed (GTimer *timer, gulong *microseconds); GLIB_AVAILABLE_IN_2_62 gboolean g_timer_is_active (GTimer *timer); GLIB_AVAILABLE_IN_ALL void g_usleep (gulong microseconds); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62 void g_time_val_add (GTimeVal *time_, glong microseconds); GLIB_DEPRECATED_IN_2_62_FOR(g_date_time_new_from_iso8601) gboolean g_time_val_from_iso8601 (const gchar *iso_date, GTimeVal *time_); GLIB_DEPRECATED_IN_2_62_FOR(g_date_time_format) gchar* g_time_val_to_iso8601 (GTimeVal *time_) G_GNUC_MALLOC; G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_TIMER_H__ */ glib/gversionmacros.h 0000644 00000135075 15125173650 0010713 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_VERSION_MACROS_H__ #define __G_VERSION_MACROS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif /* Version boundaries checks */ #define G_ENCODE_VERSION(major,minor) ((major) << 16 | (minor) << 8) /* XXX: Every new stable minor release bump should add a macro here */ /** * GLIB_VERSION_2_26: * * A macro that evaluates to the 2.26 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.32 */ #define GLIB_VERSION_2_26 (G_ENCODE_VERSION (2, 26)) /** * GLIB_VERSION_2_28: * * A macro that evaluates to the 2.28 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.32 */ #define GLIB_VERSION_2_28 (G_ENCODE_VERSION (2, 28)) /** * GLIB_VERSION_2_30: * * A macro that evaluates to the 2.30 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.32 */ #define GLIB_VERSION_2_30 (G_ENCODE_VERSION (2, 30)) /** * GLIB_VERSION_2_32: * * A macro that evaluates to the 2.32 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.32 */ #define GLIB_VERSION_2_32 (G_ENCODE_VERSION (2, 32)) /** * GLIB_VERSION_2_34: * * A macro that evaluates to the 2.34 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.34 */ #define GLIB_VERSION_2_34 (G_ENCODE_VERSION (2, 34)) /** * GLIB_VERSION_2_36: * * A macro that evaluates to the 2.36 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.36 */ #define GLIB_VERSION_2_36 (G_ENCODE_VERSION (2, 36)) /** * GLIB_VERSION_2_38: * * A macro that evaluates to the 2.38 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.38 */ #define GLIB_VERSION_2_38 (G_ENCODE_VERSION (2, 38)) /** * GLIB_VERSION_2_40: * * A macro that evaluates to the 2.40 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.40 */ #define GLIB_VERSION_2_40 (G_ENCODE_VERSION (2, 40)) /** * GLIB_VERSION_2_42: * * A macro that evaluates to the 2.42 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.42 */ #define GLIB_VERSION_2_42 (G_ENCODE_VERSION (2, 42)) /** * GLIB_VERSION_2_44: * * A macro that evaluates to the 2.44 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.44 */ #define GLIB_VERSION_2_44 (G_ENCODE_VERSION (2, 44)) /** * GLIB_VERSION_2_46: * * A macro that evaluates to the 2.46 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.46 */ #define GLIB_VERSION_2_46 (G_ENCODE_VERSION (2, 46)) /** * GLIB_VERSION_2_48: * * A macro that evaluates to the 2.48 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.48 */ #define GLIB_VERSION_2_48 (G_ENCODE_VERSION (2, 48)) /** * GLIB_VERSION_2_50: * * A macro that evaluates to the 2.50 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.50 */ #define GLIB_VERSION_2_50 (G_ENCODE_VERSION (2, 50)) /** * GLIB_VERSION_2_52: * * A macro that evaluates to the 2.52 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.52 */ #define GLIB_VERSION_2_52 (G_ENCODE_VERSION (2, 52)) /** * GLIB_VERSION_2_54: * * A macro that evaluates to the 2.54 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.54 */ #define GLIB_VERSION_2_54 (G_ENCODE_VERSION (2, 54)) /** * GLIB_VERSION_2_56: * * A macro that evaluates to the 2.56 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.56 */ #define GLIB_VERSION_2_56 (G_ENCODE_VERSION (2, 56)) /** * GLIB_VERSION_2_58: * * A macro that evaluates to the 2.58 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.58 */ #define GLIB_VERSION_2_58 (G_ENCODE_VERSION (2, 58)) /** * GLIB_VERSION_2_60: * * A macro that evaluates to the 2.60 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.60 */ #define GLIB_VERSION_2_60 (G_ENCODE_VERSION (2, 60)) /** * GLIB_VERSION_2_62: * * A macro that evaluates to the 2.62 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.62 */ #define GLIB_VERSION_2_62 (G_ENCODE_VERSION (2, 62)) /** * GLIB_VERSION_2_64: * * A macro that evaluates to the 2.64 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.64 */ #define GLIB_VERSION_2_64 (G_ENCODE_VERSION (2, 64)) /** * GLIB_VERSION_2_66: * * A macro that evaluates to the 2.66 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.66 */ #define GLIB_VERSION_2_66 (G_ENCODE_VERSION (2, 66)) /** * GLIB_VERSION_2_68: * * A macro that evaluates to the 2.68 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.68 */ #define GLIB_VERSION_2_68 (G_ENCODE_VERSION (2, 68)) /** * GLIB_VERSION_2_70: * * A macro that evaluates to the 2.70 version of GLib, in a format * that can be used by the C pre-processor. * * Since: 2.70 */ #define GLIB_VERSION_2_70 (G_ENCODE_VERSION (2, 70)) /** * GLIB_VERSION_CUR_STABLE: * * A macro that evaluates to the current stable version of GLib, in a format * that can be used by the C pre-processor. * * During an unstable development cycle, this evaluates to the next stable * (unreleased) version which will be the result of the development cycle. * * Since: 2.32 */ #if (GLIB_MINOR_VERSION % 2) #define GLIB_VERSION_CUR_STABLE (G_ENCODE_VERSION (GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION + 1)) #else #define GLIB_VERSION_CUR_STABLE (G_ENCODE_VERSION (GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION)) #endif /** * GLIB_VERSION_PREV_STABLE: * * A macro that evaluates to the previous stable version of GLib, in a format * that can be used by the C pre-processor. * * During an unstable development cycle, this evaluates to the most recent * released stable release, which preceded this development cycle. * * Since: 2.32 */ #if (GLIB_MINOR_VERSION % 2) #define GLIB_VERSION_PREV_STABLE (G_ENCODE_VERSION (GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION - 1)) #else #define GLIB_VERSION_PREV_STABLE (G_ENCODE_VERSION (GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION - 2)) #endif /** * GLIB_VERSION_MIN_REQUIRED: * * A macro that should be defined by the user prior to including * the glib.h header. * The definition should be one of the predefined GLib version * macros: %GLIB_VERSION_2_26, %GLIB_VERSION_2_28,... * * This macro defines the earliest version of GLib that the package is * required to be able to compile against. * * If the compiler is configured to warn about the use of deprecated * functions, then using functions that were deprecated in version * %GLIB_VERSION_MIN_REQUIRED or earlier will cause warnings (but * using functions deprecated in later releases will not). * * Since: 2.32 */ /* If the package sets GLIB_VERSION_MIN_REQUIRED to some future * GLIB_VERSION_X_Y value that we don't know about, it will compare as * 0 in preprocessor tests. */ #ifndef GLIB_VERSION_MIN_REQUIRED # define GLIB_VERSION_MIN_REQUIRED (GLIB_VERSION_CUR_STABLE) #elif GLIB_VERSION_MIN_REQUIRED == 0 # undef GLIB_VERSION_MIN_REQUIRED # define GLIB_VERSION_MIN_REQUIRED (GLIB_VERSION_CUR_STABLE + 2) #endif /** * GLIB_VERSION_MAX_ALLOWED: * * A macro that should be defined by the user prior to including * the glib.h header. * The definition should be one of the predefined GLib version * macros: %GLIB_VERSION_2_26, %GLIB_VERSION_2_28,... * * This macro defines the latest version of the GLib API that the * package is allowed to make use of. * * If the compiler is configured to warn about the use of deprecated * functions, then using functions added after version * %GLIB_VERSION_MAX_ALLOWED will cause warnings. * * Unless you are using GLIB_CHECK_VERSION() or the like to compile * different code depending on the GLib version, then this should be * set to the same value as %GLIB_VERSION_MIN_REQUIRED. * * Since: 2.32 */ #if !defined (GLIB_VERSION_MAX_ALLOWED) || (GLIB_VERSION_MAX_ALLOWED == 0) # undef GLIB_VERSION_MAX_ALLOWED # define GLIB_VERSION_MAX_ALLOWED (GLIB_VERSION_CUR_STABLE) #endif /* sanity checks */ #if GLIB_VERSION_MIN_REQUIRED > GLIB_VERSION_CUR_STABLE #error "GLIB_VERSION_MIN_REQUIRED must be <= GLIB_VERSION_CUR_STABLE" #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_MIN_REQUIRED #error "GLIB_VERSION_MAX_ALLOWED must be >= GLIB_VERSION_MIN_REQUIRED" #endif #if GLIB_VERSION_MIN_REQUIRED < GLIB_VERSION_2_26 #error "GLIB_VERSION_MIN_REQUIRED must be >= GLIB_VERSION_2_26" #endif /* These macros are used to mark deprecated functions in GLib headers, * and thus have to be exposed in installed headers. But please * do *not* use them in other projects. Instead, use G_DEPRECATED * or define your own wrappers around it. */ #define GLIB_AVAILABLE_IN_ALL _GLIB_EXTERN /* XXX: Every new stable minor release should add a set of macros here */ #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_26 # define GLIB_DEPRECATED_IN_2_26 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_26_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_26 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_26_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_26 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_26_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_26 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_26_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_26 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_26_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_26 # define GLIB_DEPRECATED_MACRO_IN_2_26_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_26 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_26_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_26 # define GLIB_DEPRECATED_TYPE_IN_2_26_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_26 # define GLIB_AVAILABLE_IN_2_26 GLIB_UNAVAILABLE(2, 26) # define GLIB_AVAILABLE_MACRO_IN_2_26 GLIB_UNAVAILABLE_MACRO(2, 26) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_26 GLIB_UNAVAILABLE_ENUMERATOR(2, 26) # define GLIB_AVAILABLE_TYPE_IN_2_26 GLIB_UNAVAILABLE_TYPE(2, 26) #else # define GLIB_AVAILABLE_IN_2_26 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_26 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_26 # define GLIB_AVAILABLE_TYPE_IN_2_26 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_28 # define GLIB_DEPRECATED_IN_2_28 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_28_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_28 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_28_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_28 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_28_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_28 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_28_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_28 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_28_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_28 # define GLIB_DEPRECATED_MACRO_IN_2_28_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_28 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_28_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_28 # define GLIB_DEPRECATED_TYPE_IN_2_28_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_28 # define GLIB_AVAILABLE_IN_2_28 GLIB_UNAVAILABLE(2, 28) # define GLIB_AVAILABLE_MACRO_IN_2_28 GLIB_UNAVAILABLE_MACRO(2, 28) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_28 GLIB_UNAVAILABLE_ENUMERATOR(2, 28) # define GLIB_AVAILABLE_TYPE_IN_2_28 GLIB_UNAVAILABLE_TYPE(2, 28) #else # define GLIB_AVAILABLE_IN_2_28 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_28 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_28 # define GLIB_AVAILABLE_TYPE_IN_2_28 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_30 # define GLIB_DEPRECATED_IN_2_30 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_30_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_30 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_30_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_30 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_30_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_30 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_30_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_30 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_30_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_30 # define GLIB_DEPRECATED_MACRO_IN_2_30_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_30 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_30_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_30 # define GLIB_DEPRECATED_TYPE_IN_2_30_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_30 # define GLIB_AVAILABLE_IN_2_30 GLIB_UNAVAILABLE(2, 30) # define GLIB_AVAILABLE_MACRO_IN_2_30 GLIB_UNAVAILABLE_MACRO(2, 30) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_30 GLIB_UNAVAILABLE_ENUMERATOR(2, 30) # define GLIB_AVAILABLE_TYPE_IN_2_30 GLIB_UNAVAILABLE_TYPE(2, 30) #else # define GLIB_AVAILABLE_IN_2_30 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_30 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_30 # define GLIB_AVAILABLE_TYPE_IN_2_30 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_32 # define GLIB_DEPRECATED_IN_2_32 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_32_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_32 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_32_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_32 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_32_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_32 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_32_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_32 # define GLIB_DEPRECATED_MACRO_IN_2_32_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_32 # define GLIB_DEPRECATED_TYPE_IN_2_32_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_32_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_32 # define GLIB_DEPRECATED_TYPE_IN_2_32_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_32 # define GLIB_AVAILABLE_IN_2_32 GLIB_UNAVAILABLE(2, 32) # define GLIB_AVAILABLE_MACRO_IN_2_32 GLIB_UNAVAILABLE_MACRO(2, 32) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_32 GLIB_UNAVAILABLE_ENUMERATOR(2, 32) # define GLIB_AVAILABLE_TYPE_IN_2_32 GLIB_UNAVAILABLE_TYPE(2, 32) #else # define GLIB_AVAILABLE_IN_2_32 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_32 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_32 # define GLIB_AVAILABLE_TYPE_IN_2_32 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_34 # define GLIB_DEPRECATED_IN_2_34 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_34_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_34 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_34_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_34 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_34_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_34 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_34_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_34 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_34_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_34 # define GLIB_DEPRECATED_MACRO_IN_2_34_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_34 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_34_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_34 # define GLIB_DEPRECATED_TYPE_IN_2_34_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_34 # define GLIB_AVAILABLE_IN_2_34 GLIB_UNAVAILABLE(2, 34) # define GLIB_AVAILABLE_MACRO_IN_2_34 GLIB_UNAVAILABLE_MACRO(2, 34) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_34 GLIB_UNAVAILABLE_ENUMERATOR(2, 34) # define GLIB_AVAILABLE_TYPE_IN_2_34 GLIB_UNAVAILABLE_TYPE(2, 34) #else # define GLIB_AVAILABLE_IN_2_34 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_34 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_34 # define GLIB_AVAILABLE_TYPE_IN_2_34 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_36 # define GLIB_DEPRECATED_IN_2_36 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_36_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_36 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_36_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_36 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_36_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_36 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_36_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_36 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_36_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_36 # define GLIB_DEPRECATED_MACRO_IN_2_36_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_36 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_36_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_36 # define GLIB_DEPRECATED_TYPE_IN_2_36_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_36 # define GLIB_AVAILABLE_IN_2_36 GLIB_UNAVAILABLE(2, 36) # define GLIB_AVAILABLE_MACRO_IN_2_36 GLIB_UNAVAILABLE_MACRO(2, 36) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_36 GLIB_UNAVAILABLE_ENUMERATOR(2, 36) # define GLIB_AVAILABLE_TYPE_IN_2_36 GLIB_UNAVAILABLE_TYPE(2, 36) #else # define GLIB_AVAILABLE_IN_2_36 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_36 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_36 # define GLIB_AVAILABLE_TYPE_IN_2_36 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_38 # define GLIB_DEPRECATED_IN_2_38 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_38_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_38 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_38_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_38 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_38_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_38 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_38_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_38 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_38_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_38 # define GLIB_DEPRECATED_MACRO_IN_2_38_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_38 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_38_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_38 # define GLIB_DEPRECATED_TYPE_IN_2_38_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_38 # define GLIB_AVAILABLE_IN_2_38 GLIB_UNAVAILABLE(2, 38) # define GLIB_AVAILABLE_MACRO_IN_2_38 GLIB_UNAVAILABLE_MACRO(2, 38) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_38 GLIB_UNAVAILABLE_ENUMERATOR(2, 38) # define GLIB_AVAILABLE_TYPE_IN_2_38 GLIB_UNAVAILABLE_TYPE(2, 38) #else # define GLIB_AVAILABLE_IN_2_38 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_38 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_38 # define GLIB_AVAILABLE_TYPE_IN_2_38 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_40 # define GLIB_DEPRECATED_IN_2_40 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_40_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_40 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_40_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_40 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_40_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_40 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_40_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_40 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_40_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_40 # define GLIB_DEPRECATED_MACRO_IN_2_40_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_40 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_40_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_40 # define GLIB_DEPRECATED_TYPE_IN_2_40_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_40 # define GLIB_AVAILABLE_IN_2_40 GLIB_UNAVAILABLE(2, 40) # define GLIB_AVAILABLE_MACRO_IN_2_40 GLIB_UNAVAILABLE_MACRO(2, 40) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_40 GLIB_UNAVAILABLE_ENUMERATOR(2, 40) # define GLIB_AVAILABLE_TYPE_IN_2_40 GLIB_UNAVAILABLE_TYPE(2, 40) #else # define GLIB_AVAILABLE_IN_2_40 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_40 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_40 # define GLIB_AVAILABLE_TYPE_IN_2_40 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_42 # define GLIB_DEPRECATED_IN_2_42 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_42_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_42 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_42_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) #else # define GLIB_DEPRECATED_IN_2_42 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_42_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_42 # define GLIB_DEPRECATED_MACRO_IN_2_42_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_42 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_42_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_42 # define GLIB_DEPRECATED_TYPE_IN_2_42_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_42 # define GLIB_AVAILABLE_IN_2_42 GLIB_UNAVAILABLE(2, 42) # define GLIB_AVAILABLE_MACRO_IN_2_42 GLIB_UNAVAILABLE_MACRO(2, 42) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_42 GLIB_UNAVAILABLE_ENUMERATOR(2, 42) # define GLIB_AVAILABLE_TYPE_IN_2_42 GLIB_UNAVAILABLE_TYPE(2, 42) #else # define GLIB_AVAILABLE_IN_2_42 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_42 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_42 # define GLIB_AVAILABLE_TYPE_IN_2_42 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_44 # define GLIB_DEPRECATED_IN_2_44 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_44_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_44 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_44_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_44 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_44_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_44 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_44_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_44 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_44_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_44 # define GLIB_DEPRECATED_MACRO_IN_2_44_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_44 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_44_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_44 # define GLIB_DEPRECATED_TYPE_IN_2_44_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_44 # define GLIB_AVAILABLE_IN_2_44 GLIB_UNAVAILABLE(2, 44) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_44 GLIB_UNAVAILABLE_STATIC_INLINE(2, 44) # define GLIB_AVAILABLE_MACRO_IN_2_44 GLIB_UNAVAILABLE_MACRO(2, 44) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_44 GLIB_UNAVAILABLE_ENUMERATOR(2, 44) # define GLIB_AVAILABLE_TYPE_IN_2_44 GLIB_UNAVAILABLE_TYPE(2, 44) #else # define GLIB_AVAILABLE_IN_2_44 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_44 # define GLIB_AVAILABLE_MACRO_IN_2_44 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_44 # define GLIB_AVAILABLE_TYPE_IN_2_44 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_46 # define GLIB_DEPRECATED_IN_2_46 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_46_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_46 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_46_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) #else # define GLIB_DEPRECATED_IN_2_46 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_46_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_46 # define GLIB_DEPRECATED_MACRO_IN_2_46_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_46 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_46_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_46 # define GLIB_DEPRECATED_TYPE_IN_2_46_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_46 # define GLIB_AVAILABLE_IN_2_46 GLIB_UNAVAILABLE(2, 46) # define GLIB_AVAILABLE_MACRO_IN_2_46 GLIB_UNAVAILABLE_MACRO(2, 46) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_46 GLIB_UNAVAILABLE_ENUMERATOR(2, 46) # define GLIB_AVAILABLE_TYPE_IN_2_46 GLIB_UNAVAILABLE_TYPE(2, 46) #else # define GLIB_AVAILABLE_IN_2_46 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_46 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_46 # define GLIB_AVAILABLE_TYPE_IN_2_46 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_48 # define GLIB_DEPRECATED_IN_2_48 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_48_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_48 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_48_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_48 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_48_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_48 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_48_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_48 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_48_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_48 # define GLIB_DEPRECATED_MACRO_IN_2_48_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_48 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_48_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_48 # define GLIB_DEPRECATED_TYPE_IN_2_48_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_48 # define GLIB_AVAILABLE_IN_2_48 GLIB_UNAVAILABLE(2, 48) # define GLIB_AVAILABLE_MACRO_IN_2_48 GLIB_UNAVAILABLE_MACRO(2, 48) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_48 GLIB_UNAVAILABLE_ENUMERATOR(2, 48) # define GLIB_AVAILABLE_TYPE_IN_2_48 GLIB_UNAVAILABLE_TYPE(2, 48) #else # define GLIB_AVAILABLE_IN_2_48 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_48 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_48 # define GLIB_AVAILABLE_TYPE_IN_2_48 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_50 # define GLIB_DEPRECATED_IN_2_50 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_50_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_50 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_50_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_50 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_50_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_50 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_50_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_50 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_50_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_50 # define GLIB_DEPRECATED_MACRO_IN_2_50_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_50 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_50_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_50 # define GLIB_DEPRECATED_TYPE_IN_2_50_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_50 # define GLIB_AVAILABLE_IN_2_50 GLIB_UNAVAILABLE(2, 50) # define GLIB_AVAILABLE_MACRO_IN_2_50 GLIB_UNAVAILABLE_MACRO(2, 50) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_50 GLIB_UNAVAILABLE_ENUMERATOR(2, 50) # define GLIB_AVAILABLE_TYPE_IN_2_50 GLIB_UNAVAILABLE_TYPE(2, 50) #else # define GLIB_AVAILABLE_IN_2_50 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_50 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_50 # define GLIB_AVAILABLE_TYPE_IN_2_50 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_52 # define GLIB_DEPRECATED_IN_2_52 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_52_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_52 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_52_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_52 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_52_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_52 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_52_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_52 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_52_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_52 # define GLIB_DEPRECATED_MACRO_IN_2_52_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_52 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_52_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_52 # define GLIB_DEPRECATED_TYPE_IN_2_52_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_52 # define GLIB_AVAILABLE_IN_2_52 GLIB_UNAVAILABLE(2, 52) # define GLIB_AVAILABLE_MACRO_IN_2_52 GLIB_UNAVAILABLE_MACRO(2, 52) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_52 GLIB_UNAVAILABLE_ENUMERATOR(2, 52) # define GLIB_AVAILABLE_TYPE_IN_2_52 GLIB_UNAVAILABLE_TYPE(2, 52) #else # define GLIB_AVAILABLE_IN_2_52 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_52 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_52 # define GLIB_AVAILABLE_TYPE_IN_2_52 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_54 # define GLIB_DEPRECATED_IN_2_54 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_54_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_54 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_54_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_54 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_54_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_54 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_54_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_54 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_54_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_54 # define GLIB_DEPRECATED_MACRO_IN_2_54_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_54 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_54_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_54 # define GLIB_DEPRECATED_TYPE_IN_2_54_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_54 # define GLIB_AVAILABLE_IN_2_54 GLIB_UNAVAILABLE(2, 54) # define GLIB_AVAILABLE_MACRO_IN_2_54 GLIB_UNAVAILABLE_MACRO(2, 54) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_54 GLIB_UNAVAILABLE_ENUMERATOR(2, 54) # define GLIB_AVAILABLE_TYPE_IN_2_54 GLIB_UNAVAILABLE_TYPE(2, 54) #else # define GLIB_AVAILABLE_IN_2_54 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_54 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_54 # define GLIB_AVAILABLE_TYPE_IN_2_54 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_56 # define GLIB_DEPRECATED_IN_2_56 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_56_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_56 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_56_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_56 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_56_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_56 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_56_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_56 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_56_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_56 # define GLIB_DEPRECATED_MACRO_IN_2_56_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_56 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_56_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_56 # define GLIB_DEPRECATED_TYPE_IN_2_56_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_56 # define GLIB_AVAILABLE_IN_2_56 GLIB_UNAVAILABLE(2, 56) # define GLIB_AVAILABLE_MACRO_IN_2_56 GLIB_UNAVAILABLE_MACRO(2, 56) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_56 GLIB_UNAVAILABLE_ENUMERATOR(2, 56) # define GLIB_AVAILABLE_TYPE_IN_2_56 GLIB_UNAVAILABLE_TYPE(2, 56) #else # define GLIB_AVAILABLE_IN_2_56 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_56 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_56 # define GLIB_AVAILABLE_TYPE_IN_2_56 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_58 # define GLIB_DEPRECATED_IN_2_58 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_58_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_58 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_58_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_58 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_58_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_58 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_58_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_58 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_58_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_58 # define GLIB_DEPRECATED_MACRO_IN_2_58_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_58 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_58_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_58 # define GLIB_DEPRECATED_TYPE_IN_2_58_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_58 # define GLIB_AVAILABLE_IN_2_58 GLIB_UNAVAILABLE(2, 58) # define GLIB_AVAILABLE_MACRO_IN_2_58 GLIB_UNAVAILABLE_MACRO(2, 58) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_58 GLIB_UNAVAILABLE_ENUMERATOR(2, 58) # define GLIB_AVAILABLE_TYPE_IN_2_58 GLIB_UNAVAILABLE_TYPE(2, 58) #else # define GLIB_AVAILABLE_IN_2_58 _GLIB_EXTERN # define GLIB_AVAILABLE_MACRO_IN_2_58 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_58 # define GLIB_AVAILABLE_TYPE_IN_2_58 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_60 # define GLIB_DEPRECATED_IN_2_60 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_60_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_60 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_60_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_60 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_60_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_60 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_60_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_60 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_60_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_60 # define GLIB_DEPRECATED_MACRO_IN_2_60_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_60 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_60_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_60 # define GLIB_DEPRECATED_TYPE_IN_2_60_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_60 # define GLIB_AVAILABLE_IN_2_60 GLIB_UNAVAILABLE(2, 60) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_60 GLIB_UNAVAILABLE_STATIC_INLINE(2, 60) # define GLIB_AVAILABLE_MACRO_IN_2_60 GLIB_UNAVAILABLE_MACRO(2, 60) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_60 GLIB_UNAVAILABLE_ENUMERATOR(2, 60) # define GLIB_AVAILABLE_TYPE_IN_2_60 GLIB_UNAVAILABLE_TYPE(2, 60) #else # define GLIB_AVAILABLE_IN_2_60 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_60 # define GLIB_AVAILABLE_MACRO_IN_2_60 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_60 # define GLIB_AVAILABLE_TYPE_IN_2_60 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_62 # define GLIB_DEPRECATED_IN_2_62 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_62_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_62 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_62_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_62 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_62_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_62 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_62_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_62 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_62_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_62 # define GLIB_DEPRECATED_MACRO_IN_2_62_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_62 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_62_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_62 # define GLIB_DEPRECATED_TYPE_IN_2_62_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_62 # define GLIB_AVAILABLE_IN_2_62 GLIB_UNAVAILABLE(2, 62) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 GLIB_UNAVAILABLE_STATIC_INLINE(2, 62) # define GLIB_AVAILABLE_MACRO_IN_2_62 GLIB_UNAVAILABLE_MACRO(2, 62) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_62 GLIB_UNAVAILABLE_ENUMERATOR(2, 62) # define GLIB_AVAILABLE_TYPE_IN_2_62 GLIB_UNAVAILABLE_TYPE(2, 62) #else # define GLIB_AVAILABLE_IN_2_62 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 # define GLIB_AVAILABLE_MACRO_IN_2_62 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_62 # define GLIB_AVAILABLE_TYPE_IN_2_62 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_64 # define GLIB_DEPRECATED_IN_2_64 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_64_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_64 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_64_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_64 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_64_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_64 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_64_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_64 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_64_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_64 # define GLIB_DEPRECATED_MACRO_IN_2_64_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_64 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_64_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_64 # define GLIB_DEPRECATED_TYPE_IN_2_64_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_64 # define GLIB_AVAILABLE_IN_2_64 GLIB_UNAVAILABLE(2, 64) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_64 GLIB_UNAVAILABLE_STATIC_INLINE(2, 64) # define GLIB_AVAILABLE_MACRO_IN_2_64 GLIB_UNAVAILABLE_MACRO(2, 64) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_64 GLIB_UNAVAILABLE_ENUMERATOR(2, 64) # define GLIB_AVAILABLE_TYPE_IN_2_64 GLIB_UNAVAILABLE_TYPE(2, 64) #else # define GLIB_AVAILABLE_IN_2_64 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_64 # define GLIB_AVAILABLE_MACRO_IN_2_64 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_64 # define GLIB_AVAILABLE_TYPE_IN_2_64 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_66 # define GLIB_DEPRECATED_IN_2_66 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_66_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_66 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_66_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_66 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_66_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_66 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_66_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_66 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_66_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_66 # define GLIB_DEPRECATED_MACRO_IN_2_66_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_66 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_66_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_66 # define GLIB_DEPRECATED_TYPE_IN_2_66_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_66 # define GLIB_AVAILABLE_IN_2_66 GLIB_UNAVAILABLE(2, 66) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_66 GLIB_UNAVAILABLE_STATIC_INLINE(2, 66) # define GLIB_AVAILABLE_MACRO_IN_2_66 GLIB_UNAVAILABLE_MACRO(2, 66) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_66 GLIB_UNAVAILABLE_ENUMERATOR(2, 66) # define GLIB_AVAILABLE_TYPE_IN_2_66 GLIB_UNAVAILABLE_TYPE(2, 66) #else # define GLIB_AVAILABLE_IN_2_66 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_66 # define GLIB_AVAILABLE_MACRO_IN_2_66 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_66 # define GLIB_AVAILABLE_TYPE_IN_2_66 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68 # define GLIB_DEPRECATED_IN_2_68 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_68_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_68 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_68_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_68 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_68_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_68 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_68_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_68 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_68_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_68 # define GLIB_DEPRECATED_MACRO_IN_2_68_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_68 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_68_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_68 # define GLIB_DEPRECATED_TYPE_IN_2_68_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_68 # define GLIB_AVAILABLE_IN_2_68 GLIB_UNAVAILABLE(2, 68) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_68 GLIB_UNAVAILABLE_STATIC_INLINE(2, 68) # define GLIB_AVAILABLE_MACRO_IN_2_68 GLIB_UNAVAILABLE_MACRO(2, 68) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_68 GLIB_UNAVAILABLE_ENUMERATOR(2, 68) # define GLIB_AVAILABLE_TYPE_IN_2_68 GLIB_UNAVAILABLE_TYPE(2, 68) #else # define GLIB_AVAILABLE_IN_2_68 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_68 # define GLIB_AVAILABLE_MACRO_IN_2_68 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_68 # define GLIB_AVAILABLE_TYPE_IN_2_68 #endif #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_70 # define GLIB_DEPRECATED_IN_2_70 GLIB_DEPRECATED # define GLIB_DEPRECATED_IN_2_70_FOR(f) GLIB_DEPRECATED_FOR(f) # define GLIB_DEPRECATED_MACRO_IN_2_70 GLIB_DEPRECATED_MACRO # define GLIB_DEPRECATED_MACRO_IN_2_70_FOR(f) GLIB_DEPRECATED_MACRO_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_70 GLIB_DEPRECATED_ENUMERATOR # define GLIB_DEPRECATED_ENUMERATOR_IN_2_70_FOR(f) GLIB_DEPRECATED_ENUMERATOR_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_70 GLIB_DEPRECATED_TYPE # define GLIB_DEPRECATED_TYPE_IN_2_70_FOR(f) GLIB_DEPRECATED_TYPE_FOR(f) #else # define GLIB_DEPRECATED_IN_2_70 _GLIB_EXTERN # define GLIB_DEPRECATED_IN_2_70_FOR(f) _GLIB_EXTERN # define GLIB_DEPRECATED_MACRO_IN_2_70 # define GLIB_DEPRECATED_MACRO_IN_2_70_FOR(f) # define GLIB_DEPRECATED_ENUMERATOR_IN_2_70 # define GLIB_DEPRECATED_ENUMERATOR_IN_2_70_FOR(f) # define GLIB_DEPRECATED_TYPE_IN_2_70 # define GLIB_DEPRECATED_TYPE_IN_2_70_FOR(f) #endif #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_70 # define GLIB_AVAILABLE_IN_2_70 GLIB_UNAVAILABLE(2, 70) # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_70 GLIB_UNAVAILABLE_STATIC_INLINE(2, 70) # define GLIB_AVAILABLE_MACRO_IN_2_70 GLIB_UNAVAILABLE_MACRO(2, 70) # define GLIB_AVAILABLE_ENUMERATOR_IN_2_70 GLIB_UNAVAILABLE_ENUMERATOR(2, 70) # define GLIB_AVAILABLE_TYPE_IN_2_70 GLIB_UNAVAILABLE_TYPE(2, 70) #else # define GLIB_AVAILABLE_IN_2_70 _GLIB_EXTERN # define GLIB_AVAILABLE_STATIC_INLINE_IN_2_70 # define GLIB_AVAILABLE_MACRO_IN_2_70 # define GLIB_AVAILABLE_ENUMERATOR_IN_2_70 # define GLIB_AVAILABLE_TYPE_IN_2_70 #endif #endif /* __G_VERSION_MACROS_H__ */ glib/gsequence.h 0000644 00000021153 15125173650 0007620 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 * Soeren Sandmann (sandmann@daimi.au.dk) * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SEQUENCE_H__ #define __G_SEQUENCE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GSequence GSequence; typedef struct _GSequenceNode GSequenceIter; typedef gint (* GSequenceIterCompareFunc) (GSequenceIter *a, GSequenceIter *b, gpointer data); /* GSequence */ GLIB_AVAILABLE_IN_ALL GSequence * g_sequence_new (GDestroyNotify data_destroy); GLIB_AVAILABLE_IN_ALL void g_sequence_free (GSequence *seq); GLIB_AVAILABLE_IN_ALL gint g_sequence_get_length (GSequence *seq); GLIB_AVAILABLE_IN_ALL void g_sequence_foreach (GSequence *seq, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_sequence_foreach_range (GSequenceIter *begin, GSequenceIter *end, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_sequence_sort (GSequence *seq, GCompareDataFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL void g_sequence_sort_iter (GSequence *seq, GSequenceIterCompareFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_2_48 gboolean g_sequence_is_empty (GSequence *seq); /* Getting iters */ GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_get_begin_iter (GSequence *seq); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_get_end_iter (GSequence *seq); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_get_iter_at_pos (GSequence *seq, gint pos); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_append (GSequence *seq, gpointer data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_prepend (GSequence *seq, gpointer data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_insert_before (GSequenceIter *iter, gpointer data); GLIB_AVAILABLE_IN_ALL void g_sequence_move (GSequenceIter *src, GSequenceIter *dest); GLIB_AVAILABLE_IN_ALL void g_sequence_swap (GSequenceIter *a, GSequenceIter *b); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_insert_sorted (GSequence *seq, gpointer data, GCompareDataFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_insert_sorted_iter (GSequence *seq, gpointer data, GSequenceIterCompareFunc iter_cmp, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL void g_sequence_sort_changed (GSequenceIter *iter, GCompareDataFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL void g_sequence_sort_changed_iter (GSequenceIter *iter, GSequenceIterCompareFunc iter_cmp, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL void g_sequence_remove (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL void g_sequence_remove_range (GSequenceIter *begin, GSequenceIter *end); GLIB_AVAILABLE_IN_ALL void g_sequence_move_range (GSequenceIter *dest, GSequenceIter *begin, GSequenceIter *end); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_search (GSequence *seq, gpointer data, GCompareDataFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_search_iter (GSequence *seq, gpointer data, GSequenceIterCompareFunc iter_cmp, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_lookup (GSequence *seq, gpointer data, GCompareDataFunc cmp_func, gpointer cmp_data); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_lookup_iter (GSequence *seq, gpointer data, GSequenceIterCompareFunc iter_cmp, gpointer cmp_data); /* Dereferencing */ GLIB_AVAILABLE_IN_ALL gpointer g_sequence_get (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL void g_sequence_set (GSequenceIter *iter, gpointer data); /* Operations on GSequenceIter * */ GLIB_AVAILABLE_IN_ALL gboolean g_sequence_iter_is_begin (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL gboolean g_sequence_iter_is_end (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_iter_next (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_iter_prev (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL gint g_sequence_iter_get_position (GSequenceIter *iter); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_iter_move (GSequenceIter *iter, gint delta); GLIB_AVAILABLE_IN_ALL GSequence * g_sequence_iter_get_sequence (GSequenceIter *iter); /* Search */ GLIB_AVAILABLE_IN_ALL gint g_sequence_iter_compare (GSequenceIter *a, GSequenceIter *b); GLIB_AVAILABLE_IN_ALL GSequenceIter *g_sequence_range_get_midpoint (GSequenceIter *begin, GSequenceIter *end); G_END_DECLS #endif /* __G_SEQUENCE_H__ */ glib/gscanner.h 0000644 00000021235 15125173650 0007442 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_SCANNER_H__ #define __G_SCANNER_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gdataset.h> #include <glib/ghash.h> G_BEGIN_DECLS typedef struct _GScanner GScanner; typedef struct _GScannerConfig GScannerConfig; typedef union _GTokenValue GTokenValue; typedef void (*GScannerMsgFunc) (GScanner *scanner, gchar *message, gboolean error); /* GScanner: Flexible lexical scanner for general purpose. */ /* Character sets */ #define G_CSET_A_2_Z "ABCDEFGHIJKLMNOPQRSTUVWXYZ" #define G_CSET_a_2_z "abcdefghijklmnopqrstuvwxyz" #define G_CSET_DIGITS "0123456789" #define G_CSET_LATINC "\300\301\302\303\304\305\306"\ "\307\310\311\312\313\314\315\316\317\320"\ "\321\322\323\324\325\326"\ "\330\331\332\333\334\335\336" #define G_CSET_LATINS "\337\340\341\342\343\344\345\346"\ "\347\350\351\352\353\354\355\356\357\360"\ "\361\362\363\364\365\366"\ "\370\371\372\373\374\375\376\377" /* Error types */ typedef enum { G_ERR_UNKNOWN, G_ERR_UNEXP_EOF, G_ERR_UNEXP_EOF_IN_STRING, G_ERR_UNEXP_EOF_IN_COMMENT, G_ERR_NON_DIGIT_IN_CONST, G_ERR_DIGIT_RADIX, G_ERR_FLOAT_RADIX, G_ERR_FLOAT_MALFORMED } GErrorType; /* Token types */ typedef enum { G_TOKEN_EOF = 0, G_TOKEN_LEFT_PAREN = '(', G_TOKEN_RIGHT_PAREN = ')', G_TOKEN_LEFT_CURLY = '{', G_TOKEN_RIGHT_CURLY = '}', G_TOKEN_LEFT_BRACE = '[', G_TOKEN_RIGHT_BRACE = ']', G_TOKEN_EQUAL_SIGN = '=', G_TOKEN_COMMA = ',', G_TOKEN_NONE = 256, G_TOKEN_ERROR, G_TOKEN_CHAR, G_TOKEN_BINARY, G_TOKEN_OCTAL, G_TOKEN_INT, G_TOKEN_HEX, G_TOKEN_FLOAT, G_TOKEN_STRING, G_TOKEN_SYMBOL, G_TOKEN_IDENTIFIER, G_TOKEN_IDENTIFIER_NULL, G_TOKEN_COMMENT_SINGLE, G_TOKEN_COMMENT_MULTI, /*< private >*/ G_TOKEN_LAST } GTokenType; union _GTokenValue { gpointer v_symbol; gchar *v_identifier; gulong v_binary; gulong v_octal; gulong v_int; guint64 v_int64; gdouble v_float; gulong v_hex; gchar *v_string; gchar *v_comment; guchar v_char; guint v_error; }; struct _GScannerConfig { /* Character sets */ gchar *cset_skip_characters; /* default: " \t\n" */ gchar *cset_identifier_first; gchar *cset_identifier_nth; gchar *cpair_comment_single; /* default: "#\n" */ /* Should symbol lookup work case sensitive? */ guint case_sensitive : 1; /* Boolean values to be adjusted "on the fly" * to configure scanning behaviour. */ guint skip_comment_multi : 1; /* C like comment */ guint skip_comment_single : 1; /* single line comment */ guint scan_comment_multi : 1; /* scan multi line comments? */ guint scan_identifier : 1; guint scan_identifier_1char : 1; guint scan_identifier_NULL : 1; guint scan_symbols : 1; guint scan_binary : 1; guint scan_octal : 1; guint scan_float : 1; guint scan_hex : 1; /* '0x0ff0' */ guint scan_hex_dollar : 1; /* '$0ff0' */ guint scan_string_sq : 1; /* string: 'anything' */ guint scan_string_dq : 1; /* string: "\\-escapes!\n" */ guint numbers_2_int : 1; /* bin, octal, hex => int */ guint int_2_float : 1; /* int => G_TOKEN_FLOAT? */ guint identifier_2_string : 1; guint char_2_token : 1; /* return G_TOKEN_CHAR? */ guint symbol_2_token : 1; guint scope_0_fallback : 1; /* try scope 0 on lookups? */ guint store_int64 : 1; /* use value.v_int64 rather than v_int */ /*< private >*/ guint padding_dummy; }; struct _GScanner { /* unused fields */ gpointer user_data; guint max_parse_errors; /* g_scanner_error() increments this field */ guint parse_errors; /* name of input stream, featured by the default message handler */ const gchar *input_name; /* quarked data */ GData *qdata; /* link into the scanner configuration */ GScannerConfig *config; /* fields filled in after g_scanner_get_next_token() */ GTokenType token; GTokenValue value; guint line; guint position; /* fields filled in after g_scanner_peek_next_token() */ GTokenType next_token; GTokenValue next_value; guint next_line; guint next_position; /*< private >*/ /* to be considered private */ GHashTable *symbol_table; gint input_fd; const gchar *text; const gchar *text_end; gchar *buffer; guint scope_id; /*< public >*/ /* handler function for _warn and _error */ GScannerMsgFunc msg_handler; }; GLIB_AVAILABLE_IN_ALL GScanner* g_scanner_new (const GScannerConfig *config_templ); GLIB_AVAILABLE_IN_ALL void g_scanner_destroy (GScanner *scanner); GLIB_AVAILABLE_IN_ALL void g_scanner_input_file (GScanner *scanner, gint input_fd); GLIB_AVAILABLE_IN_ALL void g_scanner_sync_file_offset (GScanner *scanner); GLIB_AVAILABLE_IN_ALL void g_scanner_input_text (GScanner *scanner, const gchar *text, guint text_len); GLIB_AVAILABLE_IN_ALL GTokenType g_scanner_get_next_token (GScanner *scanner); GLIB_AVAILABLE_IN_ALL GTokenType g_scanner_peek_next_token (GScanner *scanner); GLIB_AVAILABLE_IN_ALL GTokenType g_scanner_cur_token (GScanner *scanner); GLIB_AVAILABLE_IN_ALL GTokenValue g_scanner_cur_value (GScanner *scanner); GLIB_AVAILABLE_IN_ALL guint g_scanner_cur_line (GScanner *scanner); GLIB_AVAILABLE_IN_ALL guint g_scanner_cur_position (GScanner *scanner); GLIB_AVAILABLE_IN_ALL gboolean g_scanner_eof (GScanner *scanner); GLIB_AVAILABLE_IN_ALL guint g_scanner_set_scope (GScanner *scanner, guint scope_id); GLIB_AVAILABLE_IN_ALL void g_scanner_scope_add_symbol (GScanner *scanner, guint scope_id, const gchar *symbol, gpointer value); GLIB_AVAILABLE_IN_ALL void g_scanner_scope_remove_symbol (GScanner *scanner, guint scope_id, const gchar *symbol); GLIB_AVAILABLE_IN_ALL gpointer g_scanner_scope_lookup_symbol (GScanner *scanner, guint scope_id, const gchar *symbol); GLIB_AVAILABLE_IN_ALL void g_scanner_scope_foreach_symbol (GScanner *scanner, guint scope_id, GHFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL gpointer g_scanner_lookup_symbol (GScanner *scanner, const gchar *symbol); GLIB_AVAILABLE_IN_ALL void g_scanner_unexp_token (GScanner *scanner, GTokenType expected_token, const gchar *identifier_spec, const gchar *symbol_spec, const gchar *symbol_name, const gchar *message, gint is_error); GLIB_AVAILABLE_IN_ALL void g_scanner_error (GScanner *scanner, const gchar *format, ...) G_GNUC_PRINTF (2,3); GLIB_AVAILABLE_IN_ALL void g_scanner_warn (GScanner *scanner, const gchar *format, ...) G_GNUC_PRINTF (2,3); /* keep downward source compatibility */ #define g_scanner_add_symbol( scanner, symbol, value ) G_STMT_START { \ g_scanner_scope_add_symbol ((scanner), 0, (symbol), (value)); \ } G_STMT_END GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_scanner_scope_add_symbol) #define g_scanner_remove_symbol( scanner, symbol ) G_STMT_START { \ g_scanner_scope_remove_symbol ((scanner), 0, (symbol)); \ } G_STMT_END GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_scanner_scope_remove_symbol) #define g_scanner_foreach_symbol( scanner, func, data ) G_STMT_START { \ g_scanner_scope_foreach_symbol ((scanner), 0, (func), (data)); \ } G_STMT_END GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_scanner_scope_foreach_symbol) /* The following two functions are deprecated and will be removed in * the next major release. They do no good. */ #define g_scanner_freeze_symbol_table(scanner) ((void)0) GLIB_DEPRECATED_MACRO_IN_2_26 #define g_scanner_thaw_symbol_table(scanner) ((void)0) GLIB_DEPRECATED_MACRO_IN_2_26 G_END_DECLS #endif /* __G_SCANNER_H__ */ glib/gmappedfile.h 0000644 00000003702 15125173650 0010116 0 ustar 00 /* GLIB - Library of useful routines for C programming * gmappedfile.h: Simplified wrapper around the mmap function * * Copyright 2005 Matthias Clasen * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_MAPPED_FILE_H__ #define __G_MAPPED_FILE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gbytes.h> #include <glib/gerror.h> G_BEGIN_DECLS typedef struct _GMappedFile GMappedFile; GLIB_AVAILABLE_IN_ALL GMappedFile *g_mapped_file_new (const gchar *filename, gboolean writable, GError **error); GLIB_AVAILABLE_IN_ALL GMappedFile *g_mapped_file_new_from_fd (gint fd, gboolean writable, GError **error); GLIB_AVAILABLE_IN_ALL gsize g_mapped_file_get_length (GMappedFile *file); GLIB_AVAILABLE_IN_ALL gchar *g_mapped_file_get_contents (GMappedFile *file); GLIB_AVAILABLE_IN_2_34 GBytes * g_mapped_file_get_bytes (GMappedFile *file); GLIB_AVAILABLE_IN_ALL GMappedFile *g_mapped_file_ref (GMappedFile *file); GLIB_AVAILABLE_IN_ALL void g_mapped_file_unref (GMappedFile *file); GLIB_DEPRECATED_FOR(g_mapped_file_unref) void g_mapped_file_free (GMappedFile *file); G_END_DECLS #endif /* __G_MAPPED_FILE_H__ */ glib/genviron.h 0000644 00000004474 15125173650 0007477 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_ENVIRON_H__ #define __G_ENVIRON_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL const gchar * g_getenv (const gchar *variable); GLIB_AVAILABLE_IN_ALL gboolean g_setenv (const gchar *variable, const gchar *value, gboolean overwrite); GLIB_AVAILABLE_IN_ALL void g_unsetenv (const gchar *variable); GLIB_AVAILABLE_IN_ALL gchar ** g_listenv (void); GLIB_AVAILABLE_IN_ALL gchar ** g_get_environ (void); GLIB_AVAILABLE_IN_ALL const gchar * g_environ_getenv (gchar **envp, const gchar *variable); GLIB_AVAILABLE_IN_ALL gchar ** g_environ_setenv (gchar **envp, const gchar *variable, const gchar *value, gboolean overwrite) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gchar ** g_environ_unsetenv (gchar **envp, const gchar *variable) G_GNUC_WARN_UNUSED_RESULT; G_END_DECLS #endif /* __G_ENVIRON_H__ */ glib/gmacros.h 0000644 00000132171 15125173650 0007277 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ /* This file must not include any other glib header file and must thus * not refer to variables from glibconfig.h */ #ifndef __G_MACROS_H__ #define __G_MACROS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif /* We include stddef.h to get the system's definition of NULL */ #include <stddef.h> #ifdef __GNUC__ #define G_GNUC_CHECK_VERSION(major, minor) \ ((__GNUC__ > (major)) || \ ((__GNUC__ == (major)) && \ (__GNUC_MINOR__ >= (minor)))) #else #define G_GNUC_CHECK_VERSION(major, minor) 0 #endif /* Here we provide G_GNUC_EXTENSION as an alias for __extension__, * where this is valid. This allows for warningless compilation of * "long long" types even in the presence of '-ansi -pedantic'. */ #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 8) #define G_GNUC_EXTENSION __extension__ #else #define G_GNUC_EXTENSION #endif /* Every compiler that we target supports inlining, but some of them may * complain about it if we don't say "__inline". If we have C99, or if * we are using C++, then we can use "inline" directly. Unfortunately * Visual Studio does not support __STDC_VERSION__, so we need to check * whether we are on Visual Studio 2013 or earlier to see that we need to * say "__inline" in C mode. * Otherwise, we say "__inline" to avoid the warning. */ #define G_CAN_INLINE #ifndef __cplusplus # ifdef _MSC_VER # if (_MSC_VER < 1900) # define G_INLINE_DEFINE_NEEDED # endif # elif !defined(__STDC_VERSION__) || (__STDC_VERSION__ < 199900) # define G_INLINE_DEFINE_NEEDED # endif #endif #ifdef G_INLINE_DEFINE_NEEDED # undef inline # define inline __inline #endif #undef G_INLINE_DEFINE_NEEDED /** * G_INLINE_FUNC: * * This macro used to be used to conditionally define inline functions * in a compatible way before this feature was supported in all * compilers. These days, GLib requires inlining support from the * compiler, so your GLib-using programs can safely assume that the * "inline" keyword works properly. * * Never use this macro anymore. Just say "static inline". * * Deprecated: 2.48: Use "static inline" instead */ /* For historical reasons we need to continue to support those who * define G_IMPLEMENT_INLINES to mean "don't implement this here". */ #ifdef G_IMPLEMENT_INLINES # define G_INLINE_FUNC extern GLIB_DEPRECATED_MACRO_IN_2_48_FOR(static inline) # undef G_CAN_INLINE #else # define G_INLINE_FUNC static inline GLIB_DEPRECATED_MACRO_IN_2_48_FOR(static inline) #endif /* G_IMPLEMENT_INLINES */ /* Provide macros to feature the GCC function attribute. */ /** * G_GNUC_PURE: * * Expands to the GNU C `pure` function attribute if the compiler is gcc. * Declaring a function as `pure` enables better optimization of calls to * the function. A `pure` function has no effects except its return value * and the return value depends only on the parameters and/or global * variables. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * gboolean g_type_check_value (const GValue *value) G_GNUC_PURE; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-pure-function-attribute) for more details. */ /** * G_GNUC_MALLOC: * * Expands to the * [GNU C `malloc` function attribute](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-functions-that-behave-like-malloc) * if the compiler is gcc. * Declaring a function as `malloc` enables better optimization of the function, * but must only be done if the allocation behaviour of the function is fully * understood, otherwise miscompilation can result. * * A function can have the `malloc` attribute if it returns a pointer which is * guaranteed to not alias with any other pointer valid when the function * returns, and moreover no pointers to valid objects occur in any storage * addressed by the returned pointer. * * In practice, this means that `G_GNUC_MALLOC` can be used with any function * which returns unallocated or zeroed-out memory, but not with functions which * return initialised structures containing other pointers, or with functions * that reallocate memory. This definition changed in GLib 2.58 to match the * stricter definition introduced around GCC 5. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); * ]| * * See the * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-functions-that-behave-like-malloc) * for more details. * * Since: 2.6 */ /** * G_GNUC_NO_INLINE: * * Expands to the GNU C `noinline` function attribute if the compiler is gcc. * If the compiler is not gcc, this macro expands to nothing. * * Declaring a function as `noinline` prevents the function from being * considered for inlining. * * The attribute may be placed before the declaration or definition, * right before the `static` keyword. * * |[<!-- language="C" --> * G_GNUC_NO_INLINE * static int * do_not_inline_this (void) * { * ... * } * ]| * * See the * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-noinline-function-attribute) * for more details. * * Since: 2.58 */ #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) #define G_GNUC_PURE __attribute__((__pure__)) #define G_GNUC_MALLOC __attribute__((__malloc__)) #define G_GNUC_NO_INLINE __attribute__((noinline)) #else #define G_GNUC_PURE #define G_GNUC_MALLOC #define G_GNUC_NO_INLINE #endif /** * G_GNUC_NULL_TERMINATED: * * Expands to the GNU C `sentinel` function attribute if the compiler is gcc. * This function attribute only applies to variadic functions and instructs * the compiler to check that the argument list is terminated with an * explicit %NULL. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * gchar *g_strconcat (const gchar *string1, * ...) G_GNUC_NULL_TERMINATED; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-sentinel-function-attribute) for more details. * * Since: 2.8 */ #if __GNUC__ >= 4 #define G_GNUC_NULL_TERMINATED __attribute__((__sentinel__)) #else #define G_GNUC_NULL_TERMINATED #endif /* * We can only use __typeof__ on GCC >= 4.8, and not when compiling C++. Since * __typeof__ is used in a few places in GLib, provide a pre-processor symbol * to factor the check out from callers. * * This symbol is private. */ #undef glib_typeof #if !defined(__cplusplus) && \ ((defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8))) || \ defined(__clang__)) #define glib_typeof(t) __typeof__ (t) #elif defined(__cplusplus) && __cplusplus >= 201103L /* C++11 decltype() is close enough for our usage */ /* This needs `#include <type_traits>`, but we have guarded this feature with a * `GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68` check, and such a check * cannot be enforced in this header due to include ordering requirements. * Within GLib itself, which use `glib_typeof` need to add the include * themselves. See other examples in GLib for how to do this. */ #define glib_typeof(t) typename std::remove_reference<decltype (t)>::type #define glib_typeof_2_68 #endif /* * Clang feature detection: http://clang.llvm.org/docs/LanguageExtensions.html * These are not available on GCC, but since the pre-processor doesn't do * operator short-circuiting, we can't use it in a statement or we'll get: * * error: missing binary operator before token "(" * * So we define it to 0 to satisfy the pre-processor. */ #ifdef __has_attribute #define g_macro__has_attribute __has_attribute #else #define g_macro__has_attribute(x) 0 #endif #ifdef __has_feature #define g_macro__has_feature __has_feature #else #define g_macro__has_feature(x) 0 #endif #ifdef __has_builtin #define g_macro__has_builtin __has_builtin #else #define g_macro__has_builtin(x) 0 #endif /** * G_GNUC_ALLOC_SIZE: * @x: the index of the argument specifying the allocation size * * Expands to the GNU C `alloc_size` function attribute if the compiler * is a new enough gcc. This attribute tells the compiler that the * function returns a pointer to memory of a size that is specified * by the @xth function parameter. * * Place the attribute after the function declaration, just before the * semicolon. * * |[<!-- language="C" --> * gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. * * Since: 2.18 */ /** * G_GNUC_ALLOC_SIZE2: * @x: the index of the argument specifying one factor of the allocation size * @y: the index of the argument specifying the second factor of the allocation size * * Expands to the GNU C `alloc_size` function attribute if the compiler is a * new enough gcc. This attribute tells the compiler that the function returns * a pointer to memory of a size that is specified by the product of two * function parameters. * * Place the attribute after the function declaration, just before the * semicolon. * * |[<!-- language="C" --> * gpointer g_malloc_n (gsize n_blocks, * gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1, 2); * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. * * Since: 2.18 */ #if (!defined(__clang__) && ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))) || \ (defined(__clang__) && g_macro__has_attribute(__alloc_size__)) #define G_GNUC_ALLOC_SIZE(x) __attribute__((__alloc_size__(x))) #define G_GNUC_ALLOC_SIZE2(x,y) __attribute__((__alloc_size__(x,y))) #else #define G_GNUC_ALLOC_SIZE(x) #define G_GNUC_ALLOC_SIZE2(x,y) #endif /** * G_GNUC_PRINTF: * @format_idx: the index of the argument corresponding to the * format string (the arguments are numbered from 1) * @arg_idx: the index of the first of the format arguments, or 0 if * there are no format arguments * * Expands to the GNU C `format` function attribute if the compiler is gcc. * This is used for declaring functions which take a variable number of * arguments, with the same syntax as `printf()`. It allows the compiler * to type-check the arguments passed to the function. * * Place the attribute after the function declaration, just before the * semicolon. * * See the * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) * for more details. * * |[<!-- language="C" --> * gint g_snprintf (gchar *string, * gulong n, * gchar const *format, * ...) G_GNUC_PRINTF (3, 4); * ]| */ /** * G_GNUC_SCANF: * @format_idx: the index of the argument corresponding to * the format string (the arguments are numbered from 1) * @arg_idx: the index of the first of the format arguments, or 0 if * there are no format arguments * * Expands to the GNU C `format` function attribute if the compiler is gcc. * This is used for declaring functions which take a variable number of * arguments, with the same syntax as `scanf()`. It allows the compiler * to type-check the arguments passed to the function. * * |[<!-- language="C" --> * int my_scanf (MyStream *stream, * const char *format, * ...) G_GNUC_SCANF (2, 3); * int my_vscanf (MyStream *stream, * const char *format, * va_list ap) G_GNUC_SCANF (2, 0); * ]| * * See the * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) * for details. */ /** * G_GNUC_STRFTIME: * @format_idx: the index of the argument corresponding to * the format string (the arguments are numbered from 1) * * Expands to the GNU C `strftime` format function attribute if the compiler * is gcc. This is used for declaring functions which take a format argument * which is passed to `strftime()` or an API implementing its formats. It allows * the compiler check the format passed to the function. * * |[<!-- language="C" --> * gsize my_strftime (MyBuffer *buffer, * const char *format, * const struct tm *tm) G_GNUC_STRFTIME (2); * ]| * * See the * [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) * for details. * * Since: 2.60 */ /** * G_GNUC_FORMAT: * @arg_idx: the index of the argument * * Expands to the GNU C `format_arg` function attribute if the compiler * is gcc. This function attribute specifies that a function takes a * format string for a `printf()`, `scanf()`, `strftime()` or `strfmon()` style * function and modifies it, so that the result can be passed to a `printf()`, * `scanf()`, `strftime()` or `strfmon()` style function (with the remaining * arguments to the format function the same as they would have been * for the unmodified string). * * Place the attribute after the function declaration, just before the * semicolon. * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-nonliteral-1) for more details. * * |[<!-- language="C" --> * gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2); * ]| */ /** * G_GNUC_NORETURN: * * Expands to the GNU C `noreturn` function attribute if the compiler is gcc. * It is used for declaring functions which never return. It enables * optimization of the function, and avoids possible compiler warnings. * * Since 2.68, it is recommended that code uses %G_NORETURN instead of * %G_GNUC_NORETURN, as that works on more platforms and compilers (in * particular, MSVC and C++11) than %G_GNUC_NORETURN, which works with GCC and * Clang only. %G_GNUC_NORETURN continues to work, so has not been deprecated * yet. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * void g_abort (void) G_GNUC_NORETURN; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-noreturn-function-attribute) for more details. */ /** * G_GNUC_CONST: * * Expands to the GNU C `const` function attribute if the compiler is gcc. * Declaring a function as `const` enables better optimization of calls to * the function. A `const` function doesn't examine any values except its * parameters, and has no effects except its return value. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * gchar g_ascii_tolower (gchar c) G_GNUC_CONST; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-const-function-attribute) for more details. * * A function that has pointer arguments and examines the data pointed to * must not be declared `const`. Likewise, a function that calls a non-`const` * function usually must not be `const`. It doesn't make sense for a `const` * function to return `void`. */ /** * G_GNUC_UNUSED: * * Expands to the GNU C `unused` function attribute if the compiler is gcc. * It is used for declaring functions and arguments which may never be used. * It avoids possible compiler warnings. * * For functions, place the attribute after the declaration, just before the * semicolon. For arguments, place the attribute at the beginning of the * argument declaration. * * |[<!-- language="C" --> * void my_unused_function (G_GNUC_UNUSED gint unused_argument, * gint other_argument) G_GNUC_UNUSED; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-unused-function-attribute) for more details. */ /** * G_GNUC_NO_INSTRUMENT: * * Expands to the GNU C `no_instrument_function` function attribute if the * compiler is gcc. Functions with this attribute will not be instrumented * for profiling, when the compiler is called with the * `-finstrument-functions` option. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * int do_uninteresting_things (void) G_GNUC_NO_INSTRUMENT; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-no_005finstrument_005ffunction-function-attribute) for more details. */ #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 4) #if !defined (__clang__) && G_GNUC_CHECK_VERSION (4, 4) #define G_GNUC_PRINTF( format_idx, arg_idx ) \ __attribute__((__format__ (gnu_printf, format_idx, arg_idx))) #define G_GNUC_SCANF( format_idx, arg_idx ) \ __attribute__((__format__ (gnu_scanf, format_idx, arg_idx))) #define G_GNUC_STRFTIME( format_idx ) \ __attribute__((__format__ (gnu_strftime, format_idx, 0))) #else #define G_GNUC_PRINTF( format_idx, arg_idx ) \ __attribute__((__format__ (__printf__, format_idx, arg_idx))) #define G_GNUC_SCANF( format_idx, arg_idx ) \ __attribute__((__format__ (__scanf__, format_idx, arg_idx))) #define G_GNUC_STRFTIME( format_idx ) \ __attribute__((__format__ (__strftime__, format_idx, 0))) #endif #define G_GNUC_FORMAT( arg_idx ) \ __attribute__((__format_arg__ (arg_idx))) #define G_GNUC_NORETURN \ __attribute__((__noreturn__)) #define G_GNUC_CONST \ __attribute__((__const__)) #define G_GNUC_UNUSED \ __attribute__((__unused__)) #define G_GNUC_NO_INSTRUMENT \ __attribute__((__no_instrument_function__)) #else /* !__GNUC__ */ #define G_GNUC_PRINTF( format_idx, arg_idx ) #define G_GNUC_SCANF( format_idx, arg_idx ) #define G_GNUC_STRFTIME( format_idx ) #define G_GNUC_FORMAT( arg_idx ) /* NOTE: MSVC has __declspec(noreturn) but unlike GCC __attribute__, * __declspec can only be placed at the start of the function prototype * and not at the end, so we can't use it without breaking API. */ #define G_GNUC_NORETURN #define G_GNUC_CONST #define G_GNUC_UNUSED #define G_GNUC_NO_INSTRUMENT #endif /* !__GNUC__ */ /** * G_GNUC_FALLTHROUGH: * * Expands to the GNU C `fallthrough` statement attribute if the compiler supports it. * This allows declaring case statement to explicitly fall through in switch * statements. To enable this feature, use `-Wimplicit-fallthrough` during * compilation. * * Put the attribute right before the case statement you want to fall through * to. * * |[<!-- language="C" --> * switch (foo) * { * case 1: * g_message ("it's 1"); * G_GNUC_FALLTHROUGH; * case 2: * g_message ("it's either 1 or 2"); * break; * } * ]| * * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Statement-Attributes.html#index-fallthrough-statement-attribute) for more details. * * Since: 2.60 */ #if __GNUC__ > 6 #define G_GNUC_FALLTHROUGH __attribute__((fallthrough)) #elif g_macro__has_attribute (fallthrough) #define G_GNUC_FALLTHROUGH __attribute__((fallthrough)) #else #define G_GNUC_FALLTHROUGH #endif /* __GNUC__ */ /** * G_GNUC_DEPRECATED: * * Expands to the GNU C `deprecated` attribute if the compiler is gcc. * It can be used to mark `typedef`s, variables and functions as deprecated. * When called with the `-Wdeprecated-declarations` option, * gcc will generate warnings when deprecated interfaces are used. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * int my_mistake (void) G_GNUC_DEPRECATED; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-deprecated-function-attribute) for more details. * * Since: 2.2 */ #if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1) || defined (__clang__) #define G_GNUC_DEPRECATED __attribute__((__deprecated__)) #else #define G_GNUC_DEPRECATED #endif /* __GNUC__ */ /** * G_GNUC_DEPRECATED_FOR: * @f: the intended replacement for the deprecated symbol, * such as the name of a function * * Like %G_GNUC_DEPRECATED, but names the intended replacement for the * deprecated symbol if the version of gcc in use is new enough to support * custom deprecation messages. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * int my_mistake (void) G_GNUC_DEPRECATED_FOR(my_replacement); * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-deprecated-function-attribute) for more details. * * Note that if @f is a macro, it will be expanded in the warning message. * You can enclose it in quotes to prevent this. (The quotes will show up * in the warning, but it's better than showing the macro expansion.) * * Since: 2.26 */ #if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) || defined (__clang__) #define G_GNUC_DEPRECATED_FOR(f) \ __attribute__((deprecated("Use " #f " instead"))) #else #define G_GNUC_DEPRECATED_FOR(f) G_GNUC_DEPRECATED #endif /* __GNUC__ */ #ifdef __ICC #define G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ _Pragma ("warning (push)") \ _Pragma ("warning (disable:1478)") #define G_GNUC_END_IGNORE_DEPRECATIONS \ _Pragma ("warning (pop)") #elif __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) #define G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ _Pragma ("GCC diagnostic push") \ _Pragma ("GCC diagnostic ignored \"-Wdeprecated-declarations\"") #define G_GNUC_END_IGNORE_DEPRECATIONS \ _Pragma ("GCC diagnostic pop") #elif defined (_MSC_VER) && (_MSC_VER >= 1500) && !defined (__clang__) #define G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ __pragma (warning (push)) \ __pragma (warning (disable : 4996)) #define G_GNUC_END_IGNORE_DEPRECATIONS \ __pragma (warning (pop)) #elif defined (__clang__) #define G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ _Pragma("clang diagnostic push") \ _Pragma("clang diagnostic ignored \"-Wdeprecated-declarations\"") #define G_GNUC_END_IGNORE_DEPRECATIONS \ _Pragma("clang diagnostic pop") #else #define G_GNUC_BEGIN_IGNORE_DEPRECATIONS #define G_GNUC_END_IGNORE_DEPRECATIONS #endif /** * G_GNUC_MAY_ALIAS: * * Expands to the GNU C `may_alias` type attribute if the compiler is gcc. * Types with this attribute will not be subjected to type-based alias * analysis, but are assumed to alias with any other type, just like `char`. * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Type-Attributes.html#index-may_005falias-type-attribute) for details. * * Since: 2.14 */ #if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 3) #define G_GNUC_MAY_ALIAS __attribute__((may_alias)) #else #define G_GNUC_MAY_ALIAS #endif /** * G_GNUC_WARN_UNUSED_RESULT: * * Expands to the GNU C `warn_unused_result` function attribute if the compiler * is gcc. This function attribute makes the compiler emit a warning if the * result of a function call is ignored. * * Place the attribute after the declaration, just before the semicolon. * * |[<!-- language="C" --> * GList *g_list_append (GList *list, * gpointer data) G_GNUC_WARN_UNUSED_RESULT; * ]| * * See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-warn_005funused_005fresult-function-attribute) for more details. * * Since: 2.10 */ #if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4) #define G_GNUC_WARN_UNUSED_RESULT __attribute__((warn_unused_result)) #else #define G_GNUC_WARN_UNUSED_RESULT #endif /* __GNUC__ */ /** * G_GNUC_FUNCTION: * * Expands to "" on all modern compilers, and to __FUNCTION__ on gcc * version 2.x. Don't use it. * * Deprecated: 2.16: Use G_STRFUNC() instead */ /** * G_GNUC_PRETTY_FUNCTION: * * Expands to "" on all modern compilers, and to __PRETTY_FUNCTION__ * on gcc version 2.x. Don't use it. * * Deprecated: 2.16: Use G_STRFUNC() instead */ /* Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with * macros, so we can refer to them as strings unconditionally. * usage not-recommended since gcc-3.0 * * Mark them as deprecated since 2.26, since that’s when version macros were * introduced. */ #if defined (__GNUC__) && (__GNUC__ < 3) #define G_GNUC_FUNCTION __FUNCTION__ GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC) #define G_GNUC_PRETTY_FUNCTION __PRETTY_FUNCTION__ GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC) #else /* !__GNUC__ */ #define G_GNUC_FUNCTION "" GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC) #define G_GNUC_PRETTY_FUNCTION "" GLIB_DEPRECATED_MACRO_IN_2_26_FOR(G_STRFUNC) #endif /* !__GNUC__ */ #if g_macro__has_feature(attribute_analyzer_noreturn) && defined(__clang_analyzer__) #define G_ANALYZER_ANALYZING 1 #define G_ANALYZER_NORETURN __attribute__((analyzer_noreturn)) #else #define G_ANALYZER_ANALYZING 0 #define G_ANALYZER_NORETURN #endif #define G_STRINGIFY(macro_or_string) G_STRINGIFY_ARG (macro_or_string) #define G_STRINGIFY_ARG(contents) #contents #ifndef __GI_SCANNER__ /* The static assert macro really confuses the introspection parser */ #define G_PASTE_ARGS(identifier1,identifier2) identifier1 ## identifier2 #define G_PASTE(identifier1,identifier2) G_PASTE_ARGS (identifier1, identifier2) #if !defined(__cplusplus) && defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L #define G_STATIC_ASSERT(expr) _Static_assert (expr, "Expression evaluates to false") #elif (defined(__cplusplus) && __cplusplus >= 201103L) || \ (defined(__cplusplus) && defined (_MSC_VER) && (_MSC_VER >= 1600)) || \ (defined (_MSC_VER) && (_MSC_VER >= 1800)) #define G_STATIC_ASSERT(expr) static_assert (expr, "Expression evaluates to false") #else #ifdef __COUNTER__ #define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __COUNTER__)[(expr) ? 1 : -1] G_GNUC_UNUSED #else #define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __LINE__)[(expr) ? 1 : -1] G_GNUC_UNUSED #endif #endif /* __STDC_VERSION__ */ #define G_STATIC_ASSERT_EXPR(expr) ((void) sizeof (char[(expr) ? 1 : -1])) #endif /* !__GI_SCANNER__ */ /* Provide a string identifying the current code position */ #if defined(__GNUC__) && (__GNUC__ < 3) && !defined(__cplusplus) #define G_STRLOC __FILE__ ":" G_STRINGIFY (__LINE__) ":" __PRETTY_FUNCTION__ "()" #else #define G_STRLOC __FILE__ ":" G_STRINGIFY (__LINE__) #endif /* Provide a string identifying the current function, non-concatenatable */ #if defined (__GNUC__) && defined (__cplusplus) #define G_STRFUNC ((const char*) (__PRETTY_FUNCTION__)) #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L #define G_STRFUNC ((const char*) (__func__)) #elif defined (__GNUC__) || (defined(_MSC_VER) && (_MSC_VER > 1300)) #define G_STRFUNC ((const char*) (__FUNCTION__)) #else #define G_STRFUNC ((const char*) ("???")) #endif /* Guard C code in headers, while including them from C++ */ #ifdef __cplusplus #define G_BEGIN_DECLS extern "C" { #define G_END_DECLS } #else #define G_BEGIN_DECLS #define G_END_DECLS #endif /* Provide definitions for some commonly used macros. * Some of them are only provided if they haven't already * been defined. It is assumed that if they are already * defined then the current definition is correct. */ #ifndef NULL # ifdef __cplusplus # define NULL (0L) # else /* !__cplusplus */ # define NULL ((void*) 0) # endif /* !__cplusplus */ #endif #ifndef FALSE #define FALSE (0) #endif #ifndef TRUE #define TRUE (!FALSE) #endif #undef MAX #define MAX(a, b) (((a) > (b)) ? (a) : (b)) #undef MIN #define MIN(a, b) (((a) < (b)) ? (a) : (b)) #undef ABS #define ABS(a) (((a) < 0) ? -(a) : (a)) #undef CLAMP #define CLAMP(x, low, high) (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x))) #define G_APPROX_VALUE(a, b, epsilon) \ (((a) > (b) ? (a) - (b) : (b) - (a)) < (epsilon)) /* Count the number of elements in an array. The array must be defined * as such; using this with a dynamically allocated array will give * incorrect results. */ #define G_N_ELEMENTS(arr) (sizeof (arr) / sizeof ((arr)[0])) /* Macros by analogy to GINT_TO_POINTER, GPOINTER_TO_INT */ #define GPOINTER_TO_SIZE(p) ((gsize) (p)) #define GSIZE_TO_POINTER(s) ((gpointer) (gsize) (s)) /* Provide convenience macros for handling structure * fields through their offsets. */ #if (defined(__GNUC__) && __GNUC__ >= 4) || defined (_MSC_VER) #define G_STRUCT_OFFSET(struct_type, member) \ ((glong) offsetof (struct_type, member)) #else #define G_STRUCT_OFFSET(struct_type, member) \ ((glong) ((guint8*) &((struct_type*) 0)->member)) #endif #define G_STRUCT_MEMBER_P(struct_p, struct_offset) \ ((gpointer) ((guint8*) (struct_p) + (glong) (struct_offset))) #define G_STRUCT_MEMBER(member_type, struct_p, struct_offset) \ (*(member_type*) G_STRUCT_MEMBER_P ((struct_p), (struct_offset))) /* Provide simple macro statement wrappers: * G_STMT_START { statements; } G_STMT_END; * This can be used as a single statement, like: * if (x) G_STMT_START { ... } G_STMT_END; else ... * This intentionally does not use compiler extensions like GCC's '({...})' to * avoid portability issue or side effects when compiled with different compilers. * MSVC complains about "while(0)": C4127: "Conditional expression is constant", * so we use __pragma to avoid the warning since the use here is intentional. */ #if !(defined (G_STMT_START) && defined (G_STMT_END)) #define G_STMT_START do #if defined (_MSC_VER) && (_MSC_VER >= 1500) #define G_STMT_END \ __pragma(warning(push)) \ __pragma(warning(disable:4127)) \ while(0) \ __pragma(warning(pop)) #else #define G_STMT_END while (0) #endif #endif /* Provide G_ALIGNOF alignment macro. * * Note we cannot use the gcc __alignof__ operator here, as that returns the * preferred alignment rather than the minimal alignment. See * https://gitlab.gnome.org/GNOME/glib/merge_requests/538/diffs#note_390790. */ /** * G_ALIGNOF * @type: a type-name * * Return the minimal alignment required by the platform ABI for values of the given * type. The address of a variable or struct member of the given type must always be * a multiple of this alignment. For example, most platforms require int variables * to be aligned at a 4-byte boundary, so `G_ALIGNOF (int)` is 4 on most platforms. * * Note this is not necessarily the same as the value returned by GCC’s * `__alignof__` operator, which returns the preferred alignment for a type. * The preferred alignment may be a stricter alignment than the minimal * alignment. * * Since: 2.60 */ #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__cplusplus) #define G_ALIGNOF(type) _Alignof (type) #else #define G_ALIGNOF(type) (G_STRUCT_OFFSET (struct { char a; type b; }, b)) #endif /** * G_CONST_RETURN: * * If %G_DISABLE_CONST_RETURNS is defined, this macro expands * to nothing. By default, the macro expands to const. The macro * can be used in place of const for functions that return a value * that should not be modified. The purpose of this macro is to allow * us to turn on const for returned constant strings by default, while * allowing programmers who find that annoying to turn it off. This macro * should only be used for return values and for "out" parameters, it * doesn't make sense for "in" parameters. * * Deprecated: 2.30: API providers should replace all existing uses with * const and API consumers should adjust their code accordingly */ #ifdef G_DISABLE_CONST_RETURNS #define G_CONST_RETURN GLIB_DEPRECATED_MACRO_IN_2_30_FOR(const) #else #define G_CONST_RETURN const GLIB_DEPRECATED_MACRO_IN_2_30_FOR(const) #endif /** * G_NORETURN: * * Expands to the GNU C or MSVC `noreturn` function attribute depending on * the compiler. It is used for declaring functions which never return. * Enables optimization of the function, and avoids possible compiler warnings. * * Note that %G_NORETURN supersedes the previous %G_GNUC_NORETURN macro, which * will eventually be deprecated. %G_NORETURN supports more platforms. * * Place the attribute before the function declaration as follows: * * |[<!-- language="C" --> * G_NORETURN void g_abort (void); * ]| * * Since: 2.68 */ /* Note: We can’t annotate this with GLIB_AVAILABLE_MACRO_IN_2_68 because it’s * used within the GLib headers in function declarations which are always * evaluated when a header is included. This results in warnings in third party * code which includes glib.h, even if the third party code doesn’t use the new * macro itself. */ #if (3 <= __GNUC__ || (__GNUC__ == 2 && 8 <= __GNUC_MINOR__)) || (0x5110 <= __SUNPRO_C) /* For compatibility with G_NORETURN_FUNCPTR on clang, use __attribute__((__noreturn__)), not _Noreturn. */ # define G_NORETURN __attribute__ ((__noreturn__)) #elif defined (_MSC_VER) && (1200 <= _MSC_VER) /* Use MSVC specific syntax. */ # define G_NORETURN __declspec (noreturn) /* Use ISO C++11 syntax when the compiler supports it. */ #elif (defined (__cplusplus) && __cplusplus >= 201103 && !(__GNUC__ == 4 && __GNUC_MINOR__ == 7)) || defined (_MSC_VER) && (_MSC_VER >= 1900) # define G_NORETURN [[noreturn]] /* Use ISO C11 syntax when the compiler supports it. */ #elif (defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 7) # define G_NORETURN _Noreturn #else # define G_NORETURN /* empty */ #endif /** * G_NORETURN_FUNCPTR: * * Expands to the GNU C or MSVC `noreturn` function attribute depending on * the compiler. It is used for declaring function pointers which never return. * Enables optimization of the function, and avoids possible compiler warnings. * * Place the attribute before the function declaration as follows: * * |[<!-- language="C" --> * G_NORETURN_FUNCPTR void (*funcptr) (void); * ]| * * Note that if the function is not a function pointer, you can simply use * the %G_NORETURN macro as follows: * * |[<!-- language="C" --> * G_NORETURN void g_abort (void); * ]| * * Since: 2.68 */ #if (3 <= __GNUC__ || (__GNUC__ == 2 && 8 <= __GNUC_MINOR__)) || (0x5110 <= __SUNPRO_C) # define G_NORETURN_FUNCPTR __attribute__ ((__noreturn__)) \ GLIB_AVAILABLE_MACRO_IN_2_68 #else # define G_NORETURN_FUNCPTR /* empty */ \ GLIB_AVAILABLE_MACRO_IN_2_68 #endif /* * The G_LIKELY and G_UNLIKELY macros let the programmer give hints to * the compiler about the expected result of an expression. Some compilers * can use this information for optimizations. * * The _G_BOOLEAN_EXPR macro is intended to trigger a gcc warning when * putting assignments in g_return_if_fail (). */ #if defined(__GNUC__) && (__GNUC__ > 2) && defined(__OPTIMIZE__) #define _G_BOOLEAN_EXPR(expr) \ G_GNUC_EXTENSION ({ \ int _g_boolean_var_; \ if (expr) \ _g_boolean_var_ = 1; \ else \ _g_boolean_var_ = 0; \ _g_boolean_var_; \ }) #define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 1)) #define G_UNLIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 0)) #else #define G_LIKELY(expr) (expr) #define G_UNLIKELY(expr) (expr) #endif #if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1) || defined (__clang__) #define G_DEPRECATED __attribute__((__deprecated__)) #elif defined(_MSC_VER) && (_MSC_VER >= 1300) #define G_DEPRECATED __declspec(deprecated) #else #define G_DEPRECATED #endif #if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) || defined (__clang__) #define G_DEPRECATED_FOR(f) __attribute__((__deprecated__("Use '" #f "' instead"))) #elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320) #define G_DEPRECATED_FOR(f) __declspec(deprecated("is deprecated. Use '" #f "' instead")) #else #define G_DEPRECATED_FOR(f) G_DEPRECATED #endif #if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) || defined (__clang__) #define G_UNAVAILABLE(maj,min) __attribute__((deprecated("Not available before " #maj "." #min))) #elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320) #define G_UNAVAILABLE(maj,min) __declspec(deprecated("is not available before " #maj "." #min)) #else #define G_UNAVAILABLE(maj,min) G_DEPRECATED #endif #ifndef _GLIB_EXTERN #define _GLIB_EXTERN extern #endif /* These macros are used to mark deprecated symbols in GLib headers, * and thus have to be exposed in installed headers. But please * do *not* use them in other projects. Instead, use G_DEPRECATED * or define your own wrappers around it. */ #ifdef GLIB_DISABLE_DEPRECATION_WARNINGS #define GLIB_DEPRECATED _GLIB_EXTERN #define GLIB_DEPRECATED_FOR(f) _GLIB_EXTERN #define GLIB_UNAVAILABLE(maj,min) _GLIB_EXTERN #define GLIB_UNAVAILABLE_STATIC_INLINE(maj,min) #else #define GLIB_DEPRECATED G_DEPRECATED _GLIB_EXTERN #define GLIB_DEPRECATED_FOR(f) G_DEPRECATED_FOR(f) _GLIB_EXTERN #define GLIB_UNAVAILABLE(maj,min) G_UNAVAILABLE(maj,min) _GLIB_EXTERN #define GLIB_UNAVAILABLE_STATIC_INLINE(maj,min) G_UNAVAILABLE(maj,min) #endif #if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \ (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) || \ __clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 4)) #define _GLIB_GNUC_DO_PRAGMA(x) _Pragma(G_STRINGIFY (x)) #define GLIB_DEPRECATED_MACRO _GLIB_GNUC_DO_PRAGMA(GCC warning "Deprecated pre-processor symbol") #define GLIB_DEPRECATED_MACRO_FOR(f) _GLIB_GNUC_DO_PRAGMA(GCC warning "Deprecated pre-processor symbol, replace with " #f) #define GLIB_UNAVAILABLE_MACRO(maj,min) _GLIB_GNUC_DO_PRAGMA(GCC warning "Not available before " #maj "." #min) #else #define GLIB_DEPRECATED_MACRO #define GLIB_DEPRECATED_MACRO_FOR(f) #define GLIB_UNAVAILABLE_MACRO(maj,min) #endif #if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \ ((defined (__GNUC__) && (__GNUC__ > 6 || (__GNUC__ == 6 && __GNUC_MINOR__ >= 1))) || \ (defined (__clang_major__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 0)))) #define GLIB_DEPRECATED_ENUMERATOR G_DEPRECATED #define GLIB_DEPRECATED_ENUMERATOR_FOR(f) G_DEPRECATED_FOR(f) #define GLIB_UNAVAILABLE_ENUMERATOR(maj,min) G_UNAVAILABLE(maj,min) #else #define GLIB_DEPRECATED_ENUMERATOR #define GLIB_DEPRECATED_ENUMERATOR_FOR(f) #define GLIB_UNAVAILABLE_ENUMERATOR(maj,min) #endif #if !defined(GLIB_DISABLE_DEPRECATION_WARNINGS) && \ ((defined (__GNUC__) && (__GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1))) || \ (defined (__clang_major__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >= 0)))) #define GLIB_DEPRECATED_TYPE G_DEPRECATED #define GLIB_DEPRECATED_TYPE_FOR(f) G_DEPRECATED_FOR(f) #define GLIB_UNAVAILABLE_TYPE(maj,min) G_UNAVAILABLE(maj,min) #else #define GLIB_DEPRECATED_TYPE #define GLIB_DEPRECATED_TYPE_FOR(f) #define GLIB_UNAVAILABLE_TYPE(maj,min) #endif #ifndef __GI_SCANNER__ #if defined (__GNUC__) || defined (__clang__) /* these macros are private */ #define _GLIB_AUTOPTR_FUNC_NAME(TypeName) glib_autoptr_cleanup_##TypeName #define _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) glib_autoptr_clear_##TypeName #define _GLIB_AUTOPTR_TYPENAME(TypeName) TypeName##_autoptr #define _GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName) glib_listautoptr_cleanup_##TypeName #define _GLIB_AUTOPTR_LIST_TYPENAME(TypeName) TypeName##_listautoptr #define _GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName) glib_slistautoptr_cleanup_##TypeName #define _GLIB_AUTOPTR_SLIST_TYPENAME(TypeName) TypeName##_slistautoptr #define _GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName) glib_queueautoptr_cleanup_##TypeName #define _GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName) TypeName##_queueautoptr #define _GLIB_AUTO_FUNC_NAME(TypeName) glib_auto_cleanup_##TypeName #define _GLIB_CLEANUP(func) __attribute__((cleanup(func))) #define _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(TypeName, ParentName, cleanup) \ typedef TypeName *_GLIB_AUTOPTR_TYPENAME(TypeName); \ typedef GList *_GLIB_AUTOPTR_LIST_TYPENAME(TypeName); \ typedef GSList *_GLIB_AUTOPTR_SLIST_TYPENAME(TypeName); \ typedef GQueue *_GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName); \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) (TypeName *_ptr) \ { if (_ptr) (cleanup) ((ParentName *) _ptr); } \ static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_FUNC_NAME(TypeName) (TypeName **_ptr) \ { _GLIB_AUTOPTR_CLEAR_FUNC_NAME(TypeName) (*_ptr); } \ static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName) (GList **_l) \ { g_list_free_full (*_l, (GDestroyNotify) (void(*)(void)) cleanup); } \ static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName) (GSList **_l) \ { g_slist_free_full (*_l, (GDestroyNotify) (void(*)(void)) cleanup); } \ static G_GNUC_UNUSED inline void _GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName) (GQueue **_q) \ { if (*_q) g_queue_free_full (*_q, (GDestroyNotify) (void(*)(void)) cleanup); } \ G_GNUC_END_IGNORE_DEPRECATIONS #define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName) \ _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(ModuleObjName, ParentName, _GLIB_AUTOPTR_CLEAR_FUNC_NAME(ParentName)) /* these macros are API */ #define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func) \ _GLIB_DEFINE_AUTOPTR_CLEANUP_FUNCS(TypeName, TypeName, func) #define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func) \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ static G_GNUC_UNUSED inline void _GLIB_AUTO_FUNC_NAME(TypeName) (TypeName *_ptr) { (func) (_ptr); } \ G_GNUC_END_IGNORE_DEPRECATIONS #define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none) \ G_GNUC_BEGIN_IGNORE_DEPRECATIONS \ static G_GNUC_UNUSED inline void _GLIB_AUTO_FUNC_NAME(TypeName) (TypeName *_ptr) { if (*_ptr != none) (func) (*_ptr); } \ G_GNUC_END_IGNORE_DEPRECATIONS #define g_autoptr(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_TYPENAME(TypeName) #define g_autolist(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_LIST_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_LIST_TYPENAME(TypeName) #define g_autoslist(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_SLIST_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_SLIST_TYPENAME(TypeName) #define g_autoqueue(TypeName) _GLIB_CLEANUP(_GLIB_AUTOPTR_QUEUE_FUNC_NAME(TypeName)) _GLIB_AUTOPTR_QUEUE_TYPENAME(TypeName) #define g_auto(TypeName) _GLIB_CLEANUP(_GLIB_AUTO_FUNC_NAME(TypeName)) TypeName #define g_autofree _GLIB_CLEANUP(g_autoptr_cleanup_generic_gfree) #else /* not GNU C */ /* this (dummy) macro is private */ #define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName) /* these (dummy) macros are API */ #define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func) #define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func) #define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none) /* no declaration of g_auto() or g_autoptr() here */ #endif /* __GNUC__ */ #else #define _GLIB_DEFINE_AUTOPTR_CHAINUP(ModuleObjName, ParentName) #define G_DEFINE_AUTOPTR_CLEANUP_FUNC(TypeName, func) #define G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(TypeName, func) #define G_DEFINE_AUTO_CLEANUP_FREE_FUNC(TypeName, func, none) #endif /* __GI_SCANNER__ */ /** * G_SIZEOF_MEMBER: * @struct_type: a structure type, e.g. #GOutputVector * @member: a field in the structure, e.g. `size` * * Returns the size of @member in the struct definition without having a * declared instance of @struct_type. * * Returns: the size of @member in bytes. * * Since: 2.64 */ #define G_SIZEOF_MEMBER(struct_type, member) \ GLIB_AVAILABLE_MACRO_IN_2_64 \ sizeof (((struct_type *) 0)->member) #endif /* __G_MACROS_H__ */ glib/ghook.h 0000644 00000014326 15125173650 0006754 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_HOOK_H__ #define __G_HOOK_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmem.h> G_BEGIN_DECLS /* --- typedefs --- */ typedef struct _GHook GHook; typedef struct _GHookList GHookList; typedef gint (*GHookCompareFunc) (GHook *new_hook, GHook *sibling); typedef gboolean (*GHookFindFunc) (GHook *hook, gpointer data); typedef void (*GHookMarshaller) (GHook *hook, gpointer marshal_data); typedef gboolean (*GHookCheckMarshaller) (GHook *hook, gpointer marshal_data); typedef void (*GHookFunc) (gpointer data); typedef gboolean (*GHookCheckFunc) (gpointer data); typedef void (*GHookFinalizeFunc) (GHookList *hook_list, GHook *hook); typedef enum { G_HOOK_FLAG_ACTIVE = 1 << 0, G_HOOK_FLAG_IN_CALL = 1 << 1, G_HOOK_FLAG_MASK = 0x0f } GHookFlagMask; #define G_HOOK_FLAG_USER_SHIFT (4) /* --- structures --- */ struct _GHookList { gulong seq_id; guint hook_size : 16; guint is_setup : 1; GHook *hooks; gpointer dummy3; GHookFinalizeFunc finalize_hook; gpointer dummy[2]; }; struct _GHook { gpointer data; GHook *next; GHook *prev; guint ref_count; gulong hook_id; guint flags; gpointer func; GDestroyNotify destroy; }; /* --- macros --- */ #define G_HOOK(hook) ((GHook*) (hook)) #define G_HOOK_FLAGS(hook) (G_HOOK (hook)->flags) #define G_HOOK_ACTIVE(hook) ((G_HOOK_FLAGS (hook) & \ G_HOOK_FLAG_ACTIVE) != 0) #define G_HOOK_IN_CALL(hook) ((G_HOOK_FLAGS (hook) & \ G_HOOK_FLAG_IN_CALL) != 0) #define G_HOOK_IS_VALID(hook) (G_HOOK (hook)->hook_id != 0 && \ (G_HOOK_FLAGS (hook) & \ G_HOOK_FLAG_ACTIVE)) #define G_HOOK_IS_UNLINKED(hook) (G_HOOK (hook)->next == NULL && \ G_HOOK (hook)->prev == NULL && \ G_HOOK (hook)->hook_id == 0 && \ G_HOOK (hook)->ref_count == 0) /* --- prototypes --- */ /* callback maintenance functions */ GLIB_AVAILABLE_IN_ALL void g_hook_list_init (GHookList *hook_list, guint hook_size); GLIB_AVAILABLE_IN_ALL void g_hook_list_clear (GHookList *hook_list); GLIB_AVAILABLE_IN_ALL GHook* g_hook_alloc (GHookList *hook_list); GLIB_AVAILABLE_IN_ALL void g_hook_free (GHookList *hook_list, GHook *hook); GLIB_AVAILABLE_IN_ALL GHook * g_hook_ref (GHookList *hook_list, GHook *hook); GLIB_AVAILABLE_IN_ALL void g_hook_unref (GHookList *hook_list, GHook *hook); GLIB_AVAILABLE_IN_ALL gboolean g_hook_destroy (GHookList *hook_list, gulong hook_id); GLIB_AVAILABLE_IN_ALL void g_hook_destroy_link (GHookList *hook_list, GHook *hook); GLIB_AVAILABLE_IN_ALL void g_hook_prepend (GHookList *hook_list, GHook *hook); GLIB_AVAILABLE_IN_ALL void g_hook_insert_before (GHookList *hook_list, GHook *sibling, GHook *hook); GLIB_AVAILABLE_IN_ALL void g_hook_insert_sorted (GHookList *hook_list, GHook *hook, GHookCompareFunc func); GLIB_AVAILABLE_IN_ALL GHook* g_hook_get (GHookList *hook_list, gulong hook_id); GLIB_AVAILABLE_IN_ALL GHook* g_hook_find (GHookList *hook_list, gboolean need_valids, GHookFindFunc func, gpointer data); GLIB_AVAILABLE_IN_ALL GHook* g_hook_find_data (GHookList *hook_list, gboolean need_valids, gpointer data); GLIB_AVAILABLE_IN_ALL GHook* g_hook_find_func (GHookList *hook_list, gboolean need_valids, gpointer func); GLIB_AVAILABLE_IN_ALL GHook* g_hook_find_func_data (GHookList *hook_list, gboolean need_valids, gpointer func, gpointer data); /* return the first valid hook, and increment its reference count */ GLIB_AVAILABLE_IN_ALL GHook* g_hook_first_valid (GHookList *hook_list, gboolean may_be_in_call); /* return the next valid hook with incremented reference count, and * decrement the reference count of the original hook */ GLIB_AVAILABLE_IN_ALL GHook* g_hook_next_valid (GHookList *hook_list, GHook *hook, gboolean may_be_in_call); /* GHookCompareFunc implementation to insert hooks sorted by their id */ GLIB_AVAILABLE_IN_ALL gint g_hook_compare_ids (GHook *new_hook, GHook *sibling); /* convenience macros */ #define g_hook_append( hook_list, hook ) \ g_hook_insert_before ((hook_list), NULL, (hook)) /* invoke all valid hooks with the (*GHookFunc) signature. */ GLIB_AVAILABLE_IN_ALL void g_hook_list_invoke (GHookList *hook_list, gboolean may_recurse); /* invoke all valid hooks with the (*GHookCheckFunc) signature, * and destroy the hook if FALSE is returned. */ GLIB_AVAILABLE_IN_ALL void g_hook_list_invoke_check (GHookList *hook_list, gboolean may_recurse); /* invoke a marshaller on all valid hooks. */ GLIB_AVAILABLE_IN_ALL void g_hook_list_marshal (GHookList *hook_list, gboolean may_recurse, GHookMarshaller marshaller, gpointer marshal_data); GLIB_AVAILABLE_IN_ALL void g_hook_list_marshal_check (GHookList *hook_list, gboolean may_recurse, GHookCheckMarshaller marshaller, gpointer marshal_data); G_END_DECLS #endif /* __G_HOOK_H__ */ glib/gbytes.h 0000644 00000006406 15125173650 0007142 0 ustar 00 /* * Copyright © 2009, 2010 Codethink Limited * Copyright © 2011 Collabora Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> * Stef Walter <stefw@collabora.co.uk> */ #ifndef __G_BYTES_H__ #define __G_BYTES_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <glib/garray.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_new (gconstpointer data, gsize size); GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_new_take (gpointer data, gsize size); GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_new_static (gconstpointer data, gsize size); GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_new_with_free_func (gconstpointer data, gsize size, GDestroyNotify free_func, gpointer user_data); GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_new_from_bytes (GBytes *bytes, gsize offset, gsize length); GLIB_AVAILABLE_IN_ALL gconstpointer g_bytes_get_data (GBytes *bytes, gsize *size); GLIB_AVAILABLE_IN_ALL gsize g_bytes_get_size (GBytes *bytes); GLIB_AVAILABLE_IN_ALL GBytes * g_bytes_ref (GBytes *bytes); GLIB_AVAILABLE_IN_ALL void g_bytes_unref (GBytes *bytes); GLIB_AVAILABLE_IN_ALL gpointer g_bytes_unref_to_data (GBytes *bytes, gsize *size); GLIB_AVAILABLE_IN_ALL GByteArray * g_bytes_unref_to_array (GBytes *bytes); GLIB_AVAILABLE_IN_ALL guint g_bytes_hash (gconstpointer bytes); GLIB_AVAILABLE_IN_ALL gboolean g_bytes_equal (gconstpointer bytes1, gconstpointer bytes2); GLIB_AVAILABLE_IN_ALL gint g_bytes_compare (gconstpointer bytes1, gconstpointer bytes2); G_END_DECLS #endif /* __G_BYTES_H__ */ glib/gdir.h 0000644 00000003151 15125173650 0006564 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * gdir.c: Simplified wrapper around the DIRENT functions. * * Copyright 2001 Hans Breuer * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_DIR_H__ #define __G_DIR_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> #ifdef G_OS_UNIX #include <dirent.h> #endif G_BEGIN_DECLS typedef struct _GDir GDir; GLIB_AVAILABLE_IN_ALL GDir * g_dir_open (const gchar *path, guint flags, GError **error); GLIB_AVAILABLE_IN_ALL const gchar * g_dir_read_name (GDir *dir); GLIB_AVAILABLE_IN_ALL void g_dir_rewind (GDir *dir); GLIB_AVAILABLE_IN_ALL void g_dir_close (GDir *dir); G_END_DECLS #endif /* __G_DIR_H__ */ glib/gunicode.h 0000644 00000120374 15125173650 0007443 0 ustar 00 /* gunicode.h - Unicode manipulation functions * * Copyright (C) 1999, 2000 Tom Tromey * Copyright 2000, 2005 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_UNICODE_H__ #define __G_UNICODE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> #include <glib/gtypes.h> G_BEGIN_DECLS /** * gunichar: * * A type which can hold any UTF-32 or UCS-4 character code, * also known as a Unicode code point. * * If you want to produce the UTF-8 representation of a #gunichar, * use g_ucs4_to_utf8(). See also g_utf8_to_ucs4() for the reverse * process. * * To print/scan values of this type as integer, use * %G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT. * * The notation to express a Unicode code point in running text is * as a hexadecimal number with four to six digits and uppercase * letters, prefixed by the string "U+". Leading zeros are omitted, * unless the code point would have fewer than four hexadecimal digits. * For example, "U+0041 LATIN CAPITAL LETTER A". To print a code point * in the U+-notation, use the format string "U+\%04"G_GINT32_FORMAT"X". * To scan, use the format string "U+\%06"G_GINT32_FORMAT"X". * * |[ * gunichar c; * sscanf ("U+0041", "U+%06"G_GINT32_FORMAT"X", &c) * g_print ("Read U+%04"G_GINT32_FORMAT"X", c); * ]| */ typedef guint32 gunichar; /** * gunichar2: * * A type which can hold any UTF-16 code * point<footnote id="utf16_surrogate_pairs">UTF-16 also has so called * <firstterm>surrogate pairs</firstterm> to encode characters beyond * the BMP as pairs of 16bit numbers. Surrogate pairs cannot be stored * in a single gunichar2 field, but all GLib functions accepting gunichar2 * arrays will correctly interpret surrogate pairs.</footnote>. * * To print/scan values of this type to/from text you need to convert * to/from UTF-8, using g_utf16_to_utf8()/g_utf8_to_utf16(). * * To print/scan values of this type as integer, use * %G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT. */ typedef guint16 gunichar2; /** * GUnicodeType: * @G_UNICODE_CONTROL: General category "Other, Control" (Cc) * @G_UNICODE_FORMAT: General category "Other, Format" (Cf) * @G_UNICODE_UNASSIGNED: General category "Other, Not Assigned" (Cn) * @G_UNICODE_PRIVATE_USE: General category "Other, Private Use" (Co) * @G_UNICODE_SURROGATE: General category "Other, Surrogate" (Cs) * @G_UNICODE_LOWERCASE_LETTER: General category "Letter, Lowercase" (Ll) * @G_UNICODE_MODIFIER_LETTER: General category "Letter, Modifier" (Lm) * @G_UNICODE_OTHER_LETTER: General category "Letter, Other" (Lo) * @G_UNICODE_TITLECASE_LETTER: General category "Letter, Titlecase" (Lt) * @G_UNICODE_UPPERCASE_LETTER: General category "Letter, Uppercase" (Lu) * @G_UNICODE_SPACING_MARK: General category "Mark, Spacing" (Mc) * @G_UNICODE_ENCLOSING_MARK: General category "Mark, Enclosing" (Me) * @G_UNICODE_NON_SPACING_MARK: General category "Mark, Nonspacing" (Mn) * @G_UNICODE_DECIMAL_NUMBER: General category "Number, Decimal Digit" (Nd) * @G_UNICODE_LETTER_NUMBER: General category "Number, Letter" (Nl) * @G_UNICODE_OTHER_NUMBER: General category "Number, Other" (No) * @G_UNICODE_CONNECT_PUNCTUATION: General category "Punctuation, Connector" (Pc) * @G_UNICODE_DASH_PUNCTUATION: General category "Punctuation, Dash" (Pd) * @G_UNICODE_CLOSE_PUNCTUATION: General category "Punctuation, Close" (Pe) * @G_UNICODE_FINAL_PUNCTUATION: General category "Punctuation, Final quote" (Pf) * @G_UNICODE_INITIAL_PUNCTUATION: General category "Punctuation, Initial quote" (Pi) * @G_UNICODE_OTHER_PUNCTUATION: General category "Punctuation, Other" (Po) * @G_UNICODE_OPEN_PUNCTUATION: General category "Punctuation, Open" (Ps) * @G_UNICODE_CURRENCY_SYMBOL: General category "Symbol, Currency" (Sc) * @G_UNICODE_MODIFIER_SYMBOL: General category "Symbol, Modifier" (Sk) * @G_UNICODE_MATH_SYMBOL: General category "Symbol, Math" (Sm) * @G_UNICODE_OTHER_SYMBOL: General category "Symbol, Other" (So) * @G_UNICODE_LINE_SEPARATOR: General category "Separator, Line" (Zl) * @G_UNICODE_PARAGRAPH_SEPARATOR: General category "Separator, Paragraph" (Zp) * @G_UNICODE_SPACE_SEPARATOR: General category "Separator, Space" (Zs) * * These are the possible character classifications from the * Unicode specification. * See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Category_Values). */ typedef enum { G_UNICODE_CONTROL, G_UNICODE_FORMAT, G_UNICODE_UNASSIGNED, G_UNICODE_PRIVATE_USE, G_UNICODE_SURROGATE, G_UNICODE_LOWERCASE_LETTER, G_UNICODE_MODIFIER_LETTER, G_UNICODE_OTHER_LETTER, G_UNICODE_TITLECASE_LETTER, G_UNICODE_UPPERCASE_LETTER, G_UNICODE_SPACING_MARK, G_UNICODE_ENCLOSING_MARK, G_UNICODE_NON_SPACING_MARK, G_UNICODE_DECIMAL_NUMBER, G_UNICODE_LETTER_NUMBER, G_UNICODE_OTHER_NUMBER, G_UNICODE_CONNECT_PUNCTUATION, G_UNICODE_DASH_PUNCTUATION, G_UNICODE_CLOSE_PUNCTUATION, G_UNICODE_FINAL_PUNCTUATION, G_UNICODE_INITIAL_PUNCTUATION, G_UNICODE_OTHER_PUNCTUATION, G_UNICODE_OPEN_PUNCTUATION, G_UNICODE_CURRENCY_SYMBOL, G_UNICODE_MODIFIER_SYMBOL, G_UNICODE_MATH_SYMBOL, G_UNICODE_OTHER_SYMBOL, G_UNICODE_LINE_SEPARATOR, G_UNICODE_PARAGRAPH_SEPARATOR, G_UNICODE_SPACE_SEPARATOR } GUnicodeType; /** * G_UNICODE_COMBINING_MARK: * * Older name for %G_UNICODE_SPACING_MARK. * * Deprecated: 2.30: Use %G_UNICODE_SPACING_MARK. */ #define G_UNICODE_COMBINING_MARK G_UNICODE_SPACING_MARK GLIB_DEPRECATED_MACRO_IN_2_30_FOR(G_UNICODE_SPACING_MARK) /** * GUnicodeBreakType: * @G_UNICODE_BREAK_MANDATORY: Mandatory Break (BK) * @G_UNICODE_BREAK_CARRIAGE_RETURN: Carriage Return (CR) * @G_UNICODE_BREAK_LINE_FEED: Line Feed (LF) * @G_UNICODE_BREAK_COMBINING_MARK: Attached Characters and Combining Marks (CM) * @G_UNICODE_BREAK_SURROGATE: Surrogates (SG) * @G_UNICODE_BREAK_ZERO_WIDTH_SPACE: Zero Width Space (ZW) * @G_UNICODE_BREAK_INSEPARABLE: Inseparable (IN) * @G_UNICODE_BREAK_NON_BREAKING_GLUE: Non-breaking ("Glue") (GL) * @G_UNICODE_BREAK_CONTINGENT: Contingent Break Opportunity (CB) * @G_UNICODE_BREAK_SPACE: Space (SP) * @G_UNICODE_BREAK_AFTER: Break Opportunity After (BA) * @G_UNICODE_BREAK_BEFORE: Break Opportunity Before (BB) * @G_UNICODE_BREAK_BEFORE_AND_AFTER: Break Opportunity Before and After (B2) * @G_UNICODE_BREAK_HYPHEN: Hyphen (HY) * @G_UNICODE_BREAK_NON_STARTER: Nonstarter (NS) * @G_UNICODE_BREAK_OPEN_PUNCTUATION: Opening Punctuation (OP) * @G_UNICODE_BREAK_CLOSE_PUNCTUATION: Closing Punctuation (CL) * @G_UNICODE_BREAK_QUOTATION: Ambiguous Quotation (QU) * @G_UNICODE_BREAK_EXCLAMATION: Exclamation/Interrogation (EX) * @G_UNICODE_BREAK_IDEOGRAPHIC: Ideographic (ID) * @G_UNICODE_BREAK_NUMERIC: Numeric (NU) * @G_UNICODE_BREAK_INFIX_SEPARATOR: Infix Separator (Numeric) (IS) * @G_UNICODE_BREAK_SYMBOL: Symbols Allowing Break After (SY) * @G_UNICODE_BREAK_ALPHABETIC: Ordinary Alphabetic and Symbol Characters (AL) * @G_UNICODE_BREAK_PREFIX: Prefix (Numeric) (PR) * @G_UNICODE_BREAK_POSTFIX: Postfix (Numeric) (PO) * @G_UNICODE_BREAK_COMPLEX_CONTEXT: Complex Content Dependent (South East Asian) (SA) * @G_UNICODE_BREAK_AMBIGUOUS: Ambiguous (Alphabetic or Ideographic) (AI) * @G_UNICODE_BREAK_UNKNOWN: Unknown (XX) * @G_UNICODE_BREAK_NEXT_LINE: Next Line (NL) * @G_UNICODE_BREAK_WORD_JOINER: Word Joiner (WJ) * @G_UNICODE_BREAK_HANGUL_L_JAMO: Hangul L Jamo (JL) * @G_UNICODE_BREAK_HANGUL_V_JAMO: Hangul V Jamo (JV) * @G_UNICODE_BREAK_HANGUL_T_JAMO: Hangul T Jamo (JT) * @G_UNICODE_BREAK_HANGUL_LV_SYLLABLE: Hangul LV Syllable (H2) * @G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE: Hangul LVT Syllable (H3) * @G_UNICODE_BREAK_CLOSE_PARANTHESIS: Closing Parenthesis (CP). Since 2.28 * @G_UNICODE_BREAK_CONDITIONAL_JAPANESE_STARTER: Conditional Japanese Starter (CJ). Since: 2.32 * @G_UNICODE_BREAK_HEBREW_LETTER: Hebrew Letter (HL). Since: 2.32 * @G_UNICODE_BREAK_REGIONAL_INDICATOR: Regional Indicator (RI). Since: 2.36 * @G_UNICODE_BREAK_EMOJI_BASE: Emoji Base (EB). Since: 2.50 * @G_UNICODE_BREAK_EMOJI_MODIFIER: Emoji Modifier (EM). Since: 2.50 * @G_UNICODE_BREAK_ZERO_WIDTH_JOINER: Zero Width Joiner (ZWJ). Since: 2.50 * * These are the possible line break classifications. * * Since new unicode versions may add new types here, applications should be ready * to handle unknown values. They may be regarded as %G_UNICODE_BREAK_UNKNOWN. * * See [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/). */ typedef enum { G_UNICODE_BREAK_MANDATORY, G_UNICODE_BREAK_CARRIAGE_RETURN, G_UNICODE_BREAK_LINE_FEED, G_UNICODE_BREAK_COMBINING_MARK, G_UNICODE_BREAK_SURROGATE, G_UNICODE_BREAK_ZERO_WIDTH_SPACE, G_UNICODE_BREAK_INSEPARABLE, G_UNICODE_BREAK_NON_BREAKING_GLUE, G_UNICODE_BREAK_CONTINGENT, G_UNICODE_BREAK_SPACE, G_UNICODE_BREAK_AFTER, G_UNICODE_BREAK_BEFORE, G_UNICODE_BREAK_BEFORE_AND_AFTER, G_UNICODE_BREAK_HYPHEN, G_UNICODE_BREAK_NON_STARTER, G_UNICODE_BREAK_OPEN_PUNCTUATION, G_UNICODE_BREAK_CLOSE_PUNCTUATION, G_UNICODE_BREAK_QUOTATION, G_UNICODE_BREAK_EXCLAMATION, G_UNICODE_BREAK_IDEOGRAPHIC, G_UNICODE_BREAK_NUMERIC, G_UNICODE_BREAK_INFIX_SEPARATOR, G_UNICODE_BREAK_SYMBOL, G_UNICODE_BREAK_ALPHABETIC, G_UNICODE_BREAK_PREFIX, G_UNICODE_BREAK_POSTFIX, G_UNICODE_BREAK_COMPLEX_CONTEXT, G_UNICODE_BREAK_AMBIGUOUS, G_UNICODE_BREAK_UNKNOWN, G_UNICODE_BREAK_NEXT_LINE, G_UNICODE_BREAK_WORD_JOINER, G_UNICODE_BREAK_HANGUL_L_JAMO, G_UNICODE_BREAK_HANGUL_V_JAMO, G_UNICODE_BREAK_HANGUL_T_JAMO, G_UNICODE_BREAK_HANGUL_LV_SYLLABLE, G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE, G_UNICODE_BREAK_CLOSE_PARANTHESIS, G_UNICODE_BREAK_CONDITIONAL_JAPANESE_STARTER, G_UNICODE_BREAK_HEBREW_LETTER, G_UNICODE_BREAK_REGIONAL_INDICATOR, G_UNICODE_BREAK_EMOJI_BASE, G_UNICODE_BREAK_EMOJI_MODIFIER, G_UNICODE_BREAK_ZERO_WIDTH_JOINER } GUnicodeBreakType; /** * GUnicodeScript: * @G_UNICODE_SCRIPT_INVALID_CODE: * a value never returned from g_unichar_get_script() * @G_UNICODE_SCRIPT_COMMON: a character used by multiple different scripts * @G_UNICODE_SCRIPT_INHERITED: a mark glyph that takes its script from the * base glyph to which it is attached * @G_UNICODE_SCRIPT_ARABIC: Arabic * @G_UNICODE_SCRIPT_ARMENIAN: Armenian * @G_UNICODE_SCRIPT_BENGALI: Bengali * @G_UNICODE_SCRIPT_BOPOMOFO: Bopomofo * @G_UNICODE_SCRIPT_CHEROKEE: Cherokee * @G_UNICODE_SCRIPT_COPTIC: Coptic * @G_UNICODE_SCRIPT_CYRILLIC: Cyrillic * @G_UNICODE_SCRIPT_DESERET: Deseret * @G_UNICODE_SCRIPT_DEVANAGARI: Devanagari * @G_UNICODE_SCRIPT_ETHIOPIC: Ethiopic * @G_UNICODE_SCRIPT_GEORGIAN: Georgian * @G_UNICODE_SCRIPT_GOTHIC: Gothic * @G_UNICODE_SCRIPT_GREEK: Greek * @G_UNICODE_SCRIPT_GUJARATI: Gujarati * @G_UNICODE_SCRIPT_GURMUKHI: Gurmukhi * @G_UNICODE_SCRIPT_HAN: Han * @G_UNICODE_SCRIPT_HANGUL: Hangul * @G_UNICODE_SCRIPT_HEBREW: Hebrew * @G_UNICODE_SCRIPT_HIRAGANA: Hiragana * @G_UNICODE_SCRIPT_KANNADA: Kannada * @G_UNICODE_SCRIPT_KATAKANA: Katakana * @G_UNICODE_SCRIPT_KHMER: Khmer * @G_UNICODE_SCRIPT_LAO: Lao * @G_UNICODE_SCRIPT_LATIN: Latin * @G_UNICODE_SCRIPT_MALAYALAM: Malayalam * @G_UNICODE_SCRIPT_MONGOLIAN: Mongolian * @G_UNICODE_SCRIPT_MYANMAR: Myanmar * @G_UNICODE_SCRIPT_OGHAM: Ogham * @G_UNICODE_SCRIPT_OLD_ITALIC: Old Italic * @G_UNICODE_SCRIPT_ORIYA: Oriya * @G_UNICODE_SCRIPT_RUNIC: Runic * @G_UNICODE_SCRIPT_SINHALA: Sinhala * @G_UNICODE_SCRIPT_SYRIAC: Syriac * @G_UNICODE_SCRIPT_TAMIL: Tamil * @G_UNICODE_SCRIPT_TELUGU: Telugu * @G_UNICODE_SCRIPT_THAANA: Thaana * @G_UNICODE_SCRIPT_THAI: Thai * @G_UNICODE_SCRIPT_TIBETAN: Tibetan * @G_UNICODE_SCRIPT_CANADIAN_ABORIGINAL: * Canadian Aboriginal * @G_UNICODE_SCRIPT_YI: Yi * @G_UNICODE_SCRIPT_TAGALOG: Tagalog * @G_UNICODE_SCRIPT_HANUNOO: Hanunoo * @G_UNICODE_SCRIPT_BUHID: Buhid * @G_UNICODE_SCRIPT_TAGBANWA: Tagbanwa * @G_UNICODE_SCRIPT_BRAILLE: Braille * @G_UNICODE_SCRIPT_CYPRIOT: Cypriot * @G_UNICODE_SCRIPT_LIMBU: Limbu * @G_UNICODE_SCRIPT_OSMANYA: Osmanya * @G_UNICODE_SCRIPT_SHAVIAN: Shavian * @G_UNICODE_SCRIPT_LINEAR_B: Linear B * @G_UNICODE_SCRIPT_TAI_LE: Tai Le * @G_UNICODE_SCRIPT_UGARITIC: Ugaritic * @G_UNICODE_SCRIPT_NEW_TAI_LUE: * New Tai Lue * @G_UNICODE_SCRIPT_BUGINESE: Buginese * @G_UNICODE_SCRIPT_GLAGOLITIC: Glagolitic * @G_UNICODE_SCRIPT_TIFINAGH: Tifinagh * @G_UNICODE_SCRIPT_SYLOTI_NAGRI: * Syloti Nagri * @G_UNICODE_SCRIPT_OLD_PERSIAN: * Old Persian * @G_UNICODE_SCRIPT_KHAROSHTHI: Kharoshthi * @G_UNICODE_SCRIPT_UNKNOWN: an unassigned code point * @G_UNICODE_SCRIPT_BALINESE: Balinese * @G_UNICODE_SCRIPT_CUNEIFORM: Cuneiform * @G_UNICODE_SCRIPT_PHOENICIAN: Phoenician * @G_UNICODE_SCRIPT_PHAGS_PA: Phags-pa * @G_UNICODE_SCRIPT_NKO: N'Ko * @G_UNICODE_SCRIPT_KAYAH_LI: Kayah Li. Since 2.16.3 * @G_UNICODE_SCRIPT_LEPCHA: Lepcha. Since 2.16.3 * @G_UNICODE_SCRIPT_REJANG: Rejang. Since 2.16.3 * @G_UNICODE_SCRIPT_SUNDANESE: Sundanese. Since 2.16.3 * @G_UNICODE_SCRIPT_SAURASHTRA: Saurashtra. Since 2.16.3 * @G_UNICODE_SCRIPT_CHAM: Cham. Since 2.16.3 * @G_UNICODE_SCRIPT_OL_CHIKI: Ol Chiki. Since 2.16.3 * @G_UNICODE_SCRIPT_VAI: Vai. Since 2.16.3 * @G_UNICODE_SCRIPT_CARIAN: Carian. Since 2.16.3 * @G_UNICODE_SCRIPT_LYCIAN: Lycian. Since 2.16.3 * @G_UNICODE_SCRIPT_LYDIAN: Lydian. Since 2.16.3 * @G_UNICODE_SCRIPT_AVESTAN: Avestan. Since 2.26 * @G_UNICODE_SCRIPT_BAMUM: Bamum. Since 2.26 * @G_UNICODE_SCRIPT_EGYPTIAN_HIEROGLYPHS: * Egyptian Hieroglpyhs. Since 2.26 * @G_UNICODE_SCRIPT_IMPERIAL_ARAMAIC: * Imperial Aramaic. Since 2.26 * @G_UNICODE_SCRIPT_INSCRIPTIONAL_PAHLAVI: * Inscriptional Pahlavi. Since 2.26 * @G_UNICODE_SCRIPT_INSCRIPTIONAL_PARTHIAN: * Inscriptional Parthian. Since 2.26 * @G_UNICODE_SCRIPT_JAVANESE: Javanese. Since 2.26 * @G_UNICODE_SCRIPT_KAITHI: Kaithi. Since 2.26 * @G_UNICODE_SCRIPT_LISU: Lisu. Since 2.26 * @G_UNICODE_SCRIPT_MEETEI_MAYEK: * Meetei Mayek. Since 2.26 * @G_UNICODE_SCRIPT_OLD_SOUTH_ARABIAN: * Old South Arabian. Since 2.26 * @G_UNICODE_SCRIPT_OLD_TURKIC: Old Turkic. Since 2.28 * @G_UNICODE_SCRIPT_SAMARITAN: Samaritan. Since 2.26 * @G_UNICODE_SCRIPT_TAI_THAM: Tai Tham. Since 2.26 * @G_UNICODE_SCRIPT_TAI_VIET: Tai Viet. Since 2.26 * @G_UNICODE_SCRIPT_BATAK: Batak. Since 2.28 * @G_UNICODE_SCRIPT_BRAHMI: Brahmi. Since 2.28 * @G_UNICODE_SCRIPT_MANDAIC: Mandaic. Since 2.28 * @G_UNICODE_SCRIPT_CHAKMA: Chakma. Since: 2.32 * @G_UNICODE_SCRIPT_MEROITIC_CURSIVE: Meroitic Cursive. Since: 2.32 * @G_UNICODE_SCRIPT_MEROITIC_HIEROGLYPHS: Meroitic Hieroglyphs. Since: 2.32 * @G_UNICODE_SCRIPT_MIAO: Miao. Since: 2.32 * @G_UNICODE_SCRIPT_SHARADA: Sharada. Since: 2.32 * @G_UNICODE_SCRIPT_SORA_SOMPENG: Sora Sompeng. Since: 2.32 * @G_UNICODE_SCRIPT_TAKRI: Takri. Since: 2.32 * @G_UNICODE_SCRIPT_BASSA_VAH: Bassa. Since: 2.42 * @G_UNICODE_SCRIPT_CAUCASIAN_ALBANIAN: Caucasian Albanian. Since: 2.42 * @G_UNICODE_SCRIPT_DUPLOYAN: Duployan. Since: 2.42 * @G_UNICODE_SCRIPT_ELBASAN: Elbasan. Since: 2.42 * @G_UNICODE_SCRIPT_GRANTHA: Grantha. Since: 2.42 * @G_UNICODE_SCRIPT_KHOJKI: Kjohki. Since: 2.42 * @G_UNICODE_SCRIPT_KHUDAWADI: Khudawadi, Sindhi. Since: 2.42 * @G_UNICODE_SCRIPT_LINEAR_A: Linear A. Since: 2.42 * @G_UNICODE_SCRIPT_MAHAJANI: Mahajani. Since: 2.42 * @G_UNICODE_SCRIPT_MANICHAEAN: Manichaean. Since: 2.42 * @G_UNICODE_SCRIPT_MENDE_KIKAKUI: Mende Kikakui. Since: 2.42 * @G_UNICODE_SCRIPT_MODI: Modi. Since: 2.42 * @G_UNICODE_SCRIPT_MRO: Mro. Since: 2.42 * @G_UNICODE_SCRIPT_NABATAEAN: Nabataean. Since: 2.42 * @G_UNICODE_SCRIPT_OLD_NORTH_ARABIAN: Old North Arabian. Since: 2.42 * @G_UNICODE_SCRIPT_OLD_PERMIC: Old Permic. Since: 2.42 * @G_UNICODE_SCRIPT_PAHAWH_HMONG: Pahawh Hmong. Since: 2.42 * @G_UNICODE_SCRIPT_PALMYRENE: Palmyrene. Since: 2.42 * @G_UNICODE_SCRIPT_PAU_CIN_HAU: Pau Cin Hau. Since: 2.42 * @G_UNICODE_SCRIPT_PSALTER_PAHLAVI: Psalter Pahlavi. Since: 2.42 * @G_UNICODE_SCRIPT_SIDDHAM: Siddham. Since: 2.42 * @G_UNICODE_SCRIPT_TIRHUTA: Tirhuta. Since: 2.42 * @G_UNICODE_SCRIPT_WARANG_CITI: Warang Citi. Since: 2.42 * @G_UNICODE_SCRIPT_AHOM: Ahom. Since: 2.48 * @G_UNICODE_SCRIPT_ANATOLIAN_HIEROGLYPHS: Anatolian Hieroglyphs. Since: 2.48 * @G_UNICODE_SCRIPT_HATRAN: Hatran. Since: 2.48 * @G_UNICODE_SCRIPT_MULTANI: Multani. Since: 2.48 * @G_UNICODE_SCRIPT_OLD_HUNGARIAN: Old Hungarian. Since: 2.48 * @G_UNICODE_SCRIPT_SIGNWRITING: Signwriting. Since: 2.48 * @G_UNICODE_SCRIPT_ADLAM: Adlam. Since: 2.50 * @G_UNICODE_SCRIPT_BHAIKSUKI: Bhaiksuki. Since: 2.50 * @G_UNICODE_SCRIPT_MARCHEN: Marchen. Since: 2.50 * @G_UNICODE_SCRIPT_NEWA: Newa. Since: 2.50 * @G_UNICODE_SCRIPT_OSAGE: Osage. Since: 2.50 * @G_UNICODE_SCRIPT_TANGUT: Tangut. Since: 2.50 * @G_UNICODE_SCRIPT_MASARAM_GONDI: Masaram Gondi. Since: 2.54 * @G_UNICODE_SCRIPT_NUSHU: Nushu. Since: 2.54 * @G_UNICODE_SCRIPT_SOYOMBO: Soyombo. Since: 2.54 * @G_UNICODE_SCRIPT_ZANABAZAR_SQUARE: Zanabazar Square. Since: 2.54 * @G_UNICODE_SCRIPT_DOGRA: Dogra. Since: 2.58 * @G_UNICODE_SCRIPT_GUNJALA_GONDI: Gunjala Gondi. Since: 2.58 * @G_UNICODE_SCRIPT_HANIFI_ROHINGYA: Hanifi Rohingya. Since: 2.58 * @G_UNICODE_SCRIPT_MAKASAR: Makasar. Since: 2.58 * @G_UNICODE_SCRIPT_MEDEFAIDRIN: Medefaidrin. Since: 2.58 * @G_UNICODE_SCRIPT_OLD_SOGDIAN: Old Sogdian. Since: 2.58 * @G_UNICODE_SCRIPT_SOGDIAN: Sogdian. Since: 2.58 * @G_UNICODE_SCRIPT_ELYMAIC: Elym. Since: 2.62 * @G_UNICODE_SCRIPT_NANDINAGARI: Nand. Since: 2.62 * @G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG: Rohg. Since: 2.62 * @G_UNICODE_SCRIPT_WANCHO: Wcho. Since: 2.62 * @G_UNICODE_SCRIPT_CHORASMIAN: Chorasmian. Since: 2.66 * @G_UNICODE_SCRIPT_DIVES_AKURU: Dives Akuru. Since: 2.66 * @G_UNICODE_SCRIPT_KHITAN_SMALL_SCRIPT: Khitan small script. Since: 2.66 * @G_UNICODE_SCRIPT_YEZIDI: Yezidi. Since: 2.66 * * The #GUnicodeScript enumeration identifies different writing * systems. The values correspond to the names as defined in the * Unicode standard. The enumeration has been added in GLib 2.14, * and is interchangeable with #PangoScript. * * Note that new types may be added in the future. Applications * should be ready to handle unknown values. * See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr24/). */ typedef enum { /* ISO 15924 code */ G_UNICODE_SCRIPT_INVALID_CODE = -1, G_UNICODE_SCRIPT_COMMON = 0, /* Zyyy */ G_UNICODE_SCRIPT_INHERITED, /* Zinh (Qaai) */ G_UNICODE_SCRIPT_ARABIC, /* Arab */ G_UNICODE_SCRIPT_ARMENIAN, /* Armn */ G_UNICODE_SCRIPT_BENGALI, /* Beng */ G_UNICODE_SCRIPT_BOPOMOFO, /* Bopo */ G_UNICODE_SCRIPT_CHEROKEE, /* Cher */ G_UNICODE_SCRIPT_COPTIC, /* Copt (Qaac) */ G_UNICODE_SCRIPT_CYRILLIC, /* Cyrl (Cyrs) */ G_UNICODE_SCRIPT_DESERET, /* Dsrt */ G_UNICODE_SCRIPT_DEVANAGARI, /* Deva */ G_UNICODE_SCRIPT_ETHIOPIC, /* Ethi */ G_UNICODE_SCRIPT_GEORGIAN, /* Geor (Geon, Geoa) */ G_UNICODE_SCRIPT_GOTHIC, /* Goth */ G_UNICODE_SCRIPT_GREEK, /* Grek */ G_UNICODE_SCRIPT_GUJARATI, /* Gujr */ G_UNICODE_SCRIPT_GURMUKHI, /* Guru */ G_UNICODE_SCRIPT_HAN, /* Hani */ G_UNICODE_SCRIPT_HANGUL, /* Hang */ G_UNICODE_SCRIPT_HEBREW, /* Hebr */ G_UNICODE_SCRIPT_HIRAGANA, /* Hira */ G_UNICODE_SCRIPT_KANNADA, /* Knda */ G_UNICODE_SCRIPT_KATAKANA, /* Kana */ G_UNICODE_SCRIPT_KHMER, /* Khmr */ G_UNICODE_SCRIPT_LAO, /* Laoo */ G_UNICODE_SCRIPT_LATIN, /* Latn (Latf, Latg) */ G_UNICODE_SCRIPT_MALAYALAM, /* Mlym */ G_UNICODE_SCRIPT_MONGOLIAN, /* Mong */ G_UNICODE_SCRIPT_MYANMAR, /* Mymr */ G_UNICODE_SCRIPT_OGHAM, /* Ogam */ G_UNICODE_SCRIPT_OLD_ITALIC, /* Ital */ G_UNICODE_SCRIPT_ORIYA, /* Orya */ G_UNICODE_SCRIPT_RUNIC, /* Runr */ G_UNICODE_SCRIPT_SINHALA, /* Sinh */ G_UNICODE_SCRIPT_SYRIAC, /* Syrc (Syrj, Syrn, Syre) */ G_UNICODE_SCRIPT_TAMIL, /* Taml */ G_UNICODE_SCRIPT_TELUGU, /* Telu */ G_UNICODE_SCRIPT_THAANA, /* Thaa */ G_UNICODE_SCRIPT_THAI, /* Thai */ G_UNICODE_SCRIPT_TIBETAN, /* Tibt */ G_UNICODE_SCRIPT_CANADIAN_ABORIGINAL, /* Cans */ G_UNICODE_SCRIPT_YI, /* Yiii */ G_UNICODE_SCRIPT_TAGALOG, /* Tglg */ G_UNICODE_SCRIPT_HANUNOO, /* Hano */ G_UNICODE_SCRIPT_BUHID, /* Buhd */ G_UNICODE_SCRIPT_TAGBANWA, /* Tagb */ /* Unicode-4.0 additions */ G_UNICODE_SCRIPT_BRAILLE, /* Brai */ G_UNICODE_SCRIPT_CYPRIOT, /* Cprt */ G_UNICODE_SCRIPT_LIMBU, /* Limb */ G_UNICODE_SCRIPT_OSMANYA, /* Osma */ G_UNICODE_SCRIPT_SHAVIAN, /* Shaw */ G_UNICODE_SCRIPT_LINEAR_B, /* Linb */ G_UNICODE_SCRIPT_TAI_LE, /* Tale */ G_UNICODE_SCRIPT_UGARITIC, /* Ugar */ /* Unicode-4.1 additions */ G_UNICODE_SCRIPT_NEW_TAI_LUE, /* Talu */ G_UNICODE_SCRIPT_BUGINESE, /* Bugi */ G_UNICODE_SCRIPT_GLAGOLITIC, /* Glag */ G_UNICODE_SCRIPT_TIFINAGH, /* Tfng */ G_UNICODE_SCRIPT_SYLOTI_NAGRI, /* Sylo */ G_UNICODE_SCRIPT_OLD_PERSIAN, /* Xpeo */ G_UNICODE_SCRIPT_KHAROSHTHI, /* Khar */ /* Unicode-5.0 additions */ G_UNICODE_SCRIPT_UNKNOWN, /* Zzzz */ G_UNICODE_SCRIPT_BALINESE, /* Bali */ G_UNICODE_SCRIPT_CUNEIFORM, /* Xsux */ G_UNICODE_SCRIPT_PHOENICIAN, /* Phnx */ G_UNICODE_SCRIPT_PHAGS_PA, /* Phag */ G_UNICODE_SCRIPT_NKO, /* Nkoo */ /* Unicode-5.1 additions */ G_UNICODE_SCRIPT_KAYAH_LI, /* Kali */ G_UNICODE_SCRIPT_LEPCHA, /* Lepc */ G_UNICODE_SCRIPT_REJANG, /* Rjng */ G_UNICODE_SCRIPT_SUNDANESE, /* Sund */ G_UNICODE_SCRIPT_SAURASHTRA, /* Saur */ G_UNICODE_SCRIPT_CHAM, /* Cham */ G_UNICODE_SCRIPT_OL_CHIKI, /* Olck */ G_UNICODE_SCRIPT_VAI, /* Vaii */ G_UNICODE_SCRIPT_CARIAN, /* Cari */ G_UNICODE_SCRIPT_LYCIAN, /* Lyci */ G_UNICODE_SCRIPT_LYDIAN, /* Lydi */ /* Unicode-5.2 additions */ G_UNICODE_SCRIPT_AVESTAN, /* Avst */ G_UNICODE_SCRIPT_BAMUM, /* Bamu */ G_UNICODE_SCRIPT_EGYPTIAN_HIEROGLYPHS, /* Egyp */ G_UNICODE_SCRIPT_IMPERIAL_ARAMAIC, /* Armi */ G_UNICODE_SCRIPT_INSCRIPTIONAL_PAHLAVI, /* Phli */ G_UNICODE_SCRIPT_INSCRIPTIONAL_PARTHIAN, /* Prti */ G_UNICODE_SCRIPT_JAVANESE, /* Java */ G_UNICODE_SCRIPT_KAITHI, /* Kthi */ G_UNICODE_SCRIPT_LISU, /* Lisu */ G_UNICODE_SCRIPT_MEETEI_MAYEK, /* Mtei */ G_UNICODE_SCRIPT_OLD_SOUTH_ARABIAN, /* Sarb */ G_UNICODE_SCRIPT_OLD_TURKIC, /* Orkh */ G_UNICODE_SCRIPT_SAMARITAN, /* Samr */ G_UNICODE_SCRIPT_TAI_THAM, /* Lana */ G_UNICODE_SCRIPT_TAI_VIET, /* Tavt */ /* Unicode-6.0 additions */ G_UNICODE_SCRIPT_BATAK, /* Batk */ G_UNICODE_SCRIPT_BRAHMI, /* Brah */ G_UNICODE_SCRIPT_MANDAIC, /* Mand */ /* Unicode-6.1 additions */ G_UNICODE_SCRIPT_CHAKMA, /* Cakm */ G_UNICODE_SCRIPT_MEROITIC_CURSIVE, /* Merc */ G_UNICODE_SCRIPT_MEROITIC_HIEROGLYPHS, /* Mero */ G_UNICODE_SCRIPT_MIAO, /* Plrd */ G_UNICODE_SCRIPT_SHARADA, /* Shrd */ G_UNICODE_SCRIPT_SORA_SOMPENG, /* Sora */ G_UNICODE_SCRIPT_TAKRI, /* Takr */ /* Unicode 7.0 additions */ G_UNICODE_SCRIPT_BASSA_VAH, /* Bass */ G_UNICODE_SCRIPT_CAUCASIAN_ALBANIAN, /* Aghb */ G_UNICODE_SCRIPT_DUPLOYAN, /* Dupl */ G_UNICODE_SCRIPT_ELBASAN, /* Elba */ G_UNICODE_SCRIPT_GRANTHA, /* Gran */ G_UNICODE_SCRIPT_KHOJKI, /* Khoj */ G_UNICODE_SCRIPT_KHUDAWADI, /* Sind */ G_UNICODE_SCRIPT_LINEAR_A, /* Lina */ G_UNICODE_SCRIPT_MAHAJANI, /* Mahj */ G_UNICODE_SCRIPT_MANICHAEAN, /* Mani */ G_UNICODE_SCRIPT_MENDE_KIKAKUI, /* Mend */ G_UNICODE_SCRIPT_MODI, /* Modi */ G_UNICODE_SCRIPT_MRO, /* Mroo */ G_UNICODE_SCRIPT_NABATAEAN, /* Nbat */ G_UNICODE_SCRIPT_OLD_NORTH_ARABIAN, /* Narb */ G_UNICODE_SCRIPT_OLD_PERMIC, /* Perm */ G_UNICODE_SCRIPT_PAHAWH_HMONG, /* Hmng */ G_UNICODE_SCRIPT_PALMYRENE, /* Palm */ G_UNICODE_SCRIPT_PAU_CIN_HAU, /* Pauc */ G_UNICODE_SCRIPT_PSALTER_PAHLAVI, /* Phlp */ G_UNICODE_SCRIPT_SIDDHAM, /* Sidd */ G_UNICODE_SCRIPT_TIRHUTA, /* Tirh */ G_UNICODE_SCRIPT_WARANG_CITI, /* Wara */ /* Unicode 8.0 additions */ G_UNICODE_SCRIPT_AHOM, /* Ahom */ G_UNICODE_SCRIPT_ANATOLIAN_HIEROGLYPHS, /* Hluw */ G_UNICODE_SCRIPT_HATRAN, /* Hatr */ G_UNICODE_SCRIPT_MULTANI, /* Mult */ G_UNICODE_SCRIPT_OLD_HUNGARIAN, /* Hung */ G_UNICODE_SCRIPT_SIGNWRITING, /* Sgnw */ /* Unicode 9.0 additions */ G_UNICODE_SCRIPT_ADLAM, /* Adlm */ G_UNICODE_SCRIPT_BHAIKSUKI, /* Bhks */ G_UNICODE_SCRIPT_MARCHEN, /* Marc */ G_UNICODE_SCRIPT_NEWA, /* Newa */ G_UNICODE_SCRIPT_OSAGE, /* Osge */ G_UNICODE_SCRIPT_TANGUT, /* Tang */ /* Unicode 10.0 additions */ G_UNICODE_SCRIPT_MASARAM_GONDI, /* Gonm */ G_UNICODE_SCRIPT_NUSHU, /* Nshu */ G_UNICODE_SCRIPT_SOYOMBO, /* Soyo */ G_UNICODE_SCRIPT_ZANABAZAR_SQUARE, /* Zanb */ /* Unicode 11.0 additions */ G_UNICODE_SCRIPT_DOGRA, /* Dogr */ G_UNICODE_SCRIPT_GUNJALA_GONDI, /* Gong */ G_UNICODE_SCRIPT_HANIFI_ROHINGYA, /* Rohg */ G_UNICODE_SCRIPT_MAKASAR, /* Maka */ G_UNICODE_SCRIPT_MEDEFAIDRIN, /* Medf */ G_UNICODE_SCRIPT_OLD_SOGDIAN, /* Sogo */ G_UNICODE_SCRIPT_SOGDIAN, /* Sogd */ /* Unicode 12.0 additions */ G_UNICODE_SCRIPT_ELYMAIC, /* Elym */ G_UNICODE_SCRIPT_NANDINAGARI, /* Nand */ G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG, /* Rohg */ G_UNICODE_SCRIPT_WANCHO, /* Wcho */ /* Unicode 13.0 additions */ G_UNICODE_SCRIPT_CHORASMIAN, /* Chrs */ G_UNICODE_SCRIPT_DIVES_AKURU, /* Diak */ G_UNICODE_SCRIPT_KHITAN_SMALL_SCRIPT, /* Kits */ G_UNICODE_SCRIPT_YEZIDI /* Yezi */ } GUnicodeScript; GLIB_AVAILABLE_IN_ALL guint32 g_unicode_script_to_iso15924 (GUnicodeScript script); GLIB_AVAILABLE_IN_ALL GUnicodeScript g_unicode_script_from_iso15924 (guint32 iso15924); /* These are all analogs of the <ctype.h> functions. */ GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isalnum (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isalpha (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_iscntrl (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isdigit (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isgraph (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_islower (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isprint (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_ispunct (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isspace (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isupper (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isxdigit (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_istitle (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_isdefined (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_iswide (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_iswide_cjk(gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_iszerowidth(gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_ismark (gunichar c) G_GNUC_CONST; /* More <ctype.h> functions. These convert between the three cases. * See the Unicode book to understand title case. */ GLIB_AVAILABLE_IN_ALL gunichar g_unichar_toupper (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gunichar g_unichar_tolower (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gunichar g_unichar_totitle (gunichar c) G_GNUC_CONST; /* If C is a digit (according to 'g_unichar_isdigit'), then return its numeric value. Otherwise return -1. */ GLIB_AVAILABLE_IN_ALL gint g_unichar_digit_value (gunichar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gint g_unichar_xdigit_value (gunichar c) G_GNUC_CONST; /* Return the Unicode character type of a given character. */ GLIB_AVAILABLE_IN_ALL GUnicodeType g_unichar_type (gunichar c) G_GNUC_CONST; /* Return the line break property for a given character */ GLIB_AVAILABLE_IN_ALL GUnicodeBreakType g_unichar_break_type (gunichar c) G_GNUC_CONST; /* Returns the combining class for a given character */ GLIB_AVAILABLE_IN_ALL gint g_unichar_combining_class (gunichar uc) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_unichar_get_mirror_char (gunichar ch, gunichar *mirrored_ch); GLIB_AVAILABLE_IN_ALL GUnicodeScript g_unichar_get_script (gunichar ch) G_GNUC_CONST; /* Validate a Unicode character */ GLIB_AVAILABLE_IN_ALL gboolean g_unichar_validate (gunichar ch) G_GNUC_CONST; /* Pairwise canonical compose/decompose */ GLIB_AVAILABLE_IN_ALL gboolean g_unichar_compose (gunichar a, gunichar b, gunichar *ch); GLIB_AVAILABLE_IN_ALL gboolean g_unichar_decompose (gunichar ch, gunichar *a, gunichar *b); GLIB_AVAILABLE_IN_ALL gsize g_unichar_fully_decompose (gunichar ch, gboolean compat, gunichar *result, gsize result_len); /** * G_UNICHAR_MAX_DECOMPOSITION_LENGTH: * * The maximum length (in codepoints) of a compatibility or canonical * decomposition of a single Unicode character. * * This is as defined by Unicode 6.1. * * Since: 2.32 */ #define G_UNICHAR_MAX_DECOMPOSITION_LENGTH 18 /* codepoints */ /* Compute canonical ordering of a string in-place. This rearranges decomposed characters in the string according to their combining classes. See the Unicode manual for more information. */ GLIB_AVAILABLE_IN_ALL void g_unicode_canonical_ordering (gunichar *string, gsize len); GLIB_DEPRECATED_IN_2_30 gunichar *g_unicode_canonical_decomposition (gunichar ch, gsize *result_len) G_GNUC_MALLOC; /* Array of skip-bytes-per-initial character. */ GLIB_VAR const gchar * const g_utf8_skip; /** * g_utf8_next_char: * @p: Pointer to the start of a valid UTF-8 character * * Skips to the next character in a UTF-8 string. The string must be * valid; this macro is as fast as possible, and has no error-checking. * You would use this macro to iterate over a string character by * character. The macro returns the start of the next UTF-8 character. * Before using this macro, use g_utf8_validate() to validate strings * that may contain invalid UTF-8. */ #define g_utf8_next_char(p) (char *)((p) + g_utf8_skip[*(const guchar *)(p)]) GLIB_AVAILABLE_IN_ALL gunichar g_utf8_get_char (const gchar *p) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gunichar g_utf8_get_char_validated (const gchar *p, gssize max_len) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gchar* g_utf8_offset_to_pointer (const gchar *str, glong offset) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL glong g_utf8_pointer_to_offset (const gchar *str, const gchar *pos) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gchar* g_utf8_prev_char (const gchar *p) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gchar* g_utf8_find_next_char (const gchar *p, const gchar *end) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gchar* g_utf8_find_prev_char (const gchar *str, const gchar *p) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL glong g_utf8_strlen (const gchar *p, gssize max) G_GNUC_PURE; GLIB_AVAILABLE_IN_2_30 gchar *g_utf8_substring (const gchar *str, glong start_pos, glong end_pos) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_strncpy (gchar *dest, const gchar *src, gsize n); /* Find the UTF-8 character corresponding to ch, in string p. These functions are equivalants to strchr and strrchr */ GLIB_AVAILABLE_IN_ALL gchar* g_utf8_strchr (const gchar *p, gssize len, gunichar c); GLIB_AVAILABLE_IN_ALL gchar* g_utf8_strrchr (const gchar *p, gssize len, gunichar c); GLIB_AVAILABLE_IN_ALL gchar* g_utf8_strreverse (const gchar *str, gssize len); GLIB_AVAILABLE_IN_ALL gunichar2 *g_utf8_to_utf16 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gunichar * g_utf8_to_ucs4 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gunichar * g_utf8_to_ucs4_fast (const gchar *str, glong len, glong *items_written) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gunichar * g_utf16_to_ucs4 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_utf16_to_utf8 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gunichar2 *g_ucs4_to_utf16 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_ucs4_to_utf8 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gint g_unichar_to_utf8 (gunichar c, gchar *outbuf); GLIB_AVAILABLE_IN_ALL gboolean g_utf8_validate (const gchar *str, gssize max_len, const gchar **end); GLIB_AVAILABLE_IN_2_60 gboolean g_utf8_validate_len (const gchar *str, gsize max_len, const gchar **end); GLIB_AVAILABLE_IN_ALL gchar *g_utf8_strup (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_strdown (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_casefold (const gchar *str, gssize len) G_GNUC_MALLOC; /** * GNormalizeMode: * @G_NORMALIZE_DEFAULT: standardize differences that do not affect the * text content, such as the above-mentioned accent representation * @G_NORMALIZE_NFD: another name for %G_NORMALIZE_DEFAULT * @G_NORMALIZE_DEFAULT_COMPOSE: like %G_NORMALIZE_DEFAULT, but with * composed forms rather than a maximally decomposed form * @G_NORMALIZE_NFC: another name for %G_NORMALIZE_DEFAULT_COMPOSE * @G_NORMALIZE_ALL: beyond %G_NORMALIZE_DEFAULT also standardize the * "compatibility" characters in Unicode, such as SUPERSCRIPT THREE * to the standard forms (in this case DIGIT THREE). Formatting * information may be lost but for most text operations such * characters should be considered the same * @G_NORMALIZE_NFKD: another name for %G_NORMALIZE_ALL * @G_NORMALIZE_ALL_COMPOSE: like %G_NORMALIZE_ALL, but with composed * forms rather than a maximally decomposed form * @G_NORMALIZE_NFKC: another name for %G_NORMALIZE_ALL_COMPOSE * * Defines how a Unicode string is transformed in a canonical * form, standardizing such issues as whether a character with * an accent is represented as a base character and combining * accent or as a single precomposed character. Unicode strings * should generally be normalized before comparing them. */ typedef enum { G_NORMALIZE_DEFAULT, G_NORMALIZE_NFD = G_NORMALIZE_DEFAULT, G_NORMALIZE_DEFAULT_COMPOSE, G_NORMALIZE_NFC = G_NORMALIZE_DEFAULT_COMPOSE, G_NORMALIZE_ALL, G_NORMALIZE_NFKD = G_NORMALIZE_ALL, G_NORMALIZE_ALL_COMPOSE, G_NORMALIZE_NFKC = G_NORMALIZE_ALL_COMPOSE } GNormalizeMode; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_normalize (const gchar *str, gssize len, GNormalizeMode mode) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gint g_utf8_collate (const gchar *str1, const gchar *str2) G_GNUC_PURE; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_collate_key (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_utf8_collate_key_for_filename (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_52 gchar *g_utf8_make_valid (const gchar *str, gssize len) G_GNUC_MALLOC; G_END_DECLS #endif /* __G_UNICODE_H__ */ glib/gdate.h 0000644 00000030204 15125173650 0006722 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_DATE_H__ #define __G_DATE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <time.h> #include <glib/gtypes.h> #include <glib/gquark.h> G_BEGIN_DECLS /* GDate * * Date calculations (not time for now, to be resolved). These are a * mutant combination of Steffen Beyer's DateCalc routines * (http://www.perl.com/CPAN/authors/id/STBEY/) and Jon Trowbridge's * date routines (written for in-house software). Written by Havoc * Pennington <hp@pobox.com> */ typedef gint32 GTime GLIB_DEPRECATED_TYPE_IN_2_62_FOR(GDateTime); typedef guint16 GDateYear; typedef guint8 GDateDay; /* day of the month */ typedef struct _GDate GDate; /* enum used to specify order of appearance in parsed date strings */ typedef enum { G_DATE_DAY = 0, G_DATE_MONTH = 1, G_DATE_YEAR = 2 } GDateDMY; /* actual week and month values */ typedef enum { G_DATE_BAD_WEEKDAY = 0, G_DATE_MONDAY = 1, G_DATE_TUESDAY = 2, G_DATE_WEDNESDAY = 3, G_DATE_THURSDAY = 4, G_DATE_FRIDAY = 5, G_DATE_SATURDAY = 6, G_DATE_SUNDAY = 7 } GDateWeekday; typedef enum { G_DATE_BAD_MONTH = 0, G_DATE_JANUARY = 1, G_DATE_FEBRUARY = 2, G_DATE_MARCH = 3, G_DATE_APRIL = 4, G_DATE_MAY = 5, G_DATE_JUNE = 6, G_DATE_JULY = 7, G_DATE_AUGUST = 8, G_DATE_SEPTEMBER = 9, G_DATE_OCTOBER = 10, G_DATE_NOVEMBER = 11, G_DATE_DECEMBER = 12 } GDateMonth; #define G_DATE_BAD_JULIAN 0U #define G_DATE_BAD_DAY 0U #define G_DATE_BAD_YEAR 0U /* Note: directly manipulating structs is generally a bad idea, but * in this case it's an *incredibly* bad idea, because all or part * of this struct can be invalid at any given time. Use the functions, * or you will get hosed, I promise. */ struct _GDate { guint julian_days : 32; /* julian days representation - we use a * bitfield hoping that 64 bit platforms * will pack this whole struct in one big * int */ guint julian : 1; /* julian is valid */ guint dmy : 1; /* dmy is valid */ /* DMY representation */ guint day : 6; guint month : 4; guint year : 16; }; /* g_date_new() returns an invalid date, you then have to _set() stuff * to get a usable object. You can also allocate a GDate statically, * then call g_date_clear() to initialize. */ GLIB_AVAILABLE_IN_ALL GDate* g_date_new (void); GLIB_AVAILABLE_IN_ALL GDate* g_date_new_dmy (GDateDay day, GDateMonth month, GDateYear year); GLIB_AVAILABLE_IN_ALL GDate* g_date_new_julian (guint32 julian_day); GLIB_AVAILABLE_IN_ALL void g_date_free (GDate *date); GLIB_AVAILABLE_IN_2_56 GDate* g_date_copy (const GDate *date); /* check g_date_valid() after doing an operation that might fail, like * _parse. Almost all g_date operations are undefined on invalid * dates (the exceptions are the mutators, since you need those to * return to validity). */ GLIB_AVAILABLE_IN_ALL gboolean g_date_valid (const GDate *date); GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_day (GDateDay day) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_month (GDateMonth month) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_year (GDateYear year) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_weekday (GDateWeekday weekday) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_julian (guint32 julian_date) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_date_valid_dmy (GDateDay day, GDateMonth month, GDateYear year) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GDateWeekday g_date_get_weekday (const GDate *date); GLIB_AVAILABLE_IN_ALL GDateMonth g_date_get_month (const GDate *date); GLIB_AVAILABLE_IN_ALL GDateYear g_date_get_year (const GDate *date); GLIB_AVAILABLE_IN_ALL GDateDay g_date_get_day (const GDate *date); GLIB_AVAILABLE_IN_ALL guint32 g_date_get_julian (const GDate *date); GLIB_AVAILABLE_IN_ALL guint g_date_get_day_of_year (const GDate *date); /* First monday/sunday is the start of week 1; if we haven't reached * that day, return 0. These are not ISO weeks of the year; that * routine needs to be added. * these functions return the number of weeks, starting on the * corrsponding day */ GLIB_AVAILABLE_IN_ALL guint g_date_get_monday_week_of_year (const GDate *date); GLIB_AVAILABLE_IN_ALL guint g_date_get_sunday_week_of_year (const GDate *date); GLIB_AVAILABLE_IN_ALL guint g_date_get_iso8601_week_of_year (const GDate *date); /* If you create a static date struct you need to clear it to get it * in a safe state before use. You can clear a whole array at * once with the ndates argument. */ GLIB_AVAILABLE_IN_ALL void g_date_clear (GDate *date, guint n_dates); /* The parse routine is meant for dates typed in by a user, so it * permits many formats but tries to catch common typos. If your data * needs to be strictly validated, it is not an appropriate function. */ GLIB_AVAILABLE_IN_ALL void g_date_set_parse (GDate *date, const gchar *str); GLIB_AVAILABLE_IN_ALL void g_date_set_time_t (GDate *date, time_t timet); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_date_set_time_t) void g_date_set_time_val (GDate *date, GTimeVal *timeval); GLIB_DEPRECATED_FOR(g_date_set_time_t) void g_date_set_time (GDate *date, GTime time_); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL void g_date_set_month (GDate *date, GDateMonth month); GLIB_AVAILABLE_IN_ALL void g_date_set_day (GDate *date, GDateDay day); GLIB_AVAILABLE_IN_ALL void g_date_set_year (GDate *date, GDateYear year); GLIB_AVAILABLE_IN_ALL void g_date_set_dmy (GDate *date, GDateDay day, GDateMonth month, GDateYear y); GLIB_AVAILABLE_IN_ALL void g_date_set_julian (GDate *date, guint32 julian_date); GLIB_AVAILABLE_IN_ALL gboolean g_date_is_first_of_month (const GDate *date); GLIB_AVAILABLE_IN_ALL gboolean g_date_is_last_of_month (const GDate *date); /* To go forward by some number of weeks just go forward weeks*7 days */ GLIB_AVAILABLE_IN_ALL void g_date_add_days (GDate *date, guint n_days); GLIB_AVAILABLE_IN_ALL void g_date_subtract_days (GDate *date, guint n_days); /* If you add/sub months while day > 28, the day might change */ GLIB_AVAILABLE_IN_ALL void g_date_add_months (GDate *date, guint n_months); GLIB_AVAILABLE_IN_ALL void g_date_subtract_months (GDate *date, guint n_months); /* If it's feb 29, changing years can move you to the 28th */ GLIB_AVAILABLE_IN_ALL void g_date_add_years (GDate *date, guint n_years); GLIB_AVAILABLE_IN_ALL void g_date_subtract_years (GDate *date, guint n_years); GLIB_AVAILABLE_IN_ALL gboolean g_date_is_leap_year (GDateYear year) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL guint8 g_date_get_days_in_month (GDateMonth month, GDateYear year) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL guint8 g_date_get_monday_weeks_in_year (GDateYear year) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL guint8 g_date_get_sunday_weeks_in_year (GDateYear year) G_GNUC_CONST; /* Returns the number of days between the two dates. If date2 comes before date1, a negative value is return. */ GLIB_AVAILABLE_IN_ALL gint g_date_days_between (const GDate *date1, const GDate *date2); /* qsort-friendly (with a cast...) */ GLIB_AVAILABLE_IN_ALL gint g_date_compare (const GDate *lhs, const GDate *rhs); GLIB_AVAILABLE_IN_ALL void g_date_to_struct_tm (const GDate *date, struct tm *tm); GLIB_AVAILABLE_IN_ALL void g_date_clamp (GDate *date, const GDate *min_date, const GDate *max_date); /* Swap date1 and date2's values if date1 > date2. */ GLIB_AVAILABLE_IN_ALL void g_date_order (GDate *date1, GDate *date2); /* Just like strftime() except you can only use date-related formats. * Using a time format is undefined. */ GLIB_AVAILABLE_IN_ALL gsize g_date_strftime (gchar *s, gsize slen, const gchar *format, const GDate *date); #define g_date_weekday g_date_get_weekday GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_weekday) #define g_date_month g_date_get_month GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_month) #define g_date_year g_date_get_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_year) #define g_date_day g_date_get_day GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_day) #define g_date_julian g_date_get_julian GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_julian) #define g_date_day_of_year g_date_get_day_of_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_day_of_year) #define g_date_monday_week_of_year g_date_get_monday_week_of_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_monday_week_of_year) #define g_date_sunday_week_of_year g_date_get_sunday_week_of_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_sunday_week_of_year) #define g_date_days_in_month g_date_get_days_in_month GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_days_in_month) #define g_date_monday_weeks_in_year g_date_get_monday_weeks_in_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_monday_weeks_in_year) #define g_date_sunday_weeks_in_year g_date_get_sunday_weeks_in_year GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_date_get_sunday_weeks_in_year) G_END_DECLS #endif /* __G_DATE_H__ */ glib/garray.h 0000644 00000026171 15125173650 0007133 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_ARRAY_H__ #define __G_ARRAY_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GBytes GBytes; typedef struct _GArray GArray; typedef struct _GByteArray GByteArray; typedef struct _GPtrArray GPtrArray; struct _GArray { gchar *data; guint len; }; struct _GByteArray { guint8 *data; guint len; }; struct _GPtrArray { gpointer *pdata; guint len; }; /* Resizable arrays. remove fills any cleared spot and shortens the * array, while preserving the order. remove_fast will distort the * order by moving the last element to the position of the removed. */ #define g_array_append_val(a,v) g_array_append_vals (a, &(v), 1) #define g_array_prepend_val(a,v) g_array_prepend_vals (a, &(v), 1) #define g_array_insert_val(a,i,v) g_array_insert_vals (a, i, &(v), 1) #define g_array_index(a,t,i) (((t*) (void *) (a)->data) [(i)]) GLIB_AVAILABLE_IN_ALL GArray* g_array_new (gboolean zero_terminated, gboolean clear_, guint element_size); GLIB_AVAILABLE_IN_2_64 gpointer g_array_steal (GArray *array, gsize *len); GLIB_AVAILABLE_IN_ALL GArray* g_array_sized_new (gboolean zero_terminated, gboolean clear_, guint element_size, guint reserved_size); GLIB_AVAILABLE_IN_2_62 GArray* g_array_copy (GArray *array); GLIB_AVAILABLE_IN_ALL gchar* g_array_free (GArray *array, gboolean free_segment); GLIB_AVAILABLE_IN_ALL GArray *g_array_ref (GArray *array); GLIB_AVAILABLE_IN_ALL void g_array_unref (GArray *array); GLIB_AVAILABLE_IN_ALL guint g_array_get_element_size (GArray *array); GLIB_AVAILABLE_IN_ALL GArray* g_array_append_vals (GArray *array, gconstpointer data, guint len); GLIB_AVAILABLE_IN_ALL GArray* g_array_prepend_vals (GArray *array, gconstpointer data, guint len); GLIB_AVAILABLE_IN_ALL GArray* g_array_insert_vals (GArray *array, guint index_, gconstpointer data, guint len); GLIB_AVAILABLE_IN_ALL GArray* g_array_set_size (GArray *array, guint length); GLIB_AVAILABLE_IN_ALL GArray* g_array_remove_index (GArray *array, guint index_); GLIB_AVAILABLE_IN_ALL GArray* g_array_remove_index_fast (GArray *array, guint index_); GLIB_AVAILABLE_IN_ALL GArray* g_array_remove_range (GArray *array, guint index_, guint length); GLIB_AVAILABLE_IN_ALL void g_array_sort (GArray *array, GCompareFunc compare_func); GLIB_AVAILABLE_IN_ALL void g_array_sort_with_data (GArray *array, GCompareDataFunc compare_func, gpointer user_data); GLIB_AVAILABLE_IN_2_62 gboolean g_array_binary_search (GArray *array, gconstpointer target, GCompareFunc compare_func, guint *out_match_index); GLIB_AVAILABLE_IN_ALL void g_array_set_clear_func (GArray *array, GDestroyNotify clear_func); /* Resizable pointer array. This interface is much less complicated * than the above. Add appends a pointer. Remove fills any cleared * spot and shortens the array. remove_fast will again distort order. */ #define g_ptr_array_index(array,index_) ((array)->pdata)[index_] GLIB_AVAILABLE_IN_ALL GPtrArray* g_ptr_array_new (void); GLIB_AVAILABLE_IN_ALL GPtrArray* g_ptr_array_new_with_free_func (GDestroyNotify element_free_func); GLIB_AVAILABLE_IN_2_64 gpointer* g_ptr_array_steal (GPtrArray *array, gsize *len); GLIB_AVAILABLE_IN_2_62 GPtrArray *g_ptr_array_copy (GPtrArray *array, GCopyFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL GPtrArray* g_ptr_array_sized_new (guint reserved_size); GLIB_AVAILABLE_IN_ALL GPtrArray* g_ptr_array_new_full (guint reserved_size, GDestroyNotify element_free_func); GLIB_AVAILABLE_IN_ALL gpointer* g_ptr_array_free (GPtrArray *array, gboolean free_seg); GLIB_AVAILABLE_IN_ALL GPtrArray* g_ptr_array_ref (GPtrArray *array); GLIB_AVAILABLE_IN_ALL void g_ptr_array_unref (GPtrArray *array); GLIB_AVAILABLE_IN_ALL void g_ptr_array_set_free_func (GPtrArray *array, GDestroyNotify element_free_func); GLIB_AVAILABLE_IN_ALL void g_ptr_array_set_size (GPtrArray *array, gint length); GLIB_AVAILABLE_IN_ALL gpointer g_ptr_array_remove_index (GPtrArray *array, guint index_); GLIB_AVAILABLE_IN_ALL gpointer g_ptr_array_remove_index_fast (GPtrArray *array, guint index_); GLIB_AVAILABLE_IN_2_58 gpointer g_ptr_array_steal_index (GPtrArray *array, guint index_); GLIB_AVAILABLE_IN_2_58 gpointer g_ptr_array_steal_index_fast (GPtrArray *array, guint index_); GLIB_AVAILABLE_IN_ALL gboolean g_ptr_array_remove (GPtrArray *array, gpointer data); GLIB_AVAILABLE_IN_ALL gboolean g_ptr_array_remove_fast (GPtrArray *array, gpointer data); GLIB_AVAILABLE_IN_ALL GPtrArray *g_ptr_array_remove_range (GPtrArray *array, guint index_, guint length); GLIB_AVAILABLE_IN_ALL void g_ptr_array_add (GPtrArray *array, gpointer data); GLIB_AVAILABLE_IN_2_62 void g_ptr_array_extend (GPtrArray *array_to_extend, GPtrArray *array, GCopyFunc func, gpointer user_data); GLIB_AVAILABLE_IN_2_62 void g_ptr_array_extend_and_steal (GPtrArray *array_to_extend, GPtrArray *array); GLIB_AVAILABLE_IN_2_40 void g_ptr_array_insert (GPtrArray *array, gint index_, gpointer data); GLIB_AVAILABLE_IN_ALL void g_ptr_array_sort (GPtrArray *array, GCompareFunc compare_func); GLIB_AVAILABLE_IN_ALL void g_ptr_array_sort_with_data (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_ptr_array_foreach (GPtrArray *array, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_2_54 gboolean g_ptr_array_find (GPtrArray *haystack, gconstpointer needle, guint *index_); GLIB_AVAILABLE_IN_2_54 gboolean g_ptr_array_find_with_equal_func (GPtrArray *haystack, gconstpointer needle, GEqualFunc equal_func, guint *index_); /* Byte arrays, an array of guint8. Implemented as a GArray, * but type-safe. */ GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_new (void); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_new_take (guint8 *data, gsize len); GLIB_AVAILABLE_IN_2_64 guint8* g_byte_array_steal (GByteArray *array, gsize *len); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_sized_new (guint reserved_size); GLIB_AVAILABLE_IN_ALL guint8* g_byte_array_free (GByteArray *array, gboolean free_segment); GLIB_AVAILABLE_IN_ALL GBytes* g_byte_array_free_to_bytes (GByteArray *array); GLIB_AVAILABLE_IN_ALL GByteArray *g_byte_array_ref (GByteArray *array); GLIB_AVAILABLE_IN_ALL void g_byte_array_unref (GByteArray *array); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_append (GByteArray *array, const guint8 *data, guint len); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_prepend (GByteArray *array, const guint8 *data, guint len); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_set_size (GByteArray *array, guint length); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_remove_index (GByteArray *array, guint index_); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_remove_index_fast (GByteArray *array, guint index_); GLIB_AVAILABLE_IN_ALL GByteArray* g_byte_array_remove_range (GByteArray *array, guint index_, guint length); GLIB_AVAILABLE_IN_ALL void g_byte_array_sort (GByteArray *array, GCompareFunc compare_func); GLIB_AVAILABLE_IN_ALL void g_byte_array_sort_with_data (GByteArray *array, GCompareDataFunc compare_func, gpointer user_data); G_END_DECLS #endif /* __G_ARRAY_H__ */ glib/gi18n.h 0000644 00000002217 15125173650 0006567 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997, 2002 Peter Mattis, Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_I18N_H__ #define __G_I18N_H__ #include <glib.h> #include <libintl.h> #include <string.h> #define _(String) gettext (String) #define Q_(String) g_dpgettext (NULL, String, 0) #define N_(String) (String) #define C_(Context,String) g_dpgettext (NULL, Context "\004" String, strlen (Context) + 1) #define NC_(Context, String) (String) #endif /* __G_I18N_H__ */ glib/gwin32.h 0000644 00000011073 15125173650 0006752 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_WIN32_H__ #define __G_WIN32_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #ifdef G_PLATFORM_WIN32 G_BEGIN_DECLS #ifndef MAXPATHLEN #define MAXPATHLEN 1024 #endif #ifdef G_OS_WIN32 /* * To get prototypes for the following POSIXish functions, you have to * include the indicated non-POSIX headers. The functions are defined * in OLDNAMES.LIB (MSVC) or -lmoldname-msvc (mingw32). But note that * for POSIX functions that take or return file names in the system * codepage, in many cases you would want to use the GLib wrappers in * gstdio.h and UTF-8 instead. * * getcwd: <direct.h> (MSVC), <io.h> (mingw32) * getpid: <process.h> * access: <io.h> * unlink: <stdio.h> or <io.h> * open, read, write, lseek, close: <io.h> * rmdir: <io.h> * pipe: <io.h> (actually, _pipe()) */ /* For some POSIX functions that are not provided by the MS runtime, * we provide emulation functions in glib, which are prefixed with * g_win32_. Or that was the idea at some time, but there is just one * of those: */ GLIB_AVAILABLE_IN_ALL gint g_win32_ftruncate (gint f, guint size); #endif /* G_OS_WIN32 */ /* The MS setlocale uses locale names of the form "English_United * States.1252" etc. We want the Unixish standard form "en", "zh_TW" * etc. This function gets the current thread locale from Windows and * returns it as a string of the above form for use in forming file * names etc. The returned string should be deallocated with g_free(). */ GLIB_AVAILABLE_IN_ALL gchar* g_win32_getlocale (void); /* Translate a Win32 error code (as returned by GetLastError()) into * the corresponding message. The returned string should be deallocated * with g_free(). */ GLIB_AVAILABLE_IN_ALL gchar* g_win32_error_message (gint error); GLIB_DEPRECATED gchar* g_win32_get_package_installation_directory (const gchar *package, const gchar *dll_name); GLIB_DEPRECATED gchar* g_win32_get_package_installation_subdirectory (const gchar *package, const gchar *dll_name, const gchar *subdir); GLIB_AVAILABLE_IN_ALL gchar* g_win32_get_package_installation_directory_of_module (gpointer hmodule); GLIB_DEPRECATED_IN_2_44_FOR(g_win32_check_windows_version) guint g_win32_get_windows_version (void); GLIB_AVAILABLE_IN_ALL gchar* g_win32_locale_filename_from_utf8 (const gchar *utf8filename); GLIB_AVAILABLE_IN_2_40 gchar ** g_win32_get_command_line (void); /* As of GLib 2.14 we only support NT-based Windows */ #define G_WIN32_IS_NT_BASED() TRUE #define G_WIN32_HAVE_WIDECHAR_API() TRUE /** * GWin32OSType: * @G_WIN32_OS_ANY: The running system can be a workstation or a server edition of * Windows. The type of the running system is therefore not checked. * @G_WIN32_OS_WORKSTATION: The running system is a workstation edition of Windows, * such as Windows 7 Professional. * @G_WIN32_OS_SERVER: The running system is a server edition of Windows, such as * Windows Server 2008 R2. * * Type of Windows edition to check for at run-time. **/ typedef enum { G_WIN32_OS_ANY, G_WIN32_OS_WORKSTATION, G_WIN32_OS_SERVER, } GWin32OSType; GLIB_AVAILABLE_IN_2_44 gboolean g_win32_check_windows_version (const gint major, const gint minor, const gint spver, const GWin32OSType os_type); G_END_DECLS #endif /* G_PLATFORM_WIN32 */ #endif /* __G_WIN32_H__ */ glib/gthread.h 0000644 00000044506 15125173650 0007266 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_THREAD_H__ #define __G_THREAD_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gatomic.h> #include <glib/gerror.h> #include <glib/gutils.h> G_BEGIN_DECLS #define G_THREAD_ERROR g_thread_error_quark () GLIB_AVAILABLE_IN_ALL GQuark g_thread_error_quark (void); typedef enum { G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */ } GThreadError; typedef gpointer (*GThreadFunc) (gpointer data); typedef struct _GThread GThread; typedef union _GMutex GMutex; typedef struct _GRecMutex GRecMutex; typedef struct _GRWLock GRWLock; typedef struct _GCond GCond; typedef struct _GPrivate GPrivate; typedef struct _GOnce GOnce; union _GMutex { /*< private >*/ gpointer p; guint i[2]; }; struct _GRWLock { /*< private >*/ gpointer p; guint i[2]; }; struct _GCond { /*< private >*/ gpointer p; guint i[2]; }; struct _GRecMutex { /*< private >*/ gpointer p; guint i[2]; }; #define G_PRIVATE_INIT(notify) { NULL, (notify), { NULL, NULL } } struct _GPrivate { /*< private >*/ gpointer p; GDestroyNotify notify; gpointer future[2]; }; typedef enum { G_ONCE_STATUS_NOTCALLED, G_ONCE_STATUS_PROGRESS, G_ONCE_STATUS_READY } GOnceStatus; #define G_ONCE_INIT { G_ONCE_STATUS_NOTCALLED, NULL } struct _GOnce { volatile GOnceStatus status; volatile gpointer retval; }; #define G_LOCK_NAME(name) g__ ## name ## _lock #define G_LOCK_DEFINE_STATIC(name) static G_LOCK_DEFINE (name) #define G_LOCK_DEFINE(name) GMutex G_LOCK_NAME (name) #define G_LOCK_EXTERN(name) extern GMutex G_LOCK_NAME (name) #ifdef G_DEBUG_LOCKS # define G_LOCK(name) G_STMT_START{ \ g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ "file %s: line %d (%s): locking: %s ", \ __FILE__, __LINE__, G_STRFUNC, \ #name); \ g_mutex_lock (&G_LOCK_NAME (name)); \ }G_STMT_END # define G_UNLOCK(name) G_STMT_START{ \ g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ "file %s: line %d (%s): unlocking: %s ", \ __FILE__, __LINE__, G_STRFUNC, \ #name); \ g_mutex_unlock (&G_LOCK_NAME (name)); \ }G_STMT_END # define G_TRYLOCK(name) \ (g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ "file %s: line %d (%s): try locking: %s ", \ __FILE__, __LINE__, G_STRFUNC, \ #name), g_mutex_trylock (&G_LOCK_NAME (name))) #else /* !G_DEBUG_LOCKS */ # define G_LOCK(name) g_mutex_lock (&G_LOCK_NAME (name)) # define G_UNLOCK(name) g_mutex_unlock (&G_LOCK_NAME (name)) # define G_TRYLOCK(name) g_mutex_trylock (&G_LOCK_NAME (name)) #endif /* !G_DEBUG_LOCKS */ GLIB_AVAILABLE_IN_2_32 GThread * g_thread_ref (GThread *thread); GLIB_AVAILABLE_IN_2_32 void g_thread_unref (GThread *thread); GLIB_AVAILABLE_IN_2_32 GThread * g_thread_new (const gchar *name, GThreadFunc func, gpointer data); GLIB_AVAILABLE_IN_2_32 GThread * g_thread_try_new (const gchar *name, GThreadFunc func, gpointer data, GError **error); GLIB_AVAILABLE_IN_ALL GThread * g_thread_self (void); GLIB_AVAILABLE_IN_ALL void g_thread_exit (gpointer retval); GLIB_AVAILABLE_IN_ALL gpointer g_thread_join (GThread *thread); GLIB_AVAILABLE_IN_ALL void g_thread_yield (void); GLIB_AVAILABLE_IN_2_32 void g_mutex_init (GMutex *mutex); GLIB_AVAILABLE_IN_2_32 void g_mutex_clear (GMutex *mutex); GLIB_AVAILABLE_IN_ALL void g_mutex_lock (GMutex *mutex); GLIB_AVAILABLE_IN_ALL gboolean g_mutex_trylock (GMutex *mutex); GLIB_AVAILABLE_IN_ALL void g_mutex_unlock (GMutex *mutex); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_init (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_clear (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_writer_lock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 gboolean g_rw_lock_writer_trylock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_writer_unlock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_reader_lock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 gboolean g_rw_lock_reader_trylock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rw_lock_reader_unlock (GRWLock *rw_lock); GLIB_AVAILABLE_IN_2_32 void g_rec_mutex_init (GRecMutex *rec_mutex); GLIB_AVAILABLE_IN_2_32 void g_rec_mutex_clear (GRecMutex *rec_mutex); GLIB_AVAILABLE_IN_2_32 void g_rec_mutex_lock (GRecMutex *rec_mutex); GLIB_AVAILABLE_IN_2_32 gboolean g_rec_mutex_trylock (GRecMutex *rec_mutex); GLIB_AVAILABLE_IN_2_32 void g_rec_mutex_unlock (GRecMutex *rec_mutex); GLIB_AVAILABLE_IN_2_32 void g_cond_init (GCond *cond); GLIB_AVAILABLE_IN_2_32 void g_cond_clear (GCond *cond); GLIB_AVAILABLE_IN_ALL void g_cond_wait (GCond *cond, GMutex *mutex); GLIB_AVAILABLE_IN_ALL void g_cond_signal (GCond *cond); GLIB_AVAILABLE_IN_ALL void g_cond_broadcast (GCond *cond); GLIB_AVAILABLE_IN_2_32 gboolean g_cond_wait_until (GCond *cond, GMutex *mutex, gint64 end_time); GLIB_AVAILABLE_IN_ALL gpointer g_private_get (GPrivate *key); GLIB_AVAILABLE_IN_ALL void g_private_set (GPrivate *key, gpointer value); GLIB_AVAILABLE_IN_2_32 void g_private_replace (GPrivate *key, gpointer value); GLIB_AVAILABLE_IN_ALL gpointer g_once_impl (GOnce *once, GThreadFunc func, gpointer arg); GLIB_AVAILABLE_IN_ALL gboolean g_once_init_enter (volatile void *location); GLIB_AVAILABLE_IN_ALL void g_once_init_leave (volatile void *location, gsize result); /* Use C11-style atomic extensions to check the fast path for status=ready. If * they are not available, fall back to using a mutex and condition variable in * g_once_impl(). * * On the C11-style codepath, only the load of once->status needs to be atomic, * as the writes to it and once->retval in g_once_impl() are related by a * happens-before relation. Release-acquire semantics are defined such that any * atomic/non-atomic write which happens-before a store/release is guaranteed to * be seen by the load/acquire of the same atomic variable. */ #if defined(G_ATOMIC_LOCK_FREE) && defined(__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4) && defined(__ATOMIC_SEQ_CST) # define g_once(once, func, arg) \ ((__atomic_load_n (&(once)->status, __ATOMIC_ACQUIRE) == G_ONCE_STATUS_READY) ? \ (once)->retval : \ g_once_impl ((once), (func), (arg))) #else # define g_once(once, func, arg) g_once_impl ((once), (func), (arg)) #endif #ifdef __GNUC__ # define g_once_init_enter(location) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(location) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(location) : NULL); \ (!g_atomic_pointer_get (location) && \ g_once_init_enter (location)); \ })) # define g_once_init_leave(location, result) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(location) == sizeof (gpointer)); \ 0 ? (void) (*(location) = (result)) : (void) 0; \ g_once_init_leave ((location), (gsize) (result)); \ })) #else # define g_once_init_enter(location) \ (g_once_init_enter((location))) # define g_once_init_leave(location, result) \ (g_once_init_leave((location), (gsize) (result))) #endif GLIB_AVAILABLE_IN_2_36 guint g_get_num_processors (void); /** * GMutexLocker: * * Opaque type. See g_mutex_locker_new() for details. * Since: 2.44 */ typedef void GMutexLocker; /** * g_mutex_locker_new: * @mutex: a mutex to lock * * Lock @mutex and return a new #GMutexLocker. Unlock with * g_mutex_locker_free(). Using g_mutex_unlock() on @mutex * while a #GMutexLocker exists can lead to undefined behaviour. * * No allocation is performed, it is equivalent to a g_mutex_lock() call. * * This is intended to be used with g_autoptr(). Note that g_autoptr() * is only available when using GCC or clang, so the following example * will only work with those compilers: * |[ * typedef struct * { * ... * GMutex mutex; * ... * } MyObject; * * static void * my_object_do_stuff (MyObject *self) * { * g_autoptr(GMutexLocker) locker = g_mutex_locker_new (&self->mutex); * * // Code with mutex locked here * * if (cond) * // No need to unlock * return; * * // Optionally early unlock * g_clear_pointer (&locker, g_mutex_locker_free); * * // Code with mutex unlocked here * } * ]| * * Returns: a #GMutexLocker * Since: 2.44 */ GLIB_AVAILABLE_STATIC_INLINE_IN_2_44 static inline GMutexLocker * g_mutex_locker_new (GMutex *mutex) { g_mutex_lock (mutex); return (GMutexLocker *) mutex; } /** * g_mutex_locker_free: * @locker: a GMutexLocker * * Unlock @locker's mutex. See g_mutex_locker_new() for details. * * No memory is freed, it is equivalent to a g_mutex_unlock() call. * * Since: 2.44 */ GLIB_AVAILABLE_STATIC_INLINE_IN_2_44 static inline void g_mutex_locker_free (GMutexLocker *locker) { g_mutex_unlock ((GMutex *) locker); } /** * GRecMutexLocker: * * Opaque type. See g_rec_mutex_locker_new() for details. * Since: 2.60 */ typedef void GRecMutexLocker; /** * g_rec_mutex_locker_new: * @rec_mutex: a recursive mutex to lock * * Lock @rec_mutex and return a new #GRecMutexLocker. Unlock with * g_rec_mutex_locker_free(). Using g_rec_mutex_unlock() on @rec_mutex * while a #GRecMutexLocker exists can lead to undefined behaviour. * * No allocation is performed, it is equivalent to a g_rec_mutex_lock() call. * * This is intended to be used with g_autoptr(). Note that g_autoptr() * is only available when using GCC or clang, so the following example * will only work with those compilers: * |[ * typedef struct * { * ... * GRecMutex rec_mutex; * ... * } MyObject; * * static void * my_object_do_stuff (MyObject *self) * { * g_autoptr(GRecMutexLocker) locker = g_rec_mutex_locker_new (&self->rec_mutex); * * // Code with rec_mutex locked here * * if (cond) * // No need to unlock * return; * * // Optionally early unlock * g_clear_pointer (&locker, g_rec_mutex_locker_free); * * // Code with rec_mutex unlocked here * } * ]| * * Returns: a #GRecMutexLocker * Since: 2.60 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_60 static inline GRecMutexLocker * g_rec_mutex_locker_new (GRecMutex *rec_mutex) { g_rec_mutex_lock (rec_mutex); return (GRecMutexLocker *) rec_mutex; } G_GNUC_END_IGNORE_DEPRECATIONS /** * g_rec_mutex_locker_free: * @locker: a GRecMutexLocker * * Unlock @locker's recursive mutex. See g_rec_mutex_locker_new() for details. * * No memory is freed, it is equivalent to a g_rec_mutex_unlock() call. * * Since: 2.60 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_60 static inline void g_rec_mutex_locker_free (GRecMutexLocker *locker) { g_rec_mutex_unlock ((GRecMutex *) locker); } G_GNUC_END_IGNORE_DEPRECATIONS /** * GRWLockWriterLocker: * * Opaque type. See g_rw_lock_writer_locker_new() for details. * Since: 2.62 */ typedef void GRWLockWriterLocker; /** * g_rw_lock_writer_locker_new: * @rw_lock: a #GRWLock * * Obtain a write lock on @rw_lock and return a new #GRWLockWriterLocker. * Unlock with g_rw_lock_writer_locker_free(). Using g_rw_lock_writer_unlock() * on @rw_lock while a #GRWLockWriterLocker exists can lead to undefined * behaviour. * * No allocation is performed, it is equivalent to a g_rw_lock_writer_lock() call. * * This is intended to be used with g_autoptr(). Note that g_autoptr() * is only available when using GCC or clang, so the following example * will only work with those compilers: * |[ * typedef struct * { * ... * GRWLock rw_lock; * GPtrArray *array; * ... * } MyObject; * * static gchar * * my_object_get_data (MyObject *self, guint index) * { * g_autoptr(GRWLockReaderLocker) locker = g_rw_lock_reader_locker_new (&self->rw_lock); * * // Code with a read lock obtained on rw_lock here * * if (self->array == NULL) * // No need to unlock * return NULL; * * if (index < self->array->len) * // No need to unlock * return g_ptr_array_index (self->array, index); * * // Optionally early unlock * g_clear_pointer (&locker, g_rw_lock_reader_locker_free); * * // Code with rw_lock unlocked here * return NULL; * } * * static void * my_object_set_data (MyObject *self, guint index, gpointer data) * { * g_autoptr(GRWLockWriterLocker) locker = g_rw_lock_writer_locker_new (&self->rw_lock); * * // Code with a write lock obtained on rw_lock here * * if (self->array == NULL) * self->array = g_ptr_array_new (); * * if (cond) * // No need to unlock * return; * * if (index >= self->array->len) * g_ptr_array_set_size (self->array, index+1); * g_ptr_array_index (self->array, index) = data; * * // Optionally early unlock * g_clear_pointer (&locker, g_rw_lock_writer_locker_free); * * // Code with rw_lock unlocked here * } * ]| * * Returns: a #GRWLockWriterLocker * Since: 2.62 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 static inline GRWLockWriterLocker * g_rw_lock_writer_locker_new (GRWLock *rw_lock) { g_rw_lock_writer_lock (rw_lock); return (GRWLockWriterLocker *) rw_lock; } G_GNUC_END_IGNORE_DEPRECATIONS /** * g_rw_lock_writer_locker_free: * @locker: a GRWLockWriterLocker * * Release a write lock on @locker's read-write lock. See * g_rw_lock_writer_locker_new() for details. * * No memory is freed, it is equivalent to a g_rw_lock_writer_unlock() call. * * Since: 2.62 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 static inline void g_rw_lock_writer_locker_free (GRWLockWriterLocker *locker) { g_rw_lock_writer_unlock ((GRWLock *) locker); } G_GNUC_END_IGNORE_DEPRECATIONS /** * GRWLockReaderLocker: * * Opaque type. See g_rw_lock_reader_locker_new() for details. * Since: 2.62 */ typedef void GRWLockReaderLocker; /** * g_rw_lock_reader_locker_new: * @rw_lock: a #GRWLock * * Obtain a read lock on @rw_lock and return a new #GRWLockReaderLocker. * Unlock with g_rw_lock_reader_locker_free(). Using g_rw_lock_reader_unlock() * on @rw_lock while a #GRWLockReaderLocker exists can lead to undefined * behaviour. * * No allocation is performed, it is equivalent to a g_rw_lock_reader_lock() call. * * This is intended to be used with g_autoptr(). For a code sample, see * g_rw_lock_writer_locker_new(). * * Returns: a #GRWLockReaderLocker * Since: 2.62 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 static inline GRWLockReaderLocker * g_rw_lock_reader_locker_new (GRWLock *rw_lock) { g_rw_lock_reader_lock (rw_lock); return (GRWLockReaderLocker *) rw_lock; } G_GNUC_END_IGNORE_DEPRECATIONS /** * g_rw_lock_reader_locker_free: * @locker: a GRWLockReaderLocker * * Release a read lock on @locker's read-write lock. See * g_rw_lock_reader_locker_new() for details. * * No memory is freed, it is equivalent to a g_rw_lock_reader_unlock() call. * * Since: 2.62 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_62 static inline void g_rw_lock_reader_locker_free (GRWLockReaderLocker *locker) { g_rw_lock_reader_unlock ((GRWLock *) locker); } G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_THREAD_H__ */ glib/gasyncqueue.h 0000644 00000013136 15125173650 0010174 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_ASYNCQUEUE_H__ #define __G_ASYNCQUEUE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gthread.h> G_BEGIN_DECLS typedef struct _GAsyncQueue GAsyncQueue; GLIB_AVAILABLE_IN_ALL GAsyncQueue *g_async_queue_new (void); GLIB_AVAILABLE_IN_ALL GAsyncQueue *g_async_queue_new_full (GDestroyNotify item_free_func); GLIB_AVAILABLE_IN_ALL void g_async_queue_lock (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL void g_async_queue_unlock (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL GAsyncQueue *g_async_queue_ref (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL void g_async_queue_unref (GAsyncQueue *queue); GLIB_DEPRECATED_FOR(g_async_queue_ref) void g_async_queue_ref_unlocked (GAsyncQueue *queue); GLIB_DEPRECATED_FOR(g_async_queue_unref) void g_async_queue_unref_and_unlock (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL void g_async_queue_push (GAsyncQueue *queue, gpointer data); GLIB_AVAILABLE_IN_ALL void g_async_queue_push_unlocked (GAsyncQueue *queue, gpointer data); GLIB_AVAILABLE_IN_ALL void g_async_queue_push_sorted (GAsyncQueue *queue, gpointer data, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_async_queue_push_sorted_unlocked (GAsyncQueue *queue, gpointer data, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_pop (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_pop_unlocked (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_try_pop (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_try_pop_unlocked (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_timeout_pop (GAsyncQueue *queue, guint64 timeout); GLIB_AVAILABLE_IN_ALL gpointer g_async_queue_timeout_pop_unlocked (GAsyncQueue *queue, guint64 timeout); GLIB_AVAILABLE_IN_ALL gint g_async_queue_length (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL gint g_async_queue_length_unlocked (GAsyncQueue *queue); GLIB_AVAILABLE_IN_ALL void g_async_queue_sort (GAsyncQueue *queue, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_async_queue_sort_unlocked (GAsyncQueue *queue, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_2_46 gboolean g_async_queue_remove (GAsyncQueue *queue, gpointer item); GLIB_AVAILABLE_IN_2_46 gboolean g_async_queue_remove_unlocked (GAsyncQueue *queue, gpointer item); GLIB_AVAILABLE_IN_2_46 void g_async_queue_push_front (GAsyncQueue *queue, gpointer item); GLIB_AVAILABLE_IN_2_46 void g_async_queue_push_front_unlocked (GAsyncQueue *queue, gpointer item); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_FOR(g_async_queue_timeout_pop) gpointer g_async_queue_timed_pop (GAsyncQueue *queue, GTimeVal *end_time); GLIB_DEPRECATED_FOR(g_async_queue_timeout_pop_unlocked) gpointer g_async_queue_timed_pop_unlocked (GAsyncQueue *queue, GTimeVal *end_time); G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_ASYNCQUEUE_H__ */ glib/gerror.h 0000644 00000025604 15125173650 0007146 0 ustar 00 /* gerror.h - Error reporting system * * Copyright 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_ERROR_H__ #define __G_ERROR_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <stdarg.h> #include <glib/gquark.h> G_BEGIN_DECLS /** * GError: * @domain: error domain, e.g. #G_FILE_ERROR * @code: error code, e.g. %G_FILE_ERROR_NOENT * @message: human-readable informative error message * * The `GError` structure contains information about * an error that has occurred. */ typedef struct _GError GError; struct _GError { GQuark domain; gint code; gchar *message; }; /** * G_DEFINE_EXTENDED_ERROR: * @ErrorType: name to return a #GQuark for * @error_type: prefix for the function name * * A convenience macro which defines two functions. First, returning * the #GQuark for the extended error type @ErrorType; it is called * `error_type_quark()`. Second, returning the private data from a * passed #GError; it is called `error_type_get_private()`. * * For this macro to work, a type named `ErrorTypePrivate` should be * defined, `error_type_private_init()`, `error_type_private_copy()` * and `error_type_private_clear()` functions need to be either * declared or defined. The functions should be similar to * #GErrorInitFunc, #GErrorCopyFunc and #GErrorClearFunc, * respectively, but they should receive the private data type instead * of #GError. * * See [Extended #GError Domains][gerror-extended-domains] for an example. * * Since: 2.68 */ #define G_DEFINE_EXTENDED_ERROR(ErrorType, error_type) \ static inline ErrorType ## Private * \ error_type ## _get_private (const GError *error) \ { \ /* Copied from gtype.c (STRUCT_ALIGNMENT and ALIGN_STRUCT macros). */ \ const gsize sa = 2 * sizeof (gsize); \ const gsize as = (sizeof (ErrorType ## Private) + (sa - 1)) & -sa; \ g_return_val_if_fail (error != NULL, NULL); \ g_return_val_if_fail (error->domain == error_type ## _quark (), NULL); \ return (ErrorType ## Private *) (((guint8 *)error) - as); \ } \ \ static void \ g_error_with_ ## error_type ## _private_init (GError *error) \ { \ ErrorType ## Private *priv = error_type ## _get_private (error); \ error_type ## _private_init (priv); \ } \ \ static void \ g_error_with_ ## error_type ## _private_copy (const GError *src_error, \ GError *dest_error) \ { \ const ErrorType ## Private *src_priv = error_type ## _get_private (src_error); \ ErrorType ## Private *dest_priv = error_type ## _get_private (dest_error); \ error_type ## _private_copy (src_priv, dest_priv); \ } \ \ static void \ g_error_with_ ## error_type ## _private_clear (GError *error) \ { \ ErrorType ## Private *priv = error_type ## _get_private (error); \ error_type ## _private_clear (priv); \ } \ \ GQuark \ error_type ## _quark (void) \ { \ static GQuark q; \ static gsize initialized = 0; \ \ if (g_once_init_enter (&initialized)) \ { \ q = g_error_domain_register_static (#ErrorType, \ sizeof (ErrorType ## Private), \ g_error_with_ ## error_type ## _private_init, \ g_error_with_ ## error_type ## _private_copy, \ g_error_with_ ## error_type ## _private_clear); \ g_once_init_leave (&initialized, 1); \ } \ \ return q; \ } /** * GErrorInitFunc: * @error: extended error * * Specifies the type of function which is called just after an * extended error instance is created and its fields filled. It should * only initialize the fields in the private data, which can be * received with the generated `*_get_private()` function. * * Normally, it is better to use G_DEFINE_EXTENDED_ERROR(), as it * already takes care of getting the private data from @error. * * Since: 2.68 */ typedef void (*GErrorInitFunc) (GError *error); /** * GErrorCopyFunc: * @src_error: source extended error * @dest_error: destination extended error * * Specifies the type of function which is called when an extended * error instance is copied. It is passed the pointer to the * destination error and source error, and should copy only the fields * of the private data from @src_error to @dest_error. * * Normally, it is better to use G_DEFINE_EXTENDED_ERROR(), as it * already takes care of getting the private data from @src_error and * @dest_error. * * Since: 2.68 */ typedef void (*GErrorCopyFunc) (const GError *src_error, GError *dest_error); /** * GErrorClearFunc: * @error: extended error to clear * * Specifies the type of function which is called when an extended * error instance is freed. It is passed the error pointer about to be * freed, and should free the error's private data fields. * * Normally, it is better to use G_DEFINE_EXTENDED_ERROR(), as it * already takes care of getting the private data from @error. * * Since: 2.68 */ typedef void (*GErrorClearFunc) (GError *error); GLIB_AVAILABLE_IN_2_68 GQuark g_error_domain_register_static (const char *error_type_name, gsize error_type_private_size, GErrorInitFunc error_type_init, GErrorCopyFunc error_type_copy, GErrorClearFunc error_type_clear); GLIB_AVAILABLE_IN_2_68 GQuark g_error_domain_register (const char *error_type_name, gsize error_type_private_size, GErrorInitFunc error_type_init, GErrorCopyFunc error_type_copy, GErrorClearFunc error_type_clear); GLIB_AVAILABLE_IN_ALL GError* g_error_new (GQuark domain, gint code, const gchar *format, ...) G_GNUC_PRINTF (3, 4); GLIB_AVAILABLE_IN_ALL GError* g_error_new_literal (GQuark domain, gint code, const gchar *message); GLIB_AVAILABLE_IN_ALL GError* g_error_new_valist (GQuark domain, gint code, const gchar *format, va_list args) G_GNUC_PRINTF(3, 0); GLIB_AVAILABLE_IN_ALL void g_error_free (GError *error); GLIB_AVAILABLE_IN_ALL GError* g_error_copy (const GError *error); GLIB_AVAILABLE_IN_ALL gboolean g_error_matches (const GError *error, GQuark domain, gint code); /* if (err) *err = g_error_new(domain, code, format, ...), also has * some sanity checks. */ GLIB_AVAILABLE_IN_ALL void g_set_error (GError **err, GQuark domain, gint code, const gchar *format, ...) G_GNUC_PRINTF (4, 5); GLIB_AVAILABLE_IN_ALL void g_set_error_literal (GError **err, GQuark domain, gint code, const gchar *message); /* if (dest) *dest = src; also has some sanity checks. */ GLIB_AVAILABLE_IN_ALL void g_propagate_error (GError **dest, GError *src); /* if (err && *err) { g_error_free(*err); *err = NULL; } */ GLIB_AVAILABLE_IN_ALL void g_clear_error (GError **err); /* if (err) prefix the formatted string to the ->message */ GLIB_AVAILABLE_IN_ALL void g_prefix_error (GError **err, const gchar *format, ...) G_GNUC_PRINTF (2, 3); /* g_propagate_error then g_error_prefix on dest */ GLIB_AVAILABLE_IN_ALL void g_propagate_prefixed_error (GError **dest, GError *src, const gchar *format, ...) G_GNUC_PRINTF (3, 4); G_END_DECLS #endif /* __G_ERROR_H__ */ glib/guri.h 0000644 00000040076 15125173650 0006614 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright © 2020 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see * <http://www.gnu.org/licenses/>. */ #pragma once #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS G_GNUC_BEGIN_IGNORE_DEPRECATIONS typedef struct _GUri GUri; GLIB_AVAILABLE_IN_2_66 GUri * g_uri_ref (GUri *uri); GLIB_AVAILABLE_IN_2_66 void g_uri_unref (GUri *uri); /** * GUriFlags: * @G_URI_FLAGS_NONE: No flags set. * @G_URI_FLAGS_PARSE_RELAXED: Parse the URI more relaxedly than the * [RFC 3986](https://tools.ietf.org/html/rfc3986) grammar specifies, * fixing up or ignoring common mistakes in URIs coming from external * sources. This is also needed for some obscure URI schemes where `;` * separates the host from the path. Don’t use this flag unless you need to. * @G_URI_FLAGS_HAS_PASSWORD: The userinfo field may contain a password, * which will be separated from the username by `:`. * @G_URI_FLAGS_HAS_AUTH_PARAMS: The userinfo may contain additional * authentication-related parameters, which will be separated from * the username and/or password by `;`. * @G_URI_FLAGS_NON_DNS: The host component should not be assumed to be a * DNS hostname or IP address (for example, for `smb` URIs with NetBIOS * hostnames). * @G_URI_FLAGS_ENCODED: When parsing a URI, this indicates that `%`-encoded * characters in the userinfo, path, query, and fragment fields * should not be decoded. (And likewise the host field if * %G_URI_FLAGS_NON_DNS is also set.) When building a URI, it indicates * that you have already `%`-encoded the components, and so #GUri * should not do any encoding itself. * @G_URI_FLAGS_ENCODED_QUERY: Same as %G_URI_FLAGS_ENCODED, for the query * field only. * @G_URI_FLAGS_ENCODED_PATH: Same as %G_URI_FLAGS_ENCODED, for the path only. * @G_URI_FLAGS_ENCODED_FRAGMENT: Same as %G_URI_FLAGS_ENCODED, for the * fragment only. * @G_URI_FLAGS_SCHEME_NORMALIZE: A scheme-based normalization will be applied. * For example, when parsing an HTTP URI changing omitted path to `/` and * omitted port to `80`; and when building a URI, changing empty path to `/` * and default port `80`). This only supports a subset of known schemes. (Since: 2.68) * * Flags that describe a URI. * * When parsing a URI, if you need to choose different flags based on * the type of URI, you can use g_uri_peek_scheme() on the URI string * to check the scheme first, and use that to decide what flags to * parse it with. * * Since: 2.66 */ GLIB_AVAILABLE_TYPE_IN_2_66 typedef enum { G_URI_FLAGS_NONE = 0, G_URI_FLAGS_PARSE_RELAXED = 1 << 0, G_URI_FLAGS_HAS_PASSWORD = 1 << 1, G_URI_FLAGS_HAS_AUTH_PARAMS = 1 << 2, G_URI_FLAGS_ENCODED = 1 << 3, G_URI_FLAGS_NON_DNS = 1 << 4, G_URI_FLAGS_ENCODED_QUERY = 1 << 5, G_URI_FLAGS_ENCODED_PATH = 1 << 6, G_URI_FLAGS_ENCODED_FRAGMENT = 1 << 7, G_URI_FLAGS_SCHEME_NORMALIZE GLIB_AVAILABLE_ENUMERATOR_IN_2_68 = 1 << 8, } GUriFlags; GLIB_AVAILABLE_IN_2_66 gboolean g_uri_split (const gchar *uri_ref, GUriFlags flags, gchar **scheme, gchar **userinfo, gchar **host, gint *port, gchar **path, gchar **query, gchar **fragment, GError **error); GLIB_AVAILABLE_IN_2_66 gboolean g_uri_split_with_user (const gchar *uri_ref, GUriFlags flags, gchar **scheme, gchar **user, gchar **password, gchar **auth_params, gchar **host, gint *port, gchar **path, gchar **query, gchar **fragment, GError **error); GLIB_AVAILABLE_IN_2_66 gboolean g_uri_split_network (const gchar *uri_string, GUriFlags flags, gchar **scheme, gchar **host, gint *port, GError **error); GLIB_AVAILABLE_IN_2_66 gboolean g_uri_is_valid (const gchar *uri_string, GUriFlags flags, GError **error); GLIB_AVAILABLE_IN_2_66 gchar * g_uri_join (GUriFlags flags, const gchar *scheme, const gchar *userinfo, const gchar *host, gint port, const gchar *path, const gchar *query, const gchar *fragment); GLIB_AVAILABLE_IN_2_66 gchar * g_uri_join_with_user (GUriFlags flags, const gchar *scheme, const gchar *user, const gchar *password, const gchar *auth_params, const gchar *host, gint port, const gchar *path, const gchar *query, const gchar *fragment); GLIB_AVAILABLE_IN_2_66 GUri * g_uri_parse (const gchar *uri_string, GUriFlags flags, GError **error); GLIB_AVAILABLE_IN_2_66 GUri * g_uri_parse_relative (GUri *base_uri, const gchar *uri_ref, GUriFlags flags, GError **error); GLIB_AVAILABLE_IN_2_66 gchar * g_uri_resolve_relative (const gchar *base_uri_string, const gchar *uri_ref, GUriFlags flags, GError **error); GLIB_AVAILABLE_IN_2_66 GUri * g_uri_build (GUriFlags flags, const gchar *scheme, const gchar *userinfo, const gchar *host, gint port, const gchar *path, const gchar *query, const gchar *fragment); GLIB_AVAILABLE_IN_2_66 GUri * g_uri_build_with_user (GUriFlags flags, const gchar *scheme, const gchar *user, const gchar *password, const gchar *auth_params, const gchar *host, gint port, const gchar *path, const gchar *query, const gchar *fragment); /** * GUriHideFlags: * @G_URI_HIDE_NONE: No flags set. * @G_URI_HIDE_USERINFO: Hide the userinfo. * @G_URI_HIDE_PASSWORD: Hide the password. * @G_URI_HIDE_AUTH_PARAMS: Hide the auth_params. * @G_URI_HIDE_QUERY: Hide the query. * @G_URI_HIDE_FRAGMENT: Hide the fragment. * * Flags describing what parts of the URI to hide in * g_uri_to_string_partial(). Note that %G_URI_HIDE_PASSWORD and * %G_URI_HIDE_AUTH_PARAMS will only work if the #GUri was parsed with * the corresponding flags. * * Since: 2.66 */ GLIB_AVAILABLE_TYPE_IN_2_66 typedef enum { G_URI_HIDE_NONE = 0, G_URI_HIDE_USERINFO = 1 << 0, G_URI_HIDE_PASSWORD = 1 << 1, G_URI_HIDE_AUTH_PARAMS = 1 << 2, G_URI_HIDE_QUERY = 1 << 3, G_URI_HIDE_FRAGMENT = 1 << 4, } GUriHideFlags; GLIB_AVAILABLE_IN_2_66 char * g_uri_to_string (GUri *uri); GLIB_AVAILABLE_IN_2_66 char * g_uri_to_string_partial (GUri *uri, GUriHideFlags flags); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_scheme (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_userinfo (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_user (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_password (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_auth_params (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_host (GUri *uri); GLIB_AVAILABLE_IN_2_66 gint g_uri_get_port (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_path (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_query (GUri *uri); GLIB_AVAILABLE_IN_2_66 const gchar *g_uri_get_fragment (GUri *uri); GLIB_AVAILABLE_IN_2_66 GUriFlags g_uri_get_flags (GUri *uri); /** * GUriParamsFlags: * @G_URI_PARAMS_NONE: No flags set. * @G_URI_PARAMS_CASE_INSENSITIVE: Parameter names are case insensitive. * @G_URI_PARAMS_WWW_FORM: Replace `+` with space character. Only useful for * URLs on the web, using the `https` or `http` schemas. * @G_URI_PARAMS_PARSE_RELAXED: See %G_URI_FLAGS_PARSE_RELAXED. * * Flags modifying the way parameters are handled by g_uri_parse_params() and * #GUriParamsIter. * * Since: 2.66 */ GLIB_AVAILABLE_TYPE_IN_2_66 typedef enum { G_URI_PARAMS_NONE = 0, G_URI_PARAMS_CASE_INSENSITIVE = 1 << 0, G_URI_PARAMS_WWW_FORM = 1 << 1, G_URI_PARAMS_PARSE_RELAXED = 1 << 2, } GUriParamsFlags; GLIB_AVAILABLE_IN_2_66 GHashTable *g_uri_parse_params (const gchar *params, gssize length, const gchar *separators, GUriParamsFlags flags, GError **error); typedef struct _GUriParamsIter GUriParamsIter; struct _GUriParamsIter { /*< private >*/ gint dummy0; gpointer dummy1; gpointer dummy2; guint8 dummy3[256]; }; GLIB_AVAILABLE_IN_2_66 void g_uri_params_iter_init (GUriParamsIter *iter, const gchar *params, gssize length, const gchar *separators, GUriParamsFlags flags); GLIB_AVAILABLE_IN_2_66 gboolean g_uri_params_iter_next (GUriParamsIter *iter, gchar **attribute, gchar **value, GError **error); /** * G_URI_ERROR: * * Error domain for URI methods. Errors in this domain will be from * the #GUriError enumeration. See #GError for information on error * domains. * * Since: 2.66 */ #define G_URI_ERROR (g_uri_error_quark ()) GLIB_AVAILABLE_MACRO_IN_2_66 GLIB_AVAILABLE_IN_2_66 GQuark g_uri_error_quark (void); /** * GUriError: * @G_URI_ERROR_FAILED: Generic error if no more specific error is available. * See the error message for details. * @G_URI_ERROR_BAD_SCHEME: The scheme of a URI could not be parsed. * @G_URI_ERROR_BAD_USER: The user/userinfo of a URI could not be parsed. * @G_URI_ERROR_BAD_PASSWORD: The password of a URI could not be parsed. * @G_URI_ERROR_BAD_AUTH_PARAMS: The authentication parameters of a URI could not be parsed. * @G_URI_ERROR_BAD_HOST: The host of a URI could not be parsed. * @G_URI_ERROR_BAD_PORT: The port of a URI could not be parsed. * @G_URI_ERROR_BAD_PATH: The path of a URI could not be parsed. * @G_URI_ERROR_BAD_QUERY: The query of a URI could not be parsed. * @G_URI_ERROR_BAD_FRAGMENT: The fragment of a URI could not be parsed. * * Error codes returned by #GUri methods. * * Since: 2.66 */ typedef enum { G_URI_ERROR_FAILED, G_URI_ERROR_BAD_SCHEME, G_URI_ERROR_BAD_USER, G_URI_ERROR_BAD_PASSWORD, G_URI_ERROR_BAD_AUTH_PARAMS, G_URI_ERROR_BAD_HOST, G_URI_ERROR_BAD_PORT, G_URI_ERROR_BAD_PATH, G_URI_ERROR_BAD_QUERY, G_URI_ERROR_BAD_FRAGMENT, } GUriError; /** * G_URI_RESERVED_CHARS_GENERIC_DELIMITERS: * * Generic delimiters characters as defined in * [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `:/?#[]@`. * * Since: 2.16 **/ #define G_URI_RESERVED_CHARS_GENERIC_DELIMITERS ":/?#[]@" /** * G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS: * * Subcomponent delimiter characters as defined in * [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `!$&'()*+,;=`. * * Since: 2.16 **/ #define G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS "!$&'()*+,;=" /** * G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT: * * Allowed characters in path elements. Includes `!$&'()*+,;=:@`. * * Since: 2.16 **/ #define G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS ":@" /** * G_URI_RESERVED_CHARS_ALLOWED_IN_PATH: * * Allowed characters in a path. Includes `!$&'()*+,;=:@/`. * * Since: 2.16 **/ #define G_URI_RESERVED_CHARS_ALLOWED_IN_PATH G_URI_RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT "/" /** * G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO: * * Allowed characters in userinfo as defined in * [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `!$&'()*+,;=:`. * * Since: 2.16 **/ #define G_URI_RESERVED_CHARS_ALLOWED_IN_USERINFO G_URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS ":" GLIB_AVAILABLE_IN_ALL char * g_uri_unescape_string (const char *escaped_string, const char *illegal_characters); GLIB_AVAILABLE_IN_ALL char * g_uri_unescape_segment (const char *escaped_string, const char *escaped_string_end, const char *illegal_characters); GLIB_AVAILABLE_IN_ALL char * g_uri_parse_scheme (const char *uri); GLIB_AVAILABLE_IN_2_66 const char *g_uri_peek_scheme (const char *uri); GLIB_AVAILABLE_IN_ALL char * g_uri_escape_string (const char *unescaped, const char *reserved_chars_allowed, gboolean allow_utf8); GLIB_AVAILABLE_IN_2_66 GBytes * g_uri_unescape_bytes (const char *escaped_string, gssize length, const char *illegal_characters, GError **error); GLIB_AVAILABLE_IN_2_66 char * g_uri_escape_bytes (const guint8 *unescaped, gsize length, const char *reserved_chars_allowed); G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS glib/gmessages.h 0000644 00000065071 15125173650 0007626 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_MESSAGES_H__ #define __G_MESSAGES_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <stdarg.h> #include <glib/gatomic.h> #include <glib/gtypes.h> #include <glib/gmacros.h> #include <glib/gvariant.h> G_BEGIN_DECLS /* calculate a string size, guaranteed to fit format + args. */ GLIB_AVAILABLE_IN_ALL gsize g_printf_string_upper_bound (const gchar* format, va_list args) G_GNUC_PRINTF(1, 0); /* Log level shift offset for user defined * log levels (0-7 are used by GLib). */ #define G_LOG_LEVEL_USER_SHIFT (8) /* Glib log levels and flags. */ typedef enum { /* log flags */ G_LOG_FLAG_RECURSION = 1 << 0, G_LOG_FLAG_FATAL = 1 << 1, /* GLib log levels */ G_LOG_LEVEL_ERROR = 1 << 2, /* always fatal */ G_LOG_LEVEL_CRITICAL = 1 << 3, G_LOG_LEVEL_WARNING = 1 << 4, G_LOG_LEVEL_MESSAGE = 1 << 5, G_LOG_LEVEL_INFO = 1 << 6, G_LOG_LEVEL_DEBUG = 1 << 7, G_LOG_LEVEL_MASK = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL) } GLogLevelFlags; /* GLib log levels that are considered fatal by default */ #define G_LOG_FATAL_MASK (G_LOG_FLAG_RECURSION | G_LOG_LEVEL_ERROR) typedef void (*GLogFunc) (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer user_data); /* Logging mechanism */ GLIB_AVAILABLE_IN_ALL guint g_log_set_handler (const gchar *log_domain, GLogLevelFlags log_levels, GLogFunc log_func, gpointer user_data); GLIB_AVAILABLE_IN_2_46 guint g_log_set_handler_full (const gchar *log_domain, GLogLevelFlags log_levels, GLogFunc log_func, gpointer user_data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL void g_log_remove_handler (const gchar *log_domain, guint handler_id); GLIB_AVAILABLE_IN_ALL void g_log_default_handler (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer unused_data); GLIB_AVAILABLE_IN_ALL GLogFunc g_log_set_default_handler (GLogFunc log_func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_log (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, ...) G_GNUC_PRINTF (3, 4); GLIB_AVAILABLE_IN_ALL void g_logv (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, va_list args) G_GNUC_PRINTF(3, 0); GLIB_AVAILABLE_IN_ALL GLogLevelFlags g_log_set_fatal_mask (const gchar *log_domain, GLogLevelFlags fatal_mask); GLIB_AVAILABLE_IN_ALL GLogLevelFlags g_log_set_always_fatal (GLogLevelFlags fatal_mask); /* Structured logging mechanism. */ /** * GLogWriterOutput: * @G_LOG_WRITER_HANDLED: Log writer has handled the log entry. * @G_LOG_WRITER_UNHANDLED: Log writer could not handle the log entry. * * Return values from #GLogWriterFuncs to indicate whether the given log entry * was successfully handled by the writer, or whether there was an error in * handling it (and hence a fallback writer should be used). * * If a #GLogWriterFunc ignores a log entry, it should return * %G_LOG_WRITER_HANDLED. * * Since: 2.50 */ typedef enum { G_LOG_WRITER_HANDLED = 1, G_LOG_WRITER_UNHANDLED = 0, } GLogWriterOutput; /** * GLogField: * @key: field name (UTF-8 string) * @value: field value (arbitrary bytes) * @length: length of @value, in bytes, or -1 if it is nul-terminated * * Structure representing a single field in a structured log entry. See * g_log_structured() for details. * * Log fields may contain arbitrary values, including binary with embedded nul * bytes. If the field contains a string, the string must be UTF-8 encoded and * have a trailing nul byte. Otherwise, @length must be set to a non-negative * value. * * Since: 2.50 */ typedef struct _GLogField GLogField; struct _GLogField { const gchar *key; gconstpointer value; gssize length; }; /** * GLogWriterFunc: * @log_level: log level of the message * @fields: (array length=n_fields): fields forming the message * @n_fields: number of @fields * @user_data: user data passed to g_log_set_writer_func() * * Writer function for log entries. A log entry is a collection of one or more * #GLogFields, using the standard [field names from journal * specification](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html). * See g_log_structured() for more information. * * Writer functions must ignore fields which they do not recognise, unless they * can write arbitrary binary output, as field values may be arbitrary binary. * * @log_level is guaranteed to be included in @fields as the `PRIORITY` field, * but is provided separately for convenience of deciding whether or where to * output the log entry. * * Writer functions should return %G_LOG_WRITER_HANDLED if they handled the log * message successfully or if they deliberately ignored it. If there was an * error handling the message (for example, if the writer function is meant to * send messages to a remote logging server and there is a network error), it * should return %G_LOG_WRITER_UNHANDLED. This allows writer functions to be * chained and fall back to simpler handlers in case of failure. * * Returns: %G_LOG_WRITER_HANDLED if the log entry was handled successfully; * %G_LOG_WRITER_UNHANDLED otherwise * Since: 2.50 */ typedef GLogWriterOutput (*GLogWriterFunc) (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields, gpointer user_data); GLIB_AVAILABLE_IN_2_50 void g_log_structured (const gchar *log_domain, GLogLevelFlags log_level, ...); GLIB_AVAILABLE_IN_2_50 void g_log_structured_array (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields); GLIB_AVAILABLE_IN_2_50 void g_log_variant (const gchar *log_domain, GLogLevelFlags log_level, GVariant *fields); GLIB_AVAILABLE_IN_2_50 void g_log_set_writer_func (GLogWriterFunc func, gpointer user_data, GDestroyNotify user_data_free); GLIB_AVAILABLE_IN_2_50 gboolean g_log_writer_supports_color (gint output_fd); GLIB_AVAILABLE_IN_2_50 gboolean g_log_writer_is_journald (gint output_fd); GLIB_AVAILABLE_IN_2_50 gchar *g_log_writer_format_fields (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields, gboolean use_color); GLIB_AVAILABLE_IN_2_50 GLogWriterOutput g_log_writer_journald (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields, gpointer user_data); GLIB_AVAILABLE_IN_2_50 GLogWriterOutput g_log_writer_standard_streams (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields, gpointer user_data); GLIB_AVAILABLE_IN_2_50 GLogWriterOutput g_log_writer_default (GLogLevelFlags log_level, const GLogField *fields, gsize n_fields, gpointer user_data); GLIB_AVAILABLE_IN_2_68 void g_log_writer_default_set_use_stderr (gboolean use_stderr); GLIB_AVAILABLE_IN_2_68 gboolean g_log_writer_default_would_drop (GLogLevelFlags log_level, const char *log_domain); /** * G_DEBUG_HERE: * * A convenience form of g_log_structured(), recommended to be added to * functions when debugging. It prints the current monotonic time and the code * location using %G_STRLOC. * * Since: 2.50 */ #define G_DEBUG_HERE() \ g_log_structured (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ "CODE_FILE", __FILE__, \ "CODE_LINE", G_STRINGIFY (__LINE__), \ "CODE_FUNC", G_STRFUNC, \ "MESSAGE", "%" G_GINT64_FORMAT ": %s", \ g_get_monotonic_time (), G_STRLOC) /* internal */ void _g_log_fallback_handler (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer unused_data); /* Internal functions, used to implement the following macros */ GLIB_AVAILABLE_IN_ALL void g_return_if_fail_warning (const char *log_domain, const char *pretty_function, const char *expression) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_ALL void g_warn_message (const char *domain, const char *file, int line, const char *func, const char *warnexpr) G_ANALYZER_NORETURN; GLIB_DEPRECATED G_NORETURN void g_assert_warning (const char *log_domain, const char *file, const int line, const char *pretty_function, const char *expression); GLIB_AVAILABLE_IN_2_56 void g_log_structured_standard (const gchar *log_domain, GLogLevelFlags log_level, const gchar *file, const gchar *line, const gchar *func, const gchar *message_format, ...) G_GNUC_PRINTF (6, 7); #ifndef G_LOG_DOMAIN #define G_LOG_DOMAIN ((gchar*) 0) #endif /* G_LOG_DOMAIN */ #if defined(G_HAVE_ISO_VARARGS) && !G_ANALYZER_ANALYZING #if defined(G_LOG_USE_STRUCTURED) && GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_56 #define g_error(...) G_STMT_START { \ g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__); \ for (;;) ; \ } G_STMT_END #define g_message(...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__) #define g_critical(...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__) #define g_warning(...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__) #define g_info(...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_INFO, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__) #define g_debug(...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, __VA_ARGS__) #else /* for(;;) ; so that GCC knows that control doesn't go past g_error(). * Put space before ending semicolon to avoid C++ build warnings. */ #define g_error(...) G_STMT_START { \ g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_ERROR, \ __VA_ARGS__); \ for (;;) ; \ } G_STMT_END #define g_message(...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_MESSAGE, \ __VA_ARGS__) #define g_critical(...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_CRITICAL, \ __VA_ARGS__) #define g_warning(...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_WARNING, \ __VA_ARGS__) #define g_info(...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_INFO, \ __VA_ARGS__) #define g_debug(...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_DEBUG, \ __VA_ARGS__) #endif #elif defined(G_HAVE_GNUC_VARARGS) && !G_ANALYZER_ANALYZING #if defined(G_LOG_USE_STRUCTURED) && GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_56 #define g_error(format...) G_STMT_START { \ g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format); \ for (;;) ; \ } G_STMT_END #define g_message(format...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format) #define g_critical(format...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format) #define g_warning(format...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format) #define g_info(format...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_INFO, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format) #define g_debug(format...) g_log_structured_standard (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, \ __FILE__, G_STRINGIFY (__LINE__), \ G_STRFUNC, format) #else #define g_error(format...) G_STMT_START { \ g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_ERROR, \ format); \ for (;;) ; \ } G_STMT_END #define g_message(format...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_MESSAGE, \ format) #define g_critical(format...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_CRITICAL, \ format) #define g_warning(format...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_WARNING, \ format) #define g_info(format...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_INFO, \ format) #define g_debug(format...) g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_DEBUG, \ format) #endif #else /* no varargs macros */ static G_NORETURN void g_error (const gchar *format, ...) G_ANALYZER_NORETURN; static void g_critical (const gchar *format, ...) G_ANALYZER_NORETURN; static inline void g_error (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, args); va_end (args); for(;;) ; } static inline void g_message (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, args); va_end (args); } static inline void g_critical (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, args); va_end (args); } static inline void g_warning (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, args); va_end (args); } static inline void g_info (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_INFO, format, args); va_end (args); } static inline void g_debug (const gchar *format, ...) { va_list args; va_start (args, format); g_logv (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format, args); va_end (args); } #endif /* !__GNUC__ */ /** * g_warning_once: * @...: format string, followed by parameters to insert * into the format string (as with printf()) * * Logs a warning only once. * * g_warning_once() calls g_warning() with the passed message the first time * the statement is executed; subsequent times it is a no-op. * * Note! On platforms where the compiler doesn't support variadic macros, the * warning is printed each time instead of only once. * * Since: 2.64 */ #if defined(G_HAVE_ISO_VARARGS) && !G_ANALYZER_ANALYZING #define g_warning_once(...) \ G_STMT_START { \ static int G_PASTE (_GWarningOnceBoolean, __LINE__) = 0; /* (atomic) */ \ if (g_atomic_int_compare_and_exchange (&G_PASTE (_GWarningOnceBoolean, __LINE__), \ 0, 1)) \ g_warning (__VA_ARGS__); \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_64 #elif defined(G_HAVE_GNUC_VARARGS) && !G_ANALYZER_ANALYZING #define g_warning_once(format...) \ G_STMT_START { \ static int G_PASTE (_GWarningOnceBoolean, __LINE__) = 0; /* (atomic) */ \ if (g_atomic_int_compare_and_exchange (&G_PASTE (_GWarningOnceBoolean, __LINE__), \ 0, 1)) \ g_warning (format); \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_64 #else #define g_warning_once g_warning #endif /** * GPrintFunc: * @string: the message to output * * Specifies the type of the print handler functions. * These are called with the complete formatted string to output. */ typedef void (*GPrintFunc) (const gchar *string); GLIB_AVAILABLE_IN_ALL void g_print (const gchar *format, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL GPrintFunc g_set_print_handler (GPrintFunc func); GLIB_AVAILABLE_IN_ALL void g_printerr (const gchar *format, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL GPrintFunc g_set_printerr_handler (GPrintFunc func); /** * g_warn_if_reached: * * Logs a warning. * * Since: 2.16 */ #define g_warn_if_reached() \ do { \ g_warn_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, NULL); \ } while (0) /** * g_warn_if_fail: * @expr: the expression to check * * Logs a warning if the expression is not true. * * Since: 2.16 */ #define g_warn_if_fail(expr) \ do { \ if G_LIKELY (expr) ; \ else g_warn_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, #expr); \ } while (0) #ifdef G_DISABLE_CHECKS /** * g_return_if_fail: * @expr: the expression to check * * Verifies that the expression @expr, usually representing a precondition, * evaluates to %TRUE. If the function returns a value, use * g_return_val_if_fail() instead. * * If @expr evaluates to %FALSE, the current function should be considered to * have undefined behaviour (a programmer error). The only correct solution * to such an error is to change the module that is calling the current * function, so that it avoids this incorrect call. * * To make this undefined behaviour visible, if @expr evaluates to %FALSE, * the result is usually that a critical message is logged and the current * function returns. * * If `G_DISABLE_CHECKS` is defined then the check is not performed. You * should therefore not depend on any side effects of @expr. * * To debug failure of a g_return_if_fail() check, run the code under a debugger * with `G_DEBUG=fatal-criticals` or `G_DEBUG=fatal-warnings` defined in the * environment (see [Running GLib Applications](glib-running.html)): * * |[ * G_DEBUG=fatal-warnings gdb ./my-program * ]| * * Any unrelated failures can be skipped over in * [gdb](https://www.gnu.org/software/gdb/) using the `continue` command. */ #define g_return_if_fail(expr) G_STMT_START{ (void)0; }G_STMT_END /** * g_return_val_if_fail: * @expr: the expression to check * @val: the value to return from the current function * if the expression is not true * * Verifies that the expression @expr, usually representing a precondition, * evaluates to %TRUE. If the function does not return a value, use * g_return_if_fail() instead. * * If @expr evaluates to %FALSE, the current function should be considered to * have undefined behaviour (a programmer error). The only correct solution * to such an error is to change the module that is calling the current * function, so that it avoids this incorrect call. * * To make this undefined behaviour visible, if @expr evaluates to %FALSE, * the result is usually that a critical message is logged and @val is * returned from the current function. * * If `G_DISABLE_CHECKS` is defined then the check is not performed. You * should therefore not depend on any side effects of @expr. * * See g_return_if_fail() for guidance on how to debug failure of this check. */ #define g_return_val_if_fail(expr,val) G_STMT_START{ (void)0; }G_STMT_END /** * g_return_if_reached: * * Logs a critical message and returns from the current function. * This can only be used in functions which do not return a value. * * See g_return_if_fail() for guidance on how to debug failure of this check. */ #define g_return_if_reached() G_STMT_START{ return; }G_STMT_END /** * g_return_val_if_reached: * @val: the value to return from the current function * * Logs a critical message and returns @val. * * See g_return_if_fail() for guidance on how to debug failure of this check. */ #define g_return_val_if_reached(val) G_STMT_START{ return (val); }G_STMT_END #else /* !G_DISABLE_CHECKS */ #define g_return_if_fail(expr) \ G_STMT_START { \ if (G_LIKELY (expr)) \ { } \ else \ { \ g_return_if_fail_warning (G_LOG_DOMAIN, \ G_STRFUNC, \ #expr); \ return; \ } \ } G_STMT_END #define g_return_val_if_fail(expr, val) \ G_STMT_START { \ if (G_LIKELY (expr)) \ { } \ else \ { \ g_return_if_fail_warning (G_LOG_DOMAIN, \ G_STRFUNC, \ #expr); \ return (val); \ } \ } G_STMT_END #define g_return_if_reached() \ G_STMT_START { \ g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_CRITICAL, \ "file %s: line %d (%s): should not be reached", \ __FILE__, \ __LINE__, \ G_STRFUNC); \ return; \ } G_STMT_END #define g_return_val_if_reached(val) \ G_STMT_START { \ g_log (G_LOG_DOMAIN, \ G_LOG_LEVEL_CRITICAL, \ "file %s: line %d (%s): should not be reached", \ __FILE__, \ __LINE__, \ G_STRFUNC); \ return (val); \ } G_STMT_END #endif /* !G_DISABLE_CHECKS */ G_END_DECLS #endif /* __G_MESSAGES_H__ */ glib/gbookmarkfile.h 0000644 00000030521 15125173650 0010454 0 ustar 00 /* gbookmarkfile.h: parsing and building desktop bookmarks * * Copyright (C) 2005-2006 Emmanuele Bassi * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_BOOKMARK_FILE_H__ #define __G_BOOKMARK_FILE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gdatetime.h> #include <glib/gerror.h> #include <time.h> G_BEGIN_DECLS /** * G_BOOKMARK_FILE_ERROR: * * Error domain for bookmark file parsing. * Errors in this domain will be from the #GBookmarkFileError * enumeration. See #GError for information on error domains. */ #define G_BOOKMARK_FILE_ERROR (g_bookmark_file_error_quark ()) /** * GBookmarkFileError: * @G_BOOKMARK_FILE_ERROR_INVALID_URI: URI was ill-formed * @G_BOOKMARK_FILE_ERROR_INVALID_VALUE: a requested field was not found * @G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED: a requested application did * not register a bookmark * @G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND: a requested URI was not found * @G_BOOKMARK_FILE_ERROR_READ: document was ill formed * @G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING: the text being parsed was * in an unknown encoding * @G_BOOKMARK_FILE_ERROR_WRITE: an error occurred while writing * @G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND: requested file was not found * * Error codes returned by bookmark file parsing. */ typedef enum { G_BOOKMARK_FILE_ERROR_INVALID_URI, G_BOOKMARK_FILE_ERROR_INVALID_VALUE, G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED, G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND, G_BOOKMARK_FILE_ERROR_READ, G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING, G_BOOKMARK_FILE_ERROR_WRITE, G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND } GBookmarkFileError; GLIB_AVAILABLE_IN_ALL GQuark g_bookmark_file_error_quark (void); /** * GBookmarkFile: * * The `GBookmarkFile` structure contains only * private data and should not be directly accessed. */ typedef struct _GBookmarkFile GBookmarkFile; GLIB_AVAILABLE_IN_ALL GBookmarkFile *g_bookmark_file_new (void); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_free (GBookmarkFile *bookmark); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_load_from_file (GBookmarkFile *bookmark, const gchar *filename, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_load_from_data (GBookmarkFile *bookmark, const gchar *data, gsize length, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_load_from_data_dirs (GBookmarkFile *bookmark, const gchar *file, gchar **full_path, GError **error); GLIB_AVAILABLE_IN_ALL gchar * g_bookmark_file_to_data (GBookmarkFile *bookmark, gsize *length, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_to_file (GBookmarkFile *bookmark, const gchar *filename, GError **error); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_title (GBookmarkFile *bookmark, const gchar *uri, const gchar *title); GLIB_AVAILABLE_IN_ALL gchar * g_bookmark_file_get_title (GBookmarkFile *bookmark, const gchar *uri, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_description (GBookmarkFile *bookmark, const gchar *uri, const gchar *description); GLIB_AVAILABLE_IN_ALL gchar * g_bookmark_file_get_description (GBookmarkFile *bookmark, const gchar *uri, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_mime_type (GBookmarkFile *bookmark, const gchar *uri, const gchar *mime_type); GLIB_AVAILABLE_IN_ALL gchar * g_bookmark_file_get_mime_type (GBookmarkFile *bookmark, const gchar *uri, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_groups (GBookmarkFile *bookmark, const gchar *uri, const gchar **groups, gsize length); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_add_group (GBookmarkFile *bookmark, const gchar *uri, const gchar *group); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_has_group (GBookmarkFile *bookmark, const gchar *uri, const gchar *group, GError **error); GLIB_AVAILABLE_IN_ALL gchar ** g_bookmark_file_get_groups (GBookmarkFile *bookmark, const gchar *uri, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_add_application (GBookmarkFile *bookmark, const gchar *uri, const gchar *name, const gchar *exec); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_has_application (GBookmarkFile *bookmark, const gchar *uri, const gchar *name, GError **error); GLIB_AVAILABLE_IN_ALL gchar ** g_bookmark_file_get_applications (GBookmarkFile *bookmark, const gchar *uri, gsize *length, GError **error); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_set_application_info) gboolean g_bookmark_file_set_app_info (GBookmarkFile *bookmark, const gchar *uri, const gchar *name, const gchar *exec, gint count, time_t stamp, GError **error); GLIB_AVAILABLE_IN_2_66 gboolean g_bookmark_file_set_application_info (GBookmarkFile *bookmark, const char *uri, const char *name, const char *exec, int count, GDateTime *stamp, GError **error); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_get_application_info) gboolean g_bookmark_file_get_app_info (GBookmarkFile *bookmark, const gchar *uri, const gchar *name, gchar **exec, guint *count, time_t *stamp, GError **error); GLIB_AVAILABLE_IN_2_66 gboolean g_bookmark_file_get_application_info (GBookmarkFile *bookmark, const char *uri, const char *name, char **exec, unsigned int *count, GDateTime **stamp, GError **error); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_is_private (GBookmarkFile *bookmark, const gchar *uri, gboolean is_private); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_get_is_private (GBookmarkFile *bookmark, const gchar *uri, GError **error); GLIB_AVAILABLE_IN_ALL void g_bookmark_file_set_icon (GBookmarkFile *bookmark, const gchar *uri, const gchar *href, const gchar *mime_type); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_get_icon (GBookmarkFile *bookmark, const gchar *uri, gchar **href, gchar **mime_type, GError **error); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_set_added_date_time) void g_bookmark_file_set_added (GBookmarkFile *bookmark, const gchar *uri, time_t added); GLIB_AVAILABLE_IN_2_66 void g_bookmark_file_set_added_date_time (GBookmarkFile *bookmark, const char *uri, GDateTime *added); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_get_added_date_time) time_t g_bookmark_file_get_added (GBookmarkFile *bookmark, const gchar *uri, GError **error); GLIB_AVAILABLE_IN_2_66 GDateTime *g_bookmark_file_get_added_date_time (GBookmarkFile *bookmark, const char *uri, GError **error); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_set_modified_date_time) void g_bookmark_file_set_modified (GBookmarkFile *bookmark, const gchar *uri, time_t modified); GLIB_AVAILABLE_IN_2_66 void g_bookmark_file_set_modified_date_time (GBookmarkFile *bookmark, const char *uri, GDateTime *modified); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_get_modified_date_time) time_t g_bookmark_file_get_modified (GBookmarkFile *bookmark, const gchar *uri, GError **error); GLIB_AVAILABLE_IN_2_66 GDateTime *g_bookmark_file_get_modified_date_time (GBookmarkFile *bookmark, const char *uri, GError **error); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_set_visited_date_time) void g_bookmark_file_set_visited (GBookmarkFile *bookmark, const gchar *uri, time_t visited); GLIB_AVAILABLE_IN_2_66 void g_bookmark_file_set_visited_date_time (GBookmarkFile *bookmark, const char *uri, GDateTime *visited); GLIB_DEPRECATED_IN_2_66_FOR(g_bookmark_file_get_visited_date_time) time_t g_bookmark_file_get_visited (GBookmarkFile *bookmark, const gchar *uri, GError **error); GLIB_AVAILABLE_IN_2_66 GDateTime *g_bookmark_file_get_visited_date_time (GBookmarkFile *bookmark, const char *uri, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_has_item (GBookmarkFile *bookmark, const gchar *uri); GLIB_AVAILABLE_IN_ALL gint g_bookmark_file_get_size (GBookmarkFile *bookmark); GLIB_AVAILABLE_IN_ALL gchar ** g_bookmark_file_get_uris (GBookmarkFile *bookmark, gsize *length); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_remove_group (GBookmarkFile *bookmark, const gchar *uri, const gchar *group, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_remove_application (GBookmarkFile *bookmark, const gchar *uri, const gchar *name, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_remove_item (GBookmarkFile *bookmark, const gchar *uri, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_bookmark_file_move_item (GBookmarkFile *bookmark, const gchar *old_uri, const gchar *new_uri, GError **error); G_END_DECLS #endif /* __G_BOOKMARK_FILE_H__ */ glib/giochannel.h 0000644 00000033202 15125173650 0007746 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_IOCHANNEL_H__ #define __G_IOCHANNEL_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gconvert.h> #include <glib/gmain.h> #include <glib/gstring.h> G_BEGIN_DECLS /* GIOChannel */ typedef struct _GIOChannel GIOChannel; typedef struct _GIOFuncs GIOFuncs; typedef enum { G_IO_ERROR_NONE, G_IO_ERROR_AGAIN, G_IO_ERROR_INVAL, G_IO_ERROR_UNKNOWN } GIOError; #define G_IO_CHANNEL_ERROR g_io_channel_error_quark() typedef enum { /* Derived from errno */ G_IO_CHANNEL_ERROR_FBIG, G_IO_CHANNEL_ERROR_INVAL, G_IO_CHANNEL_ERROR_IO, G_IO_CHANNEL_ERROR_ISDIR, G_IO_CHANNEL_ERROR_NOSPC, G_IO_CHANNEL_ERROR_NXIO, G_IO_CHANNEL_ERROR_OVERFLOW, G_IO_CHANNEL_ERROR_PIPE, /* Other */ G_IO_CHANNEL_ERROR_FAILED } GIOChannelError; typedef enum { G_IO_STATUS_ERROR, G_IO_STATUS_NORMAL, G_IO_STATUS_EOF, G_IO_STATUS_AGAIN } GIOStatus; typedef enum { G_SEEK_CUR, G_SEEK_SET, G_SEEK_END } GSeekType; typedef enum { G_IO_FLAG_APPEND = 1 << 0, G_IO_FLAG_NONBLOCK = 1 << 1, G_IO_FLAG_IS_READABLE = 1 << 2, /* Read only flag */ G_IO_FLAG_IS_WRITABLE = 1 << 3, /* Read only flag */ G_IO_FLAG_IS_WRITEABLE = 1 << 3, /* Misspelling in 2.29.10 and earlier */ G_IO_FLAG_IS_SEEKABLE = 1 << 4, /* Read only flag */ G_IO_FLAG_MASK = (1 << 5) - 1, G_IO_FLAG_GET_MASK = G_IO_FLAG_MASK, G_IO_FLAG_SET_MASK = G_IO_FLAG_APPEND | G_IO_FLAG_NONBLOCK } GIOFlags; struct _GIOChannel { /*< private >*/ gint ref_count; GIOFuncs *funcs; gchar *encoding; GIConv read_cd; GIConv write_cd; gchar *line_term; /* String which indicates the end of a line of text */ guint line_term_len; /* So we can have null in the line term */ gsize buf_size; GString *read_buf; /* Raw data from the channel */ GString *encoded_read_buf; /* Channel data converted to UTF-8 */ GString *write_buf; /* Data ready to be written to the file */ gchar partial_write_buf[6]; /* UTF-8 partial characters, null terminated */ /* Group the flags together, immediately after partial_write_buf, to save memory */ guint use_buffer : 1; /* The encoding uses the buffers */ guint do_encode : 1; /* The encoding uses the GIConv coverters */ guint close_on_unref : 1; /* Close the channel on final unref */ guint is_readable : 1; /* Cached GIOFlag */ guint is_writeable : 1; /* ditto */ guint is_seekable : 1; /* ditto */ gpointer reserved1; gpointer reserved2; }; typedef gboolean (*GIOFunc) (GIOChannel *source, GIOCondition condition, gpointer data); struct _GIOFuncs { GIOStatus (*io_read) (GIOChannel *channel, gchar *buf, gsize count, gsize *bytes_read, GError **err); GIOStatus (*io_write) (GIOChannel *channel, const gchar *buf, gsize count, gsize *bytes_written, GError **err); GIOStatus (*io_seek) (GIOChannel *channel, gint64 offset, GSeekType type, GError **err); GIOStatus (*io_close) (GIOChannel *channel, GError **err); GSource* (*io_create_watch) (GIOChannel *channel, GIOCondition condition); void (*io_free) (GIOChannel *channel); GIOStatus (*io_set_flags) (GIOChannel *channel, GIOFlags flags, GError **err); GIOFlags (*io_get_flags) (GIOChannel *channel); }; GLIB_AVAILABLE_IN_ALL void g_io_channel_init (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOChannel *g_io_channel_ref (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL void g_io_channel_unref (GIOChannel *channel); GLIB_DEPRECATED_FOR(g_io_channel_read_chars) GIOError g_io_channel_read (GIOChannel *channel, gchar *buf, gsize count, gsize *bytes_read); GLIB_DEPRECATED_FOR(g_io_channel_write_chars) GIOError g_io_channel_write (GIOChannel *channel, const gchar *buf, gsize count, gsize *bytes_written); GLIB_DEPRECATED_FOR(g_io_channel_seek_position) GIOError g_io_channel_seek (GIOChannel *channel, gint64 offset, GSeekType type); GLIB_DEPRECATED_FOR(g_io_channel_shutdown) void g_io_channel_close (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_shutdown (GIOChannel *channel, gboolean flush, GError **err); GLIB_AVAILABLE_IN_ALL guint g_io_add_watch_full (GIOChannel *channel, gint priority, GIOCondition condition, GIOFunc func, gpointer user_data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL GSource * g_io_create_watch (GIOChannel *channel, GIOCondition condition); GLIB_AVAILABLE_IN_ALL guint g_io_add_watch (GIOChannel *channel, GIOCondition condition, GIOFunc func, gpointer user_data); /* character encoding conversion involved functions. */ GLIB_AVAILABLE_IN_ALL void g_io_channel_set_buffer_size (GIOChannel *channel, gsize size); GLIB_AVAILABLE_IN_ALL gsize g_io_channel_get_buffer_size (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOCondition g_io_channel_get_buffer_condition (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_set_flags (GIOChannel *channel, GIOFlags flags, GError **error); GLIB_AVAILABLE_IN_ALL GIOFlags g_io_channel_get_flags (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL void g_io_channel_set_line_term (GIOChannel *channel, const gchar *line_term, gint length); GLIB_AVAILABLE_IN_ALL const gchar * g_io_channel_get_line_term (GIOChannel *channel, gint *length); GLIB_AVAILABLE_IN_ALL void g_io_channel_set_buffered (GIOChannel *channel, gboolean buffered); GLIB_AVAILABLE_IN_ALL gboolean g_io_channel_get_buffered (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_set_encoding (GIOChannel *channel, const gchar *encoding, GError **error); GLIB_AVAILABLE_IN_ALL const gchar * g_io_channel_get_encoding (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL void g_io_channel_set_close_on_unref (GIOChannel *channel, gboolean do_close); GLIB_AVAILABLE_IN_ALL gboolean g_io_channel_get_close_on_unref (GIOChannel *channel); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_flush (GIOChannel *channel, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_read_line (GIOChannel *channel, gchar **str_return, gsize *length, gsize *terminator_pos, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_read_line_string (GIOChannel *channel, GString *buffer, gsize *terminator_pos, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_read_to_end (GIOChannel *channel, gchar **str_return, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_read_chars (GIOChannel *channel, gchar *buf, gsize count, gsize *bytes_read, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_read_unichar (GIOChannel *channel, gunichar *thechar, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_write_chars (GIOChannel *channel, const gchar *buf, gssize count, gsize *bytes_written, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_write_unichar (GIOChannel *channel, gunichar thechar, GError **error); GLIB_AVAILABLE_IN_ALL GIOStatus g_io_channel_seek_position (GIOChannel *channel, gint64 offset, GSeekType type, GError **error); GLIB_AVAILABLE_IN_ALL GIOChannel* g_io_channel_new_file (const gchar *filename, const gchar *mode, GError **error); /* Error handling */ GLIB_AVAILABLE_IN_ALL GQuark g_io_channel_error_quark (void); GLIB_AVAILABLE_IN_ALL GIOChannelError g_io_channel_error_from_errno (gint en); /* On Unix, IO channels created with this function for any file * descriptor or socket. * * On Win32, this can be used either for files opened with the MSVCRT * (the Microsoft run-time C library) _open() or _pipe, including file * descriptors 0, 1 and 2 (corresponding to stdin, stdout and stderr), * or for Winsock SOCKETs. If the parameter is a legal file * descriptor, it is assumed to be such, otherwise it should be a * SOCKET. This relies on SOCKETs and file descriptors not * overlapping. If you want to be certain, call either * g_io_channel_win32_new_fd() or g_io_channel_win32_new_socket() * instead as appropriate. * * The term file descriptor as used in the context of Win32 refers to * the emulated Unix-like file descriptors MSVCRT provides. The native * corresponding concept is file HANDLE. There isn't as of yet a way to * get GIOChannels for Win32 file HANDLEs. */ GLIB_AVAILABLE_IN_ALL GIOChannel* g_io_channel_unix_new (int fd); GLIB_AVAILABLE_IN_ALL gint g_io_channel_unix_get_fd (GIOChannel *channel); /* Hook for GClosure / GSource integration. Don't touch */ GLIB_VAR GSourceFuncs g_io_watch_funcs; #ifdef G_OS_WIN32 /* You can use this "pseudo file descriptor" in a GPollFD to add * polling for Windows messages. GTK applications should not do that. */ #define G_WIN32_MSG_HANDLE 19981206 /* Use this to get a GPollFD from a GIOChannel, so that you can call * g_io_channel_win32_poll(). After calling this you should only use * g_io_channel_read() to read from the GIOChannel, i.e. never read() * from the underlying file descriptor. For SOCKETs, it is possible to call * recv(). */ GLIB_AVAILABLE_IN_ALL void g_io_channel_win32_make_pollfd (GIOChannel *channel, GIOCondition condition, GPollFD *fd); /* This can be used to wait until at least one of the channels is readable. * On Unix you would do a select() on the file descriptors of the channels. */ GLIB_AVAILABLE_IN_ALL gint g_io_channel_win32_poll (GPollFD *fds, gint n_fds, gint timeout_); /* Create an IO channel for Windows messages for window handle hwnd. */ #if GLIB_SIZEOF_VOID_P == 8 /* We use gsize here so that it is still an integer type and not a * pointer, like the guint in the traditional prototype. We can't use * intptr_t as that is not portable enough. */ GLIB_AVAILABLE_IN_ALL GIOChannel *g_io_channel_win32_new_messages (gsize hwnd); #else GLIB_AVAILABLE_IN_ALL GIOChannel *g_io_channel_win32_new_messages (guint hwnd); #endif /* Create an IO channel for C runtime (emulated Unix-like) file * descriptors. After calling g_io_add_watch() on a IO channel * returned by this function, you shouldn't call read() on the file * descriptor. This is because adding polling for a file descriptor is * implemented on Win32 by starting a thread that sits blocked in a * read() from the file descriptor most of the time. All reads from * the file descriptor should be done by this internal GLib * thread. Your code should call only g_io_channel_read_chars(). */ GLIB_AVAILABLE_IN_ALL GIOChannel* g_io_channel_win32_new_fd (gint fd); /* Get the C runtime file descriptor of a channel. */ GLIB_AVAILABLE_IN_ALL gint g_io_channel_win32_get_fd (GIOChannel *channel); /* Create an IO channel for a winsock socket. The parameter should be * a SOCKET. Contrary to IO channels for file descriptors (on *Win32), * you can use normal recv() or recvfrom() on sockets even if GLib * is polling them. */ GLIB_AVAILABLE_IN_ALL GIOChannel *g_io_channel_win32_new_socket (gint socket); GLIB_DEPRECATED_FOR(g_io_channel_win32_new_socket) GIOChannel *g_io_channel_win32_new_stream_socket (gint socket); GLIB_AVAILABLE_IN_ALL void g_io_channel_win32_set_debug (GIOChannel *channel, gboolean flag); #endif G_END_DECLS #endif /* __G_IOCHANNEL_H__ */ glib/gvariant.h 0000644 00000071570 15125173650 0007464 0 ustar 00 /* * Copyright © 2007, 2008 Ryan Lortie * Copyright © 2009, 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_VARIANT_H__ #define __G_VARIANT_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gvarianttype.h> #include <glib/gstring.h> #include <glib/gbytes.h> G_BEGIN_DECLS typedef struct _GVariant GVariant; typedef enum { G_VARIANT_CLASS_BOOLEAN = 'b', G_VARIANT_CLASS_BYTE = 'y', G_VARIANT_CLASS_INT16 = 'n', G_VARIANT_CLASS_UINT16 = 'q', G_VARIANT_CLASS_INT32 = 'i', G_VARIANT_CLASS_UINT32 = 'u', G_VARIANT_CLASS_INT64 = 'x', G_VARIANT_CLASS_UINT64 = 't', G_VARIANT_CLASS_HANDLE = 'h', G_VARIANT_CLASS_DOUBLE = 'd', G_VARIANT_CLASS_STRING = 's', G_VARIANT_CLASS_OBJECT_PATH = 'o', G_VARIANT_CLASS_SIGNATURE = 'g', G_VARIANT_CLASS_VARIANT = 'v', G_VARIANT_CLASS_MAYBE = 'm', G_VARIANT_CLASS_ARRAY = 'a', G_VARIANT_CLASS_TUPLE = '(', G_VARIANT_CLASS_DICT_ENTRY = '{' } GVariantClass; GLIB_AVAILABLE_IN_ALL void g_variant_unref (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_ref (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_ref_sink (GVariant *value); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_floating (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_take_ref (GVariant *value); GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_get_type (GVariant *value); GLIB_AVAILABLE_IN_ALL const gchar * g_variant_get_type_string (GVariant *value); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_of_type (GVariant *value, const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_container (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariantClass g_variant_classify (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_boolean (gboolean value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_byte (guint8 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_int16 (gint16 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_uint16 (guint16 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_int32 (gint32 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_uint32 (guint32 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_int64 (gint64 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_uint64 (guint64 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_handle (gint32 value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_double (gdouble value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_string (const gchar *string); GLIB_AVAILABLE_IN_2_38 GVariant * g_variant_new_take_string (gchar *string); GLIB_AVAILABLE_IN_2_38 GVariant * g_variant_new_printf (const gchar *format_string, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_object_path (const gchar *object_path); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_object_path (const gchar *string); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_signature (const gchar *signature); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_signature (const gchar *string); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_variant (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_strv (const gchar * const *strv, gssize length); GLIB_AVAILABLE_IN_2_30 GVariant * g_variant_new_objv (const gchar * const *strv, gssize length); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_bytestring (const gchar *string); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_bytestring_array (const gchar * const *strv, gssize length); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_fixed_array (const GVariantType *element_type, gconstpointer elements, gsize n_elements, gsize element_size); GLIB_AVAILABLE_IN_ALL gboolean g_variant_get_boolean (GVariant *value); GLIB_AVAILABLE_IN_ALL guint8 g_variant_get_byte (GVariant *value); GLIB_AVAILABLE_IN_ALL gint16 g_variant_get_int16 (GVariant *value); GLIB_AVAILABLE_IN_ALL guint16 g_variant_get_uint16 (GVariant *value); GLIB_AVAILABLE_IN_ALL gint32 g_variant_get_int32 (GVariant *value); GLIB_AVAILABLE_IN_ALL guint32 g_variant_get_uint32 (GVariant *value); GLIB_AVAILABLE_IN_ALL gint64 g_variant_get_int64 (GVariant *value); GLIB_AVAILABLE_IN_ALL guint64 g_variant_get_uint64 (GVariant *value); GLIB_AVAILABLE_IN_ALL gint32 g_variant_get_handle (GVariant *value); GLIB_AVAILABLE_IN_ALL gdouble g_variant_get_double (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_get_variant (GVariant *value); GLIB_AVAILABLE_IN_ALL const gchar * g_variant_get_string (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL gchar * g_variant_dup_string (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL const gchar ** g_variant_get_strv (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL gchar ** g_variant_dup_strv (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_2_30 const gchar ** g_variant_get_objv (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL gchar ** g_variant_dup_objv (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL const gchar * g_variant_get_bytestring (GVariant *value); GLIB_AVAILABLE_IN_ALL gchar * g_variant_dup_bytestring (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL const gchar ** g_variant_get_bytestring_array (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL gchar ** g_variant_dup_bytestring_array (GVariant *value, gsize *length); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_maybe (const GVariantType *child_type, GVariant *child); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_array (const GVariantType *child_type, GVariant * const *children, gsize n_children); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_tuple (GVariant * const *children, gsize n_children); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_dict_entry (GVariant *key, GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_get_maybe (GVariant *value); GLIB_AVAILABLE_IN_ALL gsize g_variant_n_children (GVariant *value); GLIB_AVAILABLE_IN_ALL void g_variant_get_child (GVariant *value, gsize index_, const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_get_child_value (GVariant *value, gsize index_); GLIB_AVAILABLE_IN_ALL gboolean g_variant_lookup (GVariant *dictionary, const gchar *key, const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_lookup_value (GVariant *dictionary, const gchar *key, const GVariantType *expected_type); GLIB_AVAILABLE_IN_ALL gconstpointer g_variant_get_fixed_array (GVariant *value, gsize *n_elements, gsize element_size); GLIB_AVAILABLE_IN_ALL gsize g_variant_get_size (GVariant *value); GLIB_AVAILABLE_IN_ALL gconstpointer g_variant_get_data (GVariant *value); GLIB_AVAILABLE_IN_2_36 GBytes * g_variant_get_data_as_bytes (GVariant *value); GLIB_AVAILABLE_IN_ALL void g_variant_store (GVariant *value, gpointer data); GLIB_AVAILABLE_IN_ALL gchar * g_variant_print (GVariant *value, gboolean type_annotate); GLIB_AVAILABLE_IN_ALL GString * g_variant_print_string (GVariant *value, GString *string, gboolean type_annotate); GLIB_AVAILABLE_IN_ALL guint g_variant_hash (gconstpointer value); GLIB_AVAILABLE_IN_ALL gboolean g_variant_equal (gconstpointer one, gconstpointer two); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_get_normal_form (GVariant *value); GLIB_AVAILABLE_IN_ALL gboolean g_variant_is_normal_form (GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_byteswap (GVariant *value); GLIB_AVAILABLE_IN_2_36 GVariant * g_variant_new_from_bytes (const GVariantType *type, GBytes *bytes, gboolean trusted); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_from_data (const GVariantType *type, gconstpointer data, gsize size, gboolean trusted, GDestroyNotify notify, gpointer user_data); typedef struct _GVariantIter GVariantIter; struct _GVariantIter { /*< private >*/ gsize x[16]; }; GLIB_AVAILABLE_IN_ALL GVariantIter * g_variant_iter_new (GVariant *value); GLIB_AVAILABLE_IN_ALL gsize g_variant_iter_init (GVariantIter *iter, GVariant *value); GLIB_AVAILABLE_IN_ALL GVariantIter * g_variant_iter_copy (GVariantIter *iter); GLIB_AVAILABLE_IN_ALL gsize g_variant_iter_n_children (GVariantIter *iter); GLIB_AVAILABLE_IN_ALL void g_variant_iter_free (GVariantIter *iter); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_iter_next_value (GVariantIter *iter); GLIB_AVAILABLE_IN_ALL gboolean g_variant_iter_next (GVariantIter *iter, const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL gboolean g_variant_iter_loop (GVariantIter *iter, const gchar *format_string, ...); typedef struct _GVariantBuilder GVariantBuilder; struct _GVariantBuilder { /*< private >*/ union { struct { gsize partial_magic; const GVariantType *type; gsize y[14]; } s; gsize x[16]; } u; }; typedef enum { G_VARIANT_PARSE_ERROR_FAILED, G_VARIANT_PARSE_ERROR_BASIC_TYPE_EXPECTED, G_VARIANT_PARSE_ERROR_CANNOT_INFER_TYPE, G_VARIANT_PARSE_ERROR_DEFINITE_TYPE_EXPECTED, G_VARIANT_PARSE_ERROR_INPUT_NOT_AT_END, G_VARIANT_PARSE_ERROR_INVALID_CHARACTER, G_VARIANT_PARSE_ERROR_INVALID_FORMAT_STRING, G_VARIANT_PARSE_ERROR_INVALID_OBJECT_PATH, G_VARIANT_PARSE_ERROR_INVALID_SIGNATURE, G_VARIANT_PARSE_ERROR_INVALID_TYPE_STRING, G_VARIANT_PARSE_ERROR_NO_COMMON_TYPE, G_VARIANT_PARSE_ERROR_NUMBER_OUT_OF_RANGE, G_VARIANT_PARSE_ERROR_NUMBER_TOO_BIG, G_VARIANT_PARSE_ERROR_TYPE_ERROR, G_VARIANT_PARSE_ERROR_UNEXPECTED_TOKEN, G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD, G_VARIANT_PARSE_ERROR_UNTERMINATED_STRING_CONSTANT, G_VARIANT_PARSE_ERROR_VALUE_EXPECTED, G_VARIANT_PARSE_ERROR_RECURSION } GVariantParseError; #define G_VARIANT_PARSE_ERROR (g_variant_parse_error_quark ()) GLIB_DEPRECATED_IN_2_38_FOR(g_variant_parse_error_quark) GQuark g_variant_parser_get_error_quark (void); GLIB_AVAILABLE_IN_ALL GQuark g_variant_parse_error_quark (void); /** * G_VARIANT_BUILDER_INIT: * @variant_type: a const GVariantType* * * A stack-allocated #GVariantBuilder must be initialized if it is * used together with g_auto() to avoid warnings or crashes if * function returns before g_variant_builder_init() is called on the * builder. This macro can be used as initializer instead of an * explicit zeroing a variable when declaring it and a following * g_variant_builder_init(), but it cannot be assigned to a variable. * * The passed @variant_type should be a static GVariantType to avoid * lifetime issues, as copying the @variant_type does not happen in * the G_VARIANT_BUILDER_INIT() call, but rather in functions that * make sure that #GVariantBuilder is valid. * * |[ * g_auto(GVariantBuilder) builder = G_VARIANT_BUILDER_INIT (G_VARIANT_TYPE_BYTESTRING); * ]| * * Since: 2.50 */ #define G_VARIANT_BUILDER_INIT(variant_type) { { { 2942751021u, variant_type, { 0, } } } } GLIB_AVAILABLE_IN_ALL GVariantBuilder * g_variant_builder_new (const GVariantType *type); GLIB_AVAILABLE_IN_ALL void g_variant_builder_unref (GVariantBuilder *builder); GLIB_AVAILABLE_IN_ALL GVariantBuilder * g_variant_builder_ref (GVariantBuilder *builder); GLIB_AVAILABLE_IN_ALL void g_variant_builder_init (GVariantBuilder *builder, const GVariantType *type); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_builder_end (GVariantBuilder *builder); GLIB_AVAILABLE_IN_ALL void g_variant_builder_clear (GVariantBuilder *builder); GLIB_AVAILABLE_IN_ALL void g_variant_builder_open (GVariantBuilder *builder, const GVariantType *type); GLIB_AVAILABLE_IN_ALL void g_variant_builder_close (GVariantBuilder *builder); GLIB_AVAILABLE_IN_ALL void g_variant_builder_add_value (GVariantBuilder *builder, GVariant *value); GLIB_AVAILABLE_IN_ALL void g_variant_builder_add (GVariantBuilder *builder, const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL void g_variant_builder_add_parsed (GVariantBuilder *builder, const gchar *format, ...); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new (const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL void g_variant_get (GVariant *value, const gchar *format_string, ...); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_va (const gchar *format_string, const gchar **endptr, va_list *app); GLIB_AVAILABLE_IN_ALL void g_variant_get_va (GVariant *value, const gchar *format_string, const gchar **endptr, va_list *app); GLIB_AVAILABLE_IN_2_34 gboolean g_variant_check_format_string (GVariant *value, const gchar *format_string, gboolean copy_only); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_parse (const GVariantType *type, const gchar *text, const gchar *limit, const gchar **endptr, GError **error); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_parsed (const gchar *format, ...); GLIB_AVAILABLE_IN_ALL GVariant * g_variant_new_parsed_va (const gchar *format, va_list *app); GLIB_AVAILABLE_IN_2_40 gchar * g_variant_parse_error_print_context (GError *error, const gchar *source_str); GLIB_AVAILABLE_IN_ALL gint g_variant_compare (gconstpointer one, gconstpointer two); typedef struct _GVariantDict GVariantDict; struct _GVariantDict { /*< private >*/ union { struct { GVariant *asv; gsize partial_magic; gsize y[14]; } s; gsize x[16]; } u; }; /** * G_VARIANT_DICT_INIT: * @asv: (nullable): a GVariant* * * A stack-allocated #GVariantDict must be initialized if it is used * together with g_auto() to avoid warnings or crashes if function * returns before g_variant_dict_init() is called on the builder. * This macro can be used as initializer instead of an explicit * zeroing a variable when declaring it and a following * g_variant_dict_init(), but it cannot be assigned to a variable. * * The passed @asv has to live long enough for #GVariantDict to gather * the entries from, as the gathering does not happen in the * G_VARIANT_DICT_INIT() call, but rather in functions that make sure * that #GVariantDict is valid. In context where the initialization * value has to be a constant expression, the only possible value of * @asv is %NULL. It is still possible to call g_variant_dict_init() * safely with a different @asv right after the variable was * initialized with G_VARIANT_DICT_INIT(). * * |[ * g_autoptr(GVariant) variant = get_asv_variant (); * g_auto(GVariantDict) dict = G_VARIANT_DICT_INIT (variant); * ]| * * Since: 2.50 */ #define G_VARIANT_DICT_INIT(asv) { { { asv, 3488698669u, { 0, } } } } GLIB_AVAILABLE_IN_2_40 GVariantDict * g_variant_dict_new (GVariant *from_asv); GLIB_AVAILABLE_IN_2_40 void g_variant_dict_init (GVariantDict *dict, GVariant *from_asv); GLIB_AVAILABLE_IN_2_40 gboolean g_variant_dict_lookup (GVariantDict *dict, const gchar *key, const gchar *format_string, ...); GLIB_AVAILABLE_IN_2_40 GVariant * g_variant_dict_lookup_value (GVariantDict *dict, const gchar *key, const GVariantType *expected_type); GLIB_AVAILABLE_IN_2_40 gboolean g_variant_dict_contains (GVariantDict *dict, const gchar *key); GLIB_AVAILABLE_IN_2_40 void g_variant_dict_insert (GVariantDict *dict, const gchar *key, const gchar *format_string, ...); GLIB_AVAILABLE_IN_2_40 void g_variant_dict_insert_value (GVariantDict *dict, const gchar *key, GVariant *value); GLIB_AVAILABLE_IN_2_40 gboolean g_variant_dict_remove (GVariantDict *dict, const gchar *key); GLIB_AVAILABLE_IN_2_40 void g_variant_dict_clear (GVariantDict *dict); GLIB_AVAILABLE_IN_2_40 GVariant * g_variant_dict_end (GVariantDict *dict); GLIB_AVAILABLE_IN_2_40 GVariantDict * g_variant_dict_ref (GVariantDict *dict); GLIB_AVAILABLE_IN_2_40 void g_variant_dict_unref (GVariantDict *dict); G_END_DECLS #endif /* __G_VARIANT_H__ */ glib/gvarianttype.h 0000644 00000031674 15125173650 0010367 0 ustar 00 /* * Copyright © 2007, 2008 Ryan Lortie * Copyright © 2009, 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_VARIANT_TYPE_H__ #define __G_VARIANT_TYPE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS /** * GVariantType: * * A type in the GVariant type system. * * Two types may not be compared by value; use g_variant_type_equal() or * g_variant_type_is_subtype_of(). May be copied using * g_variant_type_copy() and freed using g_variant_type_free(). **/ typedef struct _GVariantType GVariantType; /** * G_VARIANT_TYPE_BOOLEAN: * * The type of a value that can be either %TRUE or %FALSE. **/ #define G_VARIANT_TYPE_BOOLEAN ((const GVariantType *) "b") /** * G_VARIANT_TYPE_BYTE: * * The type of an integer value that can range from 0 to 255. **/ #define G_VARIANT_TYPE_BYTE ((const GVariantType *) "y") /** * G_VARIANT_TYPE_INT16: * * The type of an integer value that can range from -32768 to 32767. **/ #define G_VARIANT_TYPE_INT16 ((const GVariantType *) "n") /** * G_VARIANT_TYPE_UINT16: * * The type of an integer value that can range from 0 to 65535. * There were about this many people living in Toronto in the 1870s. **/ #define G_VARIANT_TYPE_UINT16 ((const GVariantType *) "q") /** * G_VARIANT_TYPE_INT32: * * The type of an integer value that can range from -2147483648 to * 2147483647. **/ #define G_VARIANT_TYPE_INT32 ((const GVariantType *) "i") /** * G_VARIANT_TYPE_UINT32: * * The type of an integer value that can range from 0 to 4294967295. * That's one number for everyone who was around in the late 1970s. **/ #define G_VARIANT_TYPE_UINT32 ((const GVariantType *) "u") /** * G_VARIANT_TYPE_INT64: * * The type of an integer value that can range from * -9223372036854775808 to 9223372036854775807. **/ #define G_VARIANT_TYPE_INT64 ((const GVariantType *) "x") /** * G_VARIANT_TYPE_UINT64: * * The type of an integer value that can range from 0 * to 18446744073709551615 (inclusive). That's a really big number, * but a Rubik's cube can have a bit more than twice as many possible * positions. **/ #define G_VARIANT_TYPE_UINT64 ((const GVariantType *) "t") /** * G_VARIANT_TYPE_DOUBLE: * * The type of a double precision IEEE754 floating point number. * These guys go up to about 1.80e308 (plus and minus) but miss out on * some numbers in between. In any case, that's far greater than the * estimated number of fundamental particles in the observable * universe. **/ #define G_VARIANT_TYPE_DOUBLE ((const GVariantType *) "d") /** * G_VARIANT_TYPE_STRING: * * The type of a string. "" is a string. %NULL is not a string. **/ #define G_VARIANT_TYPE_STRING ((const GVariantType *) "s") /** * G_VARIANT_TYPE_OBJECT_PATH: * * The type of a D-Bus object reference. These are strings of a * specific format used to identify objects at a given destination on * the bus. * * If you are not interacting with D-Bus, then there is no reason to make * use of this type. If you are, then the D-Bus specification contains a * precise description of valid object paths. **/ #define G_VARIANT_TYPE_OBJECT_PATH ((const GVariantType *) "o") /** * G_VARIANT_TYPE_SIGNATURE: * * The type of a D-Bus type signature. These are strings of a specific * format used as type signatures for D-Bus methods and messages. * * If you are not interacting with D-Bus, then there is no reason to make * use of this type. If you are, then the D-Bus specification contains a * precise description of valid signature strings. **/ #define G_VARIANT_TYPE_SIGNATURE ((const GVariantType *) "g") /** * G_VARIANT_TYPE_VARIANT: * * The type of a box that contains any other value (including another * variant). **/ #define G_VARIANT_TYPE_VARIANT ((const GVariantType *) "v") /** * G_VARIANT_TYPE_HANDLE: * * The type of a 32bit signed integer value, that by convention, is used * as an index into an array of file descriptors that are sent alongside * a D-Bus message. * * If you are not interacting with D-Bus, then there is no reason to make * use of this type. **/ #define G_VARIANT_TYPE_HANDLE ((const GVariantType *) "h") /** * G_VARIANT_TYPE_UNIT: * * The empty tuple type. Has only one instance. Known also as "triv" * or "void". **/ #define G_VARIANT_TYPE_UNIT ((const GVariantType *) "()") /** * G_VARIANT_TYPE_ANY: * * An indefinite type that is a supertype of every type (including * itself). **/ #define G_VARIANT_TYPE_ANY ((const GVariantType *) "*") /** * G_VARIANT_TYPE_BASIC: * * An indefinite type that is a supertype of every basic (ie: * non-container) type. **/ #define G_VARIANT_TYPE_BASIC ((const GVariantType *) "?") /** * G_VARIANT_TYPE_MAYBE: * * An indefinite type that is a supertype of every maybe type. **/ #define G_VARIANT_TYPE_MAYBE ((const GVariantType *) "m*") /** * G_VARIANT_TYPE_ARRAY: * * An indefinite type that is a supertype of every array type. **/ #define G_VARIANT_TYPE_ARRAY ((const GVariantType *) "a*") /** * G_VARIANT_TYPE_TUPLE: * * An indefinite type that is a supertype of every tuple type, * regardless of the number of items in the tuple. **/ #define G_VARIANT_TYPE_TUPLE ((const GVariantType *) "r") /** * G_VARIANT_TYPE_DICT_ENTRY: * * An indefinite type that is a supertype of every dictionary entry * type. **/ #define G_VARIANT_TYPE_DICT_ENTRY ((const GVariantType *) "{?*}") /** * G_VARIANT_TYPE_DICTIONARY: * * An indefinite type that is a supertype of every dictionary type -- * that is, any array type that has an element type equal to any * dictionary entry type. **/ #define G_VARIANT_TYPE_DICTIONARY ((const GVariantType *) "a{?*}") /** * G_VARIANT_TYPE_STRING_ARRAY: * * The type of an array of strings. **/ #define G_VARIANT_TYPE_STRING_ARRAY ((const GVariantType *) "as") /** * G_VARIANT_TYPE_OBJECT_PATH_ARRAY: * * The type of an array of object paths. **/ #define G_VARIANT_TYPE_OBJECT_PATH_ARRAY ((const GVariantType *) "ao") /** * G_VARIANT_TYPE_BYTESTRING: * * The type of an array of bytes. This type is commonly used to pass * around strings that may not be valid utf8. In that case, the * convention is that the nul terminator character should be included as * the last character in the array. **/ #define G_VARIANT_TYPE_BYTESTRING ((const GVariantType *) "ay") /** * G_VARIANT_TYPE_BYTESTRING_ARRAY: * * The type of an array of byte strings (an array of arrays of bytes). **/ #define G_VARIANT_TYPE_BYTESTRING_ARRAY ((const GVariantType *) "aay") /** * G_VARIANT_TYPE_VARDICT: * * The type of a dictionary mapping strings to variants (the ubiquitous * "a{sv}" type). * * Since: 2.30 **/ #define G_VARIANT_TYPE_VARDICT ((const GVariantType *) "a{sv}") /** * G_VARIANT_TYPE: * @type_string: a well-formed #GVariantType type string * * Converts a string to a const #GVariantType. Depending on the * current debugging level, this function may perform a runtime check * to ensure that @string is a valid GVariant type string. * * It is always a programmer error to use this macro with an invalid * type string. If in doubt, use g_variant_type_string_is_valid() to * check if the string is valid. * * Since 2.24 **/ #ifndef G_DISABLE_CHECKS # define G_VARIANT_TYPE(type_string) (g_variant_type_checked_ ((type_string))) #else # define G_VARIANT_TYPE(type_string) ((const GVariantType *) (type_string)) #endif /* type string checking */ GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_string_is_valid (const gchar *type_string); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_string_scan (const gchar *string, const gchar *limit, const gchar **endptr); /* create/destroy */ GLIB_AVAILABLE_IN_ALL void g_variant_type_free (GVariantType *type); GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_copy (const GVariantType *type); GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_new (const gchar *type_string); /* getters */ GLIB_AVAILABLE_IN_ALL gsize g_variant_type_get_string_length (const GVariantType *type); GLIB_AVAILABLE_IN_ALL const gchar * g_variant_type_peek_string (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gchar * g_variant_type_dup_string (const GVariantType *type); /* classification */ GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_definite (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_container (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_basic (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_maybe (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_array (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_tuple (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_dict_entry (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_variant (const GVariantType *type); /* for hash tables */ GLIB_AVAILABLE_IN_ALL guint g_variant_type_hash (gconstpointer type); GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_equal (gconstpointer type1, gconstpointer type2); /* subtypes */ GLIB_AVAILABLE_IN_ALL gboolean g_variant_type_is_subtype_of (const GVariantType *type, const GVariantType *supertype); /* type iterator interface */ GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_element (const GVariantType *type); GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_first (const GVariantType *type); GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_next (const GVariantType *type); GLIB_AVAILABLE_IN_ALL gsize g_variant_type_n_items (const GVariantType *type); GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_key (const GVariantType *type); GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_value (const GVariantType *type); /* constructors */ GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_new_array (const GVariantType *element); GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_new_maybe (const GVariantType *element); GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_new_tuple (const GVariantType * const *items, gint length); GLIB_AVAILABLE_IN_ALL GVariantType * g_variant_type_new_dict_entry (const GVariantType *key, const GVariantType *value); /*< private >*/ GLIB_AVAILABLE_IN_ALL const GVariantType * g_variant_type_checked_ (const gchar *); GLIB_AVAILABLE_IN_2_60 gsize g_variant_type_string_get_depth_ (const gchar *type_string); G_END_DECLS #endif /* __G_VARIANT_TYPE_H__ */ glib/grcbox.h 0000644 00000007630 15125173650 0007131 0 ustar 00 /* grcbox.h: Reference counted data * * Copyright 2018 Emmanuele Bassi * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #pragma once #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmem.h> #if defined(glib_typeof_2_68) && GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68 /* for glib_typeof */ #include <type_traits> #endif G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_58 gpointer g_rc_box_alloc (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_rc_box_alloc0 (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_rc_box_dup (gsize block_size, gconstpointer mem_block) G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_rc_box_acquire (gpointer mem_block); GLIB_AVAILABLE_IN_2_58 void g_rc_box_release (gpointer mem_block); GLIB_AVAILABLE_IN_2_58 void g_rc_box_release_full (gpointer mem_block, GDestroyNotify clear_func); GLIB_AVAILABLE_IN_2_58 gsize g_rc_box_get_size (gpointer mem_block); GLIB_AVAILABLE_IN_2_58 gpointer g_atomic_rc_box_alloc (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_atomic_rc_box_alloc0 (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_atomic_rc_box_dup (gsize block_size, gconstpointer mem_block) G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_2_58 gpointer g_atomic_rc_box_acquire (gpointer mem_block); GLIB_AVAILABLE_IN_2_58 void g_atomic_rc_box_release (gpointer mem_block); GLIB_AVAILABLE_IN_2_58 void g_atomic_rc_box_release_full (gpointer mem_block, GDestroyNotify clear_func); GLIB_AVAILABLE_IN_2_58 gsize g_atomic_rc_box_get_size (gpointer mem_block); #define g_rc_box_new(type) \ ((type *) g_rc_box_alloc (sizeof (type))) #define g_rc_box_new0(type) \ ((type *) g_rc_box_alloc0 (sizeof (type))) #define g_atomic_rc_box_new(type) \ ((type *) g_atomic_rc_box_alloc (sizeof (type))) #define g_atomic_rc_box_new0(type) \ ((type *) g_atomic_rc_box_alloc0 (sizeof (type))) #if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) /* Type check to avoid assigning references to different types */ #define g_rc_box_acquire(mem_block) \ ((glib_typeof (mem_block)) (g_rc_box_acquire) (mem_block)) #define g_atomic_rc_box_acquire(mem_block) \ ((glib_typeof (mem_block)) (g_atomic_rc_box_acquire) (mem_block)) /* Type check to avoid duplicating data to different types */ #define g_rc_box_dup(block_size, mem_block) \ ((glib_typeof (mem_block)) (g_rc_box_dup) (block_size, mem_block)) #define g_atomic_rc_box_dup(block_size, mem_block) \ ((glib_typeof (mem_block)) (g_atomic_rc_box_dup) (block_size, mem_block)) #endif G_END_DECLS glib/gmarkup.h 0000644 00000025174 15125173650 0007316 0 ustar 00 /* gmarkup.h - Simple XML-like string parser/writer * * Copyright 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_MARKUP_H__ #define __G_MARKUP_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <stdarg.h> #include <glib/gerror.h> #include <glib/gslist.h> G_BEGIN_DECLS /** * GMarkupError: * @G_MARKUP_ERROR_BAD_UTF8: text being parsed was not valid UTF-8 * @G_MARKUP_ERROR_EMPTY: document contained nothing, or only whitespace * @G_MARKUP_ERROR_PARSE: document was ill-formed * @G_MARKUP_ERROR_UNKNOWN_ELEMENT: error should be set by #GMarkupParser * functions; element wasn't known * @G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE: error should be set by #GMarkupParser * functions; attribute wasn't known * @G_MARKUP_ERROR_INVALID_CONTENT: error should be set by #GMarkupParser * functions; content was invalid * @G_MARKUP_ERROR_MISSING_ATTRIBUTE: error should be set by #GMarkupParser * functions; a required attribute was missing * * Error codes returned by markup parsing. */ typedef enum { G_MARKUP_ERROR_BAD_UTF8, G_MARKUP_ERROR_EMPTY, G_MARKUP_ERROR_PARSE, /* The following are primarily intended for specific GMarkupParser * implementations to set. */ G_MARKUP_ERROR_UNKNOWN_ELEMENT, G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE, G_MARKUP_ERROR_INVALID_CONTENT, G_MARKUP_ERROR_MISSING_ATTRIBUTE } GMarkupError; /** * G_MARKUP_ERROR: * * Error domain for markup parsing. * Errors in this domain will be from the #GMarkupError enumeration. * See #GError for information on error domains. */ #define G_MARKUP_ERROR g_markup_error_quark () GLIB_AVAILABLE_IN_ALL GQuark g_markup_error_quark (void); /** * GMarkupParseFlags: * @G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG: flag you should not use * @G_MARKUP_TREAT_CDATA_AS_TEXT: When this flag is set, CDATA marked * sections are not passed literally to the @passthrough function of * the parser. Instead, the content of the section (without the * `<![CDATA[` and `]]>`) is * passed to the @text function. This flag was added in GLib 2.12 * @G_MARKUP_PREFIX_ERROR_POSITION: Normally errors caught by GMarkup * itself have line/column information prefixed to them to let the * caller know the location of the error. When this flag is set the * location information is also prefixed to errors generated by the * #GMarkupParser implementation functions * @G_MARKUP_IGNORE_QUALIFIED: Ignore (don't report) qualified * attributes and tags, along with their contents. A qualified * attribute or tag is one that contains ':' in its name (ie: is in * another namespace). Since: 2.40. * * Flags that affect the behaviour of the parser. */ typedef enum { G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG = 1 << 0, G_MARKUP_TREAT_CDATA_AS_TEXT = 1 << 1, G_MARKUP_PREFIX_ERROR_POSITION = 1 << 2, G_MARKUP_IGNORE_QUALIFIED = 1 << 3 } GMarkupParseFlags; /** * GMarkupParseContext: * * A parse context is used to parse a stream of bytes that * you expect to contain marked-up text. * * See g_markup_parse_context_new(), #GMarkupParser, and so * on for more details. */ typedef struct _GMarkupParseContext GMarkupParseContext; typedef struct _GMarkupParser GMarkupParser; /** * GMarkupParser: * @start_element: Callback to invoke when the opening tag of an element * is seen. The callback's @attribute_names and @attribute_values parameters * are %NULL-terminated. * @end_element: Callback to invoke when the closing tag of an element * is seen. Note that this is also called for empty tags like * `<empty/>`. * @text: Callback to invoke when some text is seen (text is always * inside an element). Note that the text of an element may be spread * over multiple calls of this function. If the * %G_MARKUP_TREAT_CDATA_AS_TEXT flag is set, this function is also * called for the content of CDATA marked sections. * @passthrough: Callback to invoke for comments, processing instructions * and doctype declarations; if you're re-writing the parsed document, * write the passthrough text back out in the same position. If the * %G_MARKUP_TREAT_CDATA_AS_TEXT flag is not set, this function is also * called for CDATA marked sections. * @error: Callback to invoke when an error occurs. * * Any of the fields in #GMarkupParser can be %NULL, in which case they * will be ignored. Except for the @error function, any of these callbacks * can set an error; in particular the %G_MARKUP_ERROR_UNKNOWN_ELEMENT, * %G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE, and %G_MARKUP_ERROR_INVALID_CONTENT * errors are intended to be set from these callbacks. If you set an error * from a callback, g_markup_parse_context_parse() will report that error * back to its caller. */ struct _GMarkupParser { /* Called for open tags <foo bar="baz"> */ void (*start_element) (GMarkupParseContext *context, const gchar *element_name, const gchar **attribute_names, const gchar **attribute_values, gpointer user_data, GError **error); /* Called for close tags </foo> */ void (*end_element) (GMarkupParseContext *context, const gchar *element_name, gpointer user_data, GError **error); /* Called for character data */ /* text is not nul-terminated */ void (*text) (GMarkupParseContext *context, const gchar *text, gsize text_len, gpointer user_data, GError **error); /* Called for strings that should be re-saved verbatim in this same * position, but are not otherwise interpretable. At the moment * this includes comments and processing instructions. */ /* text is not nul-terminated. */ void (*passthrough) (GMarkupParseContext *context, const gchar *passthrough_text, gsize text_len, gpointer user_data, GError **error); /* Called on error, including one set by other * methods in the vtable. The GError should not be freed. */ void (*error) (GMarkupParseContext *context, GError *error, gpointer user_data); }; GLIB_AVAILABLE_IN_ALL GMarkupParseContext *g_markup_parse_context_new (const GMarkupParser *parser, GMarkupParseFlags flags, gpointer user_data, GDestroyNotify user_data_dnotify); GLIB_AVAILABLE_IN_2_36 GMarkupParseContext *g_markup_parse_context_ref (GMarkupParseContext *context); GLIB_AVAILABLE_IN_2_36 void g_markup_parse_context_unref (GMarkupParseContext *context); GLIB_AVAILABLE_IN_ALL void g_markup_parse_context_free (GMarkupParseContext *context); GLIB_AVAILABLE_IN_ALL gboolean g_markup_parse_context_parse (GMarkupParseContext *context, const gchar *text, gssize text_len, GError **error); GLIB_AVAILABLE_IN_ALL void g_markup_parse_context_push (GMarkupParseContext *context, const GMarkupParser *parser, gpointer user_data); GLIB_AVAILABLE_IN_ALL gpointer g_markup_parse_context_pop (GMarkupParseContext *context); GLIB_AVAILABLE_IN_ALL gboolean g_markup_parse_context_end_parse (GMarkupParseContext *context, GError **error); GLIB_AVAILABLE_IN_ALL const gchar * g_markup_parse_context_get_element (GMarkupParseContext *context); GLIB_AVAILABLE_IN_ALL const GSList * g_markup_parse_context_get_element_stack (GMarkupParseContext *context); /* For user-constructed error messages, has no precise semantics */ GLIB_AVAILABLE_IN_ALL void g_markup_parse_context_get_position (GMarkupParseContext *context, gint *line_number, gint *char_number); GLIB_AVAILABLE_IN_ALL gpointer g_markup_parse_context_get_user_data (GMarkupParseContext *context); /* useful when saving */ GLIB_AVAILABLE_IN_ALL gchar* g_markup_escape_text (const gchar *text, gssize length); GLIB_AVAILABLE_IN_ALL gchar *g_markup_printf_escaped (const char *format, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL gchar *g_markup_vprintf_escaped (const char *format, va_list args) G_GNUC_PRINTF(1, 0); typedef enum { G_MARKUP_COLLECT_INVALID, G_MARKUP_COLLECT_STRING, G_MARKUP_COLLECT_STRDUP, G_MARKUP_COLLECT_BOOLEAN, G_MARKUP_COLLECT_TRISTATE, G_MARKUP_COLLECT_OPTIONAL = (1 << 16) } GMarkupCollectType; /* useful from start_element */ GLIB_AVAILABLE_IN_ALL gboolean g_markup_collect_attributes (const gchar *element_name, const gchar **attribute_names, const gchar **attribute_values, GError **error, GMarkupCollectType first_type, const gchar *first_attr, ...); G_END_DECLS #endif /* __G_MARKUP_H__ */ glib/goption.h 0000644 00000037343 15125173650 0007330 0 ustar 00 /* goption.h - Option parser * * Copyright (C) 2004 Anders Carlsson <andersca@gnome.org> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_OPTION_H__ #define __G_OPTION_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> #include <glib/gquark.h> G_BEGIN_DECLS /** * GOptionContext: * * A `GOptionContext` struct defines which options * are accepted by the commandline option parser. The struct has only private * fields and should not be directly accessed. */ typedef struct _GOptionContext GOptionContext; /** * GOptionGroup: * * A `GOptionGroup` struct defines the options in a single * group. The struct has only private fields and should not be directly accessed. * * All options in a group share the same translation function. Libraries which * need to parse commandline options are expected to provide a function for * getting a `GOptionGroup` holding their options, which * the application can then add to its #GOptionContext. */ typedef struct _GOptionGroup GOptionGroup; typedef struct _GOptionEntry GOptionEntry; /** * GOptionFlags: * @G_OPTION_FLAG_NONE: No flags. Since: 2.42. * @G_OPTION_FLAG_HIDDEN: The option doesn't appear in `--help` output. * @G_OPTION_FLAG_IN_MAIN: The option appears in the main section of the * `--help` output, even if it is defined in a group. * @G_OPTION_FLAG_REVERSE: For options of the %G_OPTION_ARG_NONE kind, this * flag indicates that the sense of the option is reversed. * @G_OPTION_FLAG_NO_ARG: For options of the %G_OPTION_ARG_CALLBACK kind, * this flag indicates that the callback does not take any argument * (like a %G_OPTION_ARG_NONE option). Since 2.8 * @G_OPTION_FLAG_FILENAME: For options of the %G_OPTION_ARG_CALLBACK * kind, this flag indicates that the argument should be passed to the * callback in the GLib filename encoding rather than UTF-8. Since 2.8 * @G_OPTION_FLAG_OPTIONAL_ARG: For options of the %G_OPTION_ARG_CALLBACK * kind, this flag indicates that the argument supply is optional. * If no argument is given then data of %GOptionParseFunc will be * set to NULL. Since 2.8 * @G_OPTION_FLAG_NOALIAS: This flag turns off the automatic conflict * resolution which prefixes long option names with `groupname-` if * there is a conflict. This option should only be used in situations * where aliasing is necessary to model some legacy commandline interface. * It is not safe to use this option, unless all option groups are under * your direct control. Since 2.8. * * Flags which modify individual options. */ typedef enum { G_OPTION_FLAG_NONE = 0, G_OPTION_FLAG_HIDDEN = 1 << 0, G_OPTION_FLAG_IN_MAIN = 1 << 1, G_OPTION_FLAG_REVERSE = 1 << 2, G_OPTION_FLAG_NO_ARG = 1 << 3, G_OPTION_FLAG_FILENAME = 1 << 4, G_OPTION_FLAG_OPTIONAL_ARG = 1 << 5, G_OPTION_FLAG_NOALIAS = 1 << 6 } GOptionFlags; /** * GOptionArg: * @G_OPTION_ARG_NONE: No extra argument. This is useful for simple flags. * @G_OPTION_ARG_STRING: The option takes a UTF-8 string argument. * @G_OPTION_ARG_INT: The option takes an integer argument. * @G_OPTION_ARG_CALLBACK: The option provides a callback (of type * #GOptionArgFunc) to parse the extra argument. * @G_OPTION_ARG_FILENAME: The option takes a filename as argument, which will be in the GLib filename encoding rather than UTF-8. * @G_OPTION_ARG_STRING_ARRAY: The option takes a string argument, multiple * uses of the option are collected into an array of strings. * @G_OPTION_ARG_FILENAME_ARRAY: The option takes a filename as argument, * multiple uses of the option are collected into an array of strings. * @G_OPTION_ARG_DOUBLE: The option takes a double argument. The argument * can be formatted either for the user's locale or for the "C" locale. * Since 2.12 * @G_OPTION_ARG_INT64: The option takes a 64-bit integer. Like * %G_OPTION_ARG_INT but for larger numbers. The number can be in * decimal base, or in hexadecimal (when prefixed with `0x`, for * example, `0xffffffff`). Since 2.12 * * The #GOptionArg enum values determine which type of extra argument the * options expect to find. If an option expects an extra argument, it can * be specified in several ways; with a short option: `-x arg`, with a long * option: `--name arg` or combined in a single argument: `--name=arg`. */ typedef enum { G_OPTION_ARG_NONE, G_OPTION_ARG_STRING, G_OPTION_ARG_INT, G_OPTION_ARG_CALLBACK, G_OPTION_ARG_FILENAME, G_OPTION_ARG_STRING_ARRAY, G_OPTION_ARG_FILENAME_ARRAY, G_OPTION_ARG_DOUBLE, G_OPTION_ARG_INT64 } GOptionArg; /** * GOptionArgFunc: * @option_name: The name of the option being parsed. This will be either a * single dash followed by a single letter (for a short name) or two dashes * followed by a long option name. * @value: The value to be parsed. * @data: User data added to the #GOptionGroup containing the option when it * was created with g_option_group_new() * @error: A return location for errors. The error code %G_OPTION_ERROR_FAILED * is intended to be used for errors in #GOptionArgFunc callbacks. * * The type of function to be passed as callback for %G_OPTION_ARG_CALLBACK * options. * * Returns: %TRUE if the option was successfully parsed, %FALSE if an error * occurred, in which case @error should be set with g_set_error() */ typedef gboolean (*GOptionArgFunc) (const gchar *option_name, const gchar *value, gpointer data, GError **error); /** * GOptionParseFunc: * @context: The active #GOptionContext * @group: The group to which the function belongs * @data: User data added to the #GOptionGroup containing the option when it * was created with g_option_group_new() * @error: A return location for error details * * The type of function that can be called before and after parsing. * * Returns: %TRUE if the function completed successfully, %FALSE if an error * occurred, in which case @error should be set with g_set_error() */ typedef gboolean (*GOptionParseFunc) (GOptionContext *context, GOptionGroup *group, gpointer data, GError **error); /** * GOptionErrorFunc: * @context: The active #GOptionContext * @group: The group to which the function belongs * @data: User data added to the #GOptionGroup containing the option when it * was created with g_option_group_new() * @error: The #GError containing details about the parse error * * The type of function to be used as callback when a parse error occurs. */ typedef void (*GOptionErrorFunc) (GOptionContext *context, GOptionGroup *group, gpointer data, GError **error); /** * G_OPTION_ERROR: * * Error domain for option parsing. Errors in this domain will * be from the #GOptionError enumeration. See #GError for information on * error domains. */ #define G_OPTION_ERROR (g_option_error_quark ()) /** * GOptionError: * @G_OPTION_ERROR_UNKNOWN_OPTION: An option was not known to the parser. * This error will only be reported, if the parser hasn't been instructed * to ignore unknown options, see g_option_context_set_ignore_unknown_options(). * @G_OPTION_ERROR_BAD_VALUE: A value couldn't be parsed. * @G_OPTION_ERROR_FAILED: A #GOptionArgFunc callback failed. * * Error codes returned by option parsing. */ typedef enum { G_OPTION_ERROR_UNKNOWN_OPTION, G_OPTION_ERROR_BAD_VALUE, G_OPTION_ERROR_FAILED } GOptionError; GLIB_AVAILABLE_IN_ALL GQuark g_option_error_quark (void); /** * GOptionEntry: * @long_name: The long name of an option can be used to specify it * in a commandline as `--long_name`. Every option must have a * long name. To resolve conflicts if multiple option groups contain * the same long name, it is also possible to specify the option as * `--groupname-long_name`. * @short_name: If an option has a short name, it can be specified * `-short_name` in a commandline. @short_name must be a printable * ASCII character different from '-', or zero if the option has no * short name. * @flags: Flags from #GOptionFlags * @arg: The type of the option, as a #GOptionArg * @arg_data: If the @arg type is %G_OPTION_ARG_CALLBACK, then @arg_data * must point to a #GOptionArgFunc callback function, which will be * called to handle the extra argument. Otherwise, @arg_data is a * pointer to a location to store the value, the required type of * the location depends on the @arg type: * - %G_OPTION_ARG_NONE: %gboolean * - %G_OPTION_ARG_STRING: %gchar* * - %G_OPTION_ARG_INT: %gint * - %G_OPTION_ARG_FILENAME: %gchar* * - %G_OPTION_ARG_STRING_ARRAY: %gchar** * - %G_OPTION_ARG_FILENAME_ARRAY: %gchar** * - %G_OPTION_ARG_DOUBLE: %gdouble * If @arg type is %G_OPTION_ARG_STRING or %G_OPTION_ARG_FILENAME, * the location will contain a newly allocated string if the option * was given. That string needs to be freed by the callee using g_free(). * Likewise if @arg type is %G_OPTION_ARG_STRING_ARRAY or * %G_OPTION_ARG_FILENAME_ARRAY, the data should be freed using g_strfreev(). * @description: the description for the option in `--help` * output. The @description is translated using the @translate_func * of the group, see g_option_group_set_translation_domain(). * @arg_description: The placeholder to use for the extra argument parsed * by the option in `--help` output. The @arg_description is translated * using the @translate_func of the group, see * g_option_group_set_translation_domain(). * * A GOptionEntry struct defines a single option. To have an effect, they * must be added to a #GOptionGroup with g_option_context_add_main_entries() * or g_option_group_add_entries(). */ struct _GOptionEntry { const gchar *long_name; gchar short_name; gint flags; GOptionArg arg; gpointer arg_data; const gchar *description; const gchar *arg_description; }; /** * G_OPTION_REMAINING: * * If a long option in the main group has this name, it is not treated as a * regular option. Instead it collects all non-option arguments which would * otherwise be left in `argv`. The option must be of type * %G_OPTION_ARG_CALLBACK, %G_OPTION_ARG_STRING_ARRAY * or %G_OPTION_ARG_FILENAME_ARRAY. * * * Using #G_OPTION_REMAINING instead of simply scanning `argv` * for leftover arguments has the advantage that GOption takes care of * necessary encoding conversions for strings or filenames. * * Since: 2.6 */ #define G_OPTION_REMAINING "" GLIB_AVAILABLE_IN_ALL GOptionContext *g_option_context_new (const gchar *parameter_string); GLIB_AVAILABLE_IN_ALL void g_option_context_set_summary (GOptionContext *context, const gchar *summary); GLIB_AVAILABLE_IN_ALL const gchar * g_option_context_get_summary (GOptionContext *context); GLIB_AVAILABLE_IN_ALL void g_option_context_set_description (GOptionContext *context, const gchar *description); GLIB_AVAILABLE_IN_ALL const gchar * g_option_context_get_description (GOptionContext *context); GLIB_AVAILABLE_IN_ALL void g_option_context_free (GOptionContext *context); GLIB_AVAILABLE_IN_ALL void g_option_context_set_help_enabled (GOptionContext *context, gboolean help_enabled); GLIB_AVAILABLE_IN_ALL gboolean g_option_context_get_help_enabled (GOptionContext *context); GLIB_AVAILABLE_IN_ALL void g_option_context_set_ignore_unknown_options (GOptionContext *context, gboolean ignore_unknown); GLIB_AVAILABLE_IN_ALL gboolean g_option_context_get_ignore_unknown_options (GOptionContext *context); GLIB_AVAILABLE_IN_2_44 void g_option_context_set_strict_posix (GOptionContext *context, gboolean strict_posix); GLIB_AVAILABLE_IN_2_44 gboolean g_option_context_get_strict_posix (GOptionContext *context); GLIB_AVAILABLE_IN_ALL void g_option_context_add_main_entries (GOptionContext *context, const GOptionEntry *entries, const gchar *translation_domain); GLIB_AVAILABLE_IN_ALL gboolean g_option_context_parse (GOptionContext *context, gint *argc, gchar ***argv, GError **error); GLIB_AVAILABLE_IN_2_40 gboolean g_option_context_parse_strv (GOptionContext *context, gchar ***arguments, GError **error); GLIB_AVAILABLE_IN_ALL void g_option_context_set_translate_func (GOptionContext *context, GTranslateFunc func, gpointer data, GDestroyNotify destroy_notify); GLIB_AVAILABLE_IN_ALL void g_option_context_set_translation_domain (GOptionContext *context, const gchar *domain); GLIB_AVAILABLE_IN_ALL void g_option_context_add_group (GOptionContext *context, GOptionGroup *group); GLIB_AVAILABLE_IN_ALL void g_option_context_set_main_group (GOptionContext *context, GOptionGroup *group); GLIB_AVAILABLE_IN_ALL GOptionGroup *g_option_context_get_main_group (GOptionContext *context); GLIB_AVAILABLE_IN_ALL gchar *g_option_context_get_help (GOptionContext *context, gboolean main_help, GOptionGroup *group); GLIB_AVAILABLE_IN_ALL GOptionGroup *g_option_group_new (const gchar *name, const gchar *description, const gchar *help_description, gpointer user_data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL void g_option_group_set_parse_hooks (GOptionGroup *group, GOptionParseFunc pre_parse_func, GOptionParseFunc post_parse_func); GLIB_AVAILABLE_IN_ALL void g_option_group_set_error_hook (GOptionGroup *group, GOptionErrorFunc error_func); GLIB_DEPRECATED_IN_2_44 void g_option_group_free (GOptionGroup *group); GLIB_AVAILABLE_IN_2_44 GOptionGroup *g_option_group_ref (GOptionGroup *group); GLIB_AVAILABLE_IN_2_44 void g_option_group_unref (GOptionGroup *group); GLIB_AVAILABLE_IN_ALL void g_option_group_add_entries (GOptionGroup *group, const GOptionEntry *entries); GLIB_AVAILABLE_IN_ALL void g_option_group_set_translate_func (GOptionGroup *group, GTranslateFunc func, gpointer data, GDestroyNotify destroy_notify); GLIB_AVAILABLE_IN_ALL void g_option_group_set_translation_domain (GOptionGroup *group, const gchar *domain); G_END_DECLS #endif /* __G_OPTION_H__ */ glib/gshell.h 0000644 00000003330 15125173650 0007114 0 ustar 00 /* gshell.h - Shell-related utilities * * Copyright 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SHELL_H__ #define __G_SHELL_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> G_BEGIN_DECLS #define G_SHELL_ERROR g_shell_error_quark () typedef enum { /* mismatched or otherwise mangled quoting */ G_SHELL_ERROR_BAD_QUOTING, /* string to be parsed was empty */ G_SHELL_ERROR_EMPTY_STRING, G_SHELL_ERROR_FAILED } GShellError; GLIB_AVAILABLE_IN_ALL GQuark g_shell_error_quark (void); GLIB_AVAILABLE_IN_ALL gchar* g_shell_quote (const gchar *unquoted_string); GLIB_AVAILABLE_IN_ALL gchar* g_shell_unquote (const gchar *quoted_string, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_shell_parse_argv (const gchar *command_line, gint *argcp, gchar ***argvp, GError **error); G_END_DECLS #endif /* __G_SHELL_H__ */ glib/gspawn.h 0000644 00000031622 15125173650 0007142 0 ustar 00 /* gspawn.h - Process launching * * Copyright 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SPAWN_H__ #define __G_SPAWN_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> G_BEGIN_DECLS /* I'm not sure I remember our proposed naming convention here. */ /** * G_SPAWN_ERROR: * * Error domain for spawning processes. Errors in this domain will * be from the #GSpawnError enumeration. See #GError for information on * error domains. */ #define G_SPAWN_ERROR g_spawn_error_quark () /** * GSpawnError: * @G_SPAWN_ERROR_FORK: Fork failed due to lack of memory. * @G_SPAWN_ERROR_READ: Read or select on pipes failed. * @G_SPAWN_ERROR_CHDIR: Changing to working directory failed. * @G_SPAWN_ERROR_ACCES: execv() returned `EACCES` * @G_SPAWN_ERROR_PERM: execv() returned `EPERM` * @G_SPAWN_ERROR_TOO_BIG: execv() returned `E2BIG` * @G_SPAWN_ERROR_2BIG: deprecated alias for %G_SPAWN_ERROR_TOO_BIG (deprecated since GLib 2.32) * @G_SPAWN_ERROR_NOEXEC: execv() returned `ENOEXEC` * @G_SPAWN_ERROR_NAMETOOLONG: execv() returned `ENAMETOOLONG` * @G_SPAWN_ERROR_NOENT: execv() returned `ENOENT` * @G_SPAWN_ERROR_NOMEM: execv() returned `ENOMEM` * @G_SPAWN_ERROR_NOTDIR: execv() returned `ENOTDIR` * @G_SPAWN_ERROR_LOOP: execv() returned `ELOOP` * @G_SPAWN_ERROR_TXTBUSY: execv() returned `ETXTBUSY` * @G_SPAWN_ERROR_IO: execv() returned `EIO` * @G_SPAWN_ERROR_NFILE: execv() returned `ENFILE` * @G_SPAWN_ERROR_MFILE: execv() returned `EMFILE` * @G_SPAWN_ERROR_INVAL: execv() returned `EINVAL` * @G_SPAWN_ERROR_ISDIR: execv() returned `EISDIR` * @G_SPAWN_ERROR_LIBBAD: execv() returned `ELIBBAD` * @G_SPAWN_ERROR_FAILED: Some other fatal failure, * `error->message` should explain. * * Error codes returned by spawning processes. */ typedef enum { G_SPAWN_ERROR_FORK, /* fork failed due to lack of memory */ G_SPAWN_ERROR_READ, /* read or select on pipes failed */ G_SPAWN_ERROR_CHDIR, /* changing to working dir failed */ G_SPAWN_ERROR_ACCES, /* execv() returned EACCES */ G_SPAWN_ERROR_PERM, /* execv() returned EPERM */ G_SPAWN_ERROR_TOO_BIG,/* execv() returned E2BIG */ G_SPAWN_ERROR_2BIG GLIB_DEPRECATED_ENUMERATOR_IN_2_32_FOR(G_SPAWN_ERROR_TOO_BIG) = G_SPAWN_ERROR_TOO_BIG, G_SPAWN_ERROR_NOEXEC, /* execv() returned ENOEXEC */ G_SPAWN_ERROR_NAMETOOLONG, /* "" "" ENAMETOOLONG */ G_SPAWN_ERROR_NOENT, /* "" "" ENOENT */ G_SPAWN_ERROR_NOMEM, /* "" "" ENOMEM */ G_SPAWN_ERROR_NOTDIR, /* "" "" ENOTDIR */ G_SPAWN_ERROR_LOOP, /* "" "" ELOOP */ G_SPAWN_ERROR_TXTBUSY, /* "" "" ETXTBUSY */ G_SPAWN_ERROR_IO, /* "" "" EIO */ G_SPAWN_ERROR_NFILE, /* "" "" ENFILE */ G_SPAWN_ERROR_MFILE, /* "" "" EMFLE */ G_SPAWN_ERROR_INVAL, /* "" "" EINVAL */ G_SPAWN_ERROR_ISDIR, /* "" "" EISDIR */ G_SPAWN_ERROR_LIBBAD, /* "" "" ELIBBAD */ G_SPAWN_ERROR_FAILED /* other fatal failure, error->message * should explain */ } GSpawnError; /** * G_SPAWN_EXIT_ERROR: * * Error domain used by g_spawn_check_exit_status(). The code * will be the program exit code. */ #define G_SPAWN_EXIT_ERROR g_spawn_exit_error_quark () /** * GSpawnChildSetupFunc: * @user_data: (closure): user data to pass to the function. * * Specifies the type of the setup function passed to g_spawn_async(), * g_spawn_sync() and g_spawn_async_with_pipes(), which can, in very * limited ways, be used to affect the child's execution. * * On POSIX platforms, the function is called in the child after GLib * has performed all the setup it plans to perform, but before calling * exec(). Actions taken in this function will only affect the child, * not the parent. * * On Windows, the function is called in the parent. Its usefulness on * Windows is thus questionable. In many cases executing the child setup * function in the parent can have ill effects, and you should be very * careful when porting software to Windows that uses child setup * functions. * * However, even on POSIX, you are extremely limited in what you can * safely do from a #GSpawnChildSetupFunc, because any mutexes that were * held by other threads in the parent process at the time of the fork() * will still be locked in the child process, and they will never be * unlocked (since the threads that held them don't exist in the child). * POSIX allows only async-signal-safe functions (see signal(7)) to be * called in the child between fork() and exec(), which drastically limits * the usefulness of child setup functions. * * In particular, it is not safe to call any function which may * call malloc(), which includes POSIX functions such as setenv(). * If you need to set up the child environment differently from * the parent, you should use g_get_environ(), g_environ_setenv(), * and g_environ_unsetenv(), and then pass the complete environment * list to the `g_spawn...` function. */ typedef void (* GSpawnChildSetupFunc) (gpointer user_data); /** * GSpawnFlags: * @G_SPAWN_DEFAULT: no flags, default behaviour * @G_SPAWN_LEAVE_DESCRIPTORS_OPEN: the parent's open file descriptors will * be inherited by the child; otherwise all descriptors except stdin, * stdout and stderr will be closed before calling exec() in the child. * @G_SPAWN_DO_NOT_REAP_CHILD: the child will not be automatically reaped; * you must use g_child_watch_add() yourself (or call waitpid() or handle * `SIGCHLD` yourself), or the child will become a zombie. * @G_SPAWN_SEARCH_PATH: `argv[0]` need not be an absolute path, it will be * looked for in the user's `PATH`. * @G_SPAWN_STDOUT_TO_DEV_NULL: the child's standard output will be discarded, * instead of going to the same location as the parent's standard output. * @G_SPAWN_STDERR_TO_DEV_NULL: the child's standard error will be discarded. * @G_SPAWN_CHILD_INHERITS_STDIN: the child will inherit the parent's standard * input (by default, the child's standard input is attached to `/dev/null`). * @G_SPAWN_FILE_AND_ARGV_ZERO: the first element of `argv` is the file to * execute, while the remaining elements are the actual argument vector * to pass to the file. Normally g_spawn_async_with_pipes() uses `argv[0]` * as the file to execute, and passes all of `argv` to the child. * @G_SPAWN_SEARCH_PATH_FROM_ENVP: if `argv[0]` is not an absolute path, * it will be looked for in the `PATH` from the passed child environment. * Since: 2.34 * @G_SPAWN_CLOEXEC_PIPES: create all pipes with the `O_CLOEXEC` flag set. * Since: 2.40 * * Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). */ typedef enum { G_SPAWN_DEFAULT = 0, G_SPAWN_LEAVE_DESCRIPTORS_OPEN = 1 << 0, G_SPAWN_DO_NOT_REAP_CHILD = 1 << 1, /* look for argv[0] in the path i.e. use execvp() */ G_SPAWN_SEARCH_PATH = 1 << 2, /* Dump output to /dev/null */ G_SPAWN_STDOUT_TO_DEV_NULL = 1 << 3, G_SPAWN_STDERR_TO_DEV_NULL = 1 << 4, G_SPAWN_CHILD_INHERITS_STDIN = 1 << 5, G_SPAWN_FILE_AND_ARGV_ZERO = 1 << 6, G_SPAWN_SEARCH_PATH_FROM_ENVP = 1 << 7, G_SPAWN_CLOEXEC_PIPES = 1 << 8 } GSpawnFlags; GLIB_AVAILABLE_IN_ALL GQuark g_spawn_error_quark (void); GLIB_AVAILABLE_IN_ALL GQuark g_spawn_exit_error_quark (void); GLIB_AVAILABLE_IN_ALL gboolean g_spawn_async (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup, gpointer user_data, GPid *child_pid, GError **error); /* Opens pipes for non-NULL standard_output, standard_input, standard_error, * and returns the parent's end of the pipes. */ GLIB_AVAILABLE_IN_ALL gboolean g_spawn_async_with_pipes (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup, gpointer user_data, GPid *child_pid, gint *standard_input, gint *standard_output, gint *standard_error, GError **error); GLIB_AVAILABLE_IN_2_68 gboolean g_spawn_async_with_pipes_and_fds (const gchar *working_directory, const gchar * const *argv, const gchar * const *envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup, gpointer user_data, gint stdin_fd, gint stdout_fd, gint stderr_fd, const gint *source_fds, const gint *target_fds, gsize n_fds, GPid *child_pid_out, gint *stdin_pipe_out, gint *stdout_pipe_out, gint *stderr_pipe_out, GError **error); /* Lets you provide fds for stdin/stdout/stderr */ GLIB_AVAILABLE_IN_2_58 gboolean g_spawn_async_with_fds (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup, gpointer user_data, GPid *child_pid, gint stdin_fd, gint stdout_fd, gint stderr_fd, GError **error); /* If standard_output or standard_error are non-NULL, the full * standard output or error of the command will be placed there. */ GLIB_AVAILABLE_IN_ALL gboolean g_spawn_sync (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup, gpointer user_data, gchar **standard_output, gchar **standard_error, gint *exit_status, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_spawn_command_line_sync (const gchar *command_line, gchar **standard_output, gchar **standard_error, gint *exit_status, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_spawn_command_line_async (const gchar *command_line, GError **error); GLIB_AVAILABLE_IN_2_34 gboolean g_spawn_check_exit_status (gint exit_status, GError **error); GLIB_AVAILABLE_IN_ALL void g_spawn_close_pid (GPid pid); G_END_DECLS #endif /* __G_SPAWN_H__ */ glib/glib-autocleanups.h 0000644 00000011447 15125173650 0011264 0 ustar 00 /* * Copyright © 2015 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif static inline void g_autoptr_cleanup_generic_gfree (void *p) { void **pp = (void**)p; g_free (*pp); } static inline void g_autoptr_cleanup_gstring_free (GString *string) { if (string) g_string_free (string, TRUE); } /* Ignore deprecations in case we refer to a type which was added in a more * recent GLib version than the user’s #GLIB_VERSION_MAX_ALLOWED definition. */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS /* If adding a cleanup here, please also add a test case to * glib/tests/autoptr.c */ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAsyncQueue, g_async_queue_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GBookmarkFile, g_bookmark_file_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GBytes, g_bytes_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GChecksum, g_checksum_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDateTime, g_date_time_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDate, g_date_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDir, g_dir_close) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GError, g_error_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GHashTable, g_hash_table_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GHmac, g_hmac_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GIOChannel, g_io_channel_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GKeyFile, g_key_file_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GList, g_list_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GArray, g_array_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPtrArray, g_ptr_array_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GByteArray, g_byte_array_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMainContext, g_main_context_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMainContextPusher, g_main_context_pusher_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMainLoop, g_main_loop_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSource, g_source_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMappedFile, g_mapped_file_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMarkupParseContext, g_markup_parse_context_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNode, g_node_destroy) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GOptionContext, g_option_context_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GOptionGroup, g_option_group_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPatternSpec, g_pattern_spec_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GQueue, g_queue_free) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GQueue, g_queue_clear) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRand, g_rand_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRegex, g_regex_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMatchInfo, g_match_info_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GScanner, g_scanner_destroy) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSequence, g_sequence_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSList, g_slist_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GString, g_autoptr_cleanup_gstring_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GStringChunk, g_string_chunk_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GStrvBuilder, g_strv_builder_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GThread, g_thread_unref) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GMutex, g_mutex_clear) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMutexLocker, g_mutex_locker_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRecMutexLocker, g_rec_mutex_locker_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRWLockWriterLocker, g_rw_lock_writer_locker_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRWLockReaderLocker, g_rw_lock_reader_locker_free) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GCond, g_cond_clear) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTimer, g_timer_destroy) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTimeZone, g_time_zone_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTree, g_tree_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVariant, g_variant_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVariantBuilder, g_variant_builder_unref) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GVariantBuilder, g_variant_builder_clear) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVariantIter, g_variant_iter_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVariantDict, g_variant_dict_unref) G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GVariantDict, g_variant_dict_clear) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVariantType, g_variant_type_free) G_DEFINE_AUTO_CLEANUP_FREE_FUNC(GStrv, g_strfreev, NULL) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRefString, g_ref_string_release) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GUri, g_uri_unref) G_GNUC_END_IGNORE_DEPRECATIONS glib/gstringchunk.h 0000644 00000004122 15125173650 0010344 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_STRINGCHUNK_H__ #define __G_STRINGCHUNK_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GStringChunk GStringChunk; GLIB_AVAILABLE_IN_ALL GStringChunk* g_string_chunk_new (gsize size); GLIB_AVAILABLE_IN_ALL void g_string_chunk_free (GStringChunk *chunk); GLIB_AVAILABLE_IN_ALL void g_string_chunk_clear (GStringChunk *chunk); GLIB_AVAILABLE_IN_ALL gchar* g_string_chunk_insert (GStringChunk *chunk, const gchar *string); GLIB_AVAILABLE_IN_ALL gchar* g_string_chunk_insert_len (GStringChunk *chunk, const gchar *string, gssize len); GLIB_AVAILABLE_IN_ALL gchar* g_string_chunk_insert_const (GStringChunk *chunk, const gchar *string); G_END_DECLS #endif /* __G_STRING_H__ */ glib/gpoll.h 0000644 00000010035 15125173650 0006753 0 ustar 00 /* gpoll.h - poll(2) support * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_POLL_H__ #define __G_POLL_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (__G_MAIN_H__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glibconfig.h> #include <glib/gtypes.h> G_BEGIN_DECLS /* Any definitions using GPollFD or GPollFunc are primarily * for Unix and not guaranteed to be the compatible on all * operating systems on which GLib runs. Right now, the * GLib does use these functions on Win32 as well, but interprets * them in a fairly different way than on Unix. If you use * these definitions, you are should be prepared to recode * for different operating systems. * * Note that on systems with a working poll(2), that function is used * in place of g_poll(). Thus g_poll() must have the same signature as * poll(), meaning GPollFD must have the same layout as struct pollfd. * * On Win32, the fd in a GPollFD should be Win32 HANDLE (*not* a file * descriptor as provided by the C runtime) that can be used by * MsgWaitForMultipleObjects. This does *not* include file handles * from CreateFile, SOCKETs, nor pipe handles. (But you can use * WSAEventSelect to signal events when a SOCKET is readable). * * On Win32, fd can also be the special value G_WIN32_MSG_HANDLE to * indicate polling for messages. * * But note that G_WIN32_MSG_HANDLE GPollFDs should not be used by GDK * (GTK) programs, as GDK itself wants to read messages and convert them * to GDK events. * * So, unless you really know what you are doing, it's best not to try * to use the main loop polling stuff for your own needs on * Windows. */ typedef struct _GPollFD GPollFD; /** * GPollFunc: * @ufds: an array of #GPollFD elements * @nfsd: the number of elements in @ufds * @timeout_: the maximum time to wait for an event of the file descriptors. * A negative value indicates an infinite timeout. * * Specifies the type of function passed to g_main_context_set_poll_func(). * The semantics of the function should match those of the poll() system call. * * Returns: the number of #GPollFD elements which have events or errors * reported, or -1 if an error occurred. */ typedef gint (*GPollFunc) (GPollFD *ufds, guint nfsd, gint timeout_); /** * GPollFD: * @fd: the file descriptor to poll (or a HANDLE on Win32) * @events: a bitwise combination from #GIOCondition, specifying which * events should be polled for. Typically for reading from a file * descriptor you would use %G_IO_IN | %G_IO_HUP | %G_IO_ERR, and * for writing you would use %G_IO_OUT | %G_IO_ERR. * @revents: a bitwise combination of flags from #GIOCondition, returned * from the poll() function to indicate which events occurred. * * Represents a file descriptor, which events to poll for, and which events * occurred. */ struct _GPollFD { #if defined (G_OS_WIN32) && GLIB_SIZEOF_VOID_P == 8 #ifndef __GTK_DOC_IGNORE__ gint64 fd; #endif #else gint fd; #endif gushort events; gushort revents; }; /** * G_POLLFD_FORMAT: * * A format specifier that can be used in printf()-style format strings * when printing the @fd member of a #GPollFD. */ /* defined in glibconfig.h */ GLIB_AVAILABLE_IN_ALL gint g_poll (GPollFD *fds, guint nfds, gint timeout); G_END_DECLS #endif /* __G_POLL_H__ */ glib/gmain.h 0000644 00000067064 15125173650 0006747 0 ustar 00 /* gmain.h - the GLib Main loop * Copyright (C) 1998-2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_MAIN_H__ #define __G_MAIN_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gpoll.h> #include <glib/gslist.h> #include <glib/gthread.h> G_BEGIN_DECLS typedef enum /*< flags >*/ { G_IO_IN GLIB_SYSDEF_POLLIN, G_IO_OUT GLIB_SYSDEF_POLLOUT, G_IO_PRI GLIB_SYSDEF_POLLPRI, G_IO_ERR GLIB_SYSDEF_POLLERR, G_IO_HUP GLIB_SYSDEF_POLLHUP, G_IO_NVAL GLIB_SYSDEF_POLLNVAL } GIOCondition; /** * GMainContext: * * The `GMainContext` struct is an opaque data * type representing a set of sources to be handled in a main loop. */ typedef struct _GMainContext GMainContext; /** * GMainLoop: * * The `GMainLoop` struct is an opaque data type * representing the main event loop of a GLib or GTK+ application. */ typedef struct _GMainLoop GMainLoop; /** * GSource: * * The `GSource` struct is an opaque data type * representing an event source. */ typedef struct _GSource GSource; typedef struct _GSourcePrivate GSourcePrivate; /** * GSourceCallbackFuncs: * @ref: Called when a reference is added to the callback object * @unref: Called when a reference to the callback object is dropped * @get: Called to extract the callback function and data from the * callback object. * * The `GSourceCallbackFuncs` struct contains * functions for managing callback objects. */ typedef struct _GSourceCallbackFuncs GSourceCallbackFuncs; /** * GSourceFuncs: * @prepare: Called before all the file descriptors are polled. If the * source can determine that it is ready here (without waiting for the * results of the poll() call) it should return %TRUE. It can also return * a @timeout_ value which should be the maximum timeout (in milliseconds) * which should be passed to the poll() call. The actual timeout used will * be -1 if all sources returned -1, or it will be the minimum of all * the @timeout_ values returned which were >= 0. Since 2.36 this may * be %NULL, in which case the effect is as if the function always returns * %FALSE with a timeout of -1. If @prepare returns a * timeout and the source also has a ready time set, then the * lower of the two will be used. * @check: Called after all the file descriptors are polled. The source * should return %TRUE if it is ready to be dispatched. Note that some * time may have passed since the previous prepare function was called, * so the source should be checked again here. Since 2.36 this may * be %NULL, in which case the effect is as if the function always returns * %FALSE. * @dispatch: Called to dispatch the event source, after it has returned * %TRUE in either its @prepare or its @check function, or if a ready time * has been reached. The @dispatch function receives a callback function and * user data. The callback function may be %NULL if the source was never * connected to a callback using g_source_set_callback(). The @dispatch * function should call the callback function with @user_data and whatever * additional parameters are needed for this type of event source. The * return value of the @dispatch function should be #G_SOURCE_REMOVE if the * source should be removed or #G_SOURCE_CONTINUE to keep it. * @finalize: Called when the source is finalized. At this point, the source * will have been destroyed, had its callback cleared, and have been removed * from its #GMainContext, but it will still have its final reference count, * so methods can be called on it from within this function. * * The `GSourceFuncs` struct contains a table of * functions used to handle event sources in a generic manner. * * For idle sources, the prepare and check functions always return %TRUE * to indicate that the source is always ready to be processed. The prepare * function also returns a timeout value of 0 to ensure that the poll() call * doesn't block (since that would be time wasted which could have been spent * running the idle function). * * For timeout sources, the prepare and check functions both return %TRUE * if the timeout interval has expired. The prepare function also returns * a timeout value to ensure that the poll() call doesn't block too long * and miss the next timeout. * * For file descriptor sources, the prepare function typically returns %FALSE, * since it must wait until poll() has been called before it knows whether * any events need to be processed. It sets the returned timeout to -1 to * indicate that it doesn't mind how long the poll() call blocks. In the * check function, it tests the results of the poll() call to see if the * required condition has been met, and returns %TRUE if so. */ typedef struct _GSourceFuncs GSourceFuncs; /** * GPid: * * A type which is used to hold a process identification. * * On UNIX, processes are identified by a process id (an integer), * while Windows uses process handles (which are pointers). * * GPid is used in GLib only for descendant processes spawned with * the g_spawn functions. */ /* defined in glibconfig.h */ /** * G_PID_FORMAT: * * A format specifier that can be used in printf()-style format strings * when printing a #GPid. * * Since: 2.50 */ /* defined in glibconfig.h */ /** * GSourceFunc: * @user_data: data passed to the function, set when the source was * created with one of the above functions * * Specifies the type of function passed to g_timeout_add(), * g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). * * When calling g_source_set_callback(), you may need to cast a function of a * different type to this type. Use G_SOURCE_FUNC() to avoid warnings about * incompatible function types. * * Returns: %FALSE if the source should be removed. #G_SOURCE_CONTINUE and * #G_SOURCE_REMOVE are more memorable names for the return value. */ typedef gboolean (*GSourceFunc) (gpointer user_data); /** * G_SOURCE_FUNC: * @f: a function pointer. * * Cast a function pointer to a #GSourceFunc, suppressing warnings from GCC 8 * onwards with `-Wextra` or `-Wcast-function-type` enabled about the function * types being incompatible. * * For example, the correct type of callback for a source created by * g_child_watch_source_new() is #GChildWatchFunc, which accepts more arguments * than #GSourceFunc. Casting the function with `(GSourceFunc)` to call * g_source_set_callback() will trigger a warning, even though it will be cast * back to the correct type before it is called by the source. * * Since: 2.58 */ #define G_SOURCE_FUNC(f) ((GSourceFunc) (void (*)(void)) (f)) GLIB_AVAILABLE_MACRO_IN_2_58 /** * GChildWatchFunc: * @pid: the process id of the child process * @status: Status information about the child process, encoded * in a platform-specific manner * @user_data: user data passed to g_child_watch_add() * * Prototype of a #GChildWatchSource callback, called when a child * process has exited. To interpret @status, see the documentation * for g_spawn_check_exit_status(). */ typedef void (*GChildWatchFunc) (GPid pid, gint status, gpointer user_data); /** * GSourceDisposeFunc: * @source: #GSource that is currently being disposed * * Dispose function for @source. See g_source_set_dispose_function() for * details. * * Since: 2.64 */ GLIB_AVAILABLE_TYPE_IN_2_64 typedef void (*GSourceDisposeFunc) (GSource *source); struct _GSource { /*< private >*/ gpointer callback_data; GSourceCallbackFuncs *callback_funcs; const GSourceFuncs *source_funcs; guint ref_count; GMainContext *context; gint priority; guint flags; guint source_id; GSList *poll_fds; GSource *prev; GSource *next; char *name; GSourcePrivate *priv; }; struct _GSourceCallbackFuncs { void (*ref) (gpointer cb_data); void (*unref) (gpointer cb_data); void (*get) (gpointer cb_data, GSource *source, GSourceFunc *func, gpointer *data); }; /** * GSourceDummyMarshal: * * This is just a placeholder for #GClosureMarshal, * which cannot be used here for dependency reasons. */ typedef void (*GSourceDummyMarshal) (void); struct _GSourceFuncs { gboolean (*prepare) (GSource *source, gint *timeout_); gboolean (*check) (GSource *source); gboolean (*dispatch) (GSource *source, GSourceFunc callback, gpointer user_data); void (*finalize) (GSource *source); /* Can be NULL */ /*< private >*/ /* For use by g_source_set_closure */ GSourceFunc closure_callback; GSourceDummyMarshal closure_marshal; /* Really is of type GClosureMarshal */ }; /* Standard priorities */ /** * G_PRIORITY_HIGH: * * Use this for high priority event sources. * * It is not used within GLib or GTK+. */ #define G_PRIORITY_HIGH -100 /** * G_PRIORITY_DEFAULT: * * Use this for default priority event sources. * * In GLib this priority is used when adding timeout functions * with g_timeout_add(). In GDK this priority is used for events * from the X server. */ #define G_PRIORITY_DEFAULT 0 /** * G_PRIORITY_HIGH_IDLE: * * Use this for high priority idle functions. * * GTK+ uses #G_PRIORITY_HIGH_IDLE + 10 for resizing operations, * and #G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is * done to ensure that any pending resizes are processed before any * pending redraws, so that widgets are not redrawn twice unnecessarily.) */ #define G_PRIORITY_HIGH_IDLE 100 /** * G_PRIORITY_DEFAULT_IDLE: * * Use this for default priority idle functions. * * In GLib this priority is used when adding idle functions with * g_idle_add(). */ #define G_PRIORITY_DEFAULT_IDLE 200 /** * G_PRIORITY_LOW: * * Use this for very low priority background tasks. * * It is not used within GLib or GTK+. */ #define G_PRIORITY_LOW 300 /** * G_SOURCE_REMOVE: * * Use this macro as the return value of a #GSourceFunc to remove * the #GSource from the main loop. * * Since: 2.32 */ #define G_SOURCE_REMOVE FALSE /** * G_SOURCE_CONTINUE: * * Use this macro as the return value of a #GSourceFunc to leave * the #GSource in the main loop. * * Since: 2.32 */ #define G_SOURCE_CONTINUE TRUE /* GMainContext: */ GLIB_AVAILABLE_IN_ALL GMainContext *g_main_context_new (void); GLIB_AVAILABLE_IN_ALL GMainContext *g_main_context_ref (GMainContext *context); GLIB_AVAILABLE_IN_ALL void g_main_context_unref (GMainContext *context); GLIB_AVAILABLE_IN_ALL GMainContext *g_main_context_default (void); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_iteration (GMainContext *context, gboolean may_block); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_pending (GMainContext *context); /* For implementation of legacy interfaces */ GLIB_AVAILABLE_IN_ALL GSource *g_main_context_find_source_by_id (GMainContext *context, guint source_id); GLIB_AVAILABLE_IN_ALL GSource *g_main_context_find_source_by_user_data (GMainContext *context, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSource *g_main_context_find_source_by_funcs_user_data (GMainContext *context, GSourceFuncs *funcs, gpointer user_data); /* Low level functions for implementing custom main loops. */ GLIB_AVAILABLE_IN_ALL void g_main_context_wakeup (GMainContext *context); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_acquire (GMainContext *context); GLIB_AVAILABLE_IN_ALL void g_main_context_release (GMainContext *context); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_is_owner (GMainContext *context); GLIB_DEPRECATED_IN_2_58_FOR(g_main_context_is_owner) gboolean g_main_context_wait (GMainContext *context, GCond *cond, GMutex *mutex); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_prepare (GMainContext *context, gint *priority); GLIB_AVAILABLE_IN_ALL gint g_main_context_query (GMainContext *context, gint max_priority, gint *timeout_, GPollFD *fds, gint n_fds); GLIB_AVAILABLE_IN_ALL gboolean g_main_context_check (GMainContext *context, gint max_priority, GPollFD *fds, gint n_fds); GLIB_AVAILABLE_IN_ALL void g_main_context_dispatch (GMainContext *context); GLIB_AVAILABLE_IN_ALL void g_main_context_set_poll_func (GMainContext *context, GPollFunc func); GLIB_AVAILABLE_IN_ALL GPollFunc g_main_context_get_poll_func (GMainContext *context); /* Low level functions for use by source implementations */ GLIB_AVAILABLE_IN_ALL void g_main_context_add_poll (GMainContext *context, GPollFD *fd, gint priority); GLIB_AVAILABLE_IN_ALL void g_main_context_remove_poll (GMainContext *context, GPollFD *fd); GLIB_AVAILABLE_IN_ALL gint g_main_depth (void); GLIB_AVAILABLE_IN_ALL GSource *g_main_current_source (void); /* GMainContexts for other threads */ GLIB_AVAILABLE_IN_ALL void g_main_context_push_thread_default (GMainContext *context); GLIB_AVAILABLE_IN_ALL void g_main_context_pop_thread_default (GMainContext *context); GLIB_AVAILABLE_IN_ALL GMainContext *g_main_context_get_thread_default (void); GLIB_AVAILABLE_IN_ALL GMainContext *g_main_context_ref_thread_default (void); /** * GMainContextPusher: * * Opaque type. See g_main_context_pusher_new() for details. * * Since: 2.64 */ typedef void GMainContextPusher GLIB_AVAILABLE_TYPE_IN_2_64; /** * g_main_context_pusher_new: * @main_context: (transfer none): a main context to push * * Push @main_context as the new thread-default main context for the current * thread, using g_main_context_push_thread_default(), and return a new * #GMainContextPusher. Pop with g_main_context_pusher_free(). Using * g_main_context_pop_thread_default() on @main_context while a * #GMainContextPusher exists for it can lead to undefined behaviour. * * Using two #GMainContextPushers in the same scope is not allowed, as it leads * to an undefined pop order. * * This is intended to be used with g_autoptr(). Note that g_autoptr() * is only available when using GCC or clang, so the following example * will only work with those compilers: * |[ * typedef struct * { * ... * GMainContext *context; * ... * } MyObject; * * static void * my_object_do_stuff (MyObject *self) * { * g_autoptr(GMainContextPusher) pusher = g_main_context_pusher_new (self->context); * * // Code with main context as the thread default here * * if (cond) * // No need to pop * return; * * // Optionally early pop * g_clear_pointer (&pusher, g_main_context_pusher_free); * * // Code with main context no longer the thread default here * } * ]| * * Returns: (transfer full): a #GMainContextPusher * Since: 2.64 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_64 static inline GMainContextPusher * g_main_context_pusher_new (GMainContext *main_context) { g_main_context_push_thread_default (main_context); return (GMainContextPusher *) main_context; } G_GNUC_END_IGNORE_DEPRECATIONS /** * g_main_context_pusher_free: * @pusher: (transfer full): a #GMainContextPusher * * Pop @pusher’s main context as the thread default main context. * See g_main_context_pusher_new() for details. * * This will pop the #GMainContext as the current thread-default main context, * but will not call g_main_context_unref() on it. * * Since: 2.64 */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_STATIC_INLINE_IN_2_64 static inline void g_main_context_pusher_free (GMainContextPusher *pusher) { g_main_context_pop_thread_default ((GMainContext *) pusher); } G_GNUC_END_IGNORE_DEPRECATIONS /* GMainLoop: */ GLIB_AVAILABLE_IN_ALL GMainLoop *g_main_loop_new (GMainContext *context, gboolean is_running); GLIB_AVAILABLE_IN_ALL void g_main_loop_run (GMainLoop *loop); GLIB_AVAILABLE_IN_ALL void g_main_loop_quit (GMainLoop *loop); GLIB_AVAILABLE_IN_ALL GMainLoop *g_main_loop_ref (GMainLoop *loop); GLIB_AVAILABLE_IN_ALL void g_main_loop_unref (GMainLoop *loop); GLIB_AVAILABLE_IN_ALL gboolean g_main_loop_is_running (GMainLoop *loop); GLIB_AVAILABLE_IN_ALL GMainContext *g_main_loop_get_context (GMainLoop *loop); /* GSource: */ GLIB_AVAILABLE_IN_ALL GSource *g_source_new (GSourceFuncs *source_funcs, guint struct_size); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_2_64 void g_source_set_dispose_function (GSource *source, GSourceDisposeFunc dispose); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL GSource *g_source_ref (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_unref (GSource *source); GLIB_AVAILABLE_IN_ALL guint g_source_attach (GSource *source, GMainContext *context); GLIB_AVAILABLE_IN_ALL void g_source_destroy (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_set_priority (GSource *source, gint priority); GLIB_AVAILABLE_IN_ALL gint g_source_get_priority (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_set_can_recurse (GSource *source, gboolean can_recurse); GLIB_AVAILABLE_IN_ALL gboolean g_source_get_can_recurse (GSource *source); GLIB_AVAILABLE_IN_ALL guint g_source_get_id (GSource *source); GLIB_AVAILABLE_IN_ALL GMainContext *g_source_get_context (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_set_callback (GSource *source, GSourceFunc func, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL void g_source_set_funcs (GSource *source, GSourceFuncs *funcs); GLIB_AVAILABLE_IN_ALL gboolean g_source_is_destroyed (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_set_name (GSource *source, const char *name); GLIB_AVAILABLE_IN_ALL const char * g_source_get_name (GSource *source); GLIB_AVAILABLE_IN_ALL void g_source_set_name_by_id (guint tag, const char *name); GLIB_AVAILABLE_IN_2_36 void g_source_set_ready_time (GSource *source, gint64 ready_time); GLIB_AVAILABLE_IN_2_36 gint64 g_source_get_ready_time (GSource *source); #ifdef G_OS_UNIX GLIB_AVAILABLE_IN_2_36 gpointer g_source_add_unix_fd (GSource *source, gint fd, GIOCondition events); GLIB_AVAILABLE_IN_2_36 void g_source_modify_unix_fd (GSource *source, gpointer tag, GIOCondition new_events); GLIB_AVAILABLE_IN_2_36 void g_source_remove_unix_fd (GSource *source, gpointer tag); GLIB_AVAILABLE_IN_2_36 GIOCondition g_source_query_unix_fd (GSource *source, gpointer tag); #endif /* Used to implement g_source_connect_closure and internally*/ GLIB_AVAILABLE_IN_ALL void g_source_set_callback_indirect (GSource *source, gpointer callback_data, GSourceCallbackFuncs *callback_funcs); GLIB_AVAILABLE_IN_ALL void g_source_add_poll (GSource *source, GPollFD *fd); GLIB_AVAILABLE_IN_ALL void g_source_remove_poll (GSource *source, GPollFD *fd); GLIB_AVAILABLE_IN_ALL void g_source_add_child_source (GSource *source, GSource *child_source); GLIB_AVAILABLE_IN_ALL void g_source_remove_child_source (GSource *source, GSource *child_source); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_28_FOR(g_source_get_time) void g_source_get_current_time (GSource *source, GTimeVal *timeval); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL gint64 g_source_get_time (GSource *source); /* void g_source_connect_closure (GSource *source, GClosure *closure); */ /* Specific source types */ GLIB_AVAILABLE_IN_ALL GSource *g_idle_source_new (void); GLIB_AVAILABLE_IN_ALL GSource *g_child_watch_source_new (GPid pid); GLIB_AVAILABLE_IN_ALL GSource *g_timeout_source_new (guint interval); GLIB_AVAILABLE_IN_ALL GSource *g_timeout_source_new_seconds (guint interval); /* Miscellaneous functions */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_get_real_time) void g_get_current_time (GTimeVal *result); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL gint64 g_get_monotonic_time (void); GLIB_AVAILABLE_IN_ALL gint64 g_get_real_time (void); /* Source manipulation by ID */ GLIB_AVAILABLE_IN_ALL gboolean g_source_remove (guint tag); GLIB_AVAILABLE_IN_ALL gboolean g_source_remove_by_user_data (gpointer user_data); GLIB_AVAILABLE_IN_ALL gboolean g_source_remove_by_funcs_user_data (GSourceFuncs *funcs, gpointer user_data); /** * GClearHandleFunc: * @handle_id: the handle ID to clear * * Specifies the type of function passed to g_clear_handle_id(). * The implementation is expected to free the resource identified * by @handle_id; for instance, if @handle_id is a #GSource ID, * g_source_remove() can be used. * * Since: 2.56 */ typedef void (* GClearHandleFunc) (guint handle_id); GLIB_AVAILABLE_IN_2_56 void g_clear_handle_id (guint *tag_ptr, GClearHandleFunc clear_func); #define g_clear_handle_id(tag_ptr, clear_func) \ G_STMT_START { \ G_STATIC_ASSERT (sizeof *(tag_ptr) == sizeof (guint)); \ guint *_tag_ptr = (guint *) (tag_ptr); \ guint _handle_id; \ \ _handle_id = *_tag_ptr; \ if (_handle_id > 0) \ { \ *_tag_ptr = 0; \ clear_func (_handle_id); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_56 /* Idles, child watchers and timeouts */ GLIB_AVAILABLE_IN_ALL guint g_timeout_add_full (gint priority, guint interval, GSourceFunc function, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL guint g_timeout_add (guint interval, GSourceFunc function, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_timeout_add_seconds_full (gint priority, guint interval, GSourceFunc function, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL guint g_timeout_add_seconds (guint interval, GSourceFunc function, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_child_watch_add_full (gint priority, GPid pid, GChildWatchFunc function, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL guint g_child_watch_add (GPid pid, GChildWatchFunc function, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_idle_add (GSourceFunc function, gpointer data); GLIB_AVAILABLE_IN_ALL guint g_idle_add_full (gint priority, GSourceFunc function, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL gboolean g_idle_remove_by_data (gpointer data); GLIB_AVAILABLE_IN_ALL void g_main_context_invoke_full (GMainContext *context, gint priority, GSourceFunc function, gpointer data, GDestroyNotify notify); GLIB_AVAILABLE_IN_ALL void g_main_context_invoke (GMainContext *context, GSourceFunc function, gpointer data); /* Hook for GClosure / GSource integration. Don't touch */ GLIB_VAR GSourceFuncs g_timeout_funcs; GLIB_VAR GSourceFuncs g_child_watch_funcs; GLIB_VAR GSourceFuncs g_idle_funcs; #ifdef G_OS_UNIX GLIB_VAR GSourceFuncs g_unix_signal_funcs; GLIB_VAR GSourceFuncs g_unix_fd_source_funcs; #endif G_END_DECLS #endif /* __G_MAIN_H__ */ glib/gstrfuncs.h 0000644 00000032221 15125173650 0007655 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_STRFUNCS_H__ #define __G_STRFUNCS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <stdarg.h> #include <glib/gmacros.h> #include <glib/gtypes.h> #include <glib/gerror.h> G_BEGIN_DECLS /* Functions like the ones in <ctype.h> that are not affected by locale. */ typedef enum { G_ASCII_ALNUM = 1 << 0, G_ASCII_ALPHA = 1 << 1, G_ASCII_CNTRL = 1 << 2, G_ASCII_DIGIT = 1 << 3, G_ASCII_GRAPH = 1 << 4, G_ASCII_LOWER = 1 << 5, G_ASCII_PRINT = 1 << 6, G_ASCII_PUNCT = 1 << 7, G_ASCII_SPACE = 1 << 8, G_ASCII_UPPER = 1 << 9, G_ASCII_XDIGIT = 1 << 10 } GAsciiType; GLIB_VAR const guint16 * const g_ascii_table; #define g_ascii_isalnum(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_ALNUM) != 0) #define g_ascii_isalpha(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_ALPHA) != 0) #define g_ascii_iscntrl(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_CNTRL) != 0) #define g_ascii_isdigit(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_DIGIT) != 0) #define g_ascii_isgraph(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_GRAPH) != 0) #define g_ascii_islower(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_LOWER) != 0) #define g_ascii_isprint(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_PRINT) != 0) #define g_ascii_ispunct(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_PUNCT) != 0) #define g_ascii_isspace(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_SPACE) != 0) #define g_ascii_isupper(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_UPPER) != 0) #define g_ascii_isxdigit(c) \ ((g_ascii_table[(guchar) (c)] & G_ASCII_XDIGIT) != 0) GLIB_AVAILABLE_IN_ALL gchar g_ascii_tolower (gchar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gchar g_ascii_toupper (gchar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gint g_ascii_digit_value (gchar c) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gint g_ascii_xdigit_value (gchar c) G_GNUC_CONST; /* String utility functions that modify a string argument or * return a constant string that must not be freed. */ #define G_STR_DELIMITERS "_-|> <." GLIB_AVAILABLE_IN_ALL gchar* g_strdelimit (gchar *string, const gchar *delimiters, gchar new_delimiter); GLIB_AVAILABLE_IN_ALL gchar* g_strcanon (gchar *string, const gchar *valid_chars, gchar substitutor); GLIB_AVAILABLE_IN_ALL const gchar * g_strerror (gint errnum) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL const gchar * g_strsignal (gint signum) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gchar * g_strreverse (gchar *string); GLIB_AVAILABLE_IN_ALL gsize g_strlcpy (gchar *dest, const gchar *src, gsize dest_size); GLIB_AVAILABLE_IN_ALL gsize g_strlcat (gchar *dest, const gchar *src, gsize dest_size); GLIB_AVAILABLE_IN_ALL gchar * g_strstr_len (const gchar *haystack, gssize haystack_len, const gchar *needle); GLIB_AVAILABLE_IN_ALL gchar * g_strrstr (const gchar *haystack, const gchar *needle); GLIB_AVAILABLE_IN_ALL gchar * g_strrstr_len (const gchar *haystack, gssize haystack_len, const gchar *needle); GLIB_AVAILABLE_IN_ALL gboolean g_str_has_suffix (const gchar *str, const gchar *suffix); GLIB_AVAILABLE_IN_ALL gboolean g_str_has_prefix (const gchar *str, const gchar *prefix); /* String to/from double conversion functions */ GLIB_AVAILABLE_IN_ALL gdouble g_strtod (const gchar *nptr, gchar **endptr); GLIB_AVAILABLE_IN_ALL gdouble g_ascii_strtod (const gchar *nptr, gchar **endptr); GLIB_AVAILABLE_IN_ALL guint64 g_ascii_strtoull (const gchar *nptr, gchar **endptr, guint base); GLIB_AVAILABLE_IN_ALL gint64 g_ascii_strtoll (const gchar *nptr, gchar **endptr, guint base); /* 29 bytes should enough for all possible values that * g_ascii_dtostr can produce. * Then add 10 for good measure */ #define G_ASCII_DTOSTR_BUF_SIZE (29 + 10) GLIB_AVAILABLE_IN_ALL gchar * g_ascii_dtostr (gchar *buffer, gint buf_len, gdouble d); GLIB_AVAILABLE_IN_ALL gchar * g_ascii_formatd (gchar *buffer, gint buf_len, const gchar *format, gdouble d); /* removes leading spaces */ GLIB_AVAILABLE_IN_ALL gchar* g_strchug (gchar *string); /* removes trailing spaces */ GLIB_AVAILABLE_IN_ALL gchar* g_strchomp (gchar *string); /* removes leading & trailing spaces */ #define g_strstrip( string ) g_strchomp (g_strchug (string)) GLIB_AVAILABLE_IN_ALL gint g_ascii_strcasecmp (const gchar *s1, const gchar *s2); GLIB_AVAILABLE_IN_ALL gint g_ascii_strncasecmp (const gchar *s1, const gchar *s2, gsize n); GLIB_AVAILABLE_IN_ALL gchar* g_ascii_strdown (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_ascii_strup (const gchar *str, gssize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_40 gboolean g_str_is_ascii (const gchar *str); GLIB_DEPRECATED gint g_strcasecmp (const gchar *s1, const gchar *s2); GLIB_DEPRECATED gint g_strncasecmp (const gchar *s1, const gchar *s2, guint n); GLIB_DEPRECATED gchar* g_strdown (gchar *string); GLIB_DEPRECATED gchar* g_strup (gchar *string); /* String utility functions that return a newly allocated string which * ought to be freed with g_free from the caller at some point. */ GLIB_AVAILABLE_IN_ALL gchar* g_strdup (const gchar *str) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_strdup_printf (const gchar *format, ...) G_GNUC_PRINTF (1, 2) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_strdup_vprintf (const gchar *format, va_list args) G_GNUC_PRINTF(1, 0) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_strndup (const gchar *str, gsize n) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_strnfill (gsize length, gchar fill_char) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_strconcat (const gchar *string1, ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL gchar* g_strjoin (const gchar *separator, ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED; /* Make a copy of a string interpreting C string -style escape * sequences. Inverse of g_strescape. The recognized sequences are \b * \f \n \r \t \\ \" and the octal format. */ GLIB_AVAILABLE_IN_ALL gchar* g_strcompress (const gchar *source) G_GNUC_MALLOC; /* Copy a string escaping nonprintable characters like in C strings. * Inverse of g_strcompress. The exceptions parameter, if non-NULL, points * to a string containing characters that are not to be escaped. * * Deprecated API: gchar* g_strescape (const gchar *source); * Luckily this function wasn't used much, using NULL as second parameter * provides mostly identical semantics. */ GLIB_AVAILABLE_IN_ALL gchar* g_strescape (const gchar *source, const gchar *exceptions) G_GNUC_MALLOC; GLIB_DEPRECATED_IN_2_68_FOR (g_memdup2) gpointer g_memdup (gconstpointer mem, guint byte_size) G_GNUC_ALLOC_SIZE(2); GLIB_AVAILABLE_IN_2_68 gpointer g_memdup2 (gconstpointer mem, gsize byte_size) G_GNUC_ALLOC_SIZE(2); /* NULL terminated string arrays. * g_strsplit(), g_strsplit_set() split up string into max_tokens tokens * at delim and return a newly allocated string array. * g_strjoinv() concatenates all of str_array's strings, sliding in an * optional separator, the returned string is newly allocated. * g_strfreev() frees the array itself and all of its strings. * g_strdupv() copies a NULL-terminated array of strings * g_strv_length() returns the length of a NULL-terminated array of strings */ typedef gchar** GStrv; GLIB_AVAILABLE_IN_ALL gchar** g_strsplit (const gchar *string, const gchar *delimiter, gint max_tokens); GLIB_AVAILABLE_IN_ALL gchar ** g_strsplit_set (const gchar *string, const gchar *delimiters, gint max_tokens); GLIB_AVAILABLE_IN_ALL gchar* g_strjoinv (const gchar *separator, gchar **str_array) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_strfreev (gchar **str_array); GLIB_AVAILABLE_IN_ALL gchar** g_strdupv (gchar **str_array); GLIB_AVAILABLE_IN_ALL guint g_strv_length (gchar **str_array); GLIB_AVAILABLE_IN_ALL gchar* g_stpcpy (gchar *dest, const char *src); GLIB_AVAILABLE_IN_2_40 gchar * g_str_to_ascii (const gchar *str, const gchar *from_locale); GLIB_AVAILABLE_IN_2_40 gchar ** g_str_tokenize_and_fold (const gchar *string, const gchar *translit_locale, gchar ***ascii_alternates); GLIB_AVAILABLE_IN_2_40 gboolean g_str_match_string (const gchar *search_term, const gchar *potential_hit, gboolean accept_alternates); GLIB_AVAILABLE_IN_2_44 gboolean g_strv_contains (const gchar * const *strv, const gchar *str); GLIB_AVAILABLE_IN_2_60 gboolean g_strv_equal (const gchar * const *strv1, const gchar * const *strv2); /* Convenience ASCII string to number API */ /** * GNumberParserError: * @G_NUMBER_PARSER_ERROR_INVALID: String was not a valid number. * @G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS: String was a number, but out of bounds. * * Error codes returned by functions converting a string to a number. * * Since: 2.54 */ typedef enum { G_NUMBER_PARSER_ERROR_INVALID, G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS, } GNumberParserError; /** * G_NUMBER_PARSER_ERROR: * * Domain for errors returned by functions converting a string to a * number. * * Since: 2.54 */ #define G_NUMBER_PARSER_ERROR (g_number_parser_error_quark ()) GLIB_AVAILABLE_IN_2_54 GQuark g_number_parser_error_quark (void); GLIB_AVAILABLE_IN_2_54 gboolean g_ascii_string_to_signed (const gchar *str, guint base, gint64 min, gint64 max, gint64 *out_num, GError **error); GLIB_AVAILABLE_IN_2_54 gboolean g_ascii_string_to_unsigned (const gchar *str, guint base, guint64 min, guint64 max, guint64 *out_num, GError **error); G_END_DECLS #endif /* __G_STRFUNCS_H__ */ glib/guuid.h 0000644 00000002413 15125173650 0006754 0 ustar 00 /* guuid.h - UUID functions * * Copyright (C) 2013-2015, 2017 Red Hat, Inc. * * This library is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of the * licence, or (at your option) any later version. * * This 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 Lesser General Public * License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 * USA. * * Authors: Marc-André Lureau <marcandre.lureau@redhat.com> */ #ifndef __G_UUID_H__ #define __G_UUID_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_52 gboolean g_uuid_string_is_valid (const gchar *str); GLIB_AVAILABLE_IN_2_52 gchar * g_uuid_string_random (void); G_END_DECLS #endif /* __G_UUID_H__ */ glib/gquark.h 0000644 00000005200 15125173650 0007126 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_QUARK_H__ #define __G_QUARK_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef guint32 GQuark; /* Quarks (string<->id association) */ GLIB_AVAILABLE_IN_ALL GQuark g_quark_try_string (const gchar *string); GLIB_AVAILABLE_IN_ALL GQuark g_quark_from_static_string (const gchar *string); GLIB_AVAILABLE_IN_ALL GQuark g_quark_from_string (const gchar *string); GLIB_AVAILABLE_IN_ALL const gchar * g_quark_to_string (GQuark quark) G_GNUC_CONST; #define G_DEFINE_QUARK(QN, q_n) \ GQuark \ q_n##_quark (void) \ { \ static GQuark q; \ \ if G_UNLIKELY (q == 0) \ q = g_quark_from_static_string (#QN); \ \ return q; \ } GLIB_AVAILABLE_IN_ALL const gchar * g_intern_string (const gchar *string); GLIB_AVAILABLE_IN_ALL const gchar * g_intern_static_string (const gchar *string); G_END_DECLS #endif /* __G_QUARK_H__ */ glib/gthreadpool.h 0000644 00000007360 15125173650 0010155 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_THREADPOOL_H__ #define __G_THREADPOOL_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gthread.h> G_BEGIN_DECLS typedef struct _GThreadPool GThreadPool; /* Thread Pools */ struct _GThreadPool { GFunc func; gpointer user_data; gboolean exclusive; }; GLIB_AVAILABLE_IN_ALL GThreadPool * g_thread_pool_new (GFunc func, gpointer user_data, gint max_threads, gboolean exclusive, GError **error); GLIB_AVAILABLE_IN_ALL void g_thread_pool_free (GThreadPool *pool, gboolean immediate, gboolean wait_); GLIB_AVAILABLE_IN_ALL gboolean g_thread_pool_push (GThreadPool *pool, gpointer data, GError **error); GLIB_AVAILABLE_IN_ALL guint g_thread_pool_unprocessed (GThreadPool *pool); GLIB_AVAILABLE_IN_ALL void g_thread_pool_set_sort_function (GThreadPool *pool, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_2_46 gboolean g_thread_pool_move_to_front (GThreadPool *pool, gpointer data); GLIB_AVAILABLE_IN_ALL gboolean g_thread_pool_set_max_threads (GThreadPool *pool, gint max_threads, GError **error); GLIB_AVAILABLE_IN_ALL gint g_thread_pool_get_max_threads (GThreadPool *pool); GLIB_AVAILABLE_IN_ALL guint g_thread_pool_get_num_threads (GThreadPool *pool); GLIB_AVAILABLE_IN_ALL void g_thread_pool_set_max_unused_threads (gint max_threads); GLIB_AVAILABLE_IN_ALL gint g_thread_pool_get_max_unused_threads (void); GLIB_AVAILABLE_IN_ALL guint g_thread_pool_get_num_unused_threads (void); GLIB_AVAILABLE_IN_ALL void g_thread_pool_stop_unused_threads (void); GLIB_AVAILABLE_IN_ALL void g_thread_pool_set_max_idle_time (guint interval); GLIB_AVAILABLE_IN_ALL guint g_thread_pool_get_max_idle_time (void); G_END_DECLS #endif /* __G_THREADPOOL_H__ */ glib/ghmac.h 0000644 00000006615 15125173650 0006726 0 ustar 00 /* ghmac.h - secure data hashing * * Copyright (C) 2011 Stef Walter <stefw@collabora.co.uk> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_HMAC_H__ #define __G_HMAC_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include "gchecksum.h" G_BEGIN_DECLS /** * GHmac: * * An opaque structure representing a HMAC operation. * To create a new GHmac, use g_hmac_new(). To free * a GHmac, use g_hmac_unref(). * * Since: 2.30 */ typedef struct _GHmac GHmac; GLIB_AVAILABLE_IN_2_30 GHmac * g_hmac_new (GChecksumType digest_type, const guchar *key, gsize key_len); GLIB_AVAILABLE_IN_2_30 GHmac * g_hmac_copy (const GHmac *hmac); GLIB_AVAILABLE_IN_2_30 GHmac * g_hmac_ref (GHmac *hmac); GLIB_AVAILABLE_IN_2_30 void g_hmac_unref (GHmac *hmac); GLIB_AVAILABLE_IN_2_30 void g_hmac_update (GHmac *hmac, const guchar *data, gssize length); GLIB_AVAILABLE_IN_2_30 const gchar * g_hmac_get_string (GHmac *hmac); GLIB_AVAILABLE_IN_2_30 void g_hmac_get_digest (GHmac *hmac, guint8 *buffer, gsize *digest_len); GLIB_AVAILABLE_IN_2_30 gchar *g_compute_hmac_for_data (GChecksumType digest_type, const guchar *key, gsize key_len, const guchar *data, gsize length); GLIB_AVAILABLE_IN_2_30 gchar *g_compute_hmac_for_string (GChecksumType digest_type, const guchar *key, gsize key_len, const gchar *str, gssize length); GLIB_AVAILABLE_IN_2_50 gchar *g_compute_hmac_for_bytes (GChecksumType digest_type, GBytes *key, GBytes *data); G_END_DECLS #endif /* __G_CHECKSUM_H__ */ glib/gi18n-lib.h 0000644 00000002532 15125173650 0007333 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997, 2002 Peter Mattis, Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_I18N_LIB_H__ #define __G_I18N_LIB_H__ #include <glib.h> #include <libintl.h> #include <string.h> #ifndef GETTEXT_PACKAGE #error You must define GETTEXT_PACKAGE before including gi18n-lib.h. Did you forget to include config.h? #endif #define _(String) ((char *) g_dgettext (GETTEXT_PACKAGE, String)) #define Q_(String) g_dpgettext (GETTEXT_PACKAGE, String, 0) #define N_(String) (String) #define C_(Context,String) g_dpgettext (GETTEXT_PACKAGE, Context "\004" String, strlen (Context) + 1) #define NC_(Context, String) (String) #endif /* __G_I18N_LIB_H__ */ glib/ghash.h 0000644 00000017316 15125173650 0006741 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_HASH_H__ #define __G_HASH_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <glib/glist.h> G_BEGIN_DECLS typedef struct _GHashTable GHashTable; typedef gboolean (*GHRFunc) (gpointer key, gpointer value, gpointer user_data); typedef struct _GHashTableIter GHashTableIter; struct _GHashTableIter { /*< private >*/ gpointer dummy1; gpointer dummy2; gpointer dummy3; int dummy4; gboolean dummy5; gpointer dummy6; }; GLIB_AVAILABLE_IN_ALL GHashTable* g_hash_table_new (GHashFunc hash_func, GEqualFunc key_equal_func); GLIB_AVAILABLE_IN_ALL GHashTable* g_hash_table_new_full (GHashFunc hash_func, GEqualFunc key_equal_func, GDestroyNotify key_destroy_func, GDestroyNotify value_destroy_func); GLIB_AVAILABLE_IN_ALL void g_hash_table_destroy (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_insert (GHashTable *hash_table, gpointer key, gpointer value); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_replace (GHashTable *hash_table, gpointer key, gpointer value); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_add (GHashTable *hash_table, gpointer key); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_remove (GHashTable *hash_table, gconstpointer key); GLIB_AVAILABLE_IN_ALL void g_hash_table_remove_all (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_steal (GHashTable *hash_table, gconstpointer key); GLIB_AVAILABLE_IN_2_58 gboolean g_hash_table_steal_extended (GHashTable *hash_table, gconstpointer lookup_key, gpointer *stolen_key, gpointer *stolen_value); GLIB_AVAILABLE_IN_ALL void g_hash_table_steal_all (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL gpointer g_hash_table_lookup (GHashTable *hash_table, gconstpointer key); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_contains (GHashTable *hash_table, gconstpointer key); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_lookup_extended (GHashTable *hash_table, gconstpointer lookup_key, gpointer *orig_key, gpointer *value); GLIB_AVAILABLE_IN_ALL void g_hash_table_foreach (GHashTable *hash_table, GHFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL gpointer g_hash_table_find (GHashTable *hash_table, GHRFunc predicate, gpointer user_data); GLIB_AVAILABLE_IN_ALL guint g_hash_table_foreach_remove (GHashTable *hash_table, GHRFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL guint g_hash_table_foreach_steal (GHashTable *hash_table, GHRFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL guint g_hash_table_size (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL GList * g_hash_table_get_keys (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL GList * g_hash_table_get_values (GHashTable *hash_table); GLIB_AVAILABLE_IN_2_40 gpointer * g_hash_table_get_keys_as_array (GHashTable *hash_table, guint *length); GLIB_AVAILABLE_IN_ALL void g_hash_table_iter_init (GHashTableIter *iter, GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL gboolean g_hash_table_iter_next (GHashTableIter *iter, gpointer *key, gpointer *value); GLIB_AVAILABLE_IN_ALL GHashTable* g_hash_table_iter_get_hash_table (GHashTableIter *iter); GLIB_AVAILABLE_IN_ALL void g_hash_table_iter_remove (GHashTableIter *iter); GLIB_AVAILABLE_IN_2_30 void g_hash_table_iter_replace (GHashTableIter *iter, gpointer value); GLIB_AVAILABLE_IN_ALL void g_hash_table_iter_steal (GHashTableIter *iter); GLIB_AVAILABLE_IN_ALL GHashTable* g_hash_table_ref (GHashTable *hash_table); GLIB_AVAILABLE_IN_ALL void g_hash_table_unref (GHashTable *hash_table); #define g_hash_table_freeze(hash_table) ((void)0) GLIB_DEPRECATED_MACRO_IN_2_26 #define g_hash_table_thaw(hash_table) ((void)0) GLIB_DEPRECATED_MACRO_IN_2_26 /* Hash Functions */ GLIB_AVAILABLE_IN_ALL gboolean g_str_equal (gconstpointer v1, gconstpointer v2); GLIB_AVAILABLE_IN_ALL guint g_str_hash (gconstpointer v); GLIB_AVAILABLE_IN_ALL gboolean g_int_equal (gconstpointer v1, gconstpointer v2); GLIB_AVAILABLE_IN_ALL guint g_int_hash (gconstpointer v); GLIB_AVAILABLE_IN_ALL gboolean g_int64_equal (gconstpointer v1, gconstpointer v2); GLIB_AVAILABLE_IN_ALL guint g_int64_hash (gconstpointer v); GLIB_AVAILABLE_IN_ALL gboolean g_double_equal (gconstpointer v1, gconstpointer v2); GLIB_AVAILABLE_IN_ALL guint g_double_hash (gconstpointer v); GLIB_AVAILABLE_IN_ALL guint g_direct_hash (gconstpointer v) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_direct_equal (gconstpointer v1, gconstpointer v2) G_GNUC_CONST; G_END_DECLS #endif /* __G_HASH_H__ */ glib/grefstring.h 0000644 00000003514 15125173650 0010014 0 ustar 00 /* grefstring.h: Reference counted strings * * Copyright 2018 Emmanuele Bassi * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #pragma once #include "gmem.h" #include "gmacros.h" G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new (const char *str); GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new_len (const char *str, gssize len); GLIB_AVAILABLE_IN_2_58 char * g_ref_string_new_intern (const char *str); GLIB_AVAILABLE_IN_2_58 char * g_ref_string_acquire (char *str); GLIB_AVAILABLE_IN_2_58 void g_ref_string_release (char *str); GLIB_AVAILABLE_IN_2_58 gsize g_ref_string_length (char *str); /** * GRefString: * * A typedef for a reference-counted string. A pointer to a #GRefString can be * treated like a standard `char*` array by all code, but can additionally have * `g_ref_string_*()` methods called on it. `g_ref_string_*()` methods cannot be * called on `char*` arrays not allocated using g_ref_string_new(). * * If using #GRefString with autocleanups, g_autoptr() must be used rather than * g_autofree(), so that the reference counting metadata is also freed. * * Since: 2.58 */ typedef char GRefString; G_END_DECLS glib/gdatetime.h 0000644 00000030702 15125173650 0007604 0 ustar 00 /* * Copyright (C) 2009-2010 Christian Hergert <chris@dronelabs.com> * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of the * licence, or (at your option) any later version. * * This 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 Lesser General Public * License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Christian Hergert <chris@dronelabs.com> * Thiago Santos <thiago.sousa.santos@collabora.co.uk> * Emmanuele Bassi <ebassi@linux.intel.com> * Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_DATE_TIME_H__ #define __G_DATE_TIME_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtimezone.h> G_BEGIN_DECLS /** * G_TIME_SPAN_DAY: * * Evaluates to a time span of one day. * * Since: 2.26 */ #define G_TIME_SPAN_DAY (G_GINT64_CONSTANT (86400000000)) /** * G_TIME_SPAN_HOUR: * * Evaluates to a time span of one hour. * * Since: 2.26 */ #define G_TIME_SPAN_HOUR (G_GINT64_CONSTANT (3600000000)) /** * G_TIME_SPAN_MINUTE: * * Evaluates to a time span of one minute. * * Since: 2.26 */ #define G_TIME_SPAN_MINUTE (G_GINT64_CONSTANT (60000000)) /** * G_TIME_SPAN_SECOND: * * Evaluates to a time span of one second. * * Since: 2.26 */ #define G_TIME_SPAN_SECOND (G_GINT64_CONSTANT (1000000)) /** * G_TIME_SPAN_MILLISECOND: * * Evaluates to a time span of one millisecond. * * Since: 2.26 */ #define G_TIME_SPAN_MILLISECOND (G_GINT64_CONSTANT (1000)) /** * GTimeSpan: * * A value representing an interval of time, in microseconds. * * Since: 2.26 */ typedef gint64 GTimeSpan; /** * GDateTime: * * `GDateTime` is an opaque structure whose members * cannot be accessed directly. * * Since: 2.26 */ typedef struct _GDateTime GDateTime; GLIB_AVAILABLE_IN_ALL void g_date_time_unref (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_ref (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_now (GTimeZone *tz); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_now_local (void); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_now_utc (void); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_from_unix_local (gint64 t); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_from_unix_utc (gint64 t); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_date_time_new_from_unix_local) GDateTime * g_date_time_new_from_timeval_local (const GTimeVal *tv); GLIB_DEPRECATED_IN_2_62_FOR(g_date_time_new_from_unix_utc) GDateTime * g_date_time_new_from_timeval_utc (const GTimeVal *tv); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_2_56 GDateTime * g_date_time_new_from_iso8601 (const gchar *text, GTimeZone *default_tz); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new (GTimeZone *tz, gint year, gint month, gint day, gint hour, gint minute, gdouble seconds); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_local (gint year, gint month, gint day, gint hour, gint minute, gdouble seconds); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_new_utc (gint year, gint month, gint day, gint hour, gint minute, gdouble seconds); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add (GDateTime *datetime, GTimeSpan timespan); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_years (GDateTime *datetime, gint years); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_months (GDateTime *datetime, gint months); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_weeks (GDateTime *datetime, gint weeks); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_days (GDateTime *datetime, gint days); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_hours (GDateTime *datetime, gint hours); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_minutes (GDateTime *datetime, gint minutes); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_seconds (GDateTime *datetime, gdouble seconds); GLIB_AVAILABLE_IN_ALL G_GNUC_WARN_UNUSED_RESULT GDateTime * g_date_time_add_full (GDateTime *datetime, gint years, gint months, gint days, gint hours, gint minutes, gdouble seconds); GLIB_AVAILABLE_IN_ALL gint g_date_time_compare (gconstpointer dt1, gconstpointer dt2); GLIB_AVAILABLE_IN_ALL GTimeSpan g_date_time_difference (GDateTime *end, GDateTime *begin); GLIB_AVAILABLE_IN_ALL guint g_date_time_hash (gconstpointer datetime); GLIB_AVAILABLE_IN_ALL gboolean g_date_time_equal (gconstpointer dt1, gconstpointer dt2); GLIB_AVAILABLE_IN_ALL void g_date_time_get_ymd (GDateTime *datetime, gint *year, gint *month, gint *day); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_year (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_month (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_day_of_month (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_week_numbering_year (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_week_of_year (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_day_of_week (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_day_of_year (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_hour (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_minute (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_second (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint g_date_time_get_microsecond (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gdouble g_date_time_get_seconds (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gint64 g_date_time_to_unix (GDateTime *datetime); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_date_time_to_unix) gboolean g_date_time_to_timeval (GDateTime *datetime, GTimeVal *tv); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL GTimeSpan g_date_time_get_utc_offset (GDateTime *datetime); GLIB_AVAILABLE_IN_2_58 GTimeZone * g_date_time_get_timezone (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL const gchar * g_date_time_get_timezone_abbreviation (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gboolean g_date_time_is_daylight_savings (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_to_timezone (GDateTime *datetime, GTimeZone *tz); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_to_local (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL GDateTime * g_date_time_to_utc (GDateTime *datetime); GLIB_AVAILABLE_IN_ALL gchar * g_date_time_format (GDateTime *datetime, const gchar *format) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_62 gchar * g_date_time_format_iso8601 (GDateTime *datetime) G_GNUC_MALLOC; G_END_DECLS #endif /* __G_DATE_TIME_H__ */ glib/gbitlock.h 0000644 00000005526 15125173650 0007445 0 ustar 00 /* * Copyright © 2008 Ryan Lortie * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_BITLOCK_H__ #define __G_BITLOCK_H__ #include <glib/gtypes.h> #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL void g_bit_lock (volatile gint *address, gint lock_bit); GLIB_AVAILABLE_IN_ALL gboolean g_bit_trylock (volatile gint *address, gint lock_bit); GLIB_AVAILABLE_IN_ALL void g_bit_unlock (volatile gint *address, gint lock_bit); GLIB_AVAILABLE_IN_ALL void g_pointer_bit_lock (volatile void *address, gint lock_bit); GLIB_AVAILABLE_IN_ALL gboolean g_pointer_bit_trylock (volatile void *address, gint lock_bit); GLIB_AVAILABLE_IN_ALL void g_pointer_bit_unlock (volatile void *address, gint lock_bit); #ifdef __GNUC__ #define g_pointer_bit_lock(address, lock_bit) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \ g_pointer_bit_lock ((address), (lock_bit)); \ })) #define g_pointer_bit_trylock(address, lock_bit) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \ g_pointer_bit_trylock ((address), (lock_bit)); \ })) #define g_pointer_bit_unlock(address, lock_bit) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(address) == sizeof (gpointer)); \ g_pointer_bit_unlock ((address), (lock_bit)); \ })) #endif G_END_DECLS #endif /* __G_BITLOCK_H_ */ glib/gmem.h 0000644 00000035011 15125173650 0006564 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_MEM_H__ #define __G_MEM_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gutils.h> #if defined(glib_typeof_2_68) && GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68 /* for glib_typeof */ #include <type_traits> #endif G_BEGIN_DECLS /** * GMemVTable: * @malloc: function to use for allocating memory. * @realloc: function to use for reallocating memory. * @free: function to use to free memory. * @calloc: function to use for allocating zero-filled memory. * @try_malloc: function to use for allocating memory without a default error handler. * @try_realloc: function to use for reallocating memory without a default error handler. * * A set of functions used to perform memory allocation. The same #GMemVTable must * be used for all allocations in the same program; a call to g_mem_set_vtable(), * if it exists, should be prior to any use of GLib. * * This functions related to this has been deprecated in 2.46, and no longer work. */ typedef struct _GMemVTable GMemVTable; #if GLIB_SIZEOF_VOID_P > GLIB_SIZEOF_LONG /** * G_MEM_ALIGN: * * Indicates the number of bytes to which memory will be aligned on the * current platform. */ # define G_MEM_ALIGN GLIB_SIZEOF_VOID_P #else /* GLIB_SIZEOF_VOID_P <= GLIB_SIZEOF_LONG */ # define G_MEM_ALIGN GLIB_SIZEOF_LONG #endif /* GLIB_SIZEOF_VOID_P <= GLIB_SIZEOF_LONG */ /* Memory allocation functions */ GLIB_AVAILABLE_IN_ALL void g_free (gpointer mem); GLIB_AVAILABLE_IN_2_34 void g_clear_pointer (gpointer *pp, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_malloc0 (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_realloc (gpointer mem, gsize n_bytes) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gpointer g_try_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_try_malloc0 (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_try_realloc (gpointer mem, gsize n_bytes) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gpointer g_malloc_n (gsize n_blocks, gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1,2); GLIB_AVAILABLE_IN_ALL gpointer g_malloc0_n (gsize n_blocks, gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1,2); GLIB_AVAILABLE_IN_ALL gpointer g_realloc_n (gpointer mem, gsize n_blocks, gsize n_block_bytes) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gpointer g_try_malloc_n (gsize n_blocks, gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1,2); GLIB_AVAILABLE_IN_ALL gpointer g_try_malloc0_n (gsize n_blocks, gsize n_block_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE2(1,2); GLIB_AVAILABLE_IN_ALL gpointer g_try_realloc_n (gpointer mem, gsize n_blocks, gsize n_block_bytes) G_GNUC_WARN_UNUSED_RESULT; #if defined(glib_typeof) && GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_58 && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) #define g_clear_pointer(pp, destroy) \ G_STMT_START \ { \ G_STATIC_ASSERT (sizeof *(pp) == sizeof (gpointer)); \ glib_typeof ((pp)) _pp = (pp); \ glib_typeof (*(pp)) _ptr = *_pp; \ *_pp = NULL; \ if (_ptr) \ (destroy) (_ptr); \ } \ G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_34 #else /* __GNUC__ */ #define g_clear_pointer(pp, destroy) \ G_STMT_START { \ G_STATIC_ASSERT (sizeof *(pp) == sizeof (gpointer)); \ /* Only one access, please; work around type aliasing */ \ union { char *in; gpointer *out; } _pp; \ gpointer _p; \ /* This assignment is needed to avoid a gcc warning */ \ GDestroyNotify _destroy = (GDestroyNotify) (destroy); \ \ _pp.in = (char *) (pp); \ _p = *_pp.out; \ if (_p) \ { \ *_pp.out = NULL; \ _destroy (_p); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_34 #endif /* __GNUC__ */ /** * g_steal_pointer: * @pp: (not nullable): a pointer to a pointer * * Sets @pp to %NULL, returning the value that was there before. * * Conceptually, this transfers the ownership of the pointer from the * referenced variable to the "caller" of the macro (ie: "steals" the * reference). * * The return value will be properly typed, according to the type of * @pp. * * This can be very useful when combined with g_autoptr() to prevent the * return value of a function from being automatically freed. Consider * the following example (which only works on GCC and clang): * * |[ * GObject * * create_object (void) * { * g_autoptr(GObject) obj = g_object_new (G_TYPE_OBJECT, NULL); * * if (early_error_case) * return NULL; * * return g_steal_pointer (&obj); * } * ]| * * It can also be used in similar ways for 'out' parameters and is * particularly useful for dealing with optional out parameters: * * |[ * gboolean * get_object (GObject **obj_out) * { * g_autoptr(GObject) obj = g_object_new (G_TYPE_OBJECT, NULL); * * if (early_error_case) * return FALSE; * * if (obj_out) * *obj_out = g_steal_pointer (&obj); * * return TRUE; * } * ]| * * In the above example, the object will be automatically freed in the * early error case and also in the case that %NULL was given for * @obj_out. * * Since: 2.44 */ GLIB_AVAILABLE_STATIC_INLINE_IN_2_44 static inline gpointer g_steal_pointer (gpointer pp) { gpointer *ptr = (gpointer *) pp; gpointer ref; ref = *ptr; *ptr = NULL; return ref; } /* type safety */ #if defined(glib_typeof) && GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_58 && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) #define g_steal_pointer(pp) ((glib_typeof (*pp)) (g_steal_pointer) (pp)) #else /* __GNUC__ */ /* This version does not depend on gcc extensions, but gcc does not warn * about incompatible-pointer-types: */ #define g_steal_pointer(pp) \ (0 ? (*(pp)) : (g_steal_pointer) (pp)) #endif /* __GNUC__ */ /* Optimise: avoid the call to the (slower) _n function if we can * determine at compile-time that no overflow happens. */ #if defined (__GNUC__) && (__GNUC__ >= 2) && defined (__OPTIMIZE__) # define _G_NEW(struct_type, n_structs, func) \ (struct_type *) (G_GNUC_EXTENSION ({ \ gsize __n = (gsize) (n_structs); \ gsize __s = sizeof (struct_type); \ gpointer __p; \ if (__s == 1) \ __p = g_##func (__n); \ else if (__builtin_constant_p (__n) && \ (__s == 0 || __n <= G_MAXSIZE / __s)) \ __p = g_##func (__n * __s); \ else \ __p = g_##func##_n (__n, __s); \ __p; \ })) # define _G_RENEW(struct_type, mem, n_structs, func) \ (struct_type *) (G_GNUC_EXTENSION ({ \ gsize __n = (gsize) (n_structs); \ gsize __s = sizeof (struct_type); \ gpointer __p = (gpointer) (mem); \ if (__s == 1) \ __p = g_##func (__p, __n); \ else if (__builtin_constant_p (__n) && \ (__s == 0 || __n <= G_MAXSIZE / __s)) \ __p = g_##func (__p, __n * __s); \ else \ __p = g_##func##_n (__p, __n, __s); \ __p; \ })) #else /* Unoptimised version: always call the _n() function. */ #define _G_NEW(struct_type, n_structs, func) \ ((struct_type *) g_##func##_n ((n_structs), sizeof (struct_type))) #define _G_RENEW(struct_type, mem, n_structs, func) \ ((struct_type *) g_##func##_n (mem, (n_structs), sizeof (struct_type))) #endif /** * g_new: * @struct_type: the type of the elements to allocate * @n_structs: the number of elements to allocate * * Allocates @n_structs elements of type @struct_type. * The returned pointer is cast to a pointer to the given type. * If @n_structs is 0 it returns %NULL. * Care is taken to avoid overflow when calculating the size of the allocated block. * * Since the returned pointer is already casted to the right type, * it is normally unnecessary to cast it explicitly, and doing * so might hide memory allocation errors. * * Returns: a pointer to the allocated memory, cast to a pointer to @struct_type */ #define g_new(struct_type, n_structs) _G_NEW (struct_type, n_structs, malloc) /** * g_new0: * @struct_type: the type of the elements to allocate. * @n_structs: the number of elements to allocate. * * Allocates @n_structs elements of type @struct_type, initialized to 0's. * The returned pointer is cast to a pointer to the given type. * If @n_structs is 0 it returns %NULL. * Care is taken to avoid overflow when calculating the size of the allocated block. * * Since the returned pointer is already casted to the right type, * it is normally unnecessary to cast it explicitly, and doing * so might hide memory allocation errors. * * Returns: a pointer to the allocated memory, cast to a pointer to @struct_type. */ #define g_new0(struct_type, n_structs) _G_NEW (struct_type, n_structs, malloc0) /** * g_renew: * @struct_type: the type of the elements to allocate * @mem: the currently allocated memory * @n_structs: the number of elements to allocate * * Reallocates the memory pointed to by @mem, so that it now has space for * @n_structs elements of type @struct_type. It returns the new address of * the memory, which may have been moved. * Care is taken to avoid overflow when calculating the size of the allocated block. * * Returns: a pointer to the new allocated memory, cast to a pointer to @struct_type */ #define g_renew(struct_type, mem, n_structs) _G_RENEW (struct_type, mem, n_structs, realloc) /** * g_try_new: * @struct_type: the type of the elements to allocate * @n_structs: the number of elements to allocate * * Attempts to allocate @n_structs elements of type @struct_type, and returns * %NULL on failure. Contrast with g_new(), which aborts the program on failure. * The returned pointer is cast to a pointer to the given type. * The function returns %NULL when @n_structs is 0 of if an overflow occurs. * * Since: 2.8 * Returns: a pointer to the allocated memory, cast to a pointer to @struct_type */ #define g_try_new(struct_type, n_structs) _G_NEW (struct_type, n_structs, try_malloc) /** * g_try_new0: * @struct_type: the type of the elements to allocate * @n_structs: the number of elements to allocate * * Attempts to allocate @n_structs elements of type @struct_type, initialized * to 0's, and returns %NULL on failure. Contrast with g_new0(), which aborts * the program on failure. * The returned pointer is cast to a pointer to the given type. * The function returns %NULL when @n_structs is 0 or if an overflow occurs. * * Since: 2.8 * Returns: a pointer to the allocated memory, cast to a pointer to @struct_type */ #define g_try_new0(struct_type, n_structs) _G_NEW (struct_type, n_structs, try_malloc0) /** * g_try_renew: * @struct_type: the type of the elements to allocate * @mem: the currently allocated memory * @n_structs: the number of elements to allocate * * Attempts to reallocate the memory pointed to by @mem, so that it now has * space for @n_structs elements of type @struct_type, and returns %NULL on * failure. Contrast with g_renew(), which aborts the program on failure. * It returns the new address of the memory, which may have been moved. * The function returns %NULL if an overflow occurs. * * Since: 2.8 * Returns: a pointer to the new allocated memory, cast to a pointer to @struct_type */ #define g_try_renew(struct_type, mem, n_structs) _G_RENEW (struct_type, mem, n_structs, try_realloc) /* Memory allocation virtualization for debugging purposes * g_mem_set_vtable() has to be the very first GLib function called * if being used */ struct _GMemVTable { gpointer (*malloc) (gsize n_bytes); gpointer (*realloc) (gpointer mem, gsize n_bytes); void (*free) (gpointer mem); /* optional; set to NULL if not used ! */ gpointer (*calloc) (gsize n_blocks, gsize n_block_bytes); gpointer (*try_malloc) (gsize n_bytes); gpointer (*try_realloc) (gpointer mem, gsize n_bytes); }; GLIB_DEPRECATED_IN_2_46 void g_mem_set_vtable (GMemVTable *vtable); GLIB_DEPRECATED_IN_2_46 gboolean g_mem_is_system_malloc (void); GLIB_VAR gboolean g_mem_gc_friendly; /* Memory profiler and checker, has to be enabled via g_mem_set_vtable() */ GLIB_VAR GMemVTable *glib_mem_profiler_table; GLIB_DEPRECATED_IN_2_46 void g_mem_profile (void); G_END_DECLS #endif /* __G_MEM_H__ */ glib/gstring.h 0000644 00000020213 15125173650 0007312 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_STRING_H__ #define __G_STRING_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <glib/gunicode.h> #include <glib/gbytes.h> #include <glib/gutils.h> /* for G_CAN_INLINE */ G_BEGIN_DECLS typedef struct _GString GString; struct _GString { gchar *str; gsize len; gsize allocated_len; }; GLIB_AVAILABLE_IN_ALL GString* g_string_new (const gchar *init); GLIB_AVAILABLE_IN_ALL GString* g_string_new_len (const gchar *init, gssize len); GLIB_AVAILABLE_IN_ALL GString* g_string_sized_new (gsize dfl_size); GLIB_AVAILABLE_IN_ALL gchar* g_string_free (GString *string, gboolean free_segment); GLIB_AVAILABLE_IN_2_34 GBytes* g_string_free_to_bytes (GString *string); GLIB_AVAILABLE_IN_ALL gboolean g_string_equal (const GString *v, const GString *v2); GLIB_AVAILABLE_IN_ALL guint g_string_hash (const GString *str); GLIB_AVAILABLE_IN_ALL GString* g_string_assign (GString *string, const gchar *rval); GLIB_AVAILABLE_IN_ALL GString* g_string_truncate (GString *string, gsize len); GLIB_AVAILABLE_IN_ALL GString* g_string_set_size (GString *string, gsize len); GLIB_AVAILABLE_IN_ALL GString* g_string_insert_len (GString *string, gssize pos, const gchar *val, gssize len); GLIB_AVAILABLE_IN_ALL GString* g_string_append (GString *string, const gchar *val); GLIB_AVAILABLE_IN_ALL GString* g_string_append_len (GString *string, const gchar *val, gssize len); GLIB_AVAILABLE_IN_ALL GString* g_string_append_c (GString *string, gchar c); GLIB_AVAILABLE_IN_ALL GString* g_string_append_unichar (GString *string, gunichar wc); GLIB_AVAILABLE_IN_ALL GString* g_string_prepend (GString *string, const gchar *val); GLIB_AVAILABLE_IN_ALL GString* g_string_prepend_c (GString *string, gchar c); GLIB_AVAILABLE_IN_ALL GString* g_string_prepend_unichar (GString *string, gunichar wc); GLIB_AVAILABLE_IN_ALL GString* g_string_prepend_len (GString *string, const gchar *val, gssize len); GLIB_AVAILABLE_IN_ALL GString* g_string_insert (GString *string, gssize pos, const gchar *val); GLIB_AVAILABLE_IN_ALL GString* g_string_insert_c (GString *string, gssize pos, gchar c); GLIB_AVAILABLE_IN_ALL GString* g_string_insert_unichar (GString *string, gssize pos, gunichar wc); GLIB_AVAILABLE_IN_ALL GString* g_string_overwrite (GString *string, gsize pos, const gchar *val); GLIB_AVAILABLE_IN_ALL GString* g_string_overwrite_len (GString *string, gsize pos, const gchar *val, gssize len); GLIB_AVAILABLE_IN_ALL GString* g_string_erase (GString *string, gssize pos, gssize len); GLIB_AVAILABLE_IN_2_68 guint g_string_replace (GString *string, const gchar *find, const gchar *replace, guint limit); GLIB_AVAILABLE_IN_ALL GString* g_string_ascii_down (GString *string); GLIB_AVAILABLE_IN_ALL GString* g_string_ascii_up (GString *string); GLIB_AVAILABLE_IN_ALL void g_string_vprintf (GString *string, const gchar *format, va_list args) G_GNUC_PRINTF(2, 0); GLIB_AVAILABLE_IN_ALL void g_string_printf (GString *string, const gchar *format, ...) G_GNUC_PRINTF (2, 3); GLIB_AVAILABLE_IN_ALL void g_string_append_vprintf (GString *string, const gchar *format, va_list args) G_GNUC_PRINTF(2, 0); GLIB_AVAILABLE_IN_ALL void g_string_append_printf (GString *string, const gchar *format, ...) G_GNUC_PRINTF (2, 3); GLIB_AVAILABLE_IN_ALL GString* g_string_append_uri_escaped (GString *string, const gchar *unescaped, const gchar *reserved_chars_allowed, gboolean allow_utf8); /* -- optimize g_strig_append_c --- */ #ifdef G_CAN_INLINE static inline GString* g_string_append_c_inline (GString *gstring, gchar c) { if (gstring->len + 1 < gstring->allocated_len) { gstring->str[gstring->len++] = c; gstring->str[gstring->len] = 0; } else g_string_insert_c (gstring, -1, c); return gstring; } #define g_string_append_c(gstr,c) g_string_append_c_inline (gstr, c) #endif /* G_CAN_INLINE */ GLIB_DEPRECATED GString *g_string_down (GString *string); GLIB_DEPRECATED GString *g_string_up (GString *string); #define g_string_sprintf g_string_printf GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_string_printf) #define g_string_sprintfa g_string_append_printf GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_string_append_printf) G_END_DECLS #endif /* __G_STRING_H__ */ glib/gregex.h 0000644 00000066677 15125173650 0007146 0 ustar 00 /* GRegex -- regular expression API wrapper around PCRE. * * Copyright (C) 1999, 2000 Scott Wimer * Copyright (C) 2004, Matthias Clasen <mclasen@redhat.com> * Copyright (C) 2005 - 2007, Marco Barisione <marco@barisione.org> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_REGEX_H__ #define __G_REGEX_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> #include <glib/gstring.h> G_BEGIN_DECLS /** * GRegexError: * @G_REGEX_ERROR_COMPILE: Compilation of the regular expression failed. * @G_REGEX_ERROR_OPTIMIZE: Optimization of the regular expression failed. * @G_REGEX_ERROR_REPLACE: Replacement failed due to an ill-formed replacement * string. * @G_REGEX_ERROR_MATCH: The match process failed. * @G_REGEX_ERROR_INTERNAL: Internal error of the regular expression engine. * Since 2.16 * @G_REGEX_ERROR_STRAY_BACKSLASH: "\\" at end of pattern. Since 2.16 * @G_REGEX_ERROR_MISSING_CONTROL_CHAR: "\\c" at end of pattern. Since 2.16 * @G_REGEX_ERROR_UNRECOGNIZED_ESCAPE: Unrecognized character follows "\\". * Since 2.16 * @G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER: Numbers out of order in "{}" * quantifier. Since 2.16 * @G_REGEX_ERROR_QUANTIFIER_TOO_BIG: Number too big in "{}" quantifier. * Since 2.16 * @G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS: Missing terminating "]" for * character class. Since 2.16 * @G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS: Invalid escape sequence * in character class. Since 2.16 * @G_REGEX_ERROR_RANGE_OUT_OF_ORDER: Range out of order in character class. * Since 2.16 * @G_REGEX_ERROR_NOTHING_TO_REPEAT: Nothing to repeat. Since 2.16 * @G_REGEX_ERROR_UNRECOGNIZED_CHARACTER: Unrecognized character after "(?", * "(?<" or "(?P". Since 2.16 * @G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS: POSIX named classes are * supported only within a class. Since 2.16 * @G_REGEX_ERROR_UNMATCHED_PARENTHESIS: Missing terminating ")" or ")" * without opening "(". Since 2.16 * @G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE: Reference to non-existent * subpattern. Since 2.16 * @G_REGEX_ERROR_UNTERMINATED_COMMENT: Missing terminating ")" after comment. * Since 2.16 * @G_REGEX_ERROR_EXPRESSION_TOO_LARGE: Regular expression too large. * Since 2.16 * @G_REGEX_ERROR_MEMORY_ERROR: Failed to get memory. Since 2.16 * @G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND: Lookbehind assertion is not * fixed length. Since 2.16 * @G_REGEX_ERROR_MALFORMED_CONDITION: Malformed number or name after "(?(". * Since 2.16 * @G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES: Conditional group contains * more than two branches. Since 2.16 * @G_REGEX_ERROR_ASSERTION_EXPECTED: Assertion expected after "(?(". * Since 2.16 * @G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME: Unknown POSIX class name. * Since 2.16 * @G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED: POSIX collating * elements are not supported. Since 2.16 * @G_REGEX_ERROR_HEX_CODE_TOO_LARGE: Character value in "\\x{...}" sequence * is too large. Since 2.16 * @G_REGEX_ERROR_INVALID_CONDITION: Invalid condition "(?(0)". Since 2.16 * @G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND: \\C not allowed in * lookbehind assertion. Since 2.16 * @G_REGEX_ERROR_INFINITE_LOOP: Recursive call could loop indefinitely. * Since 2.16 * @G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR: Missing terminator * in subpattern name. Since 2.16 * @G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME: Two named subpatterns have * the same name. Since 2.16 * @G_REGEX_ERROR_MALFORMED_PROPERTY: Malformed "\\P" or "\\p" sequence. * Since 2.16 * @G_REGEX_ERROR_UNKNOWN_PROPERTY: Unknown property name after "\\P" or * "\\p". Since 2.16 * @G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG: Subpattern name is too long * (maximum 32 characters). Since 2.16 * @G_REGEX_ERROR_TOO_MANY_SUBPATTERNS: Too many named subpatterns (maximum * 10,000). Since 2.16 * @G_REGEX_ERROR_INVALID_OCTAL_VALUE: Octal value is greater than "\\377". * Since 2.16 * @G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE: "DEFINE" group contains more * than one branch. Since 2.16 * @G_REGEX_ERROR_DEFINE_REPETION: Repeating a "DEFINE" group is not allowed. * This error is never raised. Since: 2.16 Deprecated: 2.34 * @G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS: Inconsistent newline options. * Since 2.16 * @G_REGEX_ERROR_MISSING_BACK_REFERENCE: "\\g" is not followed by a braced, * angle-bracketed, or quoted name or number, or by a plain number. Since: 2.16 * @G_REGEX_ERROR_INVALID_RELATIVE_REFERENCE: relative reference must not be zero. Since: 2.34 * @G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_FORBIDDEN: the backtracing * control verb used does not allow an argument. Since: 2.34 * @G_REGEX_ERROR_UNKNOWN_BACKTRACKING_CONTROL_VERB: unknown backtracing * control verb. Since: 2.34 * @G_REGEX_ERROR_NUMBER_TOO_BIG: number is too big in escape sequence. Since: 2.34 * @G_REGEX_ERROR_MISSING_SUBPATTERN_NAME: Missing subpattern name. Since: 2.34 * @G_REGEX_ERROR_MISSING_DIGIT: Missing digit. Since 2.34 * @G_REGEX_ERROR_INVALID_DATA_CHARACTER: In JavaScript compatibility mode, * "[" is an invalid data character. Since: 2.34 * @G_REGEX_ERROR_EXTRA_SUBPATTERN_NAME: different names for subpatterns of the * same number are not allowed. Since: 2.34 * @G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_REQUIRED: the backtracing control * verb requires an argument. Since: 2.34 * @G_REGEX_ERROR_INVALID_CONTROL_CHAR: "\\c" must be followed by an ASCII * character. Since: 2.34 * @G_REGEX_ERROR_MISSING_NAME: "\\k" is not followed by a braced, angle-bracketed, or * quoted name. Since: 2.34 * @G_REGEX_ERROR_NOT_SUPPORTED_IN_CLASS: "\\N" is not supported in a class. Since: 2.34 * @G_REGEX_ERROR_TOO_MANY_FORWARD_REFERENCES: too many forward references. Since: 2.34 * @G_REGEX_ERROR_NAME_TOO_LONG: the name is too long in "(*MARK)", "(*PRUNE)", * "(*SKIP)", or "(*THEN)". Since: 2.34 * @G_REGEX_ERROR_CHARACTER_VALUE_TOO_LARGE: the character value in the \\u sequence is * too large. Since: 2.34 * * Error codes returned by regular expressions functions. * * Since: 2.14 */ typedef enum { G_REGEX_ERROR_COMPILE, G_REGEX_ERROR_OPTIMIZE, G_REGEX_ERROR_REPLACE, G_REGEX_ERROR_MATCH, G_REGEX_ERROR_INTERNAL, /* These are the error codes from PCRE + 100 */ G_REGEX_ERROR_STRAY_BACKSLASH = 101, G_REGEX_ERROR_MISSING_CONTROL_CHAR = 102, G_REGEX_ERROR_UNRECOGNIZED_ESCAPE = 103, G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER = 104, G_REGEX_ERROR_QUANTIFIER_TOO_BIG = 105, G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS = 106, G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS = 107, G_REGEX_ERROR_RANGE_OUT_OF_ORDER = 108, G_REGEX_ERROR_NOTHING_TO_REPEAT = 109, G_REGEX_ERROR_UNRECOGNIZED_CHARACTER = 112, G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS = 113, G_REGEX_ERROR_UNMATCHED_PARENTHESIS = 114, G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE = 115, G_REGEX_ERROR_UNTERMINATED_COMMENT = 118, G_REGEX_ERROR_EXPRESSION_TOO_LARGE = 120, G_REGEX_ERROR_MEMORY_ERROR = 121, G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND = 125, G_REGEX_ERROR_MALFORMED_CONDITION = 126, G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES = 127, G_REGEX_ERROR_ASSERTION_EXPECTED = 128, G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME = 130, G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED = 131, G_REGEX_ERROR_HEX_CODE_TOO_LARGE = 134, G_REGEX_ERROR_INVALID_CONDITION = 135, G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND = 136, G_REGEX_ERROR_INFINITE_LOOP = 140, G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR = 142, G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME = 143, G_REGEX_ERROR_MALFORMED_PROPERTY = 146, G_REGEX_ERROR_UNKNOWN_PROPERTY = 147, G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG = 148, G_REGEX_ERROR_TOO_MANY_SUBPATTERNS = 149, G_REGEX_ERROR_INVALID_OCTAL_VALUE = 151, G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE = 154, G_REGEX_ERROR_DEFINE_REPETION = 155, G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS = 156, G_REGEX_ERROR_MISSING_BACK_REFERENCE = 157, G_REGEX_ERROR_INVALID_RELATIVE_REFERENCE = 158, G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_FORBIDDEN = 159, G_REGEX_ERROR_UNKNOWN_BACKTRACKING_CONTROL_VERB = 160, G_REGEX_ERROR_NUMBER_TOO_BIG = 161, G_REGEX_ERROR_MISSING_SUBPATTERN_NAME = 162, G_REGEX_ERROR_MISSING_DIGIT = 163, G_REGEX_ERROR_INVALID_DATA_CHARACTER = 164, G_REGEX_ERROR_EXTRA_SUBPATTERN_NAME = 165, G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_REQUIRED = 166, G_REGEX_ERROR_INVALID_CONTROL_CHAR = 168, G_REGEX_ERROR_MISSING_NAME = 169, G_REGEX_ERROR_NOT_SUPPORTED_IN_CLASS = 171, G_REGEX_ERROR_TOO_MANY_FORWARD_REFERENCES = 172, G_REGEX_ERROR_NAME_TOO_LONG = 175, G_REGEX_ERROR_CHARACTER_VALUE_TOO_LARGE = 176 } GRegexError; /** * G_REGEX_ERROR: * * Error domain for regular expressions. Errors in this domain will be * from the #GRegexError enumeration. See #GError for information on * error domains. * * Since: 2.14 */ #define G_REGEX_ERROR g_regex_error_quark () GLIB_AVAILABLE_IN_ALL GQuark g_regex_error_quark (void); /** * GRegexCompileFlags: * @G_REGEX_CASELESS: Letters in the pattern match both upper- and * lowercase letters. This option can be changed within a pattern * by a "(?i)" option setting. * @G_REGEX_MULTILINE: By default, GRegex treats the strings as consisting * of a single line of characters (even if it actually contains * newlines). The "start of line" metacharacter ("^") matches only * at the start of the string, while the "end of line" metacharacter * ("$") matches only at the end of the string, or before a terminating * newline (unless #G_REGEX_DOLLAR_ENDONLY is set). When * #G_REGEX_MULTILINE is set, the "start of line" and "end of line" * constructs match immediately following or immediately before any * newline in the string, respectively, as well as at the very start * and end. This can be changed within a pattern by a "(?m)" option * setting. * @G_REGEX_DOTALL: A dot metacharacter (".") in the pattern matches all * characters, including newlines. Without it, newlines are excluded. * This option can be changed within a pattern by a ("?s") option setting. * @G_REGEX_EXTENDED: Whitespace data characters in the pattern are * totally ignored except when escaped or inside a character class. * Whitespace does not include the VT character (code 11). In addition, * characters between an unescaped "#" outside a character class and * the next newline character, inclusive, are also ignored. This can * be changed within a pattern by a "(?x)" option setting. * @G_REGEX_ANCHORED: The pattern is forced to be "anchored", that is, * it is constrained to match only at the first matching point in the * string that is being searched. This effect can also be achieved by * appropriate constructs in the pattern itself such as the "^" * metacharacter. * @G_REGEX_DOLLAR_ENDONLY: A dollar metacharacter ("$") in the pattern * matches only at the end of the string. Without this option, a * dollar also matches immediately before the final character if * it is a newline (but not before any other newlines). This option * is ignored if #G_REGEX_MULTILINE is set. * @G_REGEX_UNGREEDY: Inverts the "greediness" of the quantifiers so that * they are not greedy by default, but become greedy if followed by "?". * It can also be set by a "(?U)" option setting within the pattern. * @G_REGEX_RAW: Usually strings must be valid UTF-8 strings, using this * flag they are considered as a raw sequence of bytes. * @G_REGEX_NO_AUTO_CAPTURE: Disables the use of numbered capturing * parentheses in the pattern. Any opening parenthesis that is not * followed by "?" behaves as if it were followed by "?:" but named * parentheses can still be used for capturing (and they acquire numbers * in the usual way). * @G_REGEX_OPTIMIZE: Optimize the regular expression. If the pattern will * be used many times, then it may be worth the effort to optimize it * to improve the speed of matches. * @G_REGEX_FIRSTLINE: Limits an unanchored pattern to match before (or at) the * first newline. Since: 2.34 * @G_REGEX_DUPNAMES: Names used to identify capturing subpatterns need not * be unique. This can be helpful for certain types of pattern when it * is known that only one instance of the named subpattern can ever be * matched. * @G_REGEX_NEWLINE_CR: Usually any newline character or character sequence is * recognized. If this option is set, the only recognized newline character * is '\r'. * @G_REGEX_NEWLINE_LF: Usually any newline character or character sequence is * recognized. If this option is set, the only recognized newline character * is '\n'. * @G_REGEX_NEWLINE_CRLF: Usually any newline character or character sequence is * recognized. If this option is set, the only recognized newline character * sequence is '\r\n'. * @G_REGEX_NEWLINE_ANYCRLF: Usually any newline character or character sequence * is recognized. If this option is set, the only recognized newline character * sequences are '\r', '\n', and '\r\n'. Since: 2.34 * @G_REGEX_BSR_ANYCRLF: Usually any newline character or character sequence * is recognised. If this option is set, then "\R" only recognizes the newline * characters '\r', '\n' and '\r\n'. Since: 2.34 * @G_REGEX_JAVASCRIPT_COMPAT: Changes behaviour so that it is compatible with * JavaScript rather than PCRE. Since: 2.34 * * Flags specifying compile-time options. * * Since: 2.14 */ /* Remember to update G_REGEX_COMPILE_MASK in gregex.c after * adding a new flag. */ typedef enum { G_REGEX_CASELESS = 1 << 0, G_REGEX_MULTILINE = 1 << 1, G_REGEX_DOTALL = 1 << 2, G_REGEX_EXTENDED = 1 << 3, G_REGEX_ANCHORED = 1 << 4, G_REGEX_DOLLAR_ENDONLY = 1 << 5, G_REGEX_UNGREEDY = 1 << 9, G_REGEX_RAW = 1 << 11, G_REGEX_NO_AUTO_CAPTURE = 1 << 12, G_REGEX_OPTIMIZE = 1 << 13, G_REGEX_FIRSTLINE = 1 << 18, G_REGEX_DUPNAMES = 1 << 19, G_REGEX_NEWLINE_CR = 1 << 20, G_REGEX_NEWLINE_LF = 1 << 21, G_REGEX_NEWLINE_CRLF = G_REGEX_NEWLINE_CR | G_REGEX_NEWLINE_LF, G_REGEX_NEWLINE_ANYCRLF = G_REGEX_NEWLINE_CR | 1 << 22, G_REGEX_BSR_ANYCRLF = 1 << 23, G_REGEX_JAVASCRIPT_COMPAT = 1 << 25 } GRegexCompileFlags; /** * GRegexMatchFlags: * @G_REGEX_MATCH_ANCHORED: The pattern is forced to be "anchored", that is, * it is constrained to match only at the first matching point in the * string that is being searched. This effect can also be achieved by * appropriate constructs in the pattern itself such as the "^" * metacharacter. * @G_REGEX_MATCH_NOTBOL: Specifies that first character of the string is * not the beginning of a line, so the circumflex metacharacter should * not match before it. Setting this without #G_REGEX_MULTILINE (at * compile time) causes circumflex never to match. This option affects * only the behaviour of the circumflex metacharacter, it does not * affect "\A". * @G_REGEX_MATCH_NOTEOL: Specifies that the end of the subject string is * not the end of a line, so the dollar metacharacter should not match * it nor (except in multiline mode) a newline immediately before it. * Setting this without #G_REGEX_MULTILINE (at compile time) causes * dollar never to match. This option affects only the behaviour of * the dollar metacharacter, it does not affect "\Z" or "\z". * @G_REGEX_MATCH_NOTEMPTY: An empty string is not considered to be a valid * match if this option is set. If there are alternatives in the pattern, * they are tried. If all the alternatives match the empty string, the * entire match fails. For example, if the pattern "a?b?" is applied to * a string not beginning with "a" or "b", it matches the empty string * at the start of the string. With this flag set, this match is not * valid, so GRegex searches further into the string for occurrences * of "a" or "b". * @G_REGEX_MATCH_PARTIAL: Turns on the partial matching feature, for more * documentation on partial matching see g_match_info_is_partial_match(). * @G_REGEX_MATCH_NEWLINE_CR: Overrides the newline definition set when * creating a new #GRegex, setting the '\r' character as line terminator. * @G_REGEX_MATCH_NEWLINE_LF: Overrides the newline definition set when * creating a new #GRegex, setting the '\n' character as line terminator. * @G_REGEX_MATCH_NEWLINE_CRLF: Overrides the newline definition set when * creating a new #GRegex, setting the '\r\n' characters sequence as line terminator. * @G_REGEX_MATCH_NEWLINE_ANY: Overrides the newline definition set when * creating a new #GRegex, any Unicode newline sequence * is recognised as a newline. These are '\r', '\n' and '\rn', and the * single characters U+000B LINE TABULATION, U+000C FORM FEED (FF), * U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and * U+2029 PARAGRAPH SEPARATOR. * @G_REGEX_MATCH_NEWLINE_ANYCRLF: Overrides the newline definition set when * creating a new #GRegex; any '\r', '\n', or '\r\n' character sequence * is recognized as a newline. Since: 2.34 * @G_REGEX_MATCH_BSR_ANYCRLF: Overrides the newline definition for "\R" set when * creating a new #GRegex; only '\r', '\n', or '\r\n' character sequences * are recognized as a newline by "\R". Since: 2.34 * @G_REGEX_MATCH_BSR_ANY: Overrides the newline definition for "\R" set when * creating a new #GRegex; any Unicode newline character or character sequence * are recognized as a newline by "\R". These are '\r', '\n' and '\rn', and the * single characters U+000B LINE TABULATION, U+000C FORM FEED (FF), * U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and * U+2029 PARAGRAPH SEPARATOR. Since: 2.34 * @G_REGEX_MATCH_PARTIAL_SOFT: An alias for #G_REGEX_MATCH_PARTIAL. Since: 2.34 * @G_REGEX_MATCH_PARTIAL_HARD: Turns on the partial matching feature. In contrast to * to #G_REGEX_MATCH_PARTIAL_SOFT, this stops matching as soon as a partial match * is found, without continuing to search for a possible complete match. See * g_match_info_is_partial_match() for more information. Since: 2.34 * @G_REGEX_MATCH_NOTEMPTY_ATSTART: Like #G_REGEX_MATCH_NOTEMPTY, but only applied to * the start of the matched string. For anchored * patterns this can only happen for pattern containing "\K". Since: 2.34 * * Flags specifying match-time options. * * Since: 2.14 */ /* Remember to update G_REGEX_MATCH_MASK in gregex.c after * adding a new flag. */ typedef enum { G_REGEX_MATCH_ANCHORED = 1 << 4, G_REGEX_MATCH_NOTBOL = 1 << 7, G_REGEX_MATCH_NOTEOL = 1 << 8, G_REGEX_MATCH_NOTEMPTY = 1 << 10, G_REGEX_MATCH_PARTIAL = 1 << 15, G_REGEX_MATCH_NEWLINE_CR = 1 << 20, G_REGEX_MATCH_NEWLINE_LF = 1 << 21, G_REGEX_MATCH_NEWLINE_CRLF = G_REGEX_MATCH_NEWLINE_CR | G_REGEX_MATCH_NEWLINE_LF, G_REGEX_MATCH_NEWLINE_ANY = 1 << 22, G_REGEX_MATCH_NEWLINE_ANYCRLF = G_REGEX_MATCH_NEWLINE_CR | G_REGEX_MATCH_NEWLINE_ANY, G_REGEX_MATCH_BSR_ANYCRLF = 1 << 23, G_REGEX_MATCH_BSR_ANY = 1 << 24, G_REGEX_MATCH_PARTIAL_SOFT = G_REGEX_MATCH_PARTIAL, G_REGEX_MATCH_PARTIAL_HARD = 1 << 27, G_REGEX_MATCH_NOTEMPTY_ATSTART = 1 << 28 } GRegexMatchFlags; /** * GRegex: * * A GRegex is the "compiled" form of a regular expression pattern. * This structure is opaque and its fields cannot be accessed directly. * * Since: 2.14 */ typedef struct _GRegex GRegex; /** * GMatchInfo: * * A GMatchInfo is an opaque struct used to return information about * matches. */ typedef struct _GMatchInfo GMatchInfo; /** * GRegexEvalCallback: * @match_info: the #GMatchInfo generated by the match. * Use g_match_info_get_regex() and g_match_info_get_string() if you * need the #GRegex or the matched string. * @result: a #GString containing the new string * @user_data: user data passed to g_regex_replace_eval() * * Specifies the type of the function passed to g_regex_replace_eval(). * It is called for each occurrence of the pattern in the string passed * to g_regex_replace_eval(), and it should append the replacement to * @result. * * Returns: %FALSE to continue the replacement process, %TRUE to stop it * * Since: 2.14 */ typedef gboolean (*GRegexEvalCallback) (const GMatchInfo *match_info, GString *result, gpointer user_data); GLIB_AVAILABLE_IN_ALL GRegex *g_regex_new (const gchar *pattern, GRegexCompileFlags compile_options, GRegexMatchFlags match_options, GError **error); GLIB_AVAILABLE_IN_ALL GRegex *g_regex_ref (GRegex *regex); GLIB_AVAILABLE_IN_ALL void g_regex_unref (GRegex *regex); GLIB_AVAILABLE_IN_ALL const gchar *g_regex_get_pattern (const GRegex *regex); GLIB_AVAILABLE_IN_ALL gint g_regex_get_max_backref (const GRegex *regex); GLIB_AVAILABLE_IN_ALL gint g_regex_get_capture_count (const GRegex *regex); GLIB_AVAILABLE_IN_ALL gboolean g_regex_get_has_cr_or_lf (const GRegex *regex); GLIB_AVAILABLE_IN_2_38 gint g_regex_get_max_lookbehind (const GRegex *regex); GLIB_AVAILABLE_IN_ALL gint g_regex_get_string_number (const GRegex *regex, const gchar *name); GLIB_AVAILABLE_IN_ALL gchar *g_regex_escape_string (const gchar *string, gint length); GLIB_AVAILABLE_IN_ALL gchar *g_regex_escape_nul (const gchar *string, gint length); GLIB_AVAILABLE_IN_ALL GRegexCompileFlags g_regex_get_compile_flags (const GRegex *regex); GLIB_AVAILABLE_IN_ALL GRegexMatchFlags g_regex_get_match_flags (const GRegex *regex); /* Matching. */ GLIB_AVAILABLE_IN_ALL gboolean g_regex_match_simple (const gchar *pattern, const gchar *string, GRegexCompileFlags compile_options, GRegexMatchFlags match_options); GLIB_AVAILABLE_IN_ALL gboolean g_regex_match (const GRegex *regex, const gchar *string, GRegexMatchFlags match_options, GMatchInfo **match_info); GLIB_AVAILABLE_IN_ALL gboolean g_regex_match_full (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, GRegexMatchFlags match_options, GMatchInfo **match_info, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_regex_match_all (const GRegex *regex, const gchar *string, GRegexMatchFlags match_options, GMatchInfo **match_info); GLIB_AVAILABLE_IN_ALL gboolean g_regex_match_all_full (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, GRegexMatchFlags match_options, GMatchInfo **match_info, GError **error); /* String splitting. */ GLIB_AVAILABLE_IN_ALL gchar **g_regex_split_simple (const gchar *pattern, const gchar *string, GRegexCompileFlags compile_options, GRegexMatchFlags match_options); GLIB_AVAILABLE_IN_ALL gchar **g_regex_split (const GRegex *regex, const gchar *string, GRegexMatchFlags match_options); GLIB_AVAILABLE_IN_ALL gchar **g_regex_split_full (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, GRegexMatchFlags match_options, gint max_tokens, GError **error); /* String replacement. */ GLIB_AVAILABLE_IN_ALL gchar *g_regex_replace (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, const gchar *replacement, GRegexMatchFlags match_options, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_regex_replace_literal (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, const gchar *replacement, GRegexMatchFlags match_options, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_regex_replace_eval (const GRegex *regex, const gchar *string, gssize string_len, gint start_position, GRegexMatchFlags match_options, GRegexEvalCallback eval, gpointer user_data, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_regex_check_replacement (const gchar *replacement, gboolean *has_references, GError **error); /* Match info */ GLIB_AVAILABLE_IN_ALL GRegex *g_match_info_get_regex (const GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL const gchar *g_match_info_get_string (const GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL GMatchInfo *g_match_info_ref (GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL void g_match_info_unref (GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL void g_match_info_free (GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL gboolean g_match_info_next (GMatchInfo *match_info, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_match_info_matches (const GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL gint g_match_info_get_match_count (const GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL gboolean g_match_info_is_partial_match (const GMatchInfo *match_info); GLIB_AVAILABLE_IN_ALL gchar *g_match_info_expand_references(const GMatchInfo *match_info, const gchar *string_to_expand, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_match_info_fetch (const GMatchInfo *match_info, gint match_num); GLIB_AVAILABLE_IN_ALL gboolean g_match_info_fetch_pos (const GMatchInfo *match_info, gint match_num, gint *start_pos, gint *end_pos); GLIB_AVAILABLE_IN_ALL gchar *g_match_info_fetch_named (const GMatchInfo *match_info, const gchar *name); GLIB_AVAILABLE_IN_ALL gboolean g_match_info_fetch_named_pos (const GMatchInfo *match_info, const gchar *name, gint *start_pos, gint *end_pos); GLIB_AVAILABLE_IN_ALL gchar **g_match_info_fetch_all (const GMatchInfo *match_info); G_END_DECLS #endif /* __G_REGEX_H__ */ glib/gslice.h 0000644 00000010751 15125173650 0007111 0 ustar 00 /* GLIB sliced memory - fast threaded memory chunk allocator * Copyright (C) 2005 Tim Janik * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SLICE_H__ #define __G_SLICE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <string.h> G_BEGIN_DECLS /* slices - fast allocation/release of small memory blocks */ GLIB_AVAILABLE_IN_ALL gpointer g_slice_alloc (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_slice_alloc0 (gsize block_size) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL gpointer g_slice_copy (gsize block_size, gconstpointer mem_block) G_GNUC_ALLOC_SIZE(1); GLIB_AVAILABLE_IN_ALL void g_slice_free1 (gsize block_size, gpointer mem_block); GLIB_AVAILABLE_IN_ALL void g_slice_free_chain_with_offset (gsize block_size, gpointer mem_chain, gsize next_offset); #define g_slice_new(type) ((type*) g_slice_alloc (sizeof (type))) /* Allow the compiler to inline memset(). Since the size is a constant, this * can significantly improve performance. */ #if defined (__GNUC__) && (__GNUC__ >= 2) && defined (__OPTIMIZE__) # define g_slice_new0(type) \ (type *) (G_GNUC_EXTENSION ({ \ gsize __s = sizeof (type); \ gpointer __p; \ __p = g_slice_alloc (__s); \ memset (__p, 0, __s); \ __p; \ })) #else # define g_slice_new0(type) ((type*) g_slice_alloc0 (sizeof (type))) #endif /* MemoryBlockType * * g_slice_dup (MemoryBlockType, * MemoryBlockType *mem_block); * g_slice_free (MemoryBlockType, * MemoryBlockType *mem_block); * g_slice_free_chain (MemoryBlockType, * MemoryBlockType *first_chain_block, * memory_block_next_field); * pseudo prototypes for the macro * definitions following below. */ /* we go through extra hoops to ensure type safety */ #define g_slice_dup(type, mem) \ (1 ? (type*) g_slice_copy (sizeof (type), (mem)) \ : ((void) ((type*) 0 == (mem)), (type*) 0)) #define g_slice_free(type, mem) \ G_STMT_START { \ if (1) g_slice_free1 (sizeof (type), (mem)); \ else (void) ((type*) 0 == (mem)); \ } G_STMT_END #define g_slice_free_chain(type, mem_chain, next) \ G_STMT_START { \ if (1) g_slice_free_chain_with_offset (sizeof (type), \ (mem_chain), G_STRUCT_OFFSET (type, next)); \ else (void) ((type*) 0 == (mem_chain)); \ } G_STMT_END /* --- internal debugging API --- */ typedef enum { G_SLICE_CONFIG_ALWAYS_MALLOC = 1, G_SLICE_CONFIG_BYPASS_MAGAZINES, G_SLICE_CONFIG_WORKING_SET_MSECS, G_SLICE_CONFIG_COLOR_INCREMENT, G_SLICE_CONFIG_CHUNK_SIZES, G_SLICE_CONFIG_CONTENTION_COUNTER } GSliceConfig; GLIB_DEPRECATED_IN_2_34 void g_slice_set_config (GSliceConfig ckey, gint64 value); GLIB_DEPRECATED_IN_2_34 gint64 g_slice_get_config (GSliceConfig ckey); GLIB_DEPRECATED_IN_2_34 gint64* g_slice_get_config_state (GSliceConfig ckey, gint64 address, guint *n_values); #ifdef G_ENABLE_DEBUG GLIB_AVAILABLE_IN_ALL void g_slice_debug_tree_statistics (void); #endif G_END_DECLS #endif /* __G_SLICE_H__ */ glib/galloca.h 0000644 00000007510 15125173650 0007244 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_ALLOCA_H__ #define __G_ALLOCA_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #if defined(__BIONIC__) && defined (GLIB_HAVE_ALLOCA_H) # include <alloca.h> #elif defined(__GNUC__) /* GCC does the right thing */ # undef alloca # define alloca(size) __builtin_alloca (size) #elif defined (GLIB_HAVE_ALLOCA_H) /* a native and working alloca.h is there */ # include <alloca.h> #else /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */ # if defined(_MSC_VER) || defined(__DMC__) # include <malloc.h> # define alloca _alloca # else /* !_MSC_VER && !__DMC__ */ # ifdef _AIX # pragma alloca # else /* !_AIX */ # ifndef alloca /* predefined by HP cc +Olibcalls */ G_BEGIN_DECLS char *alloca (); G_END_DECLS # endif /* !alloca */ # endif /* !_AIX */ # endif /* !_MSC_VER && !__DMC__ */ #endif /* !__GNUC__ && !GLIB_HAVE_ALLOCA_H */ /** * g_alloca: * @size: number of bytes to allocate. * * Allocates @size bytes on the stack; these bytes will be freed when the current * stack frame is cleaned up. This macro essentially just wraps the alloca() * function present on most UNIX variants. * Thus it provides the same advantages and pitfalls as alloca(): * * - alloca() is very fast, as on most systems it's implemented by just adjusting * the stack pointer register. * * - It doesn't cause any memory fragmentation, within its scope, separate alloca() * blocks just build up and are released together at function end. * * - Allocation sizes have to fit into the current stack frame. For instance in a * threaded environment on Linux, the per-thread stack size is limited to 2 Megabytes, * so be sparse with alloca() uses. * * - Allocation failure due to insufficient stack space is not indicated with a %NULL * return like e.g. with malloc(). Instead, most systems probably handle it the same * way as out of stack space situations from infinite function recursion, i.e. * with a segmentation fault. * * - Special care has to be taken when mixing alloca() with GNU C variable sized arrays. * Stack space allocated with alloca() in the same scope as a variable sized array * will be freed together with the variable sized array upon exit of that scope, and * not upon exit of the enclosing function scope. * * Returns: space for @size bytes, allocated on the stack */ #define g_alloca(size) alloca (size) /** * g_newa: * @struct_type: Type of memory chunks to be allocated * @n_structs: Number of chunks to be allocated * * Wraps g_alloca() in a more typesafe manner. * * Returns: Pointer to stack space for @n_structs chunks of type @struct_type */ #define g_newa(struct_type, n_structs) ((struct_type*) g_alloca (sizeof (struct_type) * (gsize) (n_structs))) #endif /* __G_ALLOCA_H__ */ glib/gbacktrace.h 0000644 00000005351 15125173650 0007731 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_BACKTRACE_H__ #define __G_BACKTRACE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #ifdef __sun__ #include <sys/select.h> #endif #include <signal.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL void g_on_error_query (const gchar *prg_name); GLIB_AVAILABLE_IN_ALL void g_on_error_stack_trace (const gchar *prg_name); /** * G_BREAKPOINT: * * Inserts a breakpoint instruction into the code. * * On architectures which support it, this is implemented as a soft interrupt * and on other architectures it raises a `SIGTRAP` signal. * * `SIGTRAP` is used rather than abort() to allow breakpoints to be skipped past * in a debugger if they are not the desired target of debugging. */ #if (defined (__i386__) || defined (__x86_64__)) && defined (__GNUC__) && __GNUC__ >= 2 # define G_BREAKPOINT() G_STMT_START{ __asm__ __volatile__ ("int $03"); }G_STMT_END #elif (defined (_MSC_VER) || defined (__DMC__)) && defined (_M_IX86) # define G_BREAKPOINT() G_STMT_START{ __asm int 3h }G_STMT_END #elif defined (_MSC_VER) # define G_BREAKPOINT() G_STMT_START{ __debugbreak(); }G_STMT_END #elif defined (__alpha__) && !defined(__osf__) && defined (__GNUC__) && __GNUC__ >= 2 # define G_BREAKPOINT() G_STMT_START{ __asm__ __volatile__ ("bpt"); }G_STMT_END #elif defined (__APPLE__) || (defined(_WIN32) && (defined(__clang__) || defined(__GNUC__))) # define G_BREAKPOINT() G_STMT_START{ __builtin_trap(); }G_STMT_END #else /* !__i386__ && !__alpha__ */ # define G_BREAKPOINT() G_STMT_START{ raise (SIGTRAP); }G_STMT_END #endif /* __i386__ */ G_END_DECLS #endif /* __G_BACKTRACE_H__ */ glib/gstrvbuilder.h 0000644 00000003115 15125173650 0010353 0 ustar 00 /* * Copyright © 2020 Canonical Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_STRVBUILDER_H__ #define __G_STRVBUILDER_H__ #if !defined(__GLIB_H_INSIDE__) && !defined(GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gstrfuncs.h> #include <glib/gtypes.h> G_BEGIN_DECLS /** * GStrvBuilder: * * A helper object to build a %NULL-terminated string array * by appending. See g_strv_builder_new(). * * Since: 2.68 */ typedef struct _GStrvBuilder GStrvBuilder; GLIB_AVAILABLE_IN_2_68 GStrvBuilder *g_strv_builder_new (void); GLIB_AVAILABLE_IN_2_68 void g_strv_builder_unref (GStrvBuilder *builder); GLIB_AVAILABLE_IN_2_68 GStrvBuilder *g_strv_builder_ref (GStrvBuilder *builder); GLIB_AVAILABLE_IN_2_68 void g_strv_builder_add (GStrvBuilder *builder, const char *value); GLIB_AVAILABLE_IN_2_68 GStrv g_strv_builder_end (GStrvBuilder *builder); G_END_DECLS #endif /* __G_STRVBUILDER_H__ */ glib/gprimes.h 0000644 00000003236 15125173650 0007311 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_PRIMES_H__ #define __G_PRIMES_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS /* Prime numbers. */ /* This function returns prime numbers spaced by approximately 1.5-2.0 * and is for use in resizing data structures which prefer * prime-valued sizes. The closest spaced prime function returns the * next largest prime, or the highest it knows about which is about * MAXINT/4. */ GLIB_AVAILABLE_IN_ALL guint g_spaced_primes_closest (guint num) G_GNUC_CONST; G_END_DECLS #endif /* __G_PRIMES_H__ */ glib/grefcount.h 0000644 00000007624 15125173650 0007644 0 ustar 00 /* grefcount.h: Reference counting * * Copyright 2018 Emmanuele Bassi * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __GREFCOUNT_H__ #define __GREFCOUNT_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gatomic.h> #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_58 void g_ref_count_init (grefcount *rc); GLIB_AVAILABLE_IN_2_58 void g_ref_count_inc (grefcount *rc); GLIB_AVAILABLE_IN_2_58 gboolean g_ref_count_dec (grefcount *rc); GLIB_AVAILABLE_IN_2_58 gboolean g_ref_count_compare (grefcount *rc, gint val); GLIB_AVAILABLE_IN_2_58 void g_atomic_ref_count_init (gatomicrefcount *arc); GLIB_AVAILABLE_IN_2_58 void g_atomic_ref_count_inc (gatomicrefcount *arc); GLIB_AVAILABLE_IN_2_58 gboolean g_atomic_ref_count_dec (gatomicrefcount *arc); GLIB_AVAILABLE_IN_2_58 gboolean g_atomic_ref_count_compare (gatomicrefcount *arc, gint val); /* On GCC we can use __extension__ to inline the API without using * ancillary functions; we only do this when disabling checks, as * it disables warnings when saturating the reference counters */ #if defined(__GNUC__) && defined(G_DISABLE_CHECKS) # define g_ref_count_init(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (grefcount)); \ (void) (0 ? *(rc) ^ *(rc) : 1); \ *(rc) = -1; \ })) # define g_ref_count_inc(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (grefcount)); \ (void) (0 ? *(rc) ^ *(rc) : 1); \ if (*(rc) == G_MININT) ; else { \ *(rc) -= 1; \ } \ })) # define g_ref_count_dec(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (grefcount)); \ grefcount __rc = *(rc); \ __rc += 1; \ if (__rc == 0) ; else { \ *(rc) = __rc; \ } \ (gboolean) (__rc == 0); \ })) # define g_ref_count_compare(rc,val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (grefcount)); \ (void) (0 ? *(rc) ^ (val) : 1); \ (gboolean) (*(rc) == -(val)); \ })) # define g_atomic_ref_count_init(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (gatomicrefcount)); \ (void) (0 ? *(rc) ^ *(rc) : 1); \ *(rc) = 1; \ })) # define g_atomic_ref_count_inc(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (gatomicrefcount)); \ (void) (0 ? *(rc) ^ *(rc) : 1); \ (void) (g_atomic_int_get (rc) == G_MAXINT ? 0 : g_atomic_int_inc ((rc))); \ })) # define g_atomic_ref_count_dec(rc) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (gatomicrefcount)); \ (void) (0 ? *(rc) ^ *(rc) : 1); \ g_atomic_int_dec_and_test ((rc)); \ })) # define g_atomic_ref_count_compare(rc,val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(rc) == sizeof (gatomicrefcount)); \ (void) (0 ? *(rc) ^ (val) : 1); \ (gboolean) (g_atomic_int_get (rc) == (val)); \ })) #endif /* __GNUC__ && G_DISABLE_CHECKS */ G_END_DECLS #endif /* __GREFCOUNT_H__ */ glib/gcharset.h 0000644 00000003052 15125173650 0007437 0 ustar 00 /* gcharset.h - Charset functions * * Copyright (C) 2011 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_CHARSET_H__ #define __G_CHARSET_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL gboolean g_get_charset (const char **charset); GLIB_AVAILABLE_IN_ALL gchar * g_get_codeset (void); GLIB_AVAILABLE_IN_2_62 gboolean g_get_console_charset (const char **charset); GLIB_AVAILABLE_IN_ALL const gchar * const * g_get_language_names (void); GLIB_AVAILABLE_IN_2_58 const gchar * const * g_get_language_names_with_category (const gchar *category_name); GLIB_AVAILABLE_IN_ALL gchar ** g_get_locale_variants (const gchar *locale); G_END_DECLS #endif /* __G_CHARSET_H__ */ glib/gtree.h 0000644 00000014470 15125173650 0006753 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_TREE_H__ #define __G_TREE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gnode.h> G_BEGIN_DECLS #undef G_TREE_DEBUG typedef struct _GTree GTree; /** * GTreeNode: * * An opaque type which identifies a specific node in a #GTree. * * Since: 2.68 */ typedef struct _GTreeNode GTreeNode; typedef gboolean (*GTraverseFunc) (gpointer key, gpointer value, gpointer data); /** * GTraverseNodeFunc: * @node: a #GTreeNode * @data: user data passed to g_tree_foreach_node() * * Specifies the type of function passed to g_tree_foreach_node(). It is * passed each node, together with the @user_data parameter passed to * g_tree_foreach_node(). If the function returns %TRUE, the traversal is * stopped. * * Returns: %TRUE to stop the traversal * Since: 2.68 */ typedef gboolean (*GTraverseNodeFunc) (GTreeNode *node, gpointer data); /* Balanced binary trees */ GLIB_AVAILABLE_IN_ALL GTree* g_tree_new (GCompareFunc key_compare_func); GLIB_AVAILABLE_IN_ALL GTree* g_tree_new_with_data (GCompareDataFunc key_compare_func, gpointer key_compare_data); GLIB_AVAILABLE_IN_ALL GTree* g_tree_new_full (GCompareDataFunc key_compare_func, gpointer key_compare_data, GDestroyNotify key_destroy_func, GDestroyNotify value_destroy_func); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_node_first (GTree *tree); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_node_last (GTree *tree); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_node_previous (GTreeNode *node); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_node_next (GTreeNode *node); GLIB_AVAILABLE_IN_ALL GTree* g_tree_ref (GTree *tree); GLIB_AVAILABLE_IN_ALL void g_tree_unref (GTree *tree); GLIB_AVAILABLE_IN_ALL void g_tree_destroy (GTree *tree); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_insert_node (GTree *tree, gpointer key, gpointer value); GLIB_AVAILABLE_IN_ALL void g_tree_insert (GTree *tree, gpointer key, gpointer value); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_replace_node (GTree *tree, gpointer key, gpointer value); GLIB_AVAILABLE_IN_ALL void g_tree_replace (GTree *tree, gpointer key, gpointer value); GLIB_AVAILABLE_IN_ALL gboolean g_tree_remove (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_ALL gboolean g_tree_steal (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_2_68 gpointer g_tree_node_key (GTreeNode *node); GLIB_AVAILABLE_IN_2_68 gpointer g_tree_node_value (GTreeNode *node); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_lookup_node (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_ALL gpointer g_tree_lookup (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_ALL gboolean g_tree_lookup_extended (GTree *tree, gconstpointer lookup_key, gpointer *orig_key, gpointer *value); GLIB_AVAILABLE_IN_ALL void g_tree_foreach (GTree *tree, GTraverseFunc func, gpointer user_data); GLIB_AVAILABLE_IN_2_68 void g_tree_foreach_node (GTree *tree, GTraverseNodeFunc func, gpointer user_data); GLIB_DEPRECATED void g_tree_traverse (GTree *tree, GTraverseFunc traverse_func, GTraverseType traverse_type, gpointer user_data); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_search_node (GTree *tree, GCompareFunc search_func, gconstpointer user_data); GLIB_AVAILABLE_IN_ALL gpointer g_tree_search (GTree *tree, GCompareFunc search_func, gconstpointer user_data); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_lower_bound (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_2_68 GTreeNode *g_tree_upper_bound (GTree *tree, gconstpointer key); GLIB_AVAILABLE_IN_ALL gint g_tree_height (GTree *tree); GLIB_AVAILABLE_IN_ALL gint g_tree_nnodes (GTree *tree); #ifdef G_TREE_DEBUG /*< private >*/ #ifndef __GTK_DOC_IGNORE__ void g_tree_dump (GTree *tree); #endif /* !__GTK_DOC_IGNORE__ */ #endif /* G_TREE_DEBUG */ G_END_DECLS #endif /* __G_TREE_H__ */ glib/gstdio.h 0000644 00000011765 15125173650 0007142 0 ustar 00 /* gstdio.h - GFilename wrappers for C library functions * * Copyright 2004 Tor Lillqvist * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_STDIO_H__ #define __G_STDIO_H__ #include <glib/gprintf.h> #include <sys/stat.h> G_BEGIN_DECLS #if (defined (__MINGW64_VERSION_MAJOR) || defined (_MSC_VER)) && !defined(_WIN64) /* Make it clear that we mean the struct with 32-bit st_size and * 32-bit st_*time fields as that is how the 32-bit GLib DLL normally * has been compiled. If you get a compiler warning when calling * g_stat(), do take it seriously and make sure that the type of * struct stat the code in GLib fills in matches the struct the type * of struct stat you pass to g_stat(). To avoid hassle, to get file * attributes just use the GIO API instead which doesn't use struct * stat. * * Sure, it would be nicer to use a struct with 64-bit st_size and * 64-bit st_*time fields, but changing that now would break ABI. And * in MinGW, a plain "struct stat" is the one with 32-bit st_size and * st_*time fields. */ typedef struct _stat32 GStatBuf; #elif defined(__MINGW64_VERSION_MAJOR) && defined(_WIN64) typedef struct _stat64 GStatBuf; #else typedef struct stat GStatBuf; #endif #if defined(G_OS_UNIX) && !defined(G_STDIO_WRAP_ON_UNIX) /* Just pass on to the system functions, so there's no potential for data * format mismatches, especially with large file interfaces. * A few functions can't be handled in this way, since they are not defined * in a portable system header that we could include here. * * #G_STDIO_WRAP_ON_UNIX is not public API and its behaviour is not guaranteed * in future. */ #ifndef __GTK_DOC_IGNORE__ #define g_chmod chmod #define g_open open #define g_creat creat #define g_rename rename #define g_mkdir mkdir #define g_stat stat #define g_lstat lstat #define g_remove remove #define g_fopen fopen #define g_freopen freopen #define g_fsync fsync #define g_utime utime #endif GLIB_AVAILABLE_IN_ALL int g_access (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chdir (const gchar *path); GLIB_AVAILABLE_IN_ALL int g_unlink (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_rmdir (const gchar *filename); #else /* ! G_OS_UNIX */ /* Wrappers for C library functions that take pathname arguments. On * Unix, the pathname is a file name as it literally is in the file * system. On well-maintained systems with consistent users who know * what they are doing and no exchange of files with others this would * be a well-defined encoding, preferably UTF-8. On Windows, the * pathname is always in UTF-8, even if that is not the on-disk * encoding, and not the encoding accepted by the C library or Win32 * API. */ GLIB_AVAILABLE_IN_ALL int g_access (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chmod (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_open (const gchar *filename, int flags, int mode); GLIB_AVAILABLE_IN_ALL int g_creat (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_rename (const gchar *oldfilename, const gchar *newfilename); GLIB_AVAILABLE_IN_ALL int g_mkdir (const gchar *filename, int mode); GLIB_AVAILABLE_IN_ALL int g_chdir (const gchar *path); GLIB_AVAILABLE_IN_ALL int g_stat (const gchar *filename, GStatBuf *buf); GLIB_AVAILABLE_IN_ALL int g_lstat (const gchar *filename, GStatBuf *buf); GLIB_AVAILABLE_IN_ALL int g_unlink (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_remove (const gchar *filename); GLIB_AVAILABLE_IN_ALL int g_rmdir (const gchar *filename); GLIB_AVAILABLE_IN_ALL FILE *g_fopen (const gchar *filename, const gchar *mode); GLIB_AVAILABLE_IN_ALL FILE *g_freopen (const gchar *filename, const gchar *mode, FILE *stream); GLIB_AVAILABLE_IN_2_64 gint g_fsync (gint fd); struct utimbuf; /* Don't need the real definition of struct utimbuf when just * including this header. */ GLIB_AVAILABLE_IN_ALL int g_utime (const gchar *filename, struct utimbuf *utb); #endif /* G_OS_UNIX */ GLIB_AVAILABLE_IN_2_36 gboolean g_close (gint fd, GError **error); G_END_DECLS #endif /* __G_STDIO_H__ */ glib/gqueue.h 0000644 00000017106 15125173650 0007137 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_QUEUE_H__ #define __G_QUEUE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/glist.h> G_BEGIN_DECLS typedef struct _GQueue GQueue; /** * GQueue: * @head: a pointer to the first element of the queue * @tail: a pointer to the last element of the queue * @length: the number of elements in the queue * * Contains the public fields of a * [Queue][glib-Double-ended-Queues]. */ struct _GQueue { GList *head; GList *tail; guint length; }; /** * G_QUEUE_INIT: * * A statically-allocated #GQueue must be initialized with this * macro before it can be used. This macro can be used to initialize * a variable, but it cannot be assigned to a variable. In that case * you have to use g_queue_init(). * * |[ * GQueue my_queue = G_QUEUE_INIT; * ]| * * Since: 2.14 */ #define G_QUEUE_INIT { NULL, NULL, 0 } /* Queues */ GLIB_AVAILABLE_IN_ALL GQueue* g_queue_new (void); GLIB_AVAILABLE_IN_ALL void g_queue_free (GQueue *queue); GLIB_AVAILABLE_IN_ALL void g_queue_free_full (GQueue *queue, GDestroyNotify free_func); GLIB_AVAILABLE_IN_ALL void g_queue_init (GQueue *queue); GLIB_AVAILABLE_IN_ALL void g_queue_clear (GQueue *queue); GLIB_AVAILABLE_IN_ALL gboolean g_queue_is_empty (GQueue *queue); GLIB_AVAILABLE_IN_2_60 void g_queue_clear_full (GQueue *queue, GDestroyNotify free_func); GLIB_AVAILABLE_IN_ALL guint g_queue_get_length (GQueue *queue); GLIB_AVAILABLE_IN_ALL void g_queue_reverse (GQueue *queue); GLIB_AVAILABLE_IN_ALL GQueue * g_queue_copy (GQueue *queue); GLIB_AVAILABLE_IN_ALL void g_queue_foreach (GQueue *queue, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL GList * g_queue_find (GQueue *queue, gconstpointer data); GLIB_AVAILABLE_IN_ALL GList * g_queue_find_custom (GQueue *queue, gconstpointer data, GCompareFunc func); GLIB_AVAILABLE_IN_ALL void g_queue_sort (GQueue *queue, GCompareDataFunc compare_func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_queue_push_head (GQueue *queue, gpointer data); GLIB_AVAILABLE_IN_ALL void g_queue_push_tail (GQueue *queue, gpointer data); GLIB_AVAILABLE_IN_ALL void g_queue_push_nth (GQueue *queue, gpointer data, gint n); GLIB_AVAILABLE_IN_ALL gpointer g_queue_pop_head (GQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_queue_pop_tail (GQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_queue_pop_nth (GQueue *queue, guint n); GLIB_AVAILABLE_IN_ALL gpointer g_queue_peek_head (GQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_queue_peek_tail (GQueue *queue); GLIB_AVAILABLE_IN_ALL gpointer g_queue_peek_nth (GQueue *queue, guint n); GLIB_AVAILABLE_IN_ALL gint g_queue_index (GQueue *queue, gconstpointer data); GLIB_AVAILABLE_IN_ALL gboolean g_queue_remove (GQueue *queue, gconstpointer data); GLIB_AVAILABLE_IN_ALL guint g_queue_remove_all (GQueue *queue, gconstpointer data); GLIB_AVAILABLE_IN_ALL void g_queue_insert_before (GQueue *queue, GList *sibling, gpointer data); GLIB_AVAILABLE_IN_2_62 void g_queue_insert_before_link (GQueue *queue, GList *sibling, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_insert_after (GQueue *queue, GList *sibling, gpointer data); GLIB_AVAILABLE_IN_2_62 void g_queue_insert_after_link (GQueue *queue, GList *sibling, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_insert_sorted (GQueue *queue, gpointer data, GCompareDataFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_queue_push_head_link (GQueue *queue, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_push_tail_link (GQueue *queue, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_push_nth_link (GQueue *queue, gint n, GList *link_); GLIB_AVAILABLE_IN_ALL GList* g_queue_pop_head_link (GQueue *queue); GLIB_AVAILABLE_IN_ALL GList* g_queue_pop_tail_link (GQueue *queue); GLIB_AVAILABLE_IN_ALL GList* g_queue_pop_nth_link (GQueue *queue, guint n); GLIB_AVAILABLE_IN_ALL GList* g_queue_peek_head_link (GQueue *queue); GLIB_AVAILABLE_IN_ALL GList* g_queue_peek_tail_link (GQueue *queue); GLIB_AVAILABLE_IN_ALL GList* g_queue_peek_nth_link (GQueue *queue, guint n); GLIB_AVAILABLE_IN_ALL gint g_queue_link_index (GQueue *queue, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_unlink (GQueue *queue, GList *link_); GLIB_AVAILABLE_IN_ALL void g_queue_delete_link (GQueue *queue, GList *link_); G_END_DECLS #endif /* __G_QUEUE_H__ */ glib/gbase64.h 0000644 00000004423 15125173650 0007075 0 ustar 00 /* gbase64.h - Base64 coding functions * * Copyright (C) 2005 Alexander Larsson <alexl@redhat.com> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_BASE64_H__ #define __G_BASE64_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL gsize g_base64_encode_step (const guchar *in, gsize len, gboolean break_lines, gchar *out, gint *state, gint *save); GLIB_AVAILABLE_IN_ALL gsize g_base64_encode_close (gboolean break_lines, gchar *out, gint *state, gint *save); GLIB_AVAILABLE_IN_ALL gchar* g_base64_encode (const guchar *data, gsize len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gsize g_base64_decode_step (const gchar *in, gsize len, guchar *out, gint *state, guint *save); GLIB_AVAILABLE_IN_ALL guchar *g_base64_decode (const gchar *text, gsize *out_len) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL guchar *g_base64_decode_inplace (gchar *text, gsize *out_len); G_END_DECLS #endif /* __G_BASE64_H__ */ glib/gslist.h 0000644 00000014627 15125173651 0007157 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_SLIST_H__ #define __G_SLIST_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmem.h> #include <glib/gnode.h> G_BEGIN_DECLS typedef struct _GSList GSList; struct _GSList { gpointer data; GSList *next; }; /* Singly linked lists */ GLIB_AVAILABLE_IN_ALL GSList* g_slist_alloc (void) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL void g_slist_free (GSList *list); GLIB_AVAILABLE_IN_ALL void g_slist_free_1 (GSList *list); #define g_slist_free1 g_slist_free_1 GLIB_AVAILABLE_IN_ALL void g_slist_free_full (GSList *list, GDestroyNotify free_func); GLIB_AVAILABLE_IN_ALL GSList* g_slist_append (GSList *list, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_prepend (GSList *list, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_insert (GSList *list, gpointer data, gint position) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_insert_sorted (GSList *list, gpointer data, GCompareFunc func) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_insert_sorted_with_data (GSList *list, gpointer data, GCompareDataFunc func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_insert_before (GSList *slist, GSList *sibling, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_concat (GSList *list1, GSList *list2) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_remove (GSList *list, gconstpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_remove_all (GSList *list, gconstpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_remove_link (GSList *list, GSList *link_) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_delete_link (GSList *list, GSList *link_) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_reverse (GSList *list) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_copy (GSList *list) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_2_34 GSList* g_slist_copy_deep (GSList *list, GCopyFunc func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_nth (GSList *list, guint n); GLIB_AVAILABLE_IN_ALL GSList* g_slist_find (GSList *list, gconstpointer data); GLIB_AVAILABLE_IN_ALL GSList* g_slist_find_custom (GSList *list, gconstpointer data, GCompareFunc func); GLIB_AVAILABLE_IN_ALL gint g_slist_position (GSList *list, GSList *llink); GLIB_AVAILABLE_IN_ALL gint g_slist_index (GSList *list, gconstpointer data); GLIB_AVAILABLE_IN_ALL GSList* g_slist_last (GSList *list); GLIB_AVAILABLE_IN_ALL guint g_slist_length (GSList *list); GLIB_AVAILABLE_IN_ALL void g_slist_foreach (GSList *list, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSList* g_slist_sort (GSList *list, GCompareFunc compare_func) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GSList* g_slist_sort_with_data (GSList *list, GCompareDataFunc compare_func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gpointer g_slist_nth_data (GSList *list, guint n); GLIB_AVAILABLE_IN_2_64 void g_clear_slist (GSList **slist_ptr, GDestroyNotify destroy); #define g_clear_slist(slist_ptr, destroy) \ G_STMT_START { \ GSList *_slist; \ \ _slist = *(slist_ptr); \ if (_slist) \ { \ *slist_ptr = NULL; \ \ if ((destroy) != NULL) \ g_slist_free_full (_slist, (destroy)); \ else \ g_slist_free (_slist); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_64 #define g_slist_next(slist) ((slist) ? (((GSList *)(slist))->next) : NULL) G_END_DECLS #endif /* __G_SLIST_H__ */ glib/ggettext.h 0000644 00000004570 15125173651 0007501 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_GETTEXT_H__ #define __G_GETTEXT_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL const gchar *g_strip_context (const gchar *msgid, const gchar *msgval) G_GNUC_FORMAT(1); GLIB_AVAILABLE_IN_ALL const gchar *g_dgettext (const gchar *domain, const gchar *msgid) G_GNUC_FORMAT(2); GLIB_AVAILABLE_IN_ALL const gchar *g_dcgettext (const gchar *domain, const gchar *msgid, gint category) G_GNUC_FORMAT(2); GLIB_AVAILABLE_IN_ALL const gchar *g_dngettext (const gchar *domain, const gchar *msgid, const gchar *msgid_plural, gulong n) G_GNUC_FORMAT(3); GLIB_AVAILABLE_IN_ALL const gchar *g_dpgettext (const gchar *domain, const gchar *msgctxtid, gsize msgidoffset) G_GNUC_FORMAT(2); GLIB_AVAILABLE_IN_ALL const gchar *g_dpgettext2 (const gchar *domain, const gchar *context, const gchar *msgid) G_GNUC_FORMAT(3); G_END_DECLS #endif /* __G_GETTEXT_H__ */ glib/gatomic.h 0000644 00000065112 15125173651 0007270 0 ustar 00 /* * Copyright © 2011 Ryan Lortie * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_ATOMIC_H__ #define __G_ATOMIC_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #if defined(glib_typeof_2_68) && GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68 /* for glib_typeof */ #include <type_traits> #endif G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL gint g_atomic_int_get (const volatile gint *atomic); GLIB_AVAILABLE_IN_ALL void g_atomic_int_set (volatile gint *atomic, gint newval); GLIB_AVAILABLE_IN_ALL void g_atomic_int_inc (volatile gint *atomic); GLIB_AVAILABLE_IN_ALL gboolean g_atomic_int_dec_and_test (volatile gint *atomic); GLIB_AVAILABLE_IN_ALL gboolean g_atomic_int_compare_and_exchange (volatile gint *atomic, gint oldval, gint newval); GLIB_AVAILABLE_IN_ALL gint g_atomic_int_add (volatile gint *atomic, gint val); GLIB_AVAILABLE_IN_2_30 guint g_atomic_int_and (volatile guint *atomic, guint val); GLIB_AVAILABLE_IN_2_30 guint g_atomic_int_or (volatile guint *atomic, guint val); GLIB_AVAILABLE_IN_ALL guint g_atomic_int_xor (volatile guint *atomic, guint val); GLIB_AVAILABLE_IN_ALL gpointer g_atomic_pointer_get (const volatile void *atomic); GLIB_AVAILABLE_IN_ALL void g_atomic_pointer_set (volatile void *atomic, gpointer newval); GLIB_AVAILABLE_IN_ALL gboolean g_atomic_pointer_compare_and_exchange (volatile void *atomic, gpointer oldval, gpointer newval); GLIB_AVAILABLE_IN_ALL gssize g_atomic_pointer_add (volatile void *atomic, gssize val); GLIB_AVAILABLE_IN_2_30 gsize g_atomic_pointer_and (volatile void *atomic, gsize val); GLIB_AVAILABLE_IN_2_30 gsize g_atomic_pointer_or (volatile void *atomic, gsize val); GLIB_AVAILABLE_IN_ALL gsize g_atomic_pointer_xor (volatile void *atomic, gsize val); GLIB_DEPRECATED_IN_2_30_FOR(g_atomic_int_add) gint g_atomic_int_exchange_and_add (volatile gint *atomic, gint val); G_END_DECLS #if defined(G_ATOMIC_LOCK_FREE) && defined(__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4) /* We prefer the new C11-style atomic extension of GCC if available */ #if defined(__ATOMIC_SEQ_CST) #define g_atomic_int_get(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ gint gaig_temp; \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ __atomic_load ((gint *)(atomic), &gaig_temp, __ATOMIC_SEQ_CST); \ (gint) gaig_temp; \ })) #define g_atomic_int_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ gint gais_temp = (gint) (newval); \ (void) (0 ? *(atomic) ^ (newval) : 1); \ __atomic_store ((gint *)(atomic), &gais_temp, __ATOMIC_SEQ_CST); \ })) #if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) #define g_atomic_pointer_get(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ glib_typeof (*(atomic)) gapg_temp_newval; \ glib_typeof ((atomic)) gapg_temp_atomic = (atomic); \ __atomic_load (gapg_temp_atomic, &gapg_temp_newval, __ATOMIC_SEQ_CST); \ gapg_temp_newval; \ })) #define g_atomic_pointer_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ glib_typeof ((atomic)) gaps_temp_atomic = (atomic); \ glib_typeof (*(atomic)) gaps_temp_newval = (newval); \ (void) (0 ? (gpointer) * (atomic) : NULL); \ __atomic_store (gaps_temp_atomic, &gaps_temp_newval, __ATOMIC_SEQ_CST); \ })) #else /* if !(defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68)) */ #define g_atomic_pointer_get(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ gpointer gapg_temp_newval; \ gpointer *gapg_temp_atomic = (gpointer *)(atomic); \ __atomic_load (gapg_temp_atomic, &gapg_temp_newval, __ATOMIC_SEQ_CST); \ gapg_temp_newval; \ })) #define g_atomic_pointer_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ gpointer *gaps_temp_atomic = (gpointer *)(atomic); \ gpointer gaps_temp_newval = (gpointer)(newval); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __atomic_store (gaps_temp_atomic, &gaps_temp_newval, __ATOMIC_SEQ_CST); \ })) #endif /* if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) */ #define g_atomic_int_inc(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ (void) __atomic_fetch_add ((atomic), 1, __ATOMIC_SEQ_CST); \ })) #define g_atomic_int_dec_and_test(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ __atomic_fetch_sub ((atomic), 1, __ATOMIC_SEQ_CST) == 1; \ })) #define g_atomic_int_compare_and_exchange(atomic, oldval, newval) \ (G_GNUC_EXTENSION ({ \ gint gaicae_oldval = (oldval); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (newval) ^ (oldval) : 1); \ __atomic_compare_exchange_n ((atomic), &gaicae_oldval, (newval), FALSE, __ATOMIC_SEQ_CST, __ATOMIC_SEQ_CST) ? TRUE : FALSE; \ })) #define g_atomic_int_add(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (gint) __atomic_fetch_add ((atomic), (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_int_and(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __atomic_fetch_and ((atomic), (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_int_or(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __atomic_fetch_or ((atomic), (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_int_xor(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __atomic_fetch_xor ((atomic), (val), __ATOMIC_SEQ_CST); \ })) #if defined(glib_typeof) && defined(__cplusplus) && __cplusplus >= 201103L /* This is typesafe because we check we can assign oldval to the type of * (*atomic). Unfortunately it can only be done in C++ because gcc/clang warn * when atomic is volatile and not oldval, or when atomic is gsize* and oldval * is NULL. Note that clang++ force us to be typesafe because it is an error if the 2nd * argument of __atomic_compare_exchange_n() has a different type than the * first. * https://gitlab.gnome.org/GNOME/glib/-/merge_requests/1919 * https://gitlab.gnome.org/GNOME/glib/-/merge_requests/1715#note_1024120. */ #define g_atomic_pointer_compare_and_exchange(atomic, oldval, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof (oldval) == sizeof (gpointer)); \ glib_typeof (*(atomic)) gapcae_oldval = (oldval); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __atomic_compare_exchange_n ((atomic), &gapcae_oldval, (newval), FALSE, __ATOMIC_SEQ_CST, __ATOMIC_SEQ_CST) ? TRUE : FALSE; \ })) #else /* if !(defined(glib_typeof) && defined(__cplusplus) && __cplusplus >= 201103L) */ #define g_atomic_pointer_compare_and_exchange(atomic, oldval, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof (oldval) == sizeof (gpointer)); \ gpointer gapcae_oldval = (gpointer)(oldval); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __atomic_compare_exchange_n ((atomic), &gapcae_oldval, (newval), FALSE, __ATOMIC_SEQ_CST, __ATOMIC_SEQ_CST) ? TRUE : FALSE; \ })) #endif /* defined(glib_typeof) */ #define g_atomic_pointer_add(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gssize) __atomic_fetch_add ((atomic), (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_pointer_and(atomic, val) \ (G_GNUC_EXTENSION ({ \ gsize *gapa_atomic = (gsize *) (atomic); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gsize)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __atomic_fetch_and (gapa_atomic, (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_pointer_or(atomic, val) \ (G_GNUC_EXTENSION ({ \ gsize *gapo_atomic = (gsize *) (atomic); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gsize)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __atomic_fetch_or (gapo_atomic, (val), __ATOMIC_SEQ_CST); \ })) #define g_atomic_pointer_xor(atomic, val) \ (G_GNUC_EXTENSION ({ \ gsize *gapx_atomic = (gsize *) (atomic); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gsize)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __atomic_fetch_xor (gapx_atomic, (val), __ATOMIC_SEQ_CST); \ })) #else /* defined(__ATOMIC_SEQ_CST) */ /* We want to achieve __ATOMIC_SEQ_CST semantics here. See * https://en.cppreference.com/w/c/atomic/memory_order#Constants. For load * operations, that means performing an *acquire*: * > A load operation with this memory order performs the acquire operation on * > the affected memory location: no reads or writes in the current thread can * > be reordered before this load. All writes in other threads that release * > the same atomic variable are visible in the current thread. * * “no reads or writes in the current thread can be reordered before this load” * is implemented using a compiler barrier (a no-op `__asm__` section) to * prevent instruction reordering. Writes in other threads are synchronised * using `__sync_synchronize()`. It’s unclear from the GCC documentation whether * `__sync_synchronize()` acts as a compiler barrier, hence our explicit use of * one. * * For store operations, `__ATOMIC_SEQ_CST` means performing a *release*: * > A store operation with this memory order performs the release operation: * > no reads or writes in the current thread can be reordered after this store. * > All writes in the current thread are visible in other threads that acquire * > the same atomic variable (see Release-Acquire ordering below) and writes * > that carry a dependency into the atomic variable become visible in other * > threads that consume the same atomic (see Release-Consume ordering below). * * “no reads or writes in the current thread can be reordered after this store” * is implemented using a compiler barrier to prevent instruction reordering. * “All writes in the current thread are visible in other threads” is implemented * using `__sync_synchronize()`; similarly for “writes that carry a dependency”. */ #define g_atomic_int_get(atomic) \ (G_GNUC_EXTENSION ({ \ gint gaig_result; \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ gaig_result = (gint) *(atomic); \ __sync_synchronize (); \ __asm__ __volatile__ ("" : : : "memory"); \ gaig_result; \ })) #define g_atomic_int_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (newval) : 1); \ __sync_synchronize (); \ __asm__ __volatile__ ("" : : : "memory"); \ *(atomic) = (newval); \ })) #define g_atomic_pointer_get(atomic) \ (G_GNUC_EXTENSION ({ \ gpointer gapg_result; \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ gapg_result = (gpointer) *(atomic); \ __sync_synchronize (); \ __asm__ __volatile__ ("" : : : "memory"); \ gapg_result; \ })) #if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) #define g_atomic_pointer_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __sync_synchronize (); \ __asm__ __volatile__ ("" : : : "memory"); \ *(atomic) = (glib_typeof (*(atomic))) (gsize) (newval); \ })) #else /* if !(defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68)) */ #define g_atomic_pointer_set(atomic, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __sync_synchronize (); \ __asm__ __volatile__ ("" : : : "memory"); \ *(atomic) = (gpointer) (gsize) (newval); \ })) #endif /* if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) */ #define g_atomic_int_inc(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ (void) __sync_fetch_and_add ((atomic), 1); \ })) #define g_atomic_int_dec_and_test(atomic) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ *(atomic) : 1); \ __sync_fetch_and_sub ((atomic), 1) == 1; \ })) #define g_atomic_int_compare_and_exchange(atomic, oldval, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (newval) ^ (oldval) : 1); \ __sync_bool_compare_and_swap ((atomic), (oldval), (newval)) ? TRUE : FALSE; \ })) #define g_atomic_int_add(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (gint) __sync_fetch_and_add ((atomic), (val)); \ })) #define g_atomic_int_and(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __sync_fetch_and_and ((atomic), (val)); \ })) #define g_atomic_int_or(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __sync_fetch_and_or ((atomic), (val)); \ })) #define g_atomic_int_xor(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gint)); \ (void) (0 ? *(atomic) ^ (val) : 1); \ (guint) __sync_fetch_and_xor ((atomic), (val)); \ })) #define g_atomic_pointer_compare_and_exchange(atomic, oldval, newval) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ __sync_bool_compare_and_swap ((atomic), (oldval), (newval)) ? TRUE : FALSE; \ })) #define g_atomic_pointer_add(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gssize) __sync_fetch_and_add ((atomic), (val)); \ })) #define g_atomic_pointer_and(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __sync_fetch_and_and ((atomic), (val)); \ })) #define g_atomic_pointer_or(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __sync_fetch_and_or ((atomic), (val)); \ })) #define g_atomic_pointer_xor(atomic, val) \ (G_GNUC_EXTENSION ({ \ G_STATIC_ASSERT (sizeof *(atomic) == sizeof (gpointer)); \ (void) (0 ? (gpointer) *(atomic) : NULL); \ (void) (0 ? (val) ^ (val) : 1); \ (gsize) __sync_fetch_and_xor ((atomic), (val)); \ })) #endif /* !defined(__ATOMIC_SEQ_CST) */ #else /* defined(G_ATOMIC_LOCK_FREE) && defined(__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4) */ #define g_atomic_int_get(atomic) \ (g_atomic_int_get ((gint *) (atomic))) #define g_atomic_int_set(atomic, newval) \ (g_atomic_int_set ((gint *) (atomic), (gint) (newval))) #define g_atomic_int_compare_and_exchange(atomic, oldval, newval) \ (g_atomic_int_compare_and_exchange ((gint *) (atomic), (oldval), (newval))) #define g_atomic_int_add(atomic, val) \ (g_atomic_int_add ((gint *) (atomic), (val))) #define g_atomic_int_and(atomic, val) \ (g_atomic_int_and ((guint *) (atomic), (val))) #define g_atomic_int_or(atomic, val) \ (g_atomic_int_or ((guint *) (atomic), (val))) #define g_atomic_int_xor(atomic, val) \ (g_atomic_int_xor ((guint *) (atomic), (val))) #define g_atomic_int_inc(atomic) \ (g_atomic_int_inc ((gint *) (atomic))) #define g_atomic_int_dec_and_test(atomic) \ (g_atomic_int_dec_and_test ((gint *) (atomic))) #if defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68) /* The (void *) cast in the middle *looks* redundant, because * g_atomic_pointer_get returns void * already, but it's to silence * -Werror=bad-function-cast when we're doing something like: * guintptr a, b; ...; a = g_atomic_pointer_get (&b); * which would otherwise be assigning the void * result of * g_atomic_pointer_get directly to the pointer-sized but * non-pointer-typed result. */ #define g_atomic_pointer_get(atomic) \ (glib_typeof (*(atomic))) (void *) ((g_atomic_pointer_get) ((void *) atomic)) #else /* !(defined(glib_typeof) && (!defined(glib_typeof_2_68) || GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_68)) */ #define g_atomic_pointer_get(atomic) \ (g_atomic_pointer_get (atomic)) #endif #define g_atomic_pointer_set(atomic, newval) \ (g_atomic_pointer_set ((atomic), (gpointer) (newval))) #define g_atomic_pointer_compare_and_exchange(atomic, oldval, newval) \ (g_atomic_pointer_compare_and_exchange ((atomic), (gpointer) (oldval), (gpointer) (newval))) #define g_atomic_pointer_add(atomic, val) \ (g_atomic_pointer_add ((atomic), (gssize) (val))) #define g_atomic_pointer_and(atomic, val) \ (g_atomic_pointer_and ((atomic), (gsize) (val))) #define g_atomic_pointer_or(atomic, val) \ (g_atomic_pointer_or ((atomic), (gsize) (val))) #define g_atomic_pointer_xor(atomic, val) \ (g_atomic_pointer_xor ((atomic), (gsize) (val))) #endif /* defined(G_ATOMIC_LOCK_FREE) && defined(__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4) */ #endif /* __G_ATOMIC_H__ */ glib/gfileutils.h 0000644 00000017272 15125173651 0010020 0 ustar 00 /* gfileutils.h - File utility functions * * Copyright 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_FILEUTILS_H__ #define __G_FILEUTILS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glibconfig.h> #include <glib/gerror.h> G_BEGIN_DECLS #define G_FILE_ERROR g_file_error_quark () typedef enum { G_FILE_ERROR_EXIST, G_FILE_ERROR_ISDIR, G_FILE_ERROR_ACCES, G_FILE_ERROR_NAMETOOLONG, G_FILE_ERROR_NOENT, G_FILE_ERROR_NOTDIR, G_FILE_ERROR_NXIO, G_FILE_ERROR_NODEV, G_FILE_ERROR_ROFS, G_FILE_ERROR_TXTBSY, G_FILE_ERROR_FAULT, G_FILE_ERROR_LOOP, G_FILE_ERROR_NOSPC, G_FILE_ERROR_NOMEM, G_FILE_ERROR_MFILE, G_FILE_ERROR_NFILE, G_FILE_ERROR_BADF, G_FILE_ERROR_INVAL, G_FILE_ERROR_PIPE, G_FILE_ERROR_AGAIN, G_FILE_ERROR_INTR, G_FILE_ERROR_IO, G_FILE_ERROR_PERM, G_FILE_ERROR_NOSYS, G_FILE_ERROR_FAILED } GFileError; /* For backward-compat reasons, these are synced to an old * anonymous enum in libgnome. But don't use that enum * in new code. */ typedef enum { G_FILE_TEST_IS_REGULAR = 1 << 0, G_FILE_TEST_IS_SYMLINK = 1 << 1, G_FILE_TEST_IS_DIR = 1 << 2, G_FILE_TEST_IS_EXECUTABLE = 1 << 3, G_FILE_TEST_EXISTS = 1 << 4 } GFileTest; /** * GFileSetContentsFlags: * @G_FILE_SET_CONTENTS_NONE: No guarantees about file consistency or durability. * The most dangerous setting, which is slightly faster than other settings. * @G_FILE_SET_CONTENTS_CONSISTENT: Guarantee file consistency: after a crash, * either the old version of the file or the new version of the file will be * available, but not a mixture. On Unix systems this equates to an `fsync()` * on the file and use of an atomic `rename()` of the new version of the file * over the old. * @G_FILE_SET_CONTENTS_DURABLE: Guarantee file durability: after a crash, the * new version of the file will be available. On Unix systems this equates to * an `fsync()` on the file (if %G_FILE_SET_CONTENTS_CONSISTENT is unset), or * the effects of %G_FILE_SET_CONTENTS_CONSISTENT plus an `fsync()` on the * directory containing the file after calling `rename()`. * @G_FILE_SET_CONTENTS_ONLY_EXISTING: Only apply consistency and durability * guarantees if the file already exists. This may speed up file operations * if the file doesn’t currently exist, but may result in a corrupted version * of the new file if the system crashes while writing it. * * Flags to pass to g_file_set_contents_full() to affect its safety and * performance. * * Since: 2.66 */ typedef enum { G_FILE_SET_CONTENTS_NONE = 0, G_FILE_SET_CONTENTS_CONSISTENT = 1 << 0, G_FILE_SET_CONTENTS_DURABLE = 1 << 1, G_FILE_SET_CONTENTS_ONLY_EXISTING = 1 << 2 } GFileSetContentsFlags GLIB_AVAILABLE_ENUMERATOR_IN_2_66; GLIB_AVAILABLE_IN_ALL GQuark g_file_error_quark (void); /* So other code can generate a GFileError */ GLIB_AVAILABLE_IN_ALL GFileError g_file_error_from_errno (gint err_no); GLIB_AVAILABLE_IN_ALL gboolean g_file_test (const gchar *filename, GFileTest test); GLIB_AVAILABLE_IN_ALL gboolean g_file_get_contents (const gchar *filename, gchar **contents, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_file_set_contents (const gchar *filename, const gchar *contents, gssize length, GError **error); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_2_66 gboolean g_file_set_contents_full (const gchar *filename, const gchar *contents, gssize length, GFileSetContentsFlags flags, int mode, GError **error); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL gchar *g_file_read_link (const gchar *filename, GError **error); /* Wrapper / workalike for mkdtemp() */ GLIB_AVAILABLE_IN_2_30 gchar *g_mkdtemp (gchar *tmpl); GLIB_AVAILABLE_IN_2_30 gchar *g_mkdtemp_full (gchar *tmpl, gint mode); /* Wrapper / workalike for mkstemp() */ GLIB_AVAILABLE_IN_ALL gint g_mkstemp (gchar *tmpl); GLIB_AVAILABLE_IN_ALL gint g_mkstemp_full (gchar *tmpl, gint flags, gint mode); /* Wrappers for g_mkstemp and g_mkdtemp() */ GLIB_AVAILABLE_IN_ALL gint g_file_open_tmp (const gchar *tmpl, gchar **name_used, GError **error); GLIB_AVAILABLE_IN_2_30 gchar *g_dir_make_tmp (const gchar *tmpl, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_build_path (const gchar *separator, const gchar *first_element, ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL gchar *g_build_pathv (const gchar *separator, gchar **args) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_build_filename (const gchar *first_element, ...) G_GNUC_MALLOC G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_ALL gchar *g_build_filenamev (gchar **args) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_56 gchar *g_build_filename_valist (const gchar *first_element, va_list *args) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gint g_mkdir_with_parents (const gchar *pathname, gint mode); #ifdef G_OS_WIN32 /* On Win32, the canonical directory separator is the backslash, and * the search path separator is the semicolon. Note that also the * (forward) slash works as directory separator. */ #define G_IS_DIR_SEPARATOR(c) ((c) == G_DIR_SEPARATOR || (c) == '/') #else /* !G_OS_WIN32 */ #define G_IS_DIR_SEPARATOR(c) ((c) == G_DIR_SEPARATOR) #endif /* !G_OS_WIN32 */ GLIB_AVAILABLE_IN_ALL gboolean g_path_is_absolute (const gchar *file_name); GLIB_AVAILABLE_IN_ALL const gchar *g_path_skip_root (const gchar *file_name); GLIB_DEPRECATED_FOR(g_path_get_basename) const gchar *g_basename (const gchar *file_name); #define g_dirname g_path_get_dirname GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_path_get_dirname) GLIB_AVAILABLE_IN_ALL gchar *g_get_current_dir (void); GLIB_AVAILABLE_IN_ALL gchar *g_path_get_basename (const gchar *file_name) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_path_get_dirname (const gchar *file_name) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_58 gchar *g_canonicalize_filename (const gchar *filename, const gchar *relative_to) G_GNUC_MALLOC; G_END_DECLS #endif /* __G_FILEUTILS_H__ */ glib/gtrashstack.h 0000644 00000003562 15125173651 0010164 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_TRASH_STACK_H__ #define __G_TRASH_STACK_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gutils.h> G_BEGIN_DECLS G_GNUC_BEGIN_IGNORE_DEPRECATIONS typedef struct _GTrashStack GTrashStack GLIB_DEPRECATED_TYPE_IN_2_48; struct _GTrashStack { GTrashStack *next; } GLIB_DEPRECATED_TYPE_IN_2_48; GLIB_DEPRECATED_IN_2_48 void g_trash_stack_push (GTrashStack **stack_p, gpointer data_p); GLIB_DEPRECATED_IN_2_48 gpointer g_trash_stack_pop (GTrashStack **stack_p); GLIB_DEPRECATED_IN_2_48 gpointer g_trash_stack_peek (GTrashStack **stack_p); GLIB_DEPRECATED_IN_2_48 guint g_trash_stack_height (GTrashStack **stack_p); G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_TRASH_STACK_H_ */ glib/gtimezone.h 0000644 00000007501 15125173651 0007644 0 ustar 00 /* * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_TIME_ZONE_H__ #define __G_TIME_ZONE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GTimeZone GTimeZone; /** * GTimeType: * @G_TIME_TYPE_STANDARD: the time is in local standard time * @G_TIME_TYPE_DAYLIGHT: the time is in local daylight time * @G_TIME_TYPE_UNIVERSAL: the time is in UTC * * Disambiguates a given time in two ways. * * First, specifies if the given time is in universal or local time. * * Second, if the time is in local time, specifies if it is local * standard time or local daylight time. This is important for the case * where the same local time occurs twice (during daylight savings time * transitions, for example). */ typedef enum { G_TIME_TYPE_STANDARD, G_TIME_TYPE_DAYLIGHT, G_TIME_TYPE_UNIVERSAL } GTimeType; GLIB_DEPRECATED_IN_2_68_FOR (g_time_zone_new_identifier) GTimeZone * g_time_zone_new (const gchar *identifier); GLIB_AVAILABLE_IN_2_68 GTimeZone * g_time_zone_new_identifier (const gchar *identifier); GLIB_AVAILABLE_IN_ALL GTimeZone * g_time_zone_new_utc (void); GLIB_AVAILABLE_IN_ALL GTimeZone * g_time_zone_new_local (void); GLIB_AVAILABLE_IN_2_58 GTimeZone * g_time_zone_new_offset (gint32 seconds); GLIB_AVAILABLE_IN_ALL GTimeZone * g_time_zone_ref (GTimeZone *tz); GLIB_AVAILABLE_IN_ALL void g_time_zone_unref (GTimeZone *tz); GLIB_AVAILABLE_IN_ALL gint g_time_zone_find_interval (GTimeZone *tz, GTimeType type, gint64 time_); GLIB_AVAILABLE_IN_ALL gint g_time_zone_adjust_time (GTimeZone *tz, GTimeType type, gint64 *time_); GLIB_AVAILABLE_IN_ALL const gchar * g_time_zone_get_abbreviation (GTimeZone *tz, gint interval); GLIB_AVAILABLE_IN_ALL gint32 g_time_zone_get_offset (GTimeZone *tz, gint interval); GLIB_AVAILABLE_IN_ALL gboolean g_time_zone_is_dst (GTimeZone *tz, gint interval); GLIB_AVAILABLE_IN_2_58 const gchar * g_time_zone_get_identifier (GTimeZone *tz); G_END_DECLS #endif /* __G_TIME_ZONE_H__ */ glib/gkeyfile.h 0000644 00000035101 15125173651 0007437 0 ustar 00 /* gkeyfile.h - desktop entry file parser * * Copyright 2004 Red Hat, Inc. * * Ray Strode <halfline@hawaii.rr.com> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_KEY_FILE_H__ #define __G_KEY_FILE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gbytes.h> #include <glib/gerror.h> G_BEGIN_DECLS typedef enum { G_KEY_FILE_ERROR_UNKNOWN_ENCODING, G_KEY_FILE_ERROR_PARSE, G_KEY_FILE_ERROR_NOT_FOUND, G_KEY_FILE_ERROR_KEY_NOT_FOUND, G_KEY_FILE_ERROR_GROUP_NOT_FOUND, G_KEY_FILE_ERROR_INVALID_VALUE } GKeyFileError; #define G_KEY_FILE_ERROR g_key_file_error_quark() GLIB_AVAILABLE_IN_ALL GQuark g_key_file_error_quark (void); typedef struct _GKeyFile GKeyFile; typedef enum { G_KEY_FILE_NONE = 0, G_KEY_FILE_KEEP_COMMENTS = 1 << 0, G_KEY_FILE_KEEP_TRANSLATIONS = 1 << 1 } GKeyFileFlags; GLIB_AVAILABLE_IN_ALL GKeyFile *g_key_file_new (void); GLIB_AVAILABLE_IN_ALL GKeyFile *g_key_file_ref (GKeyFile *key_file); GLIB_AVAILABLE_IN_ALL void g_key_file_unref (GKeyFile *key_file); GLIB_AVAILABLE_IN_ALL void g_key_file_free (GKeyFile *key_file); GLIB_AVAILABLE_IN_ALL void g_key_file_set_list_separator (GKeyFile *key_file, gchar separator); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_load_from_file (GKeyFile *key_file, const gchar *file, GKeyFileFlags flags, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_load_from_data (GKeyFile *key_file, const gchar *data, gsize length, GKeyFileFlags flags, GError **error); GLIB_AVAILABLE_IN_2_50 gboolean g_key_file_load_from_bytes (GKeyFile *key_file, GBytes *bytes, GKeyFileFlags flags, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_load_from_dirs (GKeyFile *key_file, const gchar *file, const gchar **search_dirs, gchar **full_path, GKeyFileFlags flags, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_load_from_data_dirs (GKeyFile *key_file, const gchar *file, gchar **full_path, GKeyFileFlags flags, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_to_data (GKeyFile *key_file, gsize *length, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_40 gboolean g_key_file_save_to_file (GKeyFile *key_file, const gchar *filename, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_get_start_group (GKeyFile *key_file) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar **g_key_file_get_groups (GKeyFile *key_file, gsize *length); GLIB_AVAILABLE_IN_ALL gchar **g_key_file_get_keys (GKeyFile *key_file, const gchar *group_name, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_has_group (GKeyFile *key_file, const gchar *group_name); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_has_key (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_get_value (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_value (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *value); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_get_string (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_string (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *string); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_get_locale_string (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *locale, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_2_56 gchar *g_key_file_get_locale_for_key (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *locale) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_locale_string (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *locale, const gchar *string); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_get_boolean (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_boolean (GKeyFile *key_file, const gchar *group_name, const gchar *key, gboolean value); GLIB_AVAILABLE_IN_ALL gint g_key_file_get_integer (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_integer (GKeyFile *key_file, const gchar *group_name, const gchar *key, gint value); GLIB_AVAILABLE_IN_ALL gint64 g_key_file_get_int64 (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_int64 (GKeyFile *key_file, const gchar *group_name, const gchar *key, gint64 value); GLIB_AVAILABLE_IN_ALL guint64 g_key_file_get_uint64 (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_uint64 (GKeyFile *key_file, const gchar *group_name, const gchar *key, guint64 value); GLIB_AVAILABLE_IN_ALL gdouble g_key_file_get_double (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_double (GKeyFile *key_file, const gchar *group_name, const gchar *key, gdouble value); GLIB_AVAILABLE_IN_ALL gchar **g_key_file_get_string_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_string_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar * const list[], gsize length); GLIB_AVAILABLE_IN_ALL gchar **g_key_file_get_locale_string_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *locale, gsize *length, GError **error); GLIB_AVAILABLE_IN_ALL void g_key_file_set_locale_string_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *locale, const gchar * const list[], gsize length); GLIB_AVAILABLE_IN_ALL gboolean *g_key_file_get_boolean_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gsize *length, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_boolean_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gboolean list[], gsize length); GLIB_AVAILABLE_IN_ALL gint *g_key_file_get_integer_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gsize *length, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_double_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gdouble list[], gsize length); GLIB_AVAILABLE_IN_ALL gdouble *g_key_file_get_double_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gsize *length, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL void g_key_file_set_integer_list (GKeyFile *key_file, const gchar *group_name, const gchar *key, gint list[], gsize length); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_set_comment (GKeyFile *key_file, const gchar *group_name, const gchar *key, const gchar *comment, GError **error); GLIB_AVAILABLE_IN_ALL gchar *g_key_file_get_comment (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gboolean g_key_file_remove_comment (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_remove_key (GKeyFile *key_file, const gchar *group_name, const gchar *key, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_key_file_remove_group (GKeyFile *key_file, const gchar *group_name, GError **error); /* Defines for handling freedesktop.org Desktop files */ #define G_KEY_FILE_DESKTOP_GROUP "Desktop Entry" #define G_KEY_FILE_DESKTOP_KEY_TYPE "Type" #define G_KEY_FILE_DESKTOP_KEY_VERSION "Version" #define G_KEY_FILE_DESKTOP_KEY_NAME "Name" #define G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME "GenericName" #define G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY "NoDisplay" #define G_KEY_FILE_DESKTOP_KEY_COMMENT "Comment" #define G_KEY_FILE_DESKTOP_KEY_ICON "Icon" #define G_KEY_FILE_DESKTOP_KEY_HIDDEN "Hidden" #define G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN "OnlyShowIn" #define G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN "NotShowIn" #define G_KEY_FILE_DESKTOP_KEY_TRY_EXEC "TryExec" #define G_KEY_FILE_DESKTOP_KEY_EXEC "Exec" #define G_KEY_FILE_DESKTOP_KEY_PATH "Path" #define G_KEY_FILE_DESKTOP_KEY_TERMINAL "Terminal" #define G_KEY_FILE_DESKTOP_KEY_MIME_TYPE "MimeType" #define G_KEY_FILE_DESKTOP_KEY_CATEGORIES "Categories" #define G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY "StartupNotify" #define G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS "StartupWMClass" #define G_KEY_FILE_DESKTOP_KEY_URL "URL" #define G_KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE "DBusActivatable" #define G_KEY_FILE_DESKTOP_KEY_ACTIONS "Actions" #define G_KEY_FILE_DESKTOP_TYPE_APPLICATION "Application" #define G_KEY_FILE_DESKTOP_TYPE_LINK "Link" #define G_KEY_FILE_DESKTOP_TYPE_DIRECTORY "Directory" G_END_DECLS #endif /* __G_KEY_FILE_H__ */ glib/deprecated/gcache.h 0000644 00000005653 15125173651 0011163 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_CACHE_H__ #define __G_CACHE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/glist.h> G_BEGIN_DECLS typedef struct _GCache GCache GLIB_DEPRECATED_TYPE_IN_2_26_FOR(GHashTable); typedef gpointer (*GCacheNewFunc) (gpointer key) GLIB_DEPRECATED_TYPE_IN_2_26; typedef gpointer (*GCacheDupFunc) (gpointer value) GLIB_DEPRECATED_TYPE_IN_2_26; typedef void (*GCacheDestroyFunc) (gpointer value) GLIB_DEPRECATED_TYPE_IN_2_26; G_GNUC_BEGIN_IGNORE_DEPRECATIONS /* Caches */ GLIB_DEPRECATED GCache* g_cache_new (GCacheNewFunc value_new_func, GCacheDestroyFunc value_destroy_func, GCacheDupFunc key_dup_func, GCacheDestroyFunc key_destroy_func, GHashFunc hash_key_func, GHashFunc hash_value_func, GEqualFunc key_equal_func); GLIB_DEPRECATED void g_cache_destroy (GCache *cache); GLIB_DEPRECATED gpointer g_cache_insert (GCache *cache, gpointer key); GLIB_DEPRECATED void g_cache_remove (GCache *cache, gconstpointer value); GLIB_DEPRECATED void g_cache_key_foreach (GCache *cache, GHFunc func, gpointer user_data); GLIB_DEPRECATED void g_cache_value_foreach (GCache *cache, GHFunc func, gpointer user_data); G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_CACHE_H__ */ glib/deprecated/gthread.h 0000644 00000025272 15125173651 0011366 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_DEPRECATED_THREAD_H__ #define __G_DEPRECATED_THREAD_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gthread.h> G_BEGIN_DECLS G_GNUC_BEGIN_IGNORE_DEPRECATIONS typedef enum { G_THREAD_PRIORITY_LOW, G_THREAD_PRIORITY_NORMAL, G_THREAD_PRIORITY_HIGH, G_THREAD_PRIORITY_URGENT } GThreadPriority GLIB_DEPRECATED_TYPE_IN_2_32; struct _GThread { /*< private >*/ GThreadFunc func; gpointer data; gboolean joinable; GThreadPriority priority; }; typedef struct _GThreadFunctions GThreadFunctions GLIB_DEPRECATED_TYPE_IN_2_32; struct _GThreadFunctions { GMutex* (*mutex_new) (void); void (*mutex_lock) (GMutex *mutex); gboolean (*mutex_trylock) (GMutex *mutex); void (*mutex_unlock) (GMutex *mutex); void (*mutex_free) (GMutex *mutex); GCond* (*cond_new) (void); void (*cond_signal) (GCond *cond); void (*cond_broadcast) (GCond *cond); void (*cond_wait) (GCond *cond, GMutex *mutex); gboolean (*cond_timed_wait) (GCond *cond, GMutex *mutex, GTimeVal *end_time); void (*cond_free) (GCond *cond); GPrivate* (*private_new) (GDestroyNotify destructor); gpointer (*private_get) (GPrivate *private_key); void (*private_set) (GPrivate *private_key, gpointer data); void (*thread_create) (GThreadFunc func, gpointer data, gulong stack_size, gboolean joinable, gboolean bound, GThreadPriority priority, gpointer thread, GError **error); void (*thread_yield) (void); void (*thread_join) (gpointer thread); void (*thread_exit) (void); void (*thread_set_priority)(gpointer thread, GThreadPriority priority); void (*thread_self) (gpointer thread); gboolean (*thread_equal) (gpointer thread1, gpointer thread2); } GLIB_DEPRECATED_TYPE_IN_2_32; GLIB_VAR GThreadFunctions g_thread_functions_for_glib_use; GLIB_VAR gboolean g_thread_use_default_impl; GLIB_VAR guint64 (*g_thread_gettime) (void); GLIB_DEPRECATED_IN_2_32_FOR(g_thread_new) GThread *g_thread_create (GThreadFunc func, gpointer data, gboolean joinable, GError **error); GLIB_DEPRECATED_IN_2_32_FOR(g_thread_new) GThread *g_thread_create_full (GThreadFunc func, gpointer data, gulong stack_size, gboolean joinable, gboolean bound, GThreadPriority priority, GError **error); GLIB_DEPRECATED_IN_2_32 void g_thread_set_priority (GThread *thread, GThreadPriority priority); GLIB_DEPRECATED_IN_2_32 void g_thread_foreach (GFunc thread_func, gpointer user_data); #ifndef G_OS_WIN32 #include <sys/types.h> #include <pthread.h> #endif #define g_static_mutex_get_mutex g_static_mutex_get_mutex_impl GLIB_DEPRECATED_MACRO_IN_2_32 #define G_STATIC_MUTEX_INIT { NULL } GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_mutex_init) typedef struct { GMutex *mutex; #ifndef G_OS_WIN32 /* only for ABI compatibility reasons */ pthread_mutex_t unused; #endif } GStaticMutex GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GMutex); #define g_static_mutex_lock(mutex) \ g_mutex_lock (g_static_mutex_get_mutex (mutex)) GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_mutex_lock) #define g_static_mutex_trylock(mutex) \ g_mutex_trylock (g_static_mutex_get_mutex (mutex)) GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_mutex_trylock) #define g_static_mutex_unlock(mutex) \ g_mutex_unlock (g_static_mutex_get_mutex (mutex)) GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_mutex_unlock) GLIB_DEPRECATED_IN_2_32_FOR(g_mutex_init) void g_static_mutex_init (GStaticMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(g_mutex_clear) void g_static_mutex_free (GStaticMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(GMutex) GMutex *g_static_mutex_get_mutex_impl (GStaticMutex *mutex); typedef struct _GStaticRecMutex GStaticRecMutex GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GRecMutex); struct _GStaticRecMutex { /*< private >*/ GStaticMutex mutex; guint depth; /* ABI compat only */ union { #ifdef G_OS_WIN32 void *owner; #else pthread_t owner; #endif gdouble dummy; } unused; } GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GRecMutex); #define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT, 0, { 0 } } GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_rec_mutex_init) GLIB_DEPRECATED_IN_2_32_FOR(g_rec_mutex_init) void g_static_rec_mutex_init (GStaticRecMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(g_rec_mutex_lock) void g_static_rec_mutex_lock (GStaticRecMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(g_rec_mutex_try_lock) gboolean g_static_rec_mutex_trylock (GStaticRecMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(g_rec_mutex_unlock) void g_static_rec_mutex_unlock (GStaticRecMutex *mutex); GLIB_DEPRECATED_IN_2_32 void g_static_rec_mutex_lock_full (GStaticRecMutex *mutex, guint depth); GLIB_DEPRECATED_IN_2_32 guint g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex); GLIB_DEPRECATED_IN_2_32_FOR(g_rec_mutex_free) void g_static_rec_mutex_free (GStaticRecMutex *mutex); typedef struct _GStaticRWLock GStaticRWLock GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GRWLock); struct _GStaticRWLock { /*< private >*/ GStaticMutex mutex; GCond *read_cond; GCond *write_cond; guint read_counter; gboolean have_writer; guint want_to_read; guint want_to_write; } GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GRWLock); #define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, 0, 0 } GLIB_DEPRECATED_MACRO_IN_2_32_FOR(g_rw_lock_init) GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_init) void g_static_rw_lock_init (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_reader_lock) void g_static_rw_lock_reader_lock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_reader_trylock) gboolean g_static_rw_lock_reader_trylock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_reader_unlock) void g_static_rw_lock_reader_unlock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_writer_lock) void g_static_rw_lock_writer_lock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_writer_trylock) gboolean g_static_rw_lock_writer_trylock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_writer_unlock) void g_static_rw_lock_writer_unlock (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32_FOR(g_rw_lock_free) void g_static_rw_lock_free (GStaticRWLock *lock); GLIB_DEPRECATED_IN_2_32 GPrivate * g_private_new (GDestroyNotify notify); typedef struct _GStaticPrivate GStaticPrivate GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GPrivate); struct _GStaticPrivate { /*< private >*/ guint index; } GLIB_DEPRECATED_TYPE_IN_2_32_FOR(GPrivate); #define G_STATIC_PRIVATE_INIT { 0 } GLIB_DEPRECATED_MACRO_IN_2_32_FOR(G_PRIVATE_INIT) GLIB_DEPRECATED_IN_2_32 void g_static_private_init (GStaticPrivate *private_key); GLIB_DEPRECATED_IN_2_32_FOR(g_private_get) gpointer g_static_private_get (GStaticPrivate *private_key); GLIB_DEPRECATED_IN_2_32_FOR(g_private_set) void g_static_private_set (GStaticPrivate *private_key, gpointer data, GDestroyNotify notify); GLIB_DEPRECATED_IN_2_32 void g_static_private_free (GStaticPrivate *private_key); GLIB_DEPRECATED_IN_2_32 gboolean g_once_init_enter_impl (volatile gsize *location); GLIB_DEPRECATED_IN_2_32 void g_thread_init (gpointer vtable); GLIB_DEPRECATED_IN_2_32 void g_thread_init_with_errorcheck_mutexes (gpointer vtable); GLIB_DEPRECATED_IN_2_32 gboolean g_thread_get_initialized (void); GLIB_VAR gboolean g_threads_got_initialized; #define g_thread_supported() (1) GLIB_DEPRECATED_MACRO_IN_2_32 GLIB_DEPRECATED_IN_2_32 GMutex * g_mutex_new (void); GLIB_DEPRECATED_IN_2_32 void g_mutex_free (GMutex *mutex); GLIB_DEPRECATED_IN_2_32 GCond * g_cond_new (void); GLIB_DEPRECATED_IN_2_32 void g_cond_free (GCond *cond); GLIB_DEPRECATED_IN_2_32 gboolean g_cond_timed_wait (GCond *cond, GMutex *mutex, GTimeVal *timeval); G_GNUC_END_IGNORE_DEPRECATIONS G_END_DECLS #endif /* __G_DEPRECATED_THREAD_H__ */ glib/deprecated/gcompletion.h 0000644 00000005552 15125173651 0012267 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_COMPLETION_H__ #define __G_COMPLETION_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/glist.h> G_BEGIN_DECLS typedef struct _GCompletion GCompletion; typedef gchar* (*GCompletionFunc) (gpointer); /* GCompletion */ typedef gint (*GCompletionStrncmpFunc) (const gchar *s1, const gchar *s2, gsize n); struct _GCompletion { GList* items; GCompletionFunc func; gchar* prefix; GList* cache; GCompletionStrncmpFunc strncmp_func; }; GLIB_DEPRECATED_IN_2_26 GCompletion* g_completion_new (GCompletionFunc func); GLIB_DEPRECATED_IN_2_26 void g_completion_add_items (GCompletion* cmp, GList* items); GLIB_DEPRECATED_IN_2_26 void g_completion_remove_items (GCompletion* cmp, GList* items); GLIB_DEPRECATED_IN_2_26 void g_completion_clear_items (GCompletion* cmp); GLIB_DEPRECATED_IN_2_26 GList* g_completion_complete (GCompletion* cmp, const gchar* prefix, gchar** new_prefix); GLIB_DEPRECATED_IN_2_26 GList* g_completion_complete_utf8 (GCompletion *cmp, const gchar* prefix, gchar** new_prefix); GLIB_DEPRECATED_IN_2_26 void g_completion_set_compare (GCompletion *cmp, GCompletionStrncmpFunc strncmp_func); GLIB_DEPRECATED_IN_2_26 void g_completion_free (GCompletion* cmp); G_END_DECLS #endif /* __G_COMPLETION_H__ */ glib/deprecated/gmain.h 0000644 00000010451 15125173651 0011034 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_DEPRECATED_MAIN_H__ #define __G_DEPRECATED_MAIN_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmain.h> G_BEGIN_DECLS /* ============== Compat main loop stuff ================== */ /** * g_main_new: * @is_running: set to %TRUE to indicate that the loop is running. This * is not very important since calling g_main_run() will set this * to %TRUE anyway. * * Creates a new #GMainLoop for th default main context. * * Returns: a new #GMainLoop * * Deprecated: 2.2: Use g_main_loop_new() instead */ #define g_main_new(is_running) g_main_loop_new (NULL, is_running) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_new) /** * g_main_run: * @loop: a #GMainLoop * * Runs a main loop until it stops running. * * Deprecated: 2.2: Use g_main_loop_run() instead */ #define g_main_run(loop) g_main_loop_run(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_run) /** * g_main_quit: * @loop: a #GMainLoop * * Stops the #GMainLoop. * If g_main_run() was called to run the #GMainLoop, it will now return. * * Deprecated: 2.2: Use g_main_loop_quit() instead */ #define g_main_quit(loop) g_main_loop_quit(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_quit) /** * g_main_destroy: * @loop: a #GMainLoop * * Frees the memory allocated for the #GMainLoop. * * Deprecated: 2.2: Use g_main_loop_unref() instead */ #define g_main_destroy(loop) g_main_loop_unref(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_unref) /** * g_main_is_running: * @loop: a #GMainLoop * * Checks if the main loop is running. * * Returns: %TRUE if the main loop is running * * Deprecated: 2.2: Use g_main_loop_is_running() instead */ #define g_main_is_running(loop) g_main_loop_is_running(loop) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_loop_is_running) /** * g_main_iteration: * @may_block: set to %TRUE if it should block (i.e. wait) until an event * source becomes ready. It will return after an event source has been * processed. If set to %FALSE it will return immediately if no event * source is ready to be processed. * * Runs a single iteration for the default #GMainContext. * * Returns: %TRUE if more events are pending. * * Deprecated: 2.2: Use g_main_context_iteration() instead. */ #define g_main_iteration(may_block) g_main_context_iteration (NULL, may_block) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_iteration) /** * g_main_pending: * * Checks if any events are pending for the default #GMainContext * (i.e. ready to be processed). * * Returns: %TRUE if any events are pending. * * Deprecated: 2.2: Use g_main_context_pending() instead. */ #define g_main_pending() g_main_context_pending (NULL) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_pending) /** * g_main_set_poll_func: * @func: the function to call to poll all file descriptors * * Sets the function to use for the handle polling of file descriptors * for the default main context. * * Deprecated: 2.2: Use g_main_context_set_poll_func() again */ #define g_main_set_poll_func(func) g_main_context_set_poll_func (NULL, func) GLIB_DEPRECATED_MACRO_IN_2_26_FOR(g_main_context_set_poll_func) G_END_DECLS #endif /* __G_DEPRECATED_MAIN_H__ */ glib/deprecated/gallocator.h 0000644 00000006270 15125173651 0012074 0 ustar 00 /* * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_ALLOCATOR_H__ #define __G_ALLOCATOR_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GAllocator GAllocator; typedef struct _GMemChunk GMemChunk; #define G_ALLOC_ONLY 1 #define G_ALLOC_AND_FREE 2 #define G_ALLOCATOR_LIST 1 #define G_ALLOCATOR_SLIST 2 #define G_ALLOCATOR_NODE 3 #define g_chunk_new(type, chunk) ((type *) g_mem_chunk_alloc (chunk)) #define g_chunk_new0(type, chunk) ((type *) g_mem_chunk_alloc0 (chunk)) #define g_chunk_free(mem, mem_chunk) (g_mem_chunk_free (mem_chunk, mem)) #define g_mem_chunk_create(type, x, y) (g_mem_chunk_new (NULL, sizeof (type), 0, 0)) GLIB_DEPRECATED GMemChunk * g_mem_chunk_new (const gchar *name, gint atom_size, gsize area_size, gint type); GLIB_DEPRECATED void g_mem_chunk_destroy (GMemChunk *mem_chunk); GLIB_DEPRECATED gpointer g_mem_chunk_alloc (GMemChunk *mem_chunk); GLIB_DEPRECATED gpointer g_mem_chunk_alloc0 (GMemChunk *mem_chunk); GLIB_DEPRECATED void g_mem_chunk_free (GMemChunk *mem_chunk, gpointer mem); GLIB_DEPRECATED void g_mem_chunk_clean (GMemChunk *mem_chunk); GLIB_DEPRECATED void g_mem_chunk_reset (GMemChunk *mem_chunk); GLIB_DEPRECATED void g_mem_chunk_print (GMemChunk *mem_chunk); GLIB_DEPRECATED void g_mem_chunk_info (void); GLIB_DEPRECATED void g_blow_chunks (void); GLIB_DEPRECATED GAllocator * g_allocator_new (const gchar *name, guint n_preallocs); GLIB_DEPRECATED void g_allocator_free (GAllocator *allocator); GLIB_DEPRECATED void g_list_push_allocator (GAllocator *allocator); GLIB_DEPRECATED void g_list_pop_allocator (void); GLIB_DEPRECATED void g_slist_push_allocator (GAllocator *allocator); GLIB_DEPRECATED void g_slist_pop_allocator (void); GLIB_DEPRECATED void g_node_push_allocator (GAllocator *allocator); GLIB_DEPRECATED void g_node_pop_allocator (void); G_END_DECLS #endif /* __G_ALLOCATOR_H__ */ glib/deprecated/grel.h 0000644 00000007142 15125173651 0010675 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_REL_H__ #define __G_REL_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS typedef struct _GRelation GRelation; typedef struct _GTuples GTuples; struct _GTuples { guint len; }; /* GRelation * * Indexed Relations. Imagine a really simple table in a * database. Relations are not ordered. This data type is meant for * maintaining a N-way mapping. * * g_relation_new() creates a relation with FIELDS fields * * g_relation_destroy() frees all resources * g_tuples_destroy() frees the result of g_relation_select() * * g_relation_index() indexes relation FIELD with the provided * equality and hash functions. this must be done before any * calls to insert are made. * * g_relation_insert() inserts a new tuple. you are expected to * provide the right number of fields. * * g_relation_delete() deletes all relations with KEY in FIELD * g_relation_select() returns ... * g_relation_count() counts ... */ GLIB_DEPRECATED_IN_2_26 GRelation* g_relation_new (gint fields); GLIB_DEPRECATED_IN_2_26 void g_relation_destroy (GRelation *relation); GLIB_DEPRECATED_IN_2_26 void g_relation_index (GRelation *relation, gint field, GHashFunc hash_func, GEqualFunc key_equal_func); GLIB_DEPRECATED_IN_2_26 void g_relation_insert (GRelation *relation, ...); GLIB_DEPRECATED_IN_2_26 gint g_relation_delete (GRelation *relation, gconstpointer key, gint field); GLIB_DEPRECATED_IN_2_26 GTuples* g_relation_select (GRelation *relation, gconstpointer key, gint field); GLIB_DEPRECATED_IN_2_26 gint g_relation_count (GRelation *relation, gconstpointer key, gint field); GLIB_DEPRECATED_IN_2_26 gboolean g_relation_exists (GRelation *relation, ...); GLIB_DEPRECATED_IN_2_26 void g_relation_print (GRelation *relation); GLIB_DEPRECATED_IN_2_26 void g_tuples_destroy (GTuples *tuples); GLIB_DEPRECATED_IN_2_26 gpointer g_tuples_index (GTuples *tuples, gint index_, gint field); G_END_DECLS #endif /* __G_REL_H__ */ glib/glist.h 0000644 00000015422 15125173651 0006766 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_LIST_H__ #define __G_LIST_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmem.h> #include <glib/gnode.h> G_BEGIN_DECLS typedef struct _GList GList; struct _GList { gpointer data; GList *next; GList *prev; }; /* Doubly linked lists */ GLIB_AVAILABLE_IN_ALL GList* g_list_alloc (void) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL void g_list_free (GList *list); GLIB_AVAILABLE_IN_ALL void g_list_free_1 (GList *list); #define g_list_free1 g_list_free_1 GLIB_AVAILABLE_IN_ALL void g_list_free_full (GList *list, GDestroyNotify free_func); GLIB_AVAILABLE_IN_ALL GList* g_list_append (GList *list, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_prepend (GList *list, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_insert (GList *list, gpointer data, gint position) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_insert_sorted (GList *list, gpointer data, GCompareFunc func) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_insert_sorted_with_data (GList *list, gpointer data, GCompareDataFunc func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_insert_before (GList *list, GList *sibling, gpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_2_62 GList* g_list_insert_before_link (GList *list, GList *sibling, GList *link_) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_concat (GList *list1, GList *list2) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_remove (GList *list, gconstpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_remove_all (GList *list, gconstpointer data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_remove_link (GList *list, GList *llink) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_delete_link (GList *list, GList *link_) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_reverse (GList *list) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_copy (GList *list) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_2_34 GList* g_list_copy_deep (GList *list, GCopyFunc func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_nth (GList *list, guint n); GLIB_AVAILABLE_IN_ALL GList* g_list_nth_prev (GList *list, guint n); GLIB_AVAILABLE_IN_ALL GList* g_list_find (GList *list, gconstpointer data); GLIB_AVAILABLE_IN_ALL GList* g_list_find_custom (GList *list, gconstpointer data, GCompareFunc func); GLIB_AVAILABLE_IN_ALL gint g_list_position (GList *list, GList *llink); GLIB_AVAILABLE_IN_ALL gint g_list_index (GList *list, gconstpointer data); GLIB_AVAILABLE_IN_ALL GList* g_list_last (GList *list); GLIB_AVAILABLE_IN_ALL GList* g_list_first (GList *list); GLIB_AVAILABLE_IN_ALL guint g_list_length (GList *list); GLIB_AVAILABLE_IN_ALL void g_list_foreach (GList *list, GFunc func, gpointer user_data); GLIB_AVAILABLE_IN_ALL GList* g_list_sort (GList *list, GCompareFunc compare_func) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL GList* g_list_sort_with_data (GList *list, GCompareDataFunc compare_func, gpointer user_data) G_GNUC_WARN_UNUSED_RESULT; GLIB_AVAILABLE_IN_ALL gpointer g_list_nth_data (GList *list, guint n); GLIB_AVAILABLE_IN_2_64 void g_clear_list (GList **list_ptr, GDestroyNotify destroy); #define g_clear_list(list_ptr, destroy) \ G_STMT_START { \ GList *_list; \ \ _list = *(list_ptr); \ if (_list) \ { \ *list_ptr = NULL; \ \ if ((destroy) != NULL) \ g_list_free_full (_list, (destroy)); \ else \ g_list_free (_list); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_64 #define g_list_previous(list) ((list) ? (((GList *)(list))->prev) : NULL) #define g_list_next(list) ((list) ? (((GList *)(list))->next) : NULL) G_END_DECLS #endif /* __G_LIST_H__ */ glib/gnode.h 0000644 00000020774 15125173651 0006746 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_NODE_H__ #define __G_NODE_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmem.h> G_BEGIN_DECLS typedef struct _GNode GNode; /* Tree traverse flags */ typedef enum { G_TRAVERSE_LEAVES = 1 << 0, G_TRAVERSE_NON_LEAVES = 1 << 1, G_TRAVERSE_ALL = G_TRAVERSE_LEAVES | G_TRAVERSE_NON_LEAVES, G_TRAVERSE_MASK = 0x03, G_TRAVERSE_LEAFS = G_TRAVERSE_LEAVES, G_TRAVERSE_NON_LEAFS = G_TRAVERSE_NON_LEAVES } GTraverseFlags; /* Tree traverse orders */ typedef enum { G_IN_ORDER, G_PRE_ORDER, G_POST_ORDER, G_LEVEL_ORDER } GTraverseType; typedef gboolean (*GNodeTraverseFunc) (GNode *node, gpointer data); typedef void (*GNodeForeachFunc) (GNode *node, gpointer data); /* N-way tree implementation */ struct _GNode { gpointer data; GNode *next; GNode *prev; GNode *parent; GNode *children; }; /** * G_NODE_IS_ROOT: * @node: a #GNode * * Returns %TRUE if a #GNode is the root of a tree. * * Returns: %TRUE if the #GNode is the root of a tree * (i.e. it has no parent or siblings) */ #define G_NODE_IS_ROOT(node) (((GNode*) (node))->parent == NULL && \ ((GNode*) (node))->prev == NULL && \ ((GNode*) (node))->next == NULL) /** * G_NODE_IS_LEAF: * @node: a #GNode * * Returns %TRUE if a #GNode is a leaf node. * * Returns: %TRUE if the #GNode is a leaf node * (i.e. it has no children) */ #define G_NODE_IS_LEAF(node) (((GNode*) (node))->children == NULL) GLIB_AVAILABLE_IN_ALL GNode* g_node_new (gpointer data); GLIB_AVAILABLE_IN_ALL void g_node_destroy (GNode *root); GLIB_AVAILABLE_IN_ALL void g_node_unlink (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_copy_deep (GNode *node, GCopyFunc copy_func, gpointer data); GLIB_AVAILABLE_IN_ALL GNode* g_node_copy (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_insert (GNode *parent, gint position, GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_insert_before (GNode *parent, GNode *sibling, GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_insert_after (GNode *parent, GNode *sibling, GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_prepend (GNode *parent, GNode *node); GLIB_AVAILABLE_IN_ALL guint g_node_n_nodes (GNode *root, GTraverseFlags flags); GLIB_AVAILABLE_IN_ALL GNode* g_node_get_root (GNode *node); GLIB_AVAILABLE_IN_ALL gboolean g_node_is_ancestor (GNode *node, GNode *descendant); GLIB_AVAILABLE_IN_ALL guint g_node_depth (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_find (GNode *root, GTraverseType order, GTraverseFlags flags, gpointer data); /* convenience macros */ /** * g_node_append: * @parent: the #GNode to place the new #GNode under * @node: the #GNode to insert * * Inserts a #GNode as the last child of the given parent. * * Returns: the inserted #GNode */ #define g_node_append(parent, node) \ g_node_insert_before ((parent), NULL, (node)) /** * g_node_insert_data: * @parent: the #GNode to place the new #GNode under * @position: the position to place the new #GNode at. If position is -1, * the new #GNode is inserted as the last child of @parent * @data: the data for the new #GNode * * Inserts a new #GNode at the given position. * * Returns: the new #GNode */ #define g_node_insert_data(parent, position, data) \ g_node_insert ((parent), (position), g_node_new (data)) /** * g_node_insert_data_after: * @parent: the #GNode to place the new #GNode under * @sibling: the sibling #GNode to place the new #GNode after * @data: the data for the new #GNode * * Inserts a new #GNode after the given sibling. * * Returns: the new #GNode */ #define g_node_insert_data_after(parent, sibling, data) \ g_node_insert_after ((parent), (sibling), g_node_new (data)) /** * g_node_insert_data_before: * @parent: the #GNode to place the new #GNode under * @sibling: the sibling #GNode to place the new #GNode before * @data: the data for the new #GNode * * Inserts a new #GNode before the given sibling. * * Returns: the new #GNode */ #define g_node_insert_data_before(parent, sibling, data) \ g_node_insert_before ((parent), (sibling), g_node_new (data)) /** * g_node_prepend_data: * @parent: the #GNode to place the new #GNode under * @data: the data for the new #GNode * * Inserts a new #GNode as the first child of the given parent. * * Returns: the new #GNode */ #define g_node_prepend_data(parent, data) \ g_node_prepend ((parent), g_node_new (data)) /** * g_node_append_data: * @parent: the #GNode to place the new #GNode under * @data: the data for the new #GNode * * Inserts a new #GNode as the last child of the given parent. * * Returns: the new #GNode */ #define g_node_append_data(parent, data) \ g_node_insert_before ((parent), NULL, g_node_new (data)) /* traversal function, assumes that 'node' is root * (only traverses 'node' and its subtree). * this function is just a high level interface to * low level traversal functions, optimized for speed. */ GLIB_AVAILABLE_IN_ALL void g_node_traverse (GNode *root, GTraverseType order, GTraverseFlags flags, gint max_depth, GNodeTraverseFunc func, gpointer data); /* return the maximum tree height starting with 'node', this is an expensive * operation, since we need to visit all nodes. this could be shortened by * adding 'guint height' to struct _GNode, but then again, this is not very * often needed, and would make g_node_insert() more time consuming. */ GLIB_AVAILABLE_IN_ALL guint g_node_max_height (GNode *root); GLIB_AVAILABLE_IN_ALL void g_node_children_foreach (GNode *node, GTraverseFlags flags, GNodeForeachFunc func, gpointer data); GLIB_AVAILABLE_IN_ALL void g_node_reverse_children (GNode *node); GLIB_AVAILABLE_IN_ALL guint g_node_n_children (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_nth_child (GNode *node, guint n); GLIB_AVAILABLE_IN_ALL GNode* g_node_last_child (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_find_child (GNode *node, GTraverseFlags flags, gpointer data); GLIB_AVAILABLE_IN_ALL gint g_node_child_position (GNode *node, GNode *child); GLIB_AVAILABLE_IN_ALL gint g_node_child_index (GNode *node, gpointer data); GLIB_AVAILABLE_IN_ALL GNode* g_node_first_sibling (GNode *node); GLIB_AVAILABLE_IN_ALL GNode* g_node_last_sibling (GNode *node); /** * g_node_prev_sibling: * @node: a #GNode * * Gets the previous sibling of a #GNode. * * Returns: the previous sibling of @node, or %NULL if @node is the first * node or %NULL */ #define g_node_prev_sibling(node) ((node) ? \ ((GNode*) (node))->prev : NULL) /** * g_node_next_sibling: * @node: a #GNode * * Gets the next sibling of a #GNode. * * Returns: the next sibling of @node, or %NULL if @node is the last node * or %NULL */ #define g_node_next_sibling(node) ((node) ? \ ((GNode*) (node))->next : NULL) /** * g_node_first_child: * @node: a #GNode * * Gets the first child of a #GNode. * * Returns: the first child of @node, or %NULL if @node is %NULL * or has no children */ #define g_node_first_child(node) ((node) ? \ ((GNode*) (node))->children : NULL) G_END_DECLS #endif /* __G_NODE_H__ */ glib/gversion.h 0000644 00000003675 15125173651 0007507 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_VERSION_H__ #define __G_VERSION_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_VAR const guint glib_major_version; GLIB_VAR const guint glib_minor_version; GLIB_VAR const guint glib_micro_version; GLIB_VAR const guint glib_interface_age; GLIB_VAR const guint glib_binary_age; GLIB_AVAILABLE_IN_ALL const gchar * glib_check_version (guint required_major, guint required_minor, guint required_micro); #define GLIB_CHECK_VERSION(major,minor,micro) \ (GLIB_MAJOR_VERSION > (major) || \ (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION > (minor)) || \ (GLIB_MAJOR_VERSION == (major) && GLIB_MINOR_VERSION == (minor) && \ GLIB_MICRO_VERSION >= (micro))) G_END_DECLS #endif /* __G_VERSION_H__ */ glib/gtypes.h 0000644 00000050044 15125173651 0007156 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_TYPES_H__ #define __G_TYPES_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glibconfig.h> #include <glib/gmacros.h> #include <glib/gversionmacros.h> #include <time.h> G_BEGIN_DECLS /* Provide type definitions for commonly used types. * These are useful because a "gint8" can be adjusted * to be 1 byte (8 bits) on all platforms. Similarly and * more importantly, "gint32" can be adjusted to be * 4 bytes (32 bits) on all platforms. */ typedef char gchar; typedef short gshort; typedef long glong; typedef int gint; typedef gint gboolean; typedef unsigned char guchar; typedef unsigned short gushort; typedef unsigned long gulong; typedef unsigned int guint; typedef float gfloat; typedef double gdouble; /* Define min and max constants for the fixed size numerical types */ /** * G_MININT8: (value -128) * * The minimum value which can be held in a #gint8. * * Since: 2.4 */ #define G_MININT8 ((gint8) (-G_MAXINT8 - 1)) #define G_MAXINT8 ((gint8) 0x7f) #define G_MAXUINT8 ((guint8) 0xff) /** * G_MININT16: (value -32768) * * The minimum value which can be held in a #gint16. * * Since: 2.4 */ #define G_MININT16 ((gint16) (-G_MAXINT16 - 1)) #define G_MAXINT16 ((gint16) 0x7fff) #define G_MAXUINT16 ((guint16) 0xffff) /** * G_MININT32: (value -2147483648) * * The minimum value which can be held in a #gint32. * * Since: 2.4 */ #define G_MININT32 ((gint32) (-G_MAXINT32 - 1)) #define G_MAXINT32 ((gint32) 0x7fffffff) #define G_MAXUINT32 ((guint32) 0xffffffff) /** * G_MININT64: (value -9223372036854775808) * * The minimum value which can be held in a #gint64. */ #define G_MININT64 ((gint64) (-G_MAXINT64 - G_GINT64_CONSTANT(1))) #define G_MAXINT64 G_GINT64_CONSTANT(0x7fffffffffffffff) #define G_MAXUINT64 G_GUINT64_CONSTANT(0xffffffffffffffff) typedef void* gpointer; typedef const void *gconstpointer; typedef gint (*GCompareFunc) (gconstpointer a, gconstpointer b); typedef gint (*GCompareDataFunc) (gconstpointer a, gconstpointer b, gpointer user_data); typedef gboolean (*GEqualFunc) (gconstpointer a, gconstpointer b); typedef void (*GDestroyNotify) (gpointer data); typedef void (*GFunc) (gpointer data, gpointer user_data); typedef guint (*GHashFunc) (gconstpointer key); typedef void (*GHFunc) (gpointer key, gpointer value, gpointer user_data); /** * GCopyFunc: * @src: (not nullable): A pointer to the data which should be copied * @data: Additional data * * A function of this signature is used to copy the node data * when doing a deep-copy of a tree. * * Returns: (not nullable): A pointer to the copy * * Since: 2.4 */ typedef gpointer (*GCopyFunc) (gconstpointer src, gpointer data); /** * GFreeFunc: * @data: a data pointer * * Declares a type of function which takes an arbitrary * data pointer argument and has no return value. It is * not currently used in GLib or GTK+. */ typedef void (*GFreeFunc) (gpointer data); /** * GTranslateFunc: * @str: the untranslated string * @data: user data specified when installing the function, e.g. * in g_option_group_set_translate_func() * * The type of functions which are used to translate user-visible * strings, for <option>--help</option> output. * * Returns: a translation of the string for the current locale. * The returned string is owned by GLib and must not be freed. */ typedef const gchar * (*GTranslateFunc) (const gchar *str, gpointer data); /* Define some mathematical constants that aren't available * symbolically in some strict ISO C implementations. * * Note that the large number of digits used in these definitions * doesn't imply that GLib or current computers in general would be * able to handle floating point numbers with an accuracy like this. * It's mostly an exercise in futility and future proofing. For * extended precision floating point support, look somewhere else * than GLib. */ #define G_E 2.7182818284590452353602874713526624977572470937000 #define G_LN2 0.69314718055994530941723212145817656807550013436026 #define G_LN10 2.3025850929940456840179914546843642076011014886288 #define G_PI 3.1415926535897932384626433832795028841971693993751 #define G_PI_2 1.5707963267948966192313216916397514420985846996876 #define G_PI_4 0.78539816339744830961566084581987572104929234984378 #define G_SQRT2 1.4142135623730950488016887242096980785696718753769 /* Portable endian checks and conversions * * glibconfig.h defines G_BYTE_ORDER which expands to one of * the below macros. */ #define G_LITTLE_ENDIAN 1234 #define G_BIG_ENDIAN 4321 #define G_PDP_ENDIAN 3412 /* unused, need specific PDP check */ /* Basic bit swapping functions */ #define GUINT16_SWAP_LE_BE_CONSTANT(val) ((guint16) ( \ (guint16) ((guint16) (val) >> 8) | \ (guint16) ((guint16) (val) << 8))) #define GUINT32_SWAP_LE_BE_CONSTANT(val) ((guint32) ( \ (((guint32) (val) & (guint32) 0x000000ffU) << 24) | \ (((guint32) (val) & (guint32) 0x0000ff00U) << 8) | \ (((guint32) (val) & (guint32) 0x00ff0000U) >> 8) | \ (((guint32) (val) & (guint32) 0xff000000U) >> 24))) #define GUINT64_SWAP_LE_BE_CONSTANT(val) ((guint64) ( \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x00000000000000ffU)) << 56) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x000000000000ff00U)) << 40) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x0000000000ff0000U)) << 24) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x00000000ff000000U)) << 8) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x000000ff00000000U)) >> 8) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x0000ff0000000000U)) >> 24) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0x00ff000000000000U)) >> 40) | \ (((guint64) (val) & \ (guint64) G_GINT64_CONSTANT (0xff00000000000000U)) >> 56))) /* Arch specific stuff for speed */ #if defined (__GNUC__) && (__GNUC__ >= 2) && defined (__OPTIMIZE__) # if __GNUC__ >= 4 && defined (__GNUC_MINOR__) && __GNUC_MINOR__ >= 3 # define GUINT32_SWAP_LE_BE(val) ((guint32) __builtin_bswap32 ((guint32) (val))) # define GUINT64_SWAP_LE_BE(val) ((guint64) __builtin_bswap64 ((guint64) (val))) # endif # if defined (__i386__) # define GUINT16_SWAP_LE_BE_IA32(val) \ (G_GNUC_EXTENSION \ ({ guint16 __v, __x = ((guint16) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT16_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ ("rorw $8, %w0" \ : "=r" (__v) \ : "0" (__x) \ : "cc"); \ __v; })) # if !defined (__i486__) && !defined (__i586__) \ && !defined (__pentium__) && !defined (__i686__) \ && !defined (__pentiumpro__) && !defined (__pentium4__) # define GUINT32_SWAP_LE_BE_IA32(val) \ (G_GNUC_EXTENSION \ ({ guint32 __v, __x = ((guint32) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT32_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ ("rorw $8, %w0\n\t" \ "rorl $16, %0\n\t" \ "rorw $8, %w0" \ : "=r" (__v) \ : "0" (__x) \ : "cc"); \ __v; })) # else /* 486 and higher has bswap */ # define GUINT32_SWAP_LE_BE_IA32(val) \ (G_GNUC_EXTENSION \ ({ guint32 __v, __x = ((guint32) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT32_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ ("bswap %0" \ : "=r" (__v) \ : "0" (__x)); \ __v; })) # endif /* processor specific 32-bit stuff */ # define GUINT64_SWAP_LE_BE_IA32(val) \ (G_GNUC_EXTENSION \ ({ union { guint64 __ll; \ guint32 __l[2]; } __w, __r; \ __w.__ll = ((guint64) (val)); \ if (__builtin_constant_p (__w.__ll)) \ __r.__ll = GUINT64_SWAP_LE_BE_CONSTANT (__w.__ll); \ else \ { \ __r.__l[0] = GUINT32_SWAP_LE_BE (__w.__l[1]); \ __r.__l[1] = GUINT32_SWAP_LE_BE (__w.__l[0]); \ } \ __r.__ll; })) /* Possibly just use the constant version and let gcc figure it out? */ # define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_IA32 (val)) # ifndef GUINT32_SWAP_LE_BE # define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_IA32 (val)) # endif # ifndef GUINT64_SWAP_LE_BE # define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_IA32 (val)) # endif # elif defined (__ia64__) # define GUINT16_SWAP_LE_BE_IA64(val) \ (G_GNUC_EXTENSION \ ({ guint16 __v, __x = ((guint16) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT16_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ __volatile__ ("shl %0 = %1, 48 ;;" \ "mux1 %0 = %0, @rev ;;" \ : "=r" (__v) \ : "r" (__x)); \ __v; })) # define GUINT32_SWAP_LE_BE_IA64(val) \ (G_GNUC_EXTENSION \ ({ guint32 __v, __x = ((guint32) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT32_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ __volatile__ ("shl %0 = %1, 32 ;;" \ "mux1 %0 = %0, @rev ;;" \ : "=r" (__v) \ : "r" (__x)); \ __v; })) # define GUINT64_SWAP_LE_BE_IA64(val) \ (G_GNUC_EXTENSION \ ({ guint64 __v, __x = ((guint64) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT64_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ __volatile__ ("mux1 %0 = %1, @rev ;;" \ : "=r" (__v) \ : "r" (__x)); \ __v; })) # define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_IA64 (val)) # ifndef GUINT32_SWAP_LE_BE # define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_IA64 (val)) # endif # ifndef GUINT64_SWAP_LE_BE # define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_IA64 (val)) # endif # elif defined (__x86_64__) # define GUINT32_SWAP_LE_BE_X86_64(val) \ (G_GNUC_EXTENSION \ ({ guint32 __v, __x = ((guint32) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT32_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ ("bswapl %0" \ : "=r" (__v) \ : "0" (__x)); \ __v; })) # define GUINT64_SWAP_LE_BE_X86_64(val) \ (G_GNUC_EXTENSION \ ({ guint64 __v, __x = ((guint64) (val)); \ if (__builtin_constant_p (__x)) \ __v = GUINT64_SWAP_LE_BE_CONSTANT (__x); \ else \ __asm__ ("bswapq %0" \ : "=r" (__v) \ : "0" (__x)); \ __v; })) /* gcc seems to figure out optimal code for this on its own */ # define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val)) # ifndef GUINT32_SWAP_LE_BE # define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_X86_64 (val)) # endif # ifndef GUINT64_SWAP_LE_BE # define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_X86_64 (val)) # endif # else /* generic gcc */ # define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val)) # ifndef GUINT32_SWAP_LE_BE # define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val)) # endif # ifndef GUINT64_SWAP_LE_BE # define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT (val)) # endif # endif #else /* generic */ # define GUINT16_SWAP_LE_BE(val) (GUINT16_SWAP_LE_BE_CONSTANT (val)) # define GUINT32_SWAP_LE_BE(val) (GUINT32_SWAP_LE_BE_CONSTANT (val)) # define GUINT64_SWAP_LE_BE(val) (GUINT64_SWAP_LE_BE_CONSTANT (val)) #endif /* generic */ #define GUINT16_SWAP_LE_PDP(val) ((guint16) (val)) #define GUINT16_SWAP_BE_PDP(val) (GUINT16_SWAP_LE_BE (val)) #define GUINT32_SWAP_LE_PDP(val) ((guint32) ( \ (((guint32) (val) & (guint32) 0x0000ffffU) << 16) | \ (((guint32) (val) & (guint32) 0xffff0000U) >> 16))) #define GUINT32_SWAP_BE_PDP(val) ((guint32) ( \ (((guint32) (val) & (guint32) 0x00ff00ffU) << 8) | \ (((guint32) (val) & (guint32) 0xff00ff00U) >> 8))) /* The G*_TO_?E() macros are defined in glibconfig.h. * The transformation is symmetric, so the FROM just maps to the TO. */ #define GINT16_FROM_LE(val) (GINT16_TO_LE (val)) #define GUINT16_FROM_LE(val) (GUINT16_TO_LE (val)) #define GINT16_FROM_BE(val) (GINT16_TO_BE (val)) #define GUINT16_FROM_BE(val) (GUINT16_TO_BE (val)) #define GINT32_FROM_LE(val) (GINT32_TO_LE (val)) #define GUINT32_FROM_LE(val) (GUINT32_TO_LE (val)) #define GINT32_FROM_BE(val) (GINT32_TO_BE (val)) #define GUINT32_FROM_BE(val) (GUINT32_TO_BE (val)) #define GINT64_FROM_LE(val) (GINT64_TO_LE (val)) #define GUINT64_FROM_LE(val) (GUINT64_TO_LE (val)) #define GINT64_FROM_BE(val) (GINT64_TO_BE (val)) #define GUINT64_FROM_BE(val) (GUINT64_TO_BE (val)) #define GLONG_FROM_LE(val) (GLONG_TO_LE (val)) #define GULONG_FROM_LE(val) (GULONG_TO_LE (val)) #define GLONG_FROM_BE(val) (GLONG_TO_BE (val)) #define GULONG_FROM_BE(val) (GULONG_TO_BE (val)) #define GINT_FROM_LE(val) (GINT_TO_LE (val)) #define GUINT_FROM_LE(val) (GUINT_TO_LE (val)) #define GINT_FROM_BE(val) (GINT_TO_BE (val)) #define GUINT_FROM_BE(val) (GUINT_TO_BE (val)) #define GSIZE_FROM_LE(val) (GSIZE_TO_LE (val)) #define GSSIZE_FROM_LE(val) (GSSIZE_TO_LE (val)) #define GSIZE_FROM_BE(val) (GSIZE_TO_BE (val)) #define GSSIZE_FROM_BE(val) (GSSIZE_TO_BE (val)) /* Portable versions of host-network order stuff */ #define g_ntohl(val) (GUINT32_FROM_BE (val)) #define g_ntohs(val) (GUINT16_FROM_BE (val)) #define g_htonl(val) (GUINT32_TO_BE (val)) #define g_htons(val) (GUINT16_TO_BE (val)) /* Overflow-checked unsigned integer arithmetic */ #ifndef _GLIB_TEST_OVERFLOW_FALLBACK /* https://bugzilla.gnome.org/show_bug.cgi?id=769104 */ #if __GNUC__ >= 5 && !defined(__INTEL_COMPILER) #define _GLIB_HAVE_BUILTIN_OVERFLOW_CHECKS #elif g_macro__has_builtin(__builtin_uadd_overflow) #define _GLIB_HAVE_BUILTIN_OVERFLOW_CHECKS #endif #endif #define g_uint_checked_add(dest, a, b) \ _GLIB_CHECKED_ADD_U32(dest, a, b) #define g_uint_checked_mul(dest, a, b) \ _GLIB_CHECKED_MUL_U32(dest, a, b) #define g_uint64_checked_add(dest, a, b) \ _GLIB_CHECKED_ADD_U64(dest, a, b) #define g_uint64_checked_mul(dest, a, b) \ _GLIB_CHECKED_MUL_U64(dest, a, b) #if GLIB_SIZEOF_SIZE_T == 8 #define g_size_checked_add(dest, a, b) \ _GLIB_CHECKED_ADD_U64(dest, a, b) #define g_size_checked_mul(dest, a, b) \ _GLIB_CHECKED_MUL_U64(dest, a, b) #else #define g_size_checked_add(dest, a, b) \ _GLIB_CHECKED_ADD_U32(dest, a, b) #define g_size_checked_mul(dest, a, b) \ _GLIB_CHECKED_MUL_U32(dest, a, b) #endif /* The names of the following inlines are private. Use the macro * definitions above. */ #ifdef _GLIB_HAVE_BUILTIN_OVERFLOW_CHECKS static inline gboolean _GLIB_CHECKED_ADD_U32 (guint32 *dest, guint32 a, guint32 b) { return !__builtin_uadd_overflow(a, b, dest); } static inline gboolean _GLIB_CHECKED_MUL_U32 (guint32 *dest, guint32 a, guint32 b) { return !__builtin_umul_overflow(a, b, dest); } static inline gboolean _GLIB_CHECKED_ADD_U64 (guint64 *dest, guint64 a, guint64 b) { G_STATIC_ASSERT(sizeof (unsigned long long) == sizeof (guint64)); return !__builtin_uaddll_overflow(a, b, (unsigned long long *) dest); } static inline gboolean _GLIB_CHECKED_MUL_U64 (guint64 *dest, guint64 a, guint64 b) { return !__builtin_umulll_overflow(a, b, (unsigned long long *) dest); } #else static inline gboolean _GLIB_CHECKED_ADD_U32 (guint32 *dest, guint32 a, guint32 b) { *dest = a + b; return *dest >= a; } static inline gboolean _GLIB_CHECKED_MUL_U32 (guint32 *dest, guint32 a, guint32 b) { *dest = a * b; return !a || *dest / a == b; } static inline gboolean _GLIB_CHECKED_ADD_U64 (guint64 *dest, guint64 a, guint64 b) { *dest = a + b; return *dest >= a; } static inline gboolean _GLIB_CHECKED_MUL_U64 (guint64 *dest, guint64 a, guint64 b) { *dest = a * b; return !a || *dest / a == b; } #endif /* IEEE Standard 754 Single Precision Storage Format (gfloat): * * 31 30 23 22 0 * +--------+---------------+---------------+ * | s 1bit | e[30:23] 8bit | f[22:0] 23bit | * +--------+---------------+---------------+ * B0------------------->B1------->B2-->B3--> * * IEEE Standard 754 Double Precision Storage Format (gdouble): * * 63 62 52 51 32 31 0 * +--------+----------------+----------------+ +---------------+ * | s 1bit | e[62:52] 11bit | f[51:32] 20bit | | f[31:0] 32bit | * +--------+----------------+----------------+ +---------------+ * B0--------------->B1---------->B2--->B3----> B4->B5->B6->B7-> */ /* subtract from biased_exponent to form base2 exponent (normal numbers) */ typedef union _GDoubleIEEE754 GDoubleIEEE754; typedef union _GFloatIEEE754 GFloatIEEE754; #define G_IEEE754_FLOAT_BIAS (127) #define G_IEEE754_DOUBLE_BIAS (1023) /* multiply with base2 exponent to get base10 exponent (normal numbers) */ #define G_LOG_2_BASE_10 (0.30102999566398119521) #if G_BYTE_ORDER == G_LITTLE_ENDIAN union _GFloatIEEE754 { gfloat v_float; struct { guint mantissa : 23; guint biased_exponent : 8; guint sign : 1; } mpn; }; union _GDoubleIEEE754 { gdouble v_double; struct { guint mantissa_low : 32; guint mantissa_high : 20; guint biased_exponent : 11; guint sign : 1; } mpn; }; #elif G_BYTE_ORDER == G_BIG_ENDIAN union _GFloatIEEE754 { gfloat v_float; struct { guint sign : 1; guint biased_exponent : 8; guint mantissa : 23; } mpn; }; union _GDoubleIEEE754 { gdouble v_double; struct { guint sign : 1; guint biased_exponent : 11; guint mantissa_high : 20; guint mantissa_low : 32; } mpn; }; #else /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */ #error unknown ENDIAN type #endif /* !G_LITTLE_ENDIAN && !G_BIG_ENDIAN */ typedef struct _GTimeVal GTimeVal GLIB_DEPRECATED_TYPE_IN_2_62_FOR(GDateTime); struct _GTimeVal { glong tv_sec; glong tv_usec; } GLIB_DEPRECATED_TYPE_IN_2_62_FOR(GDateTime); typedef gint grefcount; typedef gint gatomicrefcount; /* should be accessed only using atomics */ G_END_DECLS /* We prefix variable declarations so they can * properly get exported in Windows DLLs. */ #ifndef GLIB_VAR # ifdef G_PLATFORM_WIN32 # ifdef GLIB_STATIC_COMPILATION # define GLIB_VAR extern # else /* !GLIB_STATIC_COMPILATION */ # ifdef GLIB_COMPILATION # ifdef DLL_EXPORT # define GLIB_VAR extern __declspec(dllexport) # else /* !DLL_EXPORT */ # define GLIB_VAR extern # endif /* !DLL_EXPORT */ # else /* !GLIB_COMPILATION */ # define GLIB_VAR extern __declspec(dllimport) # endif /* !GLIB_COMPILATION */ # endif /* !GLIB_STATIC_COMPILATION */ # else /* !G_PLATFORM_WIN32 */ # define GLIB_VAR _GLIB_EXTERN # endif /* !G_PLATFORM_WIN32 */ #endif /* GLIB_VAR */ #endif /* __G_TYPES_H__ */ glib/ghostutils.h 0000644 00000002660 15125173651 0010051 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_HOST_UTILS_H__ #define __G_HOST_UTILS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL gboolean g_hostname_is_non_ascii (const gchar *hostname); GLIB_AVAILABLE_IN_ALL gboolean g_hostname_is_ascii_encoded (const gchar *hostname); GLIB_AVAILABLE_IN_ALL gboolean g_hostname_is_ip_address (const gchar *hostname); GLIB_AVAILABLE_IN_ALL gchar *g_hostname_to_ascii (const gchar *hostname); GLIB_AVAILABLE_IN_ALL gchar *g_hostname_to_unicode (const gchar *hostname); G_END_DECLS #endif /* __G_HOST_UTILS_H__ */ glib/gconvert.h 0000644 00000013443 15125173651 0007474 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_CONVERT_H__ #define __G_CONVERT_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gerror.h> G_BEGIN_DECLS /** * GConvertError: * @G_CONVERT_ERROR_NO_CONVERSION: Conversion between the requested character * sets is not supported. * @G_CONVERT_ERROR_ILLEGAL_SEQUENCE: Invalid byte sequence in conversion input; * or the character sequence could not be represented in the target * character set. * @G_CONVERT_ERROR_FAILED: Conversion failed for some reason. * @G_CONVERT_ERROR_PARTIAL_INPUT: Partial character sequence at end of input. * @G_CONVERT_ERROR_BAD_URI: URI is invalid. * @G_CONVERT_ERROR_NOT_ABSOLUTE_PATH: Pathname is not an absolute path. * @G_CONVERT_ERROR_NO_MEMORY: No memory available. Since: 2.40 * @G_CONVERT_ERROR_EMBEDDED_NUL: An embedded NUL character is present in * conversion output where a NUL-terminated string is expected. * Since: 2.56 * * Error codes returned by character set conversion routines. */ typedef enum { G_CONVERT_ERROR_NO_CONVERSION, G_CONVERT_ERROR_ILLEGAL_SEQUENCE, G_CONVERT_ERROR_FAILED, G_CONVERT_ERROR_PARTIAL_INPUT, G_CONVERT_ERROR_BAD_URI, G_CONVERT_ERROR_NOT_ABSOLUTE_PATH, G_CONVERT_ERROR_NO_MEMORY, G_CONVERT_ERROR_EMBEDDED_NUL } GConvertError; /** * G_CONVERT_ERROR: * * Error domain for character set conversions. Errors in this domain will * be from the #GConvertError enumeration. See #GError for information on * error domains. */ #define G_CONVERT_ERROR g_convert_error_quark() GLIB_AVAILABLE_IN_ALL GQuark g_convert_error_quark (void); /** * GIConv: (skip) * * The GIConv struct wraps an iconv() conversion descriptor. It contains * private data and should only be accessed using the following functions. */ typedef struct _GIConv *GIConv; GLIB_AVAILABLE_IN_ALL GIConv g_iconv_open (const gchar *to_codeset, const gchar *from_codeset); GLIB_AVAILABLE_IN_ALL gsize g_iconv (GIConv converter, gchar **inbuf, gsize *inbytes_left, gchar **outbuf, gsize *outbytes_left); GLIB_AVAILABLE_IN_ALL gint g_iconv_close (GIConv converter); GLIB_AVAILABLE_IN_ALL gchar* g_convert (const gchar *str, gssize len, const gchar *to_codeset, const gchar *from_codeset, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_convert_with_iconv (const gchar *str, gssize len, GIConv converter, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_convert_with_fallback (const gchar *str, gssize len, const gchar *to_codeset, const gchar *from_codeset, const gchar *fallback, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; /* Convert between libc's idea of strings and UTF-8. */ GLIB_AVAILABLE_IN_ALL gchar* g_locale_to_utf8 (const gchar *opsysstring, gssize len, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_locale_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; /* Convert between the operating system (or C runtime) * representation of file names and UTF-8. */ GLIB_AVAILABLE_IN_ALL gchar* g_filename_to_utf8 (const gchar *opsysstring, gssize len, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar* g_filename_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read, gsize *bytes_written, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_filename_from_uri (const gchar *uri, gchar **hostname, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_filename_to_uri (const gchar *filename, const gchar *hostname, GError **error) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar *g_filename_display_name (const gchar *filename) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gboolean g_get_filename_charsets (const gchar ***filename_charsets); GLIB_AVAILABLE_IN_ALL gchar *g_filename_display_basename (const gchar *filename) G_GNUC_MALLOC; GLIB_AVAILABLE_IN_ALL gchar **g_uri_list_extract_uris (const gchar *uri_list); G_END_DECLS #endif /* __G_CONVERT_H__ */ glib/gqsort.h 0000644 00000002733 15125173651 0007164 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_QSORT_H__ #define __G_QSORT_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL void g_qsort_with_data (gconstpointer pbase, gint total_elems, gsize size, GCompareDataFunc compare_func, gpointer user_data); G_END_DECLS #endif /* __G_QSORT_H__ */ glib/gdataset.h 0000644 00000014145 15125173651 0007441 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_DATASET_H__ #define __G_DATASET_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gquark.h> G_BEGIN_DECLS typedef struct _GData GData; typedef void (*GDataForeachFunc) (GQuark key_id, gpointer data, gpointer user_data); /* Keyed Data List */ GLIB_AVAILABLE_IN_ALL void g_datalist_init (GData **datalist); GLIB_AVAILABLE_IN_ALL void g_datalist_clear (GData **datalist); GLIB_AVAILABLE_IN_ALL gpointer g_datalist_id_get_data (GData **datalist, GQuark key_id); GLIB_AVAILABLE_IN_ALL void g_datalist_id_set_data_full (GData **datalist, GQuark key_id, gpointer data, GDestroyNotify destroy_func); typedef gpointer (*GDuplicateFunc) (gpointer data, gpointer user_data); GLIB_AVAILABLE_IN_2_34 gpointer g_datalist_id_dup_data (GData **datalist, GQuark key_id, GDuplicateFunc dup_func, gpointer user_data); GLIB_AVAILABLE_IN_2_34 gboolean g_datalist_id_replace_data (GData **datalist, GQuark key_id, gpointer oldval, gpointer newval, GDestroyNotify destroy, GDestroyNotify *old_destroy); GLIB_AVAILABLE_IN_ALL gpointer g_datalist_id_remove_no_notify (GData **datalist, GQuark key_id); GLIB_AVAILABLE_IN_ALL void g_datalist_foreach (GData **datalist, GDataForeachFunc func, gpointer user_data); /** * G_DATALIST_FLAGS_MASK: * * A bitmask that restricts the possible flags passed to * g_datalist_set_flags(). Passing a flags value where * flags & ~G_DATALIST_FLAGS_MASK != 0 is an error. */ #define G_DATALIST_FLAGS_MASK 0x3 GLIB_AVAILABLE_IN_ALL void g_datalist_set_flags (GData **datalist, guint flags); GLIB_AVAILABLE_IN_ALL void g_datalist_unset_flags (GData **datalist, guint flags); GLIB_AVAILABLE_IN_ALL guint g_datalist_get_flags (GData **datalist); #define g_datalist_id_set_data(dl, q, d) \ g_datalist_id_set_data_full ((dl), (q), (d), NULL) #define g_datalist_id_remove_data(dl, q) \ g_datalist_id_set_data ((dl), (q), NULL) #define g_datalist_set_data_full(dl, k, d, f) \ g_datalist_id_set_data_full ((dl), g_quark_from_string (k), (d), (f)) #define g_datalist_remove_no_notify(dl, k) \ g_datalist_id_remove_no_notify ((dl), g_quark_try_string (k)) #define g_datalist_set_data(dl, k, d) \ g_datalist_set_data_full ((dl), (k), (d), NULL) #define g_datalist_remove_data(dl, k) \ g_datalist_id_set_data ((dl), g_quark_try_string (k), NULL) /* Location Associated Keyed Data */ GLIB_AVAILABLE_IN_ALL void g_dataset_destroy (gconstpointer dataset_location); GLIB_AVAILABLE_IN_ALL gpointer g_dataset_id_get_data (gconstpointer dataset_location, GQuark key_id); GLIB_AVAILABLE_IN_ALL gpointer g_datalist_get_data (GData **datalist, const gchar *key); GLIB_AVAILABLE_IN_ALL void g_dataset_id_set_data_full (gconstpointer dataset_location, GQuark key_id, gpointer data, GDestroyNotify destroy_func); GLIB_AVAILABLE_IN_ALL gpointer g_dataset_id_remove_no_notify (gconstpointer dataset_location, GQuark key_id); GLIB_AVAILABLE_IN_ALL void g_dataset_foreach (gconstpointer dataset_location, GDataForeachFunc func, gpointer user_data); #define g_dataset_id_set_data(l, k, d) \ g_dataset_id_set_data_full ((l), (k), (d), NULL) #define g_dataset_id_remove_data(l, k) \ g_dataset_id_set_data ((l), (k), NULL) #define g_dataset_get_data(l, k) \ (g_dataset_id_get_data ((l), g_quark_try_string (k))) #define g_dataset_set_data_full(l, k, d, f) \ g_dataset_id_set_data_full ((l), g_quark_from_string (k), (d), (f)) #define g_dataset_remove_no_notify(l, k) \ g_dataset_id_remove_no_notify ((l), g_quark_try_string (k)) #define g_dataset_set_data(l, k, d) \ g_dataset_set_data_full ((l), (k), (d), NULL) #define g_dataset_remove_data(l, k) \ g_dataset_id_set_data ((l), g_quark_try_string (k), NULL) G_END_DECLS #endif /* __G_DATASET_H__ */ glib/gtestutils.h 0000644 00000104502 15125173651 0010051 0 ustar 00 /* GLib testing utilities * Copyright (C) 2007 Imendio AB * Authors: Tim Janik * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_TEST_UTILS_H__ #define __G_TEST_UTILS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gmessages.h> #include <glib/gstring.h> #include <glib/gerror.h> #include <glib/gslist.h> #include <errno.h> #include <string.h> G_BEGIN_DECLS typedef struct GTestCase GTestCase; typedef struct GTestSuite GTestSuite; typedef void (*GTestFunc) (void); typedef void (*GTestDataFunc) (gconstpointer user_data); typedef void (*GTestFixtureFunc) (gpointer fixture, gconstpointer user_data); /* assertion API */ #define g_assert_cmpstr(s1, cmp, s2) G_STMT_START { \ const char *__s1 = (s1), *__s2 = (s2); \ if (g_strcmp0 (__s1, __s2) cmp 0) ; else \ g_assertion_message_cmpstr (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #s1 " " #cmp " " #s2, __s1, #cmp, __s2); \ } G_STMT_END #define g_assert_cmpint(n1, cmp, n2) G_STMT_START { \ gint64 __n1 = (n1), __n2 = (n2); \ if (__n1 cmp __n2) ; else \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #n1 " " #cmp " " #n2, (long double) __n1, #cmp, (long double) __n2, 'i'); \ } G_STMT_END #define g_assert_cmpuint(n1, cmp, n2) G_STMT_START { \ guint64 __n1 = (n1), __n2 = (n2); \ if (__n1 cmp __n2) ; else \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #n1 " " #cmp " " #n2, (long double) __n1, #cmp, (long double) __n2, 'i'); \ } G_STMT_END #define g_assert_cmphex(n1, cmp, n2) G_STMT_START {\ guint64 __n1 = (n1), __n2 = (n2); \ if (__n1 cmp __n2) ; else \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #n1 " " #cmp " " #n2, (long double) __n1, #cmp, (long double) __n2, 'x'); \ } G_STMT_END #define g_assert_cmpfloat(n1,cmp,n2) G_STMT_START { \ long double __n1 = (long double) (n1), __n2 = (long double) (n2); \ if (__n1 cmp __n2) ; else \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #n1 " " #cmp " " #n2, (long double) __n1, #cmp, (long double) __n2, 'f'); \ } G_STMT_END #define g_assert_cmpfloat_with_epsilon(n1,n2,epsilon) \ G_STMT_START { \ double __n1 = (n1), __n2 = (n2), __epsilon = (epsilon); \ if (G_APPROX_VALUE (__n1, __n2, __epsilon)) ; else \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #n1 " == " #n2 " (+/- " #epsilon ")", __n1, "==", __n2, 'f'); \ } G_STMT_END #define g_assert_cmpmem(m1, l1, m2, l2) G_STMT_START {\ gconstpointer __m1 = m1, __m2 = m2; \ int __l1 = l1, __l2 = l2; \ if (__l1 != 0 && __m1 == NULL) \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "assertion failed (" #l1 " == 0 || " #m1 " != NULL)"); \ else if (__l2 != 0 && __m2 == NULL) \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "assertion failed (" #l2 " == 0 || " #m2 " != NULL)"); \ else if (__l1 != __l2) \ g_assertion_message_cmpnum (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #l1 " (len(" #m1 ")) == " #l2 " (len(" #m2 "))", \ (long double) __l1, "==", (long double) __l2, 'i'); \ else if (__l1 != 0 && __m2 != NULL && memcmp (__m1, __m2, __l1) != 0) \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "assertion failed (" #m1 " == " #m2 ")"); \ } G_STMT_END #define g_assert_cmpvariant(v1, v2) \ G_STMT_START \ { \ GVariant *__v1 = (v1), *__v2 = (v2); \ if (!g_variant_equal (__v1, __v2)) \ { \ gchar *__s1, *__s2, *__msg; \ __s1 = g_variant_print (__v1, TRUE); \ __s2 = g_variant_print (__v2, TRUE); \ __msg = g_strdup_printf ("assertion failed (" #v1 " == " #v2 "): %s does not equal %s", __s1, __s2); \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, __msg); \ g_free (__s1); \ g_free (__s2); \ g_free (__msg); \ } \ } \ G_STMT_END #define g_assert_cmpstrv(strv1, strv2) \ G_STMT_START \ { \ const char * const *__strv1 = (const char * const *) (strv1); \ const char * const *__strv2 = (const char * const *) (strv2); \ if (!__strv1 || !__strv2) \ { \ if (__strv1) \ { \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "assertion failed (" #strv1 " == " #strv2 "): " #strv2 " is NULL, but " #strv1 " is not"); \ } \ else if (__strv2) \ { \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "assertion failed (" #strv1 " == " #strv2 "): " #strv1 " is NULL, but " #strv2 " is not"); \ } \ } \ else \ { \ guint __l1 = g_strv_length ((char **) __strv1); \ guint __l2 = g_strv_length ((char **) __strv2); \ if (__l1 != __l2) \ { \ char *__msg; \ __msg = g_strdup_printf ("assertion failed (" #strv1 " == " #strv2 "): length %u does not equal length %u", __l1, __l2); \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, __msg); \ g_free (__msg); \ } \ else \ { \ guint __i; \ for (__i = 0; __i < __l1; __i++) \ { \ if (g_strcmp0 (__strv1[__i], __strv2[__i]) != 0) \ { \ g_assertion_message_cmpstrv (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #strv1 " == " #strv2, \ __strv1, __strv2, __i); \ } \ } \ } \ } \ } \ G_STMT_END #define g_assert_no_errno(expr) G_STMT_START { \ int __ret, __errsv; \ errno = 0; \ __ret = expr; \ __errsv = errno; \ if (__ret < 0) \ { \ gchar *__msg; \ __msg = g_strdup_printf ("assertion failed (" #expr " >= 0): errno %i: %s", __errsv, g_strerror (__errsv)); \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, __msg); \ g_free (__msg); \ } \ } G_STMT_END \ GLIB_AVAILABLE_MACRO_IN_2_66 #define g_assert_no_error(err) G_STMT_START { \ if (err) \ g_assertion_message_error (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #err, err, 0, 0); \ } G_STMT_END #define g_assert_error(err, dom, c) G_STMT_START { \ if (!err || (err)->domain != dom || (err)->code != c) \ g_assertion_message_error (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #err, err, dom, c); \ } G_STMT_END #define g_assert_true(expr) G_STMT_START { \ if G_LIKELY (expr) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should be TRUE"); \ } G_STMT_END #define g_assert_false(expr) G_STMT_START { \ if G_LIKELY (!(expr)) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should be FALSE"); \ } G_STMT_END /* Use nullptr in C++ to catch misuse of these macros. */ #if defined(__cplusplus) && __cplusplus >= 201100L #define g_assert_null(expr) G_STMT_START { if G_LIKELY ((expr) == nullptr) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should be nullptr"); \ } G_STMT_END #define g_assert_nonnull(expr) G_STMT_START { \ if G_LIKELY ((expr) != nullptr) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should not be nullptr"); \ } G_STMT_END #else /* not C++ */ #define g_assert_null(expr) G_STMT_START { if G_LIKELY ((expr) == NULL) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should be NULL"); \ } G_STMT_END #define g_assert_nonnull(expr) G_STMT_START { \ if G_LIKELY ((expr) != NULL) ; else \ g_assertion_message (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ "'" #expr "' should not be NULL"); \ } G_STMT_END #endif #ifdef G_DISABLE_ASSERT /* https://gcc.gnu.org/onlinedocs/gcc-8.3.0/gcc/Other-Builtins.html#index-_005f_005fbuiltin_005funreachable * GCC 5 is not a strict lower bound for versions of GCC which provide __builtin_unreachable(). */ #if __GNUC__ >= 5 || g_macro__has_builtin(__builtin_unreachable) #define g_assert_not_reached() G_STMT_START { (void) 0; __builtin_unreachable (); } G_STMT_END #elif defined (_MSC_VER) #define g_assert_not_reached() G_STMT_START { (void) 0; __assume (0); } G_STMT_END #else /* if __builtin_unreachable() is not supported: */ #define g_assert_not_reached() G_STMT_START { (void) 0; } G_STMT_END #endif #define g_assert(expr) G_STMT_START { (void) 0; } G_STMT_END #else /* !G_DISABLE_ASSERT */ #define g_assert_not_reached() G_STMT_START { g_assertion_message_expr (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, NULL); } G_STMT_END #define g_assert(expr) G_STMT_START { \ if G_LIKELY (expr) ; else \ g_assertion_message_expr (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, \ #expr); \ } G_STMT_END #endif /* !G_DISABLE_ASSERT */ GLIB_AVAILABLE_IN_ALL int g_strcmp0 (const char *str1, const char *str2); /* report performance results */ GLIB_AVAILABLE_IN_ALL void g_test_minimized_result (double minimized_quantity, const char *format, ...) G_GNUC_PRINTF (2, 3); GLIB_AVAILABLE_IN_ALL void g_test_maximized_result (double maximized_quantity, const char *format, ...) G_GNUC_PRINTF (2, 3); /* initialize testing framework */ GLIB_AVAILABLE_IN_ALL void g_test_init (int *argc, char ***argv, ...) G_GNUC_NULL_TERMINATED; /** * G_TEST_OPTION_ISOLATE_DIRS: * * Creates a unique temporary directory for each unit test and uses * g_set_user_dirs() to set XDG directories to point into subdirectories of it * for the duration of the unit test. The directory tree is cleaned up after the * test finishes successfully. Note that this doesn’t take effect until * g_test_run() is called, so calls to (for example) g_get_user_home_dir() will * return the system-wide value when made in a test program’s main() function. * * The following functions will return subdirectories of the temporary directory * when this option is used. The specific subdirectory paths in use are not * guaranteed to be stable API — always use a getter function to retrieve them. * * - g_get_home_dir() * - g_get_user_cache_dir() * - g_get_system_config_dirs() * - g_get_user_config_dir() * - g_get_system_data_dirs() * - g_get_user_data_dir() * - g_get_user_runtime_dir() * * The subdirectories may not be created by the test harness; as with normal * calls to functions like g_get_user_cache_dir(), the caller must be prepared * to create the directory if it doesn’t exist. * * Since: 2.60 */ #define G_TEST_OPTION_ISOLATE_DIRS "isolate_dirs" /* While we discourage its use, g_assert() is often used in unit tests * (especially in legacy code). g_assert_*() should really be used instead. * g_assert() can be disabled at client program compile time, which can render * tests useless. Highlight that to the user. */ #ifdef G_DISABLE_ASSERT #if defined(G_HAVE_ISO_VARARGS) #define g_test_init(argc, argv, ...) \ G_STMT_START { \ g_printerr ("Tests were compiled with G_DISABLE_ASSERT and are likely no-ops. Aborting.\n"); \ exit (1); \ } G_STMT_END #elif defined(G_HAVE_GNUC_VARARGS) #define g_test_init(argc, argv...) \ G_STMT_START { \ g_printerr ("Tests were compiled with G_DISABLE_ASSERT and are likely no-ops. Aborting.\n"); \ exit (1); \ } G_STMT_END #else /* no varargs */ /* do nothing */ #endif /* varargs support */ #endif /* G_DISABLE_ASSERT */ /* query testing framework config */ #define g_test_initialized() (g_test_config_vars->test_initialized) #define g_test_quick() (g_test_config_vars->test_quick) #define g_test_slow() (!g_test_config_vars->test_quick) #define g_test_thorough() (!g_test_config_vars->test_quick) #define g_test_perf() (g_test_config_vars->test_perf) #define g_test_verbose() (g_test_config_vars->test_verbose) #define g_test_quiet() (g_test_config_vars->test_quiet) #define g_test_undefined() (g_test_config_vars->test_undefined) GLIB_AVAILABLE_IN_2_38 gboolean g_test_subprocess (void); /* run all tests under toplevel suite (path: /) */ GLIB_AVAILABLE_IN_ALL int g_test_run (void); /* hook up a test functions under test path */ GLIB_AVAILABLE_IN_ALL void g_test_add_func (const char *testpath, GTestFunc test_func); GLIB_AVAILABLE_IN_ALL void g_test_add_data_func (const char *testpath, gconstpointer test_data, GTestDataFunc test_func); GLIB_AVAILABLE_IN_2_34 void g_test_add_data_func_full (const char *testpath, gpointer test_data, GTestDataFunc test_func, GDestroyNotify data_free_func); /* tell about currently run test */ GLIB_AVAILABLE_IN_2_68 const char * g_test_get_path (void); /* tell about failure */ GLIB_AVAILABLE_IN_2_30 void g_test_fail (void); GLIB_AVAILABLE_IN_2_38 void g_test_incomplete (const gchar *msg); GLIB_AVAILABLE_IN_2_38 void g_test_skip (const gchar *msg); GLIB_AVAILABLE_IN_2_38 gboolean g_test_failed (void); GLIB_AVAILABLE_IN_2_38 void g_test_set_nonfatal_assertions (void); /** * g_test_add: * @testpath: The test path for a new test case. * @Fixture: The type of a fixture data structure. * @tdata: Data argument for the test functions. * @fsetup: The function to set up the fixture data. * @ftest: The actual test function. * @fteardown: The function to tear down the fixture data. * * Hook up a new test case at @testpath, similar to g_test_add_func(). * A fixture data structure with setup and teardown functions may be provided, * similar to g_test_create_case(). * * g_test_add() is implemented as a macro, so that the fsetup(), ftest() and * fteardown() callbacks can expect a @Fixture pointer as their first argument * in a type safe manner. They otherwise have type #GTestFixtureFunc. * * Since: 2.16 */ #define g_test_add(testpath, Fixture, tdata, fsetup, ftest, fteardown) \ G_STMT_START { \ void (*add_vtable) (const char*, \ gsize, \ gconstpointer, \ void (*) (Fixture*, gconstpointer), \ void (*) (Fixture*, gconstpointer), \ void (*) (Fixture*, gconstpointer)) = (void (*) (const gchar *, gsize, gconstpointer, void (*) (Fixture*, gconstpointer), void (*) (Fixture*, gconstpointer), void (*) (Fixture*, gconstpointer))) g_test_add_vtable; \ add_vtable \ (testpath, sizeof (Fixture), tdata, fsetup, ftest, fteardown); \ } G_STMT_END /* add test messages to the test report */ GLIB_AVAILABLE_IN_ALL void g_test_message (const char *format, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL void g_test_bug_base (const char *uri_pattern); GLIB_AVAILABLE_IN_ALL void g_test_bug (const char *bug_uri_snippet); GLIB_AVAILABLE_IN_2_62 void g_test_summary (const char *summary); /* measure test timings */ GLIB_AVAILABLE_IN_ALL void g_test_timer_start (void); GLIB_AVAILABLE_IN_ALL double g_test_timer_elapsed (void); /* elapsed seconds */ GLIB_AVAILABLE_IN_ALL double g_test_timer_last (void); /* repeat last elapsed() result */ /* automatically g_free or g_object_unref upon teardown */ GLIB_AVAILABLE_IN_ALL void g_test_queue_free (gpointer gfree_pointer); GLIB_AVAILABLE_IN_ALL void g_test_queue_destroy (GDestroyNotify destroy_func, gpointer destroy_data); #define g_test_queue_unref(gobject) g_test_queue_destroy (g_object_unref, gobject) /** * GTestTrapFlags: * @G_TEST_TRAP_SILENCE_STDOUT: Redirect stdout of the test child to * `/dev/null` so it cannot be observed on the console during test * runs. The actual output is still captured though to allow later * tests with g_test_trap_assert_stdout(). * @G_TEST_TRAP_SILENCE_STDERR: Redirect stderr of the test child to * `/dev/null` so it cannot be observed on the console during test * runs. The actual output is still captured though to allow later * tests with g_test_trap_assert_stderr(). * @G_TEST_TRAP_INHERIT_STDIN: If this flag is given, stdin of the * child process is shared with stdin of its parent process. * It is redirected to `/dev/null` otherwise. * * Test traps are guards around forked tests. * These flags determine what traps to set. * * Deprecated: 2.38: #GTestTrapFlags is used only with g_test_trap_fork(), * which is deprecated. g_test_trap_subprocess() uses * #GTestSubprocessFlags. */ typedef enum { G_TEST_TRAP_SILENCE_STDOUT = 1 << 7, G_TEST_TRAP_SILENCE_STDERR = 1 << 8, G_TEST_TRAP_INHERIT_STDIN = 1 << 9 } GTestTrapFlags GLIB_DEPRECATED_TYPE_IN_2_38_FOR(GTestSubprocessFlags); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_38_FOR (g_test_trap_subprocess) gboolean g_test_trap_fork (guint64 usec_timeout, GTestTrapFlags test_trap_flags); G_GNUC_END_IGNORE_DEPRECATIONS typedef enum { G_TEST_SUBPROCESS_INHERIT_STDIN = 1 << 0, G_TEST_SUBPROCESS_INHERIT_STDOUT = 1 << 1, G_TEST_SUBPROCESS_INHERIT_STDERR = 1 << 2 } GTestSubprocessFlags; GLIB_AVAILABLE_IN_2_38 void g_test_trap_subprocess (const char *test_path, guint64 usec_timeout, GTestSubprocessFlags test_flags); GLIB_AVAILABLE_IN_ALL gboolean g_test_trap_has_passed (void); GLIB_AVAILABLE_IN_ALL gboolean g_test_trap_reached_timeout (void); #define g_test_trap_assert_passed() g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 0, 0) #define g_test_trap_assert_failed() g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 1, 0) #define g_test_trap_assert_stdout(soutpattern) g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 2, soutpattern) #define g_test_trap_assert_stdout_unmatched(soutpattern) g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 3, soutpattern) #define g_test_trap_assert_stderr(serrpattern) g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 4, serrpattern) #define g_test_trap_assert_stderr_unmatched(serrpattern) g_test_trap_assertions (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC, 5, serrpattern) /* provide seed-able random numbers for tests */ #define g_test_rand_bit() (0 != (g_test_rand_int() & (1 << 15))) GLIB_AVAILABLE_IN_ALL gint32 g_test_rand_int (void); GLIB_AVAILABLE_IN_ALL gint32 g_test_rand_int_range (gint32 begin, gint32 end); GLIB_AVAILABLE_IN_ALL double g_test_rand_double (void); GLIB_AVAILABLE_IN_ALL double g_test_rand_double_range (double range_start, double range_end); /* * semi-internal API: non-documented symbols with stable ABI. You * should use the non-internal helper macros instead. However, for * compatibility reason, you may use this semi-internal API. */ GLIB_AVAILABLE_IN_ALL GTestCase* g_test_create_case (const char *test_name, gsize data_size, gconstpointer test_data, GTestFixtureFunc data_setup, GTestFixtureFunc data_test, GTestFixtureFunc data_teardown); GLIB_AVAILABLE_IN_ALL GTestSuite* g_test_create_suite (const char *suite_name); GLIB_AVAILABLE_IN_ALL GTestSuite* g_test_get_root (void); GLIB_AVAILABLE_IN_ALL void g_test_suite_add (GTestSuite *suite, GTestCase *test_case); GLIB_AVAILABLE_IN_ALL void g_test_suite_add_suite (GTestSuite *suite, GTestSuite *nestedsuite); GLIB_AVAILABLE_IN_ALL int g_test_run_suite (GTestSuite *suite); GLIB_AVAILABLE_IN_ALL void g_test_trap_assertions (const char *domain, const char *file, int line, const char *func, guint64 assertion_flags, /* 0-pass, 1-fail, 2-outpattern, 4-errpattern */ const char *pattern); GLIB_AVAILABLE_IN_ALL void g_assertion_message (const char *domain, const char *file, int line, const char *func, const char *message) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_ALL G_NORETURN void g_assertion_message_expr (const char *domain, const char *file, int line, const char *func, const char *expr); GLIB_AVAILABLE_IN_ALL void g_assertion_message_cmpstr (const char *domain, const char *file, int line, const char *func, const char *expr, const char *arg1, const char *cmp, const char *arg2) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_2_68 void g_assertion_message_cmpstrv (const char *domain, const char *file, int line, const char *func, const char *expr, const char * const *arg1, const char * const *arg2, gsize first_wrong_idx) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_ALL void g_assertion_message_cmpnum (const char *domain, const char *file, int line, const char *func, const char *expr, long double arg1, const char *cmp, long double arg2, char numtype) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_ALL void g_assertion_message_error (const char *domain, const char *file, int line, const char *func, const char *expr, const GError *error, GQuark error_domain, int error_code) G_ANALYZER_NORETURN; GLIB_AVAILABLE_IN_ALL void g_test_add_vtable (const char *testpath, gsize data_size, gconstpointer test_data, GTestFixtureFunc data_setup, GTestFixtureFunc data_test, GTestFixtureFunc data_teardown); typedef struct { gboolean test_initialized; gboolean test_quick; /* disable thorough tests */ gboolean test_perf; /* run performance tests */ gboolean test_verbose; /* extra info */ gboolean test_quiet; /* reduce output */ gboolean test_undefined; /* run tests that are meant to assert */ } GTestConfig; GLIB_VAR const GTestConfig * const g_test_config_vars; /* internal logging API */ typedef enum { G_TEST_RUN_SUCCESS, G_TEST_RUN_SKIPPED, G_TEST_RUN_FAILURE, G_TEST_RUN_INCOMPLETE } GTestResult; typedef enum { G_TEST_LOG_NONE, G_TEST_LOG_ERROR, /* s:msg */ G_TEST_LOG_START_BINARY, /* s:binaryname s:seed */ G_TEST_LOG_LIST_CASE, /* s:testpath */ G_TEST_LOG_SKIP_CASE, /* s:testpath */ G_TEST_LOG_START_CASE, /* s:testpath */ G_TEST_LOG_STOP_CASE, /* d:status d:nforks d:elapsed */ G_TEST_LOG_MIN_RESULT, /* s:blurb d:result */ G_TEST_LOG_MAX_RESULT, /* s:blurb d:result */ G_TEST_LOG_MESSAGE, /* s:blurb */ G_TEST_LOG_START_SUITE, G_TEST_LOG_STOP_SUITE } GTestLogType; typedef struct { GTestLogType log_type; guint n_strings; gchar **strings; /* NULL terminated */ guint n_nums; long double *nums; } GTestLogMsg; typedef struct { /*< private >*/ GString *data; GSList *msgs; } GTestLogBuffer; GLIB_AVAILABLE_IN_ALL const char* g_test_log_type_name (GTestLogType log_type); GLIB_AVAILABLE_IN_ALL GTestLogBuffer* g_test_log_buffer_new (void); GLIB_AVAILABLE_IN_ALL void g_test_log_buffer_free (GTestLogBuffer *tbuffer); GLIB_AVAILABLE_IN_ALL void g_test_log_buffer_push (GTestLogBuffer *tbuffer, guint n_bytes, const guint8 *bytes); GLIB_AVAILABLE_IN_ALL GTestLogMsg* g_test_log_buffer_pop (GTestLogBuffer *tbuffer); GLIB_AVAILABLE_IN_ALL void g_test_log_msg_free (GTestLogMsg *tmsg); /** * GTestLogFatalFunc: * @log_domain: the log domain of the message * @log_level: the log level of the message (including the fatal and recursion flags) * @message: the message to process * @user_data: user data, set in g_test_log_set_fatal_handler() * * Specifies the prototype of fatal log handler functions. * * Returns: %TRUE if the program should abort, %FALSE otherwise * * Since: 2.22 */ typedef gboolean (*GTestLogFatalFunc) (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer user_data); GLIB_AVAILABLE_IN_ALL void g_test_log_set_fatal_handler (GTestLogFatalFunc log_func, gpointer user_data); GLIB_AVAILABLE_IN_2_34 void g_test_expect_message (const gchar *log_domain, GLogLevelFlags log_level, const gchar *pattern); GLIB_AVAILABLE_IN_2_34 void g_test_assert_expected_messages_internal (const char *domain, const char *file, int line, const char *func); typedef enum { G_TEST_DIST, G_TEST_BUILT } GTestFileType; GLIB_AVAILABLE_IN_2_38 gchar * g_test_build_filename (GTestFileType file_type, const gchar *first_path, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_2_38 const gchar *g_test_get_dir (GTestFileType file_type); GLIB_AVAILABLE_IN_2_38 const gchar *g_test_get_filename (GTestFileType file_type, const gchar *first_path, ...) G_GNUC_NULL_TERMINATED; #define g_test_assert_expected_messages() g_test_assert_expected_messages_internal (G_LOG_DOMAIN, __FILE__, __LINE__, G_STRFUNC) G_END_DECLS #endif /* __G_TEST_UTILS_H__ */ glib/gutils.h 0000644 00000034337 15125173651 0007161 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ /* * Modified by the GLib Team and others 1997-2000. See the AUTHORS * file for a list of people on the GLib Team. See the ChangeLog * files for a list of changes. These files are distributed with * GLib at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __G_UTILS_H__ #define __G_UTILS_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <stdarg.h> G_BEGIN_DECLS /* Define G_VA_COPY() to do the right thing for copying va_list variables. * glibconfig.h may have already defined G_VA_COPY as va_copy or __va_copy. */ #if !defined (G_VA_COPY) # if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32)) # define G_VA_COPY(ap1, ap2) (*(ap1) = *(ap2)) # elif defined (G_VA_COPY_AS_ARRAY) # define G_VA_COPY(ap1, ap2) memmove ((ap1), (ap2), sizeof (va_list)) # else /* va_list is a pointer */ # define G_VA_COPY(ap1, ap2) ((ap1) = (ap2)) # endif /* va_list is a pointer */ #endif /* !G_VA_COPY */ GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_name (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_real_name (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_home_dir (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_tmp_dir (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_host_name (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_prgname (void); GLIB_AVAILABLE_IN_ALL void g_set_prgname (const gchar *prgname); GLIB_AVAILABLE_IN_ALL const gchar * g_get_application_name (void); GLIB_AVAILABLE_IN_ALL void g_set_application_name (const gchar *application_name); GLIB_AVAILABLE_IN_2_64 gchar * g_get_os_info (const gchar *key_name); /** * G_OS_INFO_KEY_NAME: * * A key to get the name of the operating system excluding version information suitable for presentation to the user, e.g. "YoYoOS" * * Since: 2.64 */ #define G_OS_INFO_KEY_NAME \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "NAME" /** * G_OS_INFO_KEY_PRETTY_NAME: * * A key to get the name of the operating system in a format suitable for presentation to the user, e.g. "YoYoOS Foo" * * Since: 2.64 */ #define G_OS_INFO_KEY_PRETTY_NAME \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "PRETTY_NAME" /** * G_OS_INFO_KEY_VERSION: * * A key to get the operating system version suitable for presentation to the user, e.g. "42 (Foo)" * * Since: 2.64 */ #define G_OS_INFO_KEY_VERSION \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "VERSION" /** * G_OS_INFO_KEY_VERSION_CODENAME: * * A key to get a codename identifying the operating system release suitable for processing by scripts or usage in generated filenames, e.g. "foo" * * Since: 2.64 */ #define G_OS_INFO_KEY_VERSION_CODENAME \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "VERSION_CODENAME" /** * G_OS_INFO_KEY_VERSION_ID: * * A key to get the version of the operating system suitable for processing by scripts or usage in generated filenames, e.g. "42" * * Since: 2.64 */ #define G_OS_INFO_KEY_VERSION_ID \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "VERSION_ID" /** * G_OS_INFO_KEY_ID: * * A key to get an ID identifying the operating system suitable for processing by scripts or usage in generated filenames, e.g. "yoyoos" * * Since: 2.64 */ #define G_OS_INFO_KEY_ID \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "ID" /** * G_OS_INFO_KEY_HOME_URL: * * A key to get the homepage for the operating system, e.g. "https://www.yoyo-os.com/" * * Since: 2.64 */ #define G_OS_INFO_KEY_HOME_URL \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "HOME_URL" /** * G_OS_INFO_KEY_DOCUMENTATION_URL: * * A key to get the documentation page for the operating system, e.g. "https://docs.yoyo-os.com/" * * Since: 2.64 */ #define G_OS_INFO_KEY_DOCUMENTATION_URL \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "DOCUMENTATION_URL" /** * G_OS_INFO_KEY_SUPPORT_URL: * * A key to get the support page for the operating system, e.g. "https://support.yoyo-os.com/" * * Since: 2.64 */ #define G_OS_INFO_KEY_SUPPORT_URL \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "SUPPORT_URL" /** * G_OS_INFO_KEY_BUG_REPORT_URL: * * A key to get the bug reporting page for the operating system, e.g. "https://bugs.yoyo-os.com/" * * Since: 2.64 */ #define G_OS_INFO_KEY_BUG_REPORT_URL \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "BUG_REPORT_URL" /** * G_OS_INFO_KEY_PRIVACY_POLICY_URL: * * A key to get the privacy policy for the operating system, e.g. "https://privacy.yoyo-os.com/" * * Since: 2.64 */ #define G_OS_INFO_KEY_PRIVACY_POLICY_URL \ GLIB_AVAILABLE_MACRO_IN_2_64 \ "PRIVACY_POLICY_URL" GLIB_AVAILABLE_IN_ALL void g_reload_user_special_dirs_cache (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_data_dir (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_config_dir (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_cache_dir (void); GLIB_AVAILABLE_IN_ALL const gchar * const * g_get_system_data_dirs (void); #ifdef G_OS_WIN32 /* This function is not part of the public GLib API */ GLIB_AVAILABLE_IN_ALL const gchar * const * g_win32_get_system_data_dirs_for_module (void (*address_of_function)(void)); #endif #if defined (G_OS_WIN32) && defined (G_CAN_INLINE) /* This function is not part of the public GLib API either. Just call * g_get_system_data_dirs() in your code, never mind that that is * actually a macro and you will in fact call this inline function. */ static inline const gchar * const * _g_win32_get_system_data_dirs (void) { return g_win32_get_system_data_dirs_for_module ((void (*)(void)) &_g_win32_get_system_data_dirs); } #define g_get_system_data_dirs _g_win32_get_system_data_dirs #endif GLIB_AVAILABLE_IN_ALL const gchar * const * g_get_system_config_dirs (void); GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_runtime_dir (void); /** * GUserDirectory: * @G_USER_DIRECTORY_DESKTOP: the user's Desktop directory * @G_USER_DIRECTORY_DOCUMENTS: the user's Documents directory * @G_USER_DIRECTORY_DOWNLOAD: the user's Downloads directory * @G_USER_DIRECTORY_MUSIC: the user's Music directory * @G_USER_DIRECTORY_PICTURES: the user's Pictures directory * @G_USER_DIRECTORY_PUBLIC_SHARE: the user's shared directory * @G_USER_DIRECTORY_TEMPLATES: the user's Templates directory * @G_USER_DIRECTORY_VIDEOS: the user's Movies directory * @G_USER_N_DIRECTORIES: the number of enum values * * These are logical ids for special directories which are defined * depending on the platform used. You should use g_get_user_special_dir() * to retrieve the full path associated to the logical id. * * The #GUserDirectory enumeration can be extended at later date. Not * every platform has a directory for every logical id in this * enumeration. * * Since: 2.14 */ typedef enum { G_USER_DIRECTORY_DESKTOP, G_USER_DIRECTORY_DOCUMENTS, G_USER_DIRECTORY_DOWNLOAD, G_USER_DIRECTORY_MUSIC, G_USER_DIRECTORY_PICTURES, G_USER_DIRECTORY_PUBLIC_SHARE, G_USER_DIRECTORY_TEMPLATES, G_USER_DIRECTORY_VIDEOS, G_USER_N_DIRECTORIES } GUserDirectory; GLIB_AVAILABLE_IN_ALL const gchar * g_get_user_special_dir (GUserDirectory directory); /** * GDebugKey: * @key: the string * @value: the flag * * Associates a string with a bit flag. * Used in g_parse_debug_string(). */ typedef struct _GDebugKey GDebugKey; struct _GDebugKey { const gchar *key; guint value; }; /* Miscellaneous utility functions */ GLIB_AVAILABLE_IN_ALL guint g_parse_debug_string (const gchar *string, const GDebugKey *keys, guint nkeys); GLIB_AVAILABLE_IN_ALL gint g_snprintf (gchar *string, gulong n, gchar const *format, ...) G_GNUC_PRINTF (3, 4); GLIB_AVAILABLE_IN_ALL gint g_vsnprintf (gchar *string, gulong n, gchar const *format, va_list args) G_GNUC_PRINTF(3, 0); GLIB_AVAILABLE_IN_ALL void g_nullify_pointer (gpointer *nullify_location); typedef enum { G_FORMAT_SIZE_DEFAULT = 0, G_FORMAT_SIZE_LONG_FORMAT = 1 << 0, G_FORMAT_SIZE_IEC_UNITS = 1 << 1, G_FORMAT_SIZE_BITS = 1 << 2 } GFormatSizeFlags; GLIB_AVAILABLE_IN_2_30 gchar *g_format_size_full (guint64 size, GFormatSizeFlags flags); GLIB_AVAILABLE_IN_2_30 gchar *g_format_size (guint64 size); GLIB_DEPRECATED_IN_2_30_FOR(g_format_size) gchar *g_format_size_for_display (goffset size); #define g_ATEXIT(proc) (atexit (proc)) GLIB_DEPRECATED_MACRO_IN_2_32 #define g_memmove(dest,src,len) \ G_STMT_START { memmove ((dest), (src), (len)); } G_STMT_END GLIB_DEPRECATED_MACRO_IN_2_40_FOR(memmove) /** * GVoidFunc: * * Declares a type of function which takes no arguments * and has no return value. It is used to specify the type * function passed to g_atexit(). */ typedef void (*GVoidFunc) (void) GLIB_DEPRECATED_TYPE_IN_2_32; #define ATEXIT(proc) g_ATEXIT(proc) GLIB_DEPRECATED_MACRO_IN_2_32 G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED void g_atexit (GVoidFunc func); G_GNUC_END_IGNORE_DEPRECATIONS #ifdef G_OS_WIN32 /* It's a bad idea to wrap atexit() on Windows. If the GLib DLL calls * atexit(), the function will be called when the GLib DLL is detached * from the program, which is not what the caller wants. The caller * wants the function to be called when it *itself* exits (or is * detached, in case the caller, too, is a DLL). */ #if (defined(__MINGW_H) && !defined(_STDLIB_H_)) || (defined(_MSC_VER) && !defined(_INC_STDLIB)) int atexit (void (*)(void)); #endif #define g_atexit(func) atexit(func) GLIB_DEPRECATED_MACRO_IN_2_32 #endif /* Look for an executable in PATH, following execvp() rules */ GLIB_AVAILABLE_IN_ALL gchar* g_find_program_in_path (const gchar *program); /* Bit tests * * These are defined in a convoluted way because we want the compiler to * be able to inline the code for performance reasons, but for * historical reasons, we must continue to provide non-inline versions * on our ABI. * * We define these as functions in gutils.c which are just implemented * as calls to the _impl() versions in order to preserve the ABI. */ #define g_bit_nth_lsf(mask, nth_bit) g_bit_nth_lsf_impl(mask, nth_bit) #define g_bit_nth_msf(mask, nth_bit) g_bit_nth_msf_impl(mask, nth_bit) #define g_bit_storage(number) g_bit_storage_impl(number) GLIB_AVAILABLE_IN_ALL gint (g_bit_nth_lsf) (gulong mask, gint nth_bit); GLIB_AVAILABLE_IN_ALL gint (g_bit_nth_msf) (gulong mask, gint nth_bit); GLIB_AVAILABLE_IN_ALL guint (g_bit_storage) (gulong number); static inline gint g_bit_nth_lsf_impl (gulong mask, gint nth_bit) { if (G_UNLIKELY (nth_bit < -1)) nth_bit = -1; while (nth_bit < ((GLIB_SIZEOF_LONG * 8) - 1)) { nth_bit++; if (mask & (1UL << nth_bit)) return nth_bit; } return -1; } static inline gint g_bit_nth_msf_impl (gulong mask, gint nth_bit) { if (nth_bit < 0 || G_UNLIKELY (nth_bit > GLIB_SIZEOF_LONG * 8)) nth_bit = GLIB_SIZEOF_LONG * 8; while (nth_bit > 0) { nth_bit--; if (mask & (1UL << nth_bit)) return nth_bit; } return -1; } static inline guint g_bit_storage_impl (gulong number) { #if defined(__GNUC__) && (__GNUC__ >= 4) && defined(__OPTIMIZE__) return G_LIKELY (number) ? ((GLIB_SIZEOF_LONG * 8U - 1) ^ (guint) __builtin_clzl(number)) + 1 : 1; #else guint n_bits = 0; do { n_bits++; number >>= 1; } while (number); return n_bits; #endif } /* Crashes the program. */ #if GLIB_VERSION_MAX_ALLOWED >= GLIB_VERSION_2_50 #ifndef G_OS_WIN32 # include <stdlib.h> # define g_abort() abort () #else GLIB_AVAILABLE_IN_2_50 G_NORETURN void g_abort (void) G_ANALYZER_NORETURN; #endif #endif /* * This macro is deprecated. This DllMain() is too complex. It is * recommended to write an explicit minimal DLlMain() that just saves * the handle to the DLL and then use that handle instead, for * instance passing it to * g_win32_get_package_installation_directory_of_module(). * * On Windows, this macro defines a DllMain function that stores the * actual DLL name that the code being compiled will be included in. * STATIC should be empty or 'static'. DLL_NAME is the name of the * (pointer to the) char array where the DLL name will be stored. If * this is used, you must also include <windows.h>. If you need a more complex * DLL entry point function, you cannot use this. * * On non-Windows platforms, expands to nothing. */ #ifndef G_PLATFORM_WIN32 # define G_WIN32_DLLMAIN_FOR_DLL_NAME(static, dll_name) GLIB_DEPRECATED_MACRO_IN_2_26 #else # define G_WIN32_DLLMAIN_FOR_DLL_NAME(static, dll_name) \ static char *dll_name; \ \ BOOL WINAPI \ DllMain (HINSTANCE hinstDLL, \ DWORD fdwReason, \ LPVOID lpvReserved) \ { \ wchar_t wcbfr[1000]; \ char *tem; \ switch (fdwReason) \ { \ case DLL_PROCESS_ATTACH: \ GetModuleFileNameW ((HMODULE) hinstDLL, wcbfr, G_N_ELEMENTS (wcbfr)); \ tem = g_utf16_to_utf8 (wcbfr, -1, NULL, NULL, NULL); \ dll_name = g_path_get_basename (tem); \ g_free (tem); \ break; \ } \ \ return TRUE; \ } GLIB_DEPRECATED_MACRO_IN_2_26 #endif /* G_PLATFORM_WIN32 */ G_END_DECLS #endif /* __G_UTILS_H__ */ glib/gchecksum.h 0000644 00000007430 15125173651 0007615 0 ustar 00 /* gchecksum.h - data hashing functions * * Copyright (C) 2007 Emmanuele Bassi <ebassi@gnome.org> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_CHECKSUM_H__ #define __G_CHECKSUM_H__ #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) #error "Only <glib.h> can be included directly." #endif #include <glib/gtypes.h> #include <glib/gbytes.h> G_BEGIN_DECLS /** * GChecksumType: * @G_CHECKSUM_MD5: Use the MD5 hashing algorithm * @G_CHECKSUM_SHA1: Use the SHA-1 hashing algorithm * @G_CHECKSUM_SHA256: Use the SHA-256 hashing algorithm * @G_CHECKSUM_SHA384: Use the SHA-384 hashing algorithm (Since: 2.51) * @G_CHECKSUM_SHA512: Use the SHA-512 hashing algorithm (Since: 2.36) * * The hashing algorithm to be used by #GChecksum when performing the * digest of some data. * * Note that the #GChecksumType enumeration may be extended at a later * date to include new hashing algorithm types. * * Since: 2.16 */ typedef enum { G_CHECKSUM_MD5, G_CHECKSUM_SHA1, G_CHECKSUM_SHA256, G_CHECKSUM_SHA512, G_CHECKSUM_SHA384 } GChecksumType; /** * GChecksum: * * An opaque structure representing a checksumming operation. * To create a new GChecksum, use g_checksum_new(). To free * a GChecksum, use g_checksum_free(). * * Since: 2.16 */ typedef struct _GChecksum GChecksum; GLIB_AVAILABLE_IN_ALL gssize g_checksum_type_get_length (GChecksumType checksum_type); GLIB_AVAILABLE_IN_ALL GChecksum * g_checksum_new (GChecksumType checksum_type); GLIB_AVAILABLE_IN_ALL void g_checksum_reset (GChecksum *checksum); GLIB_AVAILABLE_IN_ALL GChecksum * g_checksum_copy (const GChecksum *checksum); GLIB_AVAILABLE_IN_ALL void g_checksum_free (GChecksum *checksum); GLIB_AVAILABLE_IN_ALL void g_checksum_update (GChecksum *checksum, const guchar *data, gssize length); GLIB_AVAILABLE_IN_ALL const gchar * g_checksum_get_string (GChecksum *checksum); GLIB_AVAILABLE_IN_ALL void g_checksum_get_digest (GChecksum *checksum, guint8 *buffer, gsize *digest_len); GLIB_AVAILABLE_IN_ALL gchar *g_compute_checksum_for_data (GChecksumType checksum_type, const guchar *data, gsize length); GLIB_AVAILABLE_IN_ALL gchar *g_compute_checksum_for_string (GChecksumType checksum_type, const gchar *str, gssize length); GLIB_AVAILABLE_IN_2_34 gchar *g_compute_checksum_for_bytes (GChecksumType checksum_type, GBytes *data); G_END_DECLS #endif /* __G_CHECKSUM_H__ */ glib/gprintf.h 0000644 00000003700 15125173651 0007311 0 ustar 00 /* GLIB - Library of useful routines for C programming * Copyright (C) 1995-1997, 2002 Peter Mattis, Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_PRINTF_H__ #define __G_PRINTF_H__ #include <glib.h> #include <stdio.h> #include <stdarg.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL gint g_printf (gchar const *format, ...) G_GNUC_PRINTF (1, 2); GLIB_AVAILABLE_IN_ALL gint g_fprintf (FILE *file, gchar const *format, ...) G_GNUC_PRINTF (2, 3); GLIB_AVAILABLE_IN_ALL gint g_sprintf (gchar *string, gchar const *format, ...) G_GNUC_PRINTF (2, 3); GLIB_AVAILABLE_IN_ALL gint g_vprintf (gchar const *format, va_list args) G_GNUC_PRINTF(1, 0); GLIB_AVAILABLE_IN_ALL gint g_vfprintf (FILE *file, gchar const *format, va_list args) G_GNUC_PRINTF(2, 0); GLIB_AVAILABLE_IN_ALL gint g_vsprintf (gchar *string, gchar const *format, va_list args) G_GNUC_PRINTF(2, 0); GLIB_AVAILABLE_IN_ALL gint g_vasprintf (gchar **string, gchar const *format, va_list args) G_GNUC_PRINTF(2, 0); G_END_DECLS #endif /* __G_PRINTF_H__ */ glib-object.h 0000644 00000002666 15125173651 0007116 0 ustar 00 /* GObject - GLib Type, Object, Parameter and Signal Library * Copyright (C) 1998, 1999, 2000 Tim Janik and Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __GLIB_GOBJECT_H__ #define __GLIB_GOBJECT_H__ #define __GLIB_GOBJECT_H_INSIDE__ #include <gobject/gbinding.h> #include <gobject/gboxed.h> #include <gobject/genums.h> #include <gobject/glib-enumtypes.h> #include <gobject/gobject.h> #include <gobject/gparam.h> #include <gobject/gparamspecs.h> #include <gobject/gsignal.h> #include <gobject/gsourceclosure.h> #include <gobject/gtype.h> #include <gobject/gtypemodule.h> #include <gobject/gtypeplugin.h> #include <gobject/gvaluearray.h> #include <gobject/gvalue.h> #include <gobject/gvaluetypes.h> #include <gobject/gobject-autocleanups.h> #undef __GLIB_GOBJECT_H_INSIDE__ #endif /* __GLIB_GOBJECT_H__ */ glib-unix.h 0000644 00000010555 15125173651 0006627 0 ustar 00 /* glib-unix.h - Unix specific integration * Copyright (C) 2011 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_UNIX_H__ #define __G_UNIX_H__ /* We need to include the UNIX headers needed to use the APIs below, * but we also take this opportunity to include a wide selection of * other UNIX headers. If one of the headers below is broken on some * system, work around it here (or better, fix the system or tell * people to use a better one). */ #include <unistd.h> #include <errno.h> #include <sys/wait.h> #include <stdlib.h> #include <fcntl.h> #include <glib.h> #ifndef G_OS_UNIX #error "This header may only be used on UNIX" #endif G_BEGIN_DECLS /** * G_UNIX_ERROR: * * Error domain for API in the g_unix_ namespace. Note that there is no * exported enumeration mapping %errno. Instead, all functions ensure that * %errno is relevant. The code for all #G_UNIX_ERROR is always 0, and the * error message is always generated via g_strerror(). * * It is expected that most code will not look at %errno from these APIs. * Important cases where one would want to differentiate between errors are * already covered by existing cross-platform GLib API, such as e.g. #GFile * wrapping `ENOENT`. However, it is provided for completeness, at least. */ #define G_UNIX_ERROR (g_unix_error_quark()) GLIB_AVAILABLE_IN_2_30 GQuark g_unix_error_quark (void); GLIB_AVAILABLE_IN_2_30 gboolean g_unix_open_pipe (gint *fds, gint flags, GError **error); GLIB_AVAILABLE_IN_2_30 gboolean g_unix_set_fd_nonblocking (gint fd, gboolean nonblock, GError **error); GLIB_AVAILABLE_IN_2_30 GSource *g_unix_signal_source_new (gint signum); GLIB_AVAILABLE_IN_2_30 guint g_unix_signal_add_full (gint priority, gint signum, GSourceFunc handler, gpointer user_data, GDestroyNotify notify); GLIB_AVAILABLE_IN_2_30 guint g_unix_signal_add (gint signum, GSourceFunc handler, gpointer user_data); /** * GUnixFDSourceFunc: * @fd: the fd that triggered the event * @condition: the IO conditions reported on @fd * @user_data: user data passed to g_unix_fd_add() * * The type of functions to be called when a UNIX fd watch source * triggers. * * Returns: %FALSE if the source should be removed **/ typedef gboolean (*GUnixFDSourceFunc) (gint fd, GIOCondition condition, gpointer user_data); GLIB_AVAILABLE_IN_2_36 GSource *g_unix_fd_source_new (gint fd, GIOCondition condition); GLIB_AVAILABLE_IN_2_36 guint g_unix_fd_add_full (gint priority, gint fd, GIOCondition condition, GUnixFDSourceFunc function, gpointer user_data, GDestroyNotify notify); GLIB_AVAILABLE_IN_2_36 guint g_unix_fd_add (gint fd, GIOCondition condition, GUnixFDSourceFunc function, gpointer user_data); GLIB_AVAILABLE_IN_2_64 struct passwd *g_unix_get_passwd_entry (const gchar *user_name, GError **error); G_END_DECLS #endif /* __G_UNIX_H__ */ gio/gsimpleproxyresolver.h 0000644 00000006713 15125173651 0012034 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright 2010, 2013 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SIMPLE_PROXY_RESOLVER_H__ #define __G_SIMPLE_PROXY_RESOLVER_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gproxyresolver.h> G_BEGIN_DECLS #define G_TYPE_SIMPLE_PROXY_RESOLVER (g_simple_proxy_resolver_get_type ()) #define G_SIMPLE_PROXY_RESOLVER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_SIMPLE_PROXY_RESOLVER, GSimpleProxyResolver)) #define G_SIMPLE_PROXY_RESOLVER_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_SIMPLE_PROXY_RESOLVER, GSimpleProxyResolverClass)) #define G_IS_SIMPLE_PROXY_RESOLVER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_SIMPLE_PROXY_RESOLVER)) #define G_IS_SIMPLE_PROXY_RESOLVER_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_SIMPLE_PROXY_RESOLVER)) #define G_SIMPLE_PROXY_RESOLVER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_SIMPLE_PROXY_RESOLVER, GSimpleProxyResolverClass)) /** * GSimpleProxyResolver: * * A #GProxyResolver implementation for using a fixed set of proxies. **/ typedef struct _GSimpleProxyResolver GSimpleProxyResolver; typedef struct _GSimpleProxyResolverPrivate GSimpleProxyResolverPrivate; typedef struct _GSimpleProxyResolverClass GSimpleProxyResolverClass; struct _GSimpleProxyResolver { GObject parent_instance; /*< private >*/ GSimpleProxyResolverPrivate *priv; }; struct _GSimpleProxyResolverClass { GObjectClass parent_class; /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); }; GLIB_AVAILABLE_IN_2_36 GType g_simple_proxy_resolver_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_36 GProxyResolver *g_simple_proxy_resolver_new (const gchar *default_proxy, gchar **ignore_hosts); GLIB_AVAILABLE_IN_2_36 void g_simple_proxy_resolver_set_default_proxy (GSimpleProxyResolver *resolver, const gchar *default_proxy); GLIB_AVAILABLE_IN_2_36 void g_simple_proxy_resolver_set_ignore_hosts (GSimpleProxyResolver *resolver, gchar **ignore_hosts); GLIB_AVAILABLE_IN_2_36 void g_simple_proxy_resolver_set_uri_proxy (GSimpleProxyResolver *resolver, const gchar *uri_scheme, const gchar *proxy); G_END_DECLS #endif /* __G_SIMPLE_PROXY_RESOLVER_H__ */ gio/gemblemedicon.h 0000644 00000005344 15125173651 0010301 0 ustar 00 /* Gio - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Matthias Clasen <mclasen@redhat.com> * Clemens N. Buss <cebuzz@gmail.com> */ #ifndef __G_EMBLEMED_ICON_H__ #define __G_EMBLEMED_ICON_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gicon.h> #include <gio/gemblem.h> G_BEGIN_DECLS #define G_TYPE_EMBLEMED_ICON (g_emblemed_icon_get_type ()) #define G_EMBLEMED_ICON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_EMBLEMED_ICON, GEmblemedIcon)) #define G_EMBLEMED_ICON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_EMBLEMED_ICON, GEmblemedIconClass)) #define G_IS_EMBLEMED_ICON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_EMBLEMED_ICON)) #define G_IS_EMBLEMED_ICON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_EMBLEMED_ICON)) #define G_EMBLEMED_ICON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_EMBLEMED_ICON, GEmblemedIconClass)) /** * GEmblemedIcon: * * An implementation of #GIcon for icons with emblems. **/ typedef struct _GEmblemedIcon GEmblemedIcon; typedef struct _GEmblemedIconClass GEmblemedIconClass; typedef struct _GEmblemedIconPrivate GEmblemedIconPrivate; struct _GEmblemedIcon { GObject parent_instance; /*< private >*/ GEmblemedIconPrivate *priv; }; struct _GEmblemedIconClass { GObjectClass parent_class; }; GLIB_AVAILABLE_IN_ALL GType g_emblemed_icon_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GIcon *g_emblemed_icon_new (GIcon *icon, GEmblem *emblem); GLIB_AVAILABLE_IN_ALL GIcon *g_emblemed_icon_get_icon (GEmblemedIcon *emblemed); GLIB_AVAILABLE_IN_ALL GList *g_emblemed_icon_get_emblems (GEmblemedIcon *emblemed); GLIB_AVAILABLE_IN_ALL void g_emblemed_icon_add_emblem (GEmblemedIcon *emblemed, GEmblem *emblem); GLIB_AVAILABLE_IN_ALL void g_emblemed_icon_clear_emblems (GEmblemedIcon *emblemed); G_END_DECLS #endif /* __G_EMBLEMED_ICON_H__ */ gio/gsimpleaction.h 0000644 00000005543 15125173651 0010346 0 ustar 00 /* * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_SIMPLE_ACTION_H__ #define __G_SIMPLE_ACTION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SIMPLE_ACTION (g_simple_action_get_type ()) #define G_SIMPLE_ACTION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SIMPLE_ACTION, GSimpleAction)) #define G_IS_SIMPLE_ACTION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_SIMPLE_ACTION)) GLIB_AVAILABLE_IN_ALL GType g_simple_action_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSimpleAction * g_simple_action_new (const gchar *name, const GVariantType *parameter_type); GLIB_AVAILABLE_IN_ALL GSimpleAction * g_simple_action_new_stateful (const gchar *name, const GVariantType *parameter_type, GVariant *state); GLIB_AVAILABLE_IN_ALL void g_simple_action_set_enabled (GSimpleAction *simple, gboolean enabled); GLIB_AVAILABLE_IN_2_30 void g_simple_action_set_state (GSimpleAction *simple, GVariant *value); GLIB_AVAILABLE_IN_2_44 void g_simple_action_set_state_hint (GSimpleAction *simple, GVariant *state_hint); G_END_DECLS #endif /* __G_SIMPLE_ACTION_H__ */ gio/gsubprocesslauncher.h 0000644 00000014601 15125173651 0011564 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2012,2013 Colin Walters <walters@verbum.org> * Copyright © 2012,2013 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> * Author: Colin Walters <walters@verbum.org> */ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #ifndef __G_SUBPROCESS_LAUNCHER_H__ #define __G_SUBPROCESS_LAUNCHER_H__ #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SUBPROCESS_LAUNCHER (g_subprocess_launcher_get_type ()) #define G_SUBPROCESS_LAUNCHER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_SUBPROCESS_LAUNCHER, GSubprocessLauncher)) #define G_IS_SUBPROCESS_LAUNCHER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_SUBPROCESS_LAUNCHER)) GLIB_AVAILABLE_IN_2_40 GType g_subprocess_launcher_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_40 GSubprocessLauncher * g_subprocess_launcher_new (GSubprocessFlags flags); GLIB_AVAILABLE_IN_2_40 GSubprocess * g_subprocess_launcher_spawn (GSubprocessLauncher *self, GError **error, const gchar *argv0, ...) G_GNUC_NULL_TERMINATED; GLIB_AVAILABLE_IN_2_40 GSubprocess * g_subprocess_launcher_spawnv (GSubprocessLauncher *self, const gchar * const *argv, GError **error); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_environ (GSubprocessLauncher *self, gchar **env); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_setenv (GSubprocessLauncher *self, const gchar *variable, const gchar *value, gboolean overwrite); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_unsetenv (GSubprocessLauncher *self, const gchar *variable); GLIB_AVAILABLE_IN_2_40 const gchar * g_subprocess_launcher_getenv (GSubprocessLauncher *self, const gchar *variable); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_cwd (GSubprocessLauncher *self, const gchar *cwd); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_flags (GSubprocessLauncher *self, GSubprocessFlags flags); /* Extended I/O control, only available on UNIX */ #ifdef G_OS_UNIX GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_stdin_file_path (GSubprocessLauncher *self, const gchar *path); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_take_stdin_fd (GSubprocessLauncher *self, gint fd); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_stdout_file_path (GSubprocessLauncher *self, const gchar *path); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_take_stdout_fd (GSubprocessLauncher *self, gint fd); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_stderr_file_path (GSubprocessLauncher *self, const gchar *path); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_take_stderr_fd (GSubprocessLauncher *self, gint fd); GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_take_fd (GSubprocessLauncher *self, gint source_fd, gint target_fd); GLIB_AVAILABLE_IN_2_68 void g_subprocess_launcher_close (GSubprocessLauncher *self); /* Child setup, only available on UNIX */ GLIB_AVAILABLE_IN_2_40 void g_subprocess_launcher_set_child_setup (GSubprocessLauncher *self, GSpawnChildSetupFunc child_setup, gpointer user_data, GDestroyNotify destroy_notify); #endif G_END_DECLS #endif /* __G_SUBPROCESS_H__ */ gio/gconverteroutputstream.h 0000644 00000005756 15125173651 0012371 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2009 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_CONVERTER_OUTPUT_STREAM_H__ #define __G_CONVERTER_OUTPUT_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gfilteroutputstream.h> #include <gio/gconverter.h> G_BEGIN_DECLS #define G_TYPE_CONVERTER_OUTPUT_STREAM (g_converter_output_stream_get_type ()) #define G_CONVERTER_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_CONVERTER_OUTPUT_STREAM, GConverterOutputStream)) #define G_CONVERTER_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_CONVERTER_OUTPUT_STREAM, GConverterOutputStreamClass)) #define G_IS_CONVERTER_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_CONVERTER_OUTPUT_STREAM)) #define G_IS_CONVERTER_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CONVERTER_OUTPUT_STREAM)) #define G_CONVERTER_OUTPUT_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CONVERTER_OUTPUT_STREAM, GConverterOutputStreamClass)) /** * GConverterOutputStream: * * An implementation of #GFilterOutputStream that allows data * conversion. **/ typedef struct _GConverterOutputStreamClass GConverterOutputStreamClass; typedef struct _GConverterOutputStreamPrivate GConverterOutputStreamPrivate; struct _GConverterOutputStream { GFilterOutputStream parent_instance; /*< private >*/ GConverterOutputStreamPrivate *priv; }; struct _GConverterOutputStreamClass { GFilterOutputStreamClass parent_class; /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); }; GLIB_AVAILABLE_IN_ALL GType g_converter_output_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GOutputStream *g_converter_output_stream_new (GOutputStream *base_stream, GConverter *converter); GLIB_AVAILABLE_IN_ALL GConverter *g_converter_output_stream_get_converter (GConverterOutputStream *converter_stream); G_END_DECLS #endif /* __G_CONVERTER_OUTPUT_STREAM_H__ */ gio/gasyncinitable.h 0000644 00000010507 15125173651 0010500 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2009 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_ASYNC_INITABLE_H__ #define __G_ASYNC_INITABLE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> #include <gio/ginitable.h> G_BEGIN_DECLS #define G_TYPE_ASYNC_INITABLE (g_async_initable_get_type ()) #define G_ASYNC_INITABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_ASYNC_INITABLE, GAsyncInitable)) #define G_IS_ASYNC_INITABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_ASYNC_INITABLE)) #define G_ASYNC_INITABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_ASYNC_INITABLE, GAsyncInitableIface)) #define G_TYPE_IS_ASYNC_INITABLE(type) (g_type_is_a ((type), G_TYPE_ASYNC_INITABLE)) /** * GAsyncInitable: * * Interface for asynchronously initializable objects. * * Since: 2.22 **/ typedef struct _GAsyncInitableIface GAsyncInitableIface; /** * GAsyncInitableIface: * @g_iface: The parent interface. * @init_async: Starts initialization of the object. * @init_finish: Finishes initialization of the object. * * Provides an interface for asynchronous initializing object such that * initialization may fail. * * Since: 2.22 **/ struct _GAsyncInitableIface { GTypeInterface g_iface; /* Virtual Table */ void (* init_async) (GAsyncInitable *initable, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean (* init_finish) (GAsyncInitable *initable, GAsyncResult *res, GError **error); }; GLIB_AVAILABLE_IN_ALL GType g_async_initable_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL void g_async_initable_init_async (GAsyncInitable *initable, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL gboolean g_async_initable_init_finish (GAsyncInitable *initable, GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_ALL void g_async_initable_new_async (GType object_type, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data, const gchar *first_property_name, ...); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_54_FOR(g_object_new_with_properties and g_async_initable_init_async) void g_async_initable_newv_async (GType object_type, guint n_parameters, GParameter *parameters, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL void g_async_initable_new_valist_async (GType object_type, const gchar *first_property_name, va_list var_args, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GObject *g_async_initable_new_finish (GAsyncInitable *initable, GAsyncResult *res, GError **error); G_END_DECLS #endif /* __G_ASYNC_INITABLE_H__ */ gio/gsimpleasyncresult.h 0000644 00000017201 15125173651 0011437 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_SIMPLE_ASYNC_RESULT_H__ #define __G_SIMPLE_ASYNC_RESULT_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SIMPLE_ASYNC_RESULT (g_simple_async_result_get_type ()) #define G_SIMPLE_ASYNC_RESULT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_SIMPLE_ASYNC_RESULT, GSimpleAsyncResult)) #define G_SIMPLE_ASYNC_RESULT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_SIMPLE_ASYNC_RESULT, GSimpleAsyncResultClass)) #define G_IS_SIMPLE_ASYNC_RESULT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_SIMPLE_ASYNC_RESULT)) #define G_IS_SIMPLE_ASYNC_RESULT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_SIMPLE_ASYNC_RESULT)) #define G_SIMPLE_ASYNC_RESULT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_SIMPLE_ASYNC_RESULT, GSimpleAsyncResultClass)) /** * GSimpleAsyncResult: * * A simple implementation of #GAsyncResult. **/ typedef struct _GSimpleAsyncResultClass GSimpleAsyncResultClass; GLIB_AVAILABLE_IN_ALL GType g_simple_async_result_get_type (void) G_GNUC_CONST; GLIB_DEPRECATED_IN_2_46_FOR(g_task_new) GSimpleAsyncResult *g_simple_async_result_new (GObject *source_object, GAsyncReadyCallback callback, gpointer user_data, gpointer source_tag); GLIB_DEPRECATED_IN_2_46_FOR(g_task_new) GSimpleAsyncResult *g_simple_async_result_new_error (GObject *source_object, GAsyncReadyCallback callback, gpointer user_data, GQuark domain, gint code, const char *format, ...) G_GNUC_PRINTF (6, 7); GLIB_DEPRECATED_IN_2_46_FOR(g_task_new) GSimpleAsyncResult *g_simple_async_result_new_from_error (GObject *source_object, GAsyncReadyCallback callback, gpointer user_data, const GError *error); GLIB_DEPRECATED_IN_2_46_FOR(g_task_new) GSimpleAsyncResult *g_simple_async_result_new_take_error (GObject *source_object, GAsyncReadyCallback callback, gpointer user_data, GError *error); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_op_res_gpointer (GSimpleAsyncResult *simple, gpointer op_res, GDestroyNotify destroy_op_res); GLIB_DEPRECATED_IN_2_46 gpointer g_simple_async_result_get_op_res_gpointer (GSimpleAsyncResult *simple); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_op_res_gssize (GSimpleAsyncResult *simple, gssize op_res); GLIB_DEPRECATED_IN_2_46 gssize g_simple_async_result_get_op_res_gssize (GSimpleAsyncResult *simple); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_op_res_gboolean (GSimpleAsyncResult *simple, gboolean op_res); GLIB_DEPRECATED_IN_2_46 gboolean g_simple_async_result_get_op_res_gboolean (GSimpleAsyncResult *simple); GLIB_AVAILABLE_IN_2_32 /* Also deprecated, but can't mark something both AVAILABLE and DEPRECATED */ void g_simple_async_result_set_check_cancellable (GSimpleAsyncResult *simple, GCancellable *check_cancellable); GLIB_DEPRECATED_IN_2_46 gpointer g_simple_async_result_get_source_tag (GSimpleAsyncResult *simple); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_handle_cancellation (GSimpleAsyncResult *simple, gboolean handle_cancellation); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_complete (GSimpleAsyncResult *simple); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_complete_in_idle (GSimpleAsyncResult *simple); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_run_in_thread (GSimpleAsyncResult *simple, GSimpleAsyncThreadFunc func, int io_priority, GCancellable *cancellable); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_from_error (GSimpleAsyncResult *simple, const GError *error); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_take_error (GSimpleAsyncResult *simple, GError *error); GLIB_DEPRECATED_IN_2_46 gboolean g_simple_async_result_propagate_error (GSimpleAsyncResult *simple, GError **dest); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_error (GSimpleAsyncResult *simple, GQuark domain, gint code, const char *format, ...) G_GNUC_PRINTF (4, 5); GLIB_DEPRECATED_IN_2_46 void g_simple_async_result_set_error_va (GSimpleAsyncResult *simple, GQuark domain, gint code, const char *format, va_list args) G_GNUC_PRINTF(4, 0); GLIB_DEPRECATED_IN_2_46 gboolean g_simple_async_result_is_valid (GAsyncResult *result, GObject *source, gpointer source_tag); GLIB_DEPRECATED_IN_2_46_FOR(g_task_report_error) void g_simple_async_report_error_in_idle (GObject *object, GAsyncReadyCallback callback, gpointer user_data, GQuark domain, gint code, const char *format, ...) G_GNUC_PRINTF(6, 7); GLIB_DEPRECATED_IN_2_46_FOR(g_task_report_error) void g_simple_async_report_gerror_in_idle (GObject *object, GAsyncReadyCallback callback, gpointer user_data, const GError *error); GLIB_DEPRECATED_IN_2_46_FOR(g_task_report_error) void g_simple_async_report_take_gerror_in_idle (GObject *object, GAsyncReadyCallback callback, gpointer user_data, GError *error); G_END_DECLS #endif /* __G_SIMPLE_ASYNC_RESULT_H__ */ gio/gfileiostream.h 0000644 00000011661 15125173651 0010340 0 ustar 00 /* GIO - GLib Input, Io and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_FILE_IO_STREAM_H__ #define __G_FILE_IO_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giostream.h> G_BEGIN_DECLS #define G_TYPE_FILE_IO_STREAM (g_file_io_stream_get_type ()) #define G_FILE_IO_STREAM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_IO_STREAM, GFileIOStream)) #define G_FILE_IO_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_IO_STREAM, GFileIOStreamClass)) #define G_IS_FILE_IO_STREAM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_IO_STREAM)) #define G_IS_FILE_IO_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_IO_STREAM)) #define G_FILE_IO_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_IO_STREAM, GFileIOStreamClass)) /** * GFileIOStream: * * A subclass of GIOStream for opened files. This adds * a few file-specific operations and seeking and truncating. * * #GFileIOStream implements GSeekable. **/ typedef struct _GFileIOStreamClass GFileIOStreamClass; typedef struct _GFileIOStreamPrivate GFileIOStreamPrivate; struct _GFileIOStream { GIOStream parent_instance; /*< private >*/ GFileIOStreamPrivate *priv; }; struct _GFileIOStreamClass { GIOStreamClass parent_class; goffset (* tell) (GFileIOStream *stream); gboolean (* can_seek) (GFileIOStream *stream); gboolean (* seek) (GFileIOStream *stream, goffset offset, GSeekType type, GCancellable *cancellable, GError **error); gboolean (* can_truncate) (GFileIOStream *stream); gboolean (* truncate_fn) (GFileIOStream *stream, goffset size, GCancellable *cancellable, GError **error); GFileInfo * (* query_info) (GFileIOStream *stream, const char *attributes, GCancellable *cancellable, GError **error); void (* query_info_async) (GFileIOStream *stream, const char *attributes, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GFileInfo * (* query_info_finish) (GFileIOStream *stream, GAsyncResult *result, GError **error); char * (* get_etag) (GFileIOStream *stream); /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); }; GLIB_AVAILABLE_IN_ALL GType g_file_io_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GFileInfo *g_file_io_stream_query_info (GFileIOStream *stream, const char *attributes, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_file_io_stream_query_info_async (GFileIOStream *stream, const char *attributes, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GFileInfo *g_file_io_stream_query_info_finish (GFileIOStream *stream, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL char * g_file_io_stream_get_etag (GFileIOStream *stream); G_END_DECLS #endif /* __G_FILE_FILE_IO_STREAM_H__ */ gio/gasyncresult.h 0000644 00000005402 15125173651 0010225 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_ASYNC_RESULT_H__ #define __G_ASYNC_RESULT_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_ASYNC_RESULT (g_async_result_get_type ()) #define G_ASYNC_RESULT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_ASYNC_RESULT, GAsyncResult)) #define G_IS_ASYNC_RESULT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_ASYNC_RESULT)) #define G_ASYNC_RESULT_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_ASYNC_RESULT, GAsyncResultIface)) /** * GAsyncResult: * * Holds results information for an asynchronous operation, * usually passed directly to an asynchronous _finish() operation. **/ typedef struct _GAsyncResultIface GAsyncResultIface; /** * GAsyncResultIface: * @g_iface: The parent interface. * @get_user_data: Gets the user data passed to the callback. * @get_source_object: Gets the source object that issued the asynchronous operation. * @is_tagged: Checks if a result is tagged with a particular source. * * Interface definition for #GAsyncResult. **/ struct _GAsyncResultIface { GTypeInterface g_iface; /* Virtual Table */ gpointer (* get_user_data) (GAsyncResult *res); GObject * (* get_source_object) (GAsyncResult *res); gboolean (* is_tagged) (GAsyncResult *res, gpointer source_tag); }; GLIB_AVAILABLE_IN_ALL GType g_async_result_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gpointer g_async_result_get_user_data (GAsyncResult *res); GLIB_AVAILABLE_IN_ALL GObject *g_async_result_get_source_object (GAsyncResult *res); GLIB_AVAILABLE_IN_2_34 gboolean g_async_result_legacy_propagate_error (GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_2_34 gboolean g_async_result_is_tagged (GAsyncResult *res, gpointer source_tag); G_END_DECLS #endif /* __G_ASYNC_RESULT_H__ */ gio/gtlsinteraction.h 0000644 00000020215 15125173651 0010712 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2011 Collabora, Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Stef Walter <stefw@collabora.co.uk> */ #ifndef __G_TLS_INTERACTION_H__ #define __G_TLS_INTERACTION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_TLS_INTERACTION (g_tls_interaction_get_type ()) #define G_TLS_INTERACTION(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_TLS_INTERACTION, GTlsInteraction)) #define G_TLS_INTERACTION_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_TLS_INTERACTION, GTlsInteractionClass)) #define G_IS_TLS_INTERACTION(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_TLS_INTERACTION)) #define G_IS_TLS_INTERACTION_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_TLS_INTERACTION)) #define G_TLS_INTERACTION_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_TLS_INTERACTION, GTlsInteractionClass)) typedef struct _GTlsInteractionClass GTlsInteractionClass; typedef struct _GTlsInteractionPrivate GTlsInteractionPrivate; struct _GTlsInteraction { /*< private >*/ GObject parent_instance; GTlsInteractionPrivate *priv; }; struct _GTlsInteractionClass { /*< private >*/ GObjectClass parent_class; /*< public >*/ GTlsInteractionResult (* ask_password) (GTlsInteraction *interaction, GTlsPassword *password, GCancellable *cancellable, GError **error); void (* ask_password_async) (GTlsInteraction *interaction, GTlsPassword *password, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GTlsInteractionResult (* ask_password_finish) (GTlsInteraction *interaction, GAsyncResult *result, GError **error); GTlsInteractionResult (* request_certificate) (GTlsInteraction *interaction, GTlsConnection *connection, GTlsCertificateRequestFlags flags, GCancellable *cancellable, GError **error); void (* request_certificate_async) (GTlsInteraction *interaction, GTlsConnection *connection, GTlsCertificateRequestFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GTlsInteractionResult (* request_certificate_finish) (GTlsInteraction *interaction, GAsyncResult *result, GError **error); /*< private >*/ /* Padding for future expansion */ gpointer padding[21]; }; GLIB_AVAILABLE_IN_ALL GType g_tls_interaction_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GTlsInteractionResult g_tls_interaction_invoke_ask_password (GTlsInteraction *interaction, GTlsPassword *password, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL GTlsInteractionResult g_tls_interaction_ask_password (GTlsInteraction *interaction, GTlsPassword *password, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_tls_interaction_ask_password_async (GTlsInteraction *interaction, GTlsPassword *password, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GTlsInteractionResult g_tls_interaction_ask_password_finish (GTlsInteraction *interaction, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_2_40 GTlsInteractionResult g_tls_interaction_invoke_request_certificate (GTlsInteraction *interaction, GTlsConnection *connection, GTlsCertificateRequestFlags flags, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_40 GTlsInteractionResult g_tls_interaction_request_certificate (GTlsInteraction *interaction, GTlsConnection *connection, GTlsCertificateRequestFlags flags, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_40 void g_tls_interaction_request_certificate_async (GTlsInteraction *interaction, GTlsConnection *connection, GTlsCertificateRequestFlags flags, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_2_40 GTlsInteractionResult g_tls_interaction_request_certificate_finish (GTlsInteraction *interaction, GAsyncResult *result, GError **error); G_END_DECLS #endif /* __G_TLS_INTERACTION_H__ */ gio/gcredentials.h 0000644 00000006520 15125173651 0010150 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_CREDENTIALS_H__ #define __G_CREDENTIALS_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> #ifdef G_OS_UNIX /* To get the uid_t type */ #include <unistd.h> #include <sys/types.h> #endif G_BEGIN_DECLS #define G_TYPE_CREDENTIALS (g_credentials_get_type ()) #define G_CREDENTIALS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_CREDENTIALS, GCredentials)) #define G_CREDENTIALS_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_CREDENTIALS, GCredentialsClass)) #define G_CREDENTIALS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CREDENTIALS, GCredentialsClass)) #define G_IS_CREDENTIALS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_CREDENTIALS)) #define G_IS_CREDENTIALS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CREDENTIALS)) typedef struct _GCredentialsClass GCredentialsClass; GLIB_AVAILABLE_IN_ALL GType g_credentials_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GCredentials *g_credentials_new (void); GLIB_AVAILABLE_IN_ALL gchar *g_credentials_to_string (GCredentials *credentials); GLIB_AVAILABLE_IN_ALL gpointer g_credentials_get_native (GCredentials *credentials, GCredentialsType native_type); GLIB_AVAILABLE_IN_ALL void g_credentials_set_native (GCredentials *credentials, GCredentialsType native_type, gpointer native); GLIB_AVAILABLE_IN_ALL gboolean g_credentials_is_same_user (GCredentials *credentials, GCredentials *other_credentials, GError **error); #ifdef G_OS_UNIX GLIB_AVAILABLE_IN_2_36 pid_t g_credentials_get_unix_pid (GCredentials *credentials, GError **error); GLIB_AVAILABLE_IN_ALL uid_t g_credentials_get_unix_user (GCredentials *credentials, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_credentials_set_unix_user (GCredentials *credentials, uid_t uid, GError **error); #endif G_END_DECLS #endif /* __G_DBUS_PROXY_H__ */ gio/gsettings.h 0000644 00000051234 15125173651 0007515 0 ustar 00 /* * Copyright © 2009, 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_SETTINGS_H__ #define __G_SETTINGS_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gsettingsschema.h> #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SETTINGS (g_settings_get_type ()) #define G_SETTINGS(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SETTINGS, GSettings)) #define G_SETTINGS_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_SETTINGS, GSettingsClass)) #define G_IS_SETTINGS(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_SETTINGS)) #define G_IS_SETTINGS_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_SETTINGS)) #define G_SETTINGS_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_SETTINGS, GSettingsClass)) typedef struct _GSettingsPrivate GSettingsPrivate; typedef struct _GSettingsClass GSettingsClass; struct _GSettingsClass { GObjectClass parent_class; /* Signals */ void (*writable_changed) (GSettings *settings, const gchar *key); void (*changed) (GSettings *settings, const gchar *key); gboolean (*writable_change_event) (GSettings *settings, GQuark key); gboolean (*change_event) (GSettings *settings, const GQuark *keys, gint n_keys); gpointer padding[20]; }; struct _GSettings { GObject parent_instance; GSettingsPrivate *priv; }; GLIB_AVAILABLE_IN_ALL GType g_settings_get_type (void); GLIB_DEPRECATED_IN_2_40_FOR(g_settings_schema_source_list_schemas) const gchar * const * g_settings_list_schemas (void); GLIB_DEPRECATED_IN_2_40_FOR(g_settings_schema_source_list_schemas) const gchar * const * g_settings_list_relocatable_schemas (void); GLIB_AVAILABLE_IN_ALL GSettings * g_settings_new (const gchar *schema_id); GLIB_AVAILABLE_IN_ALL GSettings * g_settings_new_with_path (const gchar *schema_id, const gchar *path); GLIB_AVAILABLE_IN_ALL GSettings * g_settings_new_with_backend (const gchar *schema_id, GSettingsBackend *backend); GLIB_AVAILABLE_IN_ALL GSettings * g_settings_new_with_backend_and_path (const gchar *schema_id, GSettingsBackend *backend, const gchar *path); GLIB_AVAILABLE_IN_2_32 GSettings * g_settings_new_full (GSettingsSchema *schema, GSettingsBackend *backend, const gchar *path); GLIB_AVAILABLE_IN_ALL gchar ** g_settings_list_children (GSettings *settings); GLIB_DEPRECATED_IN_2_46_FOR(g_settings_schema_list_keys) gchar ** g_settings_list_keys (GSettings *settings); GLIB_DEPRECATED_IN_2_40_FOR(g_settings_schema_key_get_range) GVariant * g_settings_get_range (GSettings *settings, const gchar *key); GLIB_DEPRECATED_IN_2_40_FOR(g_settings_schema_key_range_check) gboolean g_settings_range_check (GSettings *settings, const gchar *key, GVariant *value); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_value (GSettings *settings, const gchar *key, GVariant *value); GLIB_AVAILABLE_IN_ALL GVariant * g_settings_get_value (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_2_40 GVariant * g_settings_get_user_value (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_2_40 GVariant * g_settings_get_default_value (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set (GSettings *settings, const gchar *key, const gchar *format, ...); GLIB_AVAILABLE_IN_ALL void g_settings_get (GSettings *settings, const gchar *key, const gchar *format, ...); GLIB_AVAILABLE_IN_ALL void g_settings_reset (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gint g_settings_get_int (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_int (GSettings *settings, const gchar *key, gint value); GLIB_AVAILABLE_IN_2_50 gint64 g_settings_get_int64 (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_2_50 gboolean g_settings_set_int64 (GSettings *settings, const gchar *key, gint64 value); GLIB_AVAILABLE_IN_2_32 guint g_settings_get_uint (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_2_32 gboolean g_settings_set_uint (GSettings *settings, const gchar *key, guint value); GLIB_AVAILABLE_IN_2_50 guint64 g_settings_get_uint64 (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_2_50 gboolean g_settings_set_uint64 (GSettings *settings, const gchar *key, guint64 value); GLIB_AVAILABLE_IN_ALL gchar * g_settings_get_string (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_string (GSettings *settings, const gchar *key, const gchar *value); GLIB_AVAILABLE_IN_ALL gboolean g_settings_get_boolean (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_boolean (GSettings *settings, const gchar *key, gboolean value); GLIB_AVAILABLE_IN_ALL gdouble g_settings_get_double (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_double (GSettings *settings, const gchar *key, gdouble value); GLIB_AVAILABLE_IN_ALL gchar ** g_settings_get_strv (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_strv (GSettings *settings, const gchar *key, const gchar *const *value); GLIB_AVAILABLE_IN_ALL gint g_settings_get_enum (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_enum (GSettings *settings, const gchar *key, gint value); GLIB_AVAILABLE_IN_ALL guint g_settings_get_flags (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gboolean g_settings_set_flags (GSettings *settings, const gchar *key, guint value); GLIB_AVAILABLE_IN_ALL GSettings * g_settings_get_child (GSettings *settings, const gchar *name); GLIB_AVAILABLE_IN_ALL gboolean g_settings_is_writable (GSettings *settings, const gchar *name); GLIB_AVAILABLE_IN_ALL void g_settings_delay (GSettings *settings); GLIB_AVAILABLE_IN_ALL void g_settings_apply (GSettings *settings); GLIB_AVAILABLE_IN_ALL void g_settings_revert (GSettings *settings); GLIB_AVAILABLE_IN_ALL gboolean g_settings_get_has_unapplied (GSettings *settings); GLIB_AVAILABLE_IN_ALL void g_settings_sync (void); /** * GSettingsBindSetMapping: * @value: a #GValue containing the property value to map * @expected_type: the #GVariantType to create * @user_data: user data that was specified when the binding was created * * The type for the function that is used to convert an object property * value to a #GVariant for storing it in #GSettings. * * Returns: a new #GVariant holding the data from @value, * or %NULL in case of an error */ typedef GVariant * (*GSettingsBindSetMapping) (const GValue *value, const GVariantType *expected_type, gpointer user_data); /** * GSettingsBindGetMapping: * @value: return location for the property value * @variant: the #GVariant * @user_data: user data that was specified when the binding was created * * The type for the function that is used to convert from #GSettings to * an object property. The @value is already initialized to hold values * of the appropriate type. * * Returns: %TRUE if the conversion succeeded, %FALSE in case of an error */ typedef gboolean (*GSettingsBindGetMapping) (GValue *value, GVariant *variant, gpointer user_data); /** * GSettingsGetMapping: * @value: the #GVariant to map, or %NULL * @result: (out): the result of the mapping * @user_data: (closure): the user data that was passed to * g_settings_get_mapped() * * The type of the function that is used to convert from a value stored * in a #GSettings to a value that is useful to the application. * * If the value is successfully mapped, the result should be stored at * @result and %TRUE returned. If mapping fails (for example, if @value * is not in the right format) then %FALSE should be returned. * * If @value is %NULL then it means that the mapping function is being * given a "last chance" to successfully return a valid value. %TRUE * must be returned in this case. * * Returns: %TRUE if the conversion succeeded, %FALSE in case of an error **/ typedef gboolean (*GSettingsGetMapping) (GVariant *value, gpointer *result, gpointer user_data); /** * GSettingsBindFlags: * @G_SETTINGS_BIND_DEFAULT: Equivalent to `G_SETTINGS_BIND_GET|G_SETTINGS_BIND_SET` * @G_SETTINGS_BIND_GET: Update the #GObject property when the setting changes. * It is an error to use this flag if the property is not writable. * @G_SETTINGS_BIND_SET: Update the setting when the #GObject property changes. * It is an error to use this flag if the property is not readable. * @G_SETTINGS_BIND_NO_SENSITIVITY: Do not try to bind a "sensitivity" property to the writability of the setting * @G_SETTINGS_BIND_GET_NO_CHANGES: When set in addition to #G_SETTINGS_BIND_GET, set the #GObject property * value initially from the setting, but do not listen for changes of the setting * @G_SETTINGS_BIND_INVERT_BOOLEAN: When passed to g_settings_bind(), uses a pair of mapping functions that invert * the boolean value when mapping between the setting and the property. The setting and property must both * be booleans. You cannot pass this flag to g_settings_bind_with_mapping(). * * Flags used when creating a binding. These flags determine in which * direction the binding works. The default is to synchronize in both * directions. */ typedef enum { G_SETTINGS_BIND_DEFAULT, G_SETTINGS_BIND_GET = (1<<0), G_SETTINGS_BIND_SET = (1<<1), G_SETTINGS_BIND_NO_SENSITIVITY = (1<<2), G_SETTINGS_BIND_GET_NO_CHANGES = (1<<3), G_SETTINGS_BIND_INVERT_BOOLEAN = (1<<4) } GSettingsBindFlags; GLIB_AVAILABLE_IN_ALL void g_settings_bind (GSettings *settings, const gchar *key, gpointer object, const gchar *property, GSettingsBindFlags flags); GLIB_AVAILABLE_IN_ALL void g_settings_bind_with_mapping (GSettings *settings, const gchar *key, gpointer object, const gchar *property, GSettingsBindFlags flags, GSettingsBindGetMapping get_mapping, GSettingsBindSetMapping set_mapping, gpointer user_data, GDestroyNotify destroy); GLIB_AVAILABLE_IN_ALL void g_settings_bind_writable (GSettings *settings, const gchar *key, gpointer object, const gchar *property, gboolean inverted); GLIB_AVAILABLE_IN_ALL void g_settings_unbind (gpointer object, const gchar *property); GLIB_AVAILABLE_IN_2_32 GAction * g_settings_create_action (GSettings *settings, const gchar *key); GLIB_AVAILABLE_IN_ALL gpointer g_settings_get_mapped (GSettings *settings, const gchar *key, GSettingsGetMapping mapping, gpointer user_data); G_END_DECLS #endif /* __G_SETTINGS_H__ */ gio/gsocketservice.h 0000644 00000007043 15125173651 0010525 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2009 Codethink Limited * Copyright © 2009 Red Hat, Inc * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> * Alexander Larsson <alexl@redhat.com> */ #ifndef __G_SOCKET_SERVICE_H__ #define __G_SOCKET_SERVICE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gsocketlistener.h> G_BEGIN_DECLS #define G_TYPE_SOCKET_SERVICE (g_socket_service_get_type ()) #define G_SOCKET_SERVICE(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SOCKET_SERVICE, GSocketService)) #define G_SOCKET_SERVICE_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_SOCKET_SERVICE, GSocketServiceClass)) #define G_IS_SOCKET_SERVICE(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_SOCKET_SERVICE)) #define G_IS_SOCKET_SERVICE_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \ G_TYPE_SOCKET_SERVICE)) #define G_SOCKET_SERVICE_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_SOCKET_SERVICE, GSocketServiceClass)) typedef struct _GSocketServicePrivate GSocketServicePrivate; typedef struct _GSocketServiceClass GSocketServiceClass; /** * GSocketServiceClass: * @incoming: signal emitted when new connections are accepted * * Class structure for #GSocketService. */ struct _GSocketServiceClass { GSocketListenerClass parent_class; gboolean (* incoming) (GSocketService *service, GSocketConnection *connection, GObject *source_object); /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); void (*_g_reserved6) (void); }; struct _GSocketService { GSocketListener parent_instance; GSocketServicePrivate *priv; }; GLIB_AVAILABLE_IN_ALL GType g_socket_service_get_type (void); GLIB_AVAILABLE_IN_ALL GSocketService *g_socket_service_new (void); GLIB_AVAILABLE_IN_ALL void g_socket_service_start (GSocketService *service); GLIB_AVAILABLE_IN_ALL void g_socket_service_stop (GSocketService *service); GLIB_AVAILABLE_IN_ALL gboolean g_socket_service_is_active (GSocketService *service); G_END_DECLS #endif /* __G_SOCKET_SERVICE_H__ */ gio/gemblem.h 0000644 00000004153 15125173651 0007114 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Clemens N. Buss <cebuzz@gmail.com> * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * */ #ifndef __G_EMBLEM_H__ #define __G_EMBLEM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gioenums.h> G_BEGIN_DECLS #define G_TYPE_EMBLEM (g_emblem_get_type ()) #define G_EMBLEM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_EMBLEM, GEmblem)) #define G_EMBLEM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_EMBLEM, GEmblemClass)) #define G_IS_EMBLEM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_EMBLEM)) #define G_IS_EMBLEM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_EMBLEM)) #define G_EMBLEM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_EMBLEM, GEmblemClass)) /** * GEmblem: * * An object for Emblems */ typedef struct _GEmblem GEmblem; typedef struct _GEmblemClass GEmblemClass; GLIB_AVAILABLE_IN_ALL GType g_emblem_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GEmblem *g_emblem_new (GIcon *icon); GLIB_AVAILABLE_IN_ALL GEmblem *g_emblem_new_with_origin (GIcon *icon, GEmblemOrigin origin); GLIB_AVAILABLE_IN_ALL GIcon *g_emblem_get_icon (GEmblem *emblem); GLIB_AVAILABLE_IN_ALL GEmblemOrigin g_emblem_get_origin (GEmblem *emblem); G_END_DECLS #endif /* __G_EMBLEM_H__ */ gio/gsrvtarget.h 0000644 00000003617 15125173651 0007700 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SRV_TARGET_H__ #define __G_SRV_TARGET_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS GLIB_AVAILABLE_IN_ALL GType g_srv_target_get_type (void) G_GNUC_CONST; #define G_TYPE_SRV_TARGET (g_srv_target_get_type ()) GLIB_AVAILABLE_IN_ALL GSrvTarget *g_srv_target_new (const gchar *hostname, guint16 port, guint16 priority, guint16 weight); GLIB_AVAILABLE_IN_ALL GSrvTarget *g_srv_target_copy (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL void g_srv_target_free (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL const gchar *g_srv_target_get_hostname (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL guint16 g_srv_target_get_port (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL guint16 g_srv_target_get_priority (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL guint16 g_srv_target_get_weight (GSrvTarget *target); GLIB_AVAILABLE_IN_ALL GList *g_srv_target_list_sort (GList *targets); G_END_DECLS #endif /* __G_SRV_TARGET_H__ */ gio/gdbusobjectmanager.h 0000644 00000010572 15125173651 0011334 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_OBJECT_MANAGER_H__ #define __G_DBUS_OBJECT_MANAGER_H__ #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DBUS_OBJECT_MANAGER (g_dbus_object_manager_get_type()) #define G_DBUS_OBJECT_MANAGER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_OBJECT_MANAGER, GDBusObjectManager)) #define G_IS_DBUS_OBJECT_MANAGER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_OBJECT_MANAGER)) #define G_DBUS_OBJECT_MANAGER_GET_IFACE(o) (G_TYPE_INSTANCE_GET_INTERFACE((o), G_TYPE_DBUS_OBJECT_MANAGER, GDBusObjectManagerIface)) typedef struct _GDBusObjectManagerIface GDBusObjectManagerIface; /** * GDBusObjectManagerIface: * @parent_iface: The parent interface. * @get_object_path: Virtual function for g_dbus_object_manager_get_object_path(). * @get_objects: Virtual function for g_dbus_object_manager_get_objects(). * @get_object: Virtual function for g_dbus_object_manager_get_object(). * @get_interface: Virtual function for g_dbus_object_manager_get_interface(). * @object_added: Signal handler for the #GDBusObjectManager::object-added signal. * @object_removed: Signal handler for the #GDBusObjectManager::object-removed signal. * @interface_added: Signal handler for the #GDBusObjectManager::interface-added signal. * @interface_removed: Signal handler for the #GDBusObjectManager::interface-removed signal. * * Base type for D-Bus object managers. * * Since: 2.30 */ struct _GDBusObjectManagerIface { GTypeInterface parent_iface; /* Virtual Functions */ const gchar *(*get_object_path) (GDBusObjectManager *manager); GList *(*get_objects) (GDBusObjectManager *manager); GDBusObject *(*get_object) (GDBusObjectManager *manager, const gchar *object_path); GDBusInterface *(*get_interface) (GDBusObjectManager *manager, const gchar *object_path, const gchar *interface_name); /* Signals */ void (*object_added) (GDBusObjectManager *manager, GDBusObject *object); void (*object_removed) (GDBusObjectManager *manager, GDBusObject *object); void (*interface_added) (GDBusObjectManager *manager, GDBusObject *object, GDBusInterface *interface_); void (*interface_removed) (GDBusObjectManager *manager, GDBusObject *object, GDBusInterface *interface_); }; GLIB_AVAILABLE_IN_ALL GType g_dbus_object_manager_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_object_manager_get_object_path (GDBusObjectManager *manager); GLIB_AVAILABLE_IN_ALL GList *g_dbus_object_manager_get_objects (GDBusObjectManager *manager); GLIB_AVAILABLE_IN_ALL GDBusObject *g_dbus_object_manager_get_object (GDBusObjectManager *manager, const gchar *object_path); GLIB_AVAILABLE_IN_ALL GDBusInterface *g_dbus_object_manager_get_interface (GDBusObjectManager *manager, const gchar *object_path, const gchar *interface_name); G_END_DECLS #endif /* __G_DBUS_OBJECT_MANAGER_H__ */ gio/gbufferedoutputstream.h 0000644 00000006406 15125173651 0012135 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Christian Kellner <gicmo@gnome.org> */ #ifndef __G_BUFFERED_OUTPUT_STREAM_H__ #define __G_BUFFERED_OUTPUT_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gfilteroutputstream.h> G_BEGIN_DECLS #define G_TYPE_BUFFERED_OUTPUT_STREAM (g_buffered_output_stream_get_type ()) #define G_BUFFERED_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_BUFFERED_OUTPUT_STREAM, GBufferedOutputStream)) #define G_BUFFERED_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_BUFFERED_OUTPUT_STREAM, GBufferedOutputStreamClass)) #define G_IS_BUFFERED_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_BUFFERED_OUTPUT_STREAM)) #define G_IS_BUFFERED_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_BUFFERED_OUTPUT_STREAM)) #define G_BUFFERED_OUTPUT_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_BUFFERED_OUTPUT_STREAM, GBufferedOutputStreamClass)) /** * GBufferedOutputStream: * * An implementation of #GFilterOutputStream with a sized buffer. **/ typedef struct _GBufferedOutputStreamClass GBufferedOutputStreamClass; typedef struct _GBufferedOutputStreamPrivate GBufferedOutputStreamPrivate; struct _GBufferedOutputStream { GFilterOutputStream parent_instance; /*< protected >*/ GBufferedOutputStreamPrivate *priv; }; struct _GBufferedOutputStreamClass { GFilterOutputStreamClass parent_class; /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); }; GLIB_AVAILABLE_IN_ALL GType g_buffered_output_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GOutputStream* g_buffered_output_stream_new (GOutputStream *base_stream); GLIB_AVAILABLE_IN_ALL GOutputStream* g_buffered_output_stream_new_sized (GOutputStream *base_stream, gsize size); GLIB_AVAILABLE_IN_ALL gsize g_buffered_output_stream_get_buffer_size (GBufferedOutputStream *stream); GLIB_AVAILABLE_IN_ALL void g_buffered_output_stream_set_buffer_size (GBufferedOutputStream *stream, gsize size); GLIB_AVAILABLE_IN_ALL gboolean g_buffered_output_stream_get_auto_grow (GBufferedOutputStream *stream); GLIB_AVAILABLE_IN_ALL void g_buffered_output_stream_set_auto_grow (GBufferedOutputStream *stream, gboolean auto_grow); G_END_DECLS #endif /* __G_BUFFERED_OUTPUT_STREAM_H__ */ gio/ginitable.h 0000644 00000005640 15125173651 0007444 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2009 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_INITABLE_H__ #define __G_INITABLE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_INITABLE (g_initable_get_type ()) #define G_INITABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_INITABLE, GInitable)) #define G_IS_INITABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_INITABLE)) #define G_INITABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_INITABLE, GInitableIface)) #define G_TYPE_IS_INITABLE(type) (g_type_is_a ((type), G_TYPE_INITABLE)) /** * GInitable: * * Interface for initializable objects. * * Since: 2.22 **/ typedef struct _GInitableIface GInitableIface; /** * GInitableIface: * @g_iface: The parent interface. * @init: Initializes the object. * * Provides an interface for initializing object such that initialization * may fail. * * Since: 2.22 **/ struct _GInitableIface { GTypeInterface g_iface; /* Virtual Table */ gboolean (* init) (GInitable *initable, GCancellable *cancellable, GError **error); }; GLIB_AVAILABLE_IN_ALL GType g_initable_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_initable_init (GInitable *initable, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL gpointer g_initable_new (GType object_type, GCancellable *cancellable, GError **error, const gchar *first_property_name, ...); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_54_FOR(g_object_new_with_properties and g_initable_init) gpointer g_initable_newv (GType object_type, guint n_parameters, GParameter *parameters, GCancellable *cancellable, GError **error); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_ALL GObject* g_initable_new_valist (GType object_type, const gchar *first_property_name, va_list var_args, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_INITABLE_H__ */ gio/gioenumtypes.h 0000644 00000031020 15125173651 0010225 0 ustar 00 /* This file is generated by glib-mkenums, do not modify it. This code is licensed under the same license as the containing project. Note that it links to GLib, so must comply with the LGPL linking clauses. */ #ifndef __GIO_ENUM_TYPES_H__ #define __GIO_ENUM_TYPES_H__ #include <glib-object.h> G_BEGIN_DECLS /* enumerations from "../gio/gioenums.h" */ GLIB_AVAILABLE_IN_ALL GType g_app_info_create_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_APP_INFO_CREATE_FLAGS (g_app_info_create_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_converter_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_CONVERTER_FLAGS (g_converter_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_converter_result_get_type (void) G_GNUC_CONST; #define G_TYPE_CONVERTER_RESULT (g_converter_result_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_data_stream_byte_order_get_type (void) G_GNUC_CONST; #define G_TYPE_DATA_STREAM_BYTE_ORDER (g_data_stream_byte_order_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_data_stream_newline_type_get_type (void) G_GNUC_CONST; #define G_TYPE_DATA_STREAM_NEWLINE_TYPE (g_data_stream_newline_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_attribute_type_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_ATTRIBUTE_TYPE (g_file_attribute_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_attribute_info_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_ATTRIBUTE_INFO_FLAGS (g_file_attribute_info_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_attribute_status_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_ATTRIBUTE_STATUS (g_file_attribute_status_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_query_info_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_QUERY_INFO_FLAGS (g_file_query_info_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_create_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_CREATE_FLAGS (g_file_create_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_measure_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_MEASURE_FLAGS (g_file_measure_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_mount_mount_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_MOUNT_MOUNT_FLAGS (g_mount_mount_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_mount_unmount_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_MOUNT_UNMOUNT_FLAGS (g_mount_unmount_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_drive_start_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DRIVE_START_FLAGS (g_drive_start_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_drive_start_stop_type_get_type (void) G_GNUC_CONST; #define G_TYPE_DRIVE_START_STOP_TYPE (g_drive_start_stop_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_copy_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_COPY_FLAGS (g_file_copy_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_monitor_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_MONITOR_FLAGS (g_file_monitor_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_type_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_TYPE (g_file_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_filesystem_preview_type_get_type (void) G_GNUC_CONST; #define G_TYPE_FILESYSTEM_PREVIEW_TYPE (g_filesystem_preview_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_monitor_event_get_type (void) G_GNUC_CONST; #define G_TYPE_FILE_MONITOR_EVENT (g_file_monitor_event_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_io_error_enum_get_type (void) G_GNUC_CONST; #define G_TYPE_IO_ERROR_ENUM (g_io_error_enum_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_ask_password_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_ASK_PASSWORD_FLAGS (g_ask_password_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_password_save_get_type (void) G_GNUC_CONST; #define G_TYPE_PASSWORD_SAVE (g_password_save_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_mount_operation_result_get_type (void) G_GNUC_CONST; #define G_TYPE_MOUNT_OPERATION_RESULT (g_mount_operation_result_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_output_stream_splice_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_OUTPUT_STREAM_SPLICE_FLAGS (g_output_stream_splice_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_io_stream_splice_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_IO_STREAM_SPLICE_FLAGS (g_io_stream_splice_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_emblem_origin_get_type (void) G_GNUC_CONST; #define G_TYPE_EMBLEM_ORIGIN (g_emblem_origin_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_resolver_error_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOLVER_ERROR (g_resolver_error_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_resolver_record_type_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOLVER_RECORD_TYPE (g_resolver_record_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_resource_error_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOURCE_ERROR (g_resource_error_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_resource_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOURCE_FLAGS (g_resource_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_resource_lookup_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOURCE_LOOKUP_FLAGS (g_resource_lookup_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_family_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_FAMILY (g_socket_family_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_type_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_TYPE (g_socket_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_msg_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_MSG_FLAGS (g_socket_msg_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_protocol_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_PROTOCOL (g_socket_protocol_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_zlib_compressor_format_get_type (void) G_GNUC_CONST; #define G_TYPE_ZLIB_COMPRESSOR_FORMAT (g_zlib_compressor_format_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_unix_socket_address_type_get_type (void) G_GNUC_CONST; #define G_TYPE_UNIX_SOCKET_ADDRESS_TYPE (g_unix_socket_address_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_bus_type_get_type (void) G_GNUC_CONST; #define G_TYPE_BUS_TYPE (g_bus_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_bus_name_owner_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_BUS_NAME_OWNER_FLAGS (g_bus_name_owner_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_bus_name_watcher_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_BUS_NAME_WATCHER_FLAGS (g_bus_name_watcher_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_proxy_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_PROXY_FLAGS (g_dbus_proxy_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_error_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_ERROR (g_dbus_error_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_connection_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_CONNECTION_FLAGS (g_dbus_connection_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_capability_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_CAPABILITY_FLAGS (g_dbus_capability_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_call_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_CALL_FLAGS (g_dbus_call_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_message_type_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_MESSAGE_TYPE (g_dbus_message_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_message_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_MESSAGE_FLAGS (g_dbus_message_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_message_header_field_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_MESSAGE_HEADER_FIELD (g_dbus_message_header_field_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_property_info_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_PROPERTY_INFO_FLAGS (g_dbus_property_info_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_subtree_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_SUBTREE_FLAGS (g_dbus_subtree_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_server_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_SERVER_FLAGS (g_dbus_server_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_signal_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_SIGNAL_FLAGS (g_dbus_signal_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_send_message_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_SEND_MESSAGE_FLAGS (g_dbus_send_message_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_credentials_type_get_type (void) G_GNUC_CONST; #define G_TYPE_CREDENTIALS_TYPE (g_credentials_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_message_byte_order_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_MESSAGE_BYTE_ORDER (g_dbus_message_byte_order_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_application_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_APPLICATION_FLAGS (g_application_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_error_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_ERROR (g_tls_error_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_certificate_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_CERTIFICATE_FLAGS (g_tls_certificate_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_authentication_mode_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_AUTHENTICATION_MODE (g_tls_authentication_mode_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_channel_binding_type_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_CHANNEL_BINDING_TYPE (g_tls_channel_binding_type_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_channel_binding_error_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_CHANNEL_BINDING_ERROR (g_tls_channel_binding_error_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_rehandshake_mode_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_REHANDSHAKE_MODE (g_tls_rehandshake_mode_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_password_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_PASSWORD_FLAGS (g_tls_password_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_interaction_result_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_INTERACTION_RESULT (g_tls_interaction_result_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_interface_skeleton_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_INTERFACE_SKELETON_FLAGS (g_dbus_interface_skeleton_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_dbus_object_manager_client_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_DBUS_OBJECT_MANAGER_CLIENT_FLAGS (g_dbus_object_manager_client_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_database_verify_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_DATABASE_VERIFY_FLAGS (g_tls_database_verify_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_database_lookup_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_DATABASE_LOOKUP_FLAGS (g_tls_database_lookup_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_tls_certificate_request_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TLS_CERTIFICATE_REQUEST_FLAGS (g_tls_certificate_request_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_io_module_scope_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_IO_MODULE_SCOPE_FLAGS (g_io_module_scope_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_client_event_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_CLIENT_EVENT (g_socket_client_event_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_socket_listener_event_get_type (void) G_GNUC_CONST; #define G_TYPE_SOCKET_LISTENER_EVENT (g_socket_listener_event_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_test_dbus_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_TEST_DBUS_FLAGS (g_test_dbus_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_subprocess_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_SUBPROCESS_FLAGS (g_subprocess_flags_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_notification_priority_get_type (void) G_GNUC_CONST; #define G_TYPE_NOTIFICATION_PRIORITY (g_notification_priority_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_network_connectivity_get_type (void) G_GNUC_CONST; #define G_TYPE_NETWORK_CONNECTIVITY (g_network_connectivity_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_pollable_return_get_type (void) G_GNUC_CONST; #define G_TYPE_POLLABLE_RETURN (g_pollable_return_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_memory_monitor_warning_level_get_type (void) G_GNUC_CONST; #define G_TYPE_MEMORY_MONITOR_WARNING_LEVEL (g_memory_monitor_warning_level_get_type ()) /* enumerations from "../gio/gresolver.h" */ GLIB_AVAILABLE_IN_ALL GType g_resolver_name_lookup_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_RESOLVER_NAME_LOOKUP_FLAGS (g_resolver_name_lookup_flags_get_type ()) /* enumerations from "../gio/gsettings.h" */ GLIB_AVAILABLE_IN_ALL GType g_settings_bind_flags_get_type (void) G_GNUC_CONST; #define G_TYPE_SETTINGS_BIND_FLAGS (g_settings_bind_flags_get_type ()) G_END_DECLS #endif /* __GIO_ENUM_TYPES_H__ */ /* Generated data ends here */ gio/gmountoperation.h 0000644 00000015155 15125173651 0010742 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_MOUNT_OPERATION_H__ #define __G_MOUNT_OPERATION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_MOUNT_OPERATION (g_mount_operation_get_type ()) #define G_MOUNT_OPERATION(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_MOUNT_OPERATION, GMountOperation)) #define G_MOUNT_OPERATION_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_MOUNT_OPERATION, GMountOperationClass)) #define G_IS_MOUNT_OPERATION(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_MOUNT_OPERATION)) #define G_IS_MOUNT_OPERATION_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_MOUNT_OPERATION)) #define G_MOUNT_OPERATION_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_MOUNT_OPERATION, GMountOperationClass)) /** * GMountOperation: * * Class for providing authentication methods for mounting operations, * such as mounting a file locally, or authenticating with a server. **/ typedef struct _GMountOperationClass GMountOperationClass; typedef struct _GMountOperationPrivate GMountOperationPrivate; struct _GMountOperation { GObject parent_instance; GMountOperationPrivate *priv; }; struct _GMountOperationClass { GObjectClass parent_class; /* signals: */ void (* ask_password) (GMountOperation *op, const char *message, const char *default_user, const char *default_domain, GAskPasswordFlags flags); /** * GMountOperationClass::ask_question: * @op: a #GMountOperation * @message: string containing a message to display to the user * @choices: (array zero-terminated=1) (element-type utf8): an array of * strings for each possible choice * * Virtual implementation of #GMountOperation::ask-question. */ void (* ask_question) (GMountOperation *op, const char *message, const char *choices[]); void (* reply) (GMountOperation *op, GMountOperationResult result); void (* aborted) (GMountOperation *op); /** * GMountOperationClass::show_processes: * @op: a #GMountOperation * @message: string containing a message to display to the user * @processes: (element-type GPid): an array of #GPid for processes blocking * the operation * @choices: (array zero-terminated=1) (element-type utf8): an array of * strings for each possible choice * * Virtual implementation of #GMountOperation::show-processes. * * Since: 2.22 */ void (* show_processes) (GMountOperation *op, const gchar *message, GArray *processes, const gchar *choices[]); void (* show_unmount_progress) (GMountOperation *op, const gchar *message, gint64 time_left, gint64 bytes_left); /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); void (*_g_reserved6) (void); void (*_g_reserved7) (void); void (*_g_reserved8) (void); void (*_g_reserved9) (void); }; GLIB_AVAILABLE_IN_ALL GType g_mount_operation_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GMountOperation * g_mount_operation_new (void); GLIB_AVAILABLE_IN_ALL const char * g_mount_operation_get_username (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_username (GMountOperation *op, const char *username); GLIB_AVAILABLE_IN_ALL const char * g_mount_operation_get_password (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_password (GMountOperation *op, const char *password); GLIB_AVAILABLE_IN_ALL gboolean g_mount_operation_get_anonymous (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_anonymous (GMountOperation *op, gboolean anonymous); GLIB_AVAILABLE_IN_ALL const char * g_mount_operation_get_domain (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_domain (GMountOperation *op, const char *domain); GLIB_AVAILABLE_IN_ALL GPasswordSave g_mount_operation_get_password_save (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_password_save (GMountOperation *op, GPasswordSave save); GLIB_AVAILABLE_IN_ALL int g_mount_operation_get_choice (GMountOperation *op); GLIB_AVAILABLE_IN_ALL void g_mount_operation_set_choice (GMountOperation *op, int choice); GLIB_AVAILABLE_IN_ALL void g_mount_operation_reply (GMountOperation *op, GMountOperationResult result); GLIB_AVAILABLE_IN_2_58 gboolean g_mount_operation_get_is_tcrypt_hidden_volume (GMountOperation *op); GLIB_AVAILABLE_IN_2_58 void g_mount_operation_set_is_tcrypt_hidden_volume (GMountOperation *op, gboolean hidden_volume); GLIB_AVAILABLE_IN_2_58 gboolean g_mount_operation_get_is_tcrypt_system_volume (GMountOperation *op); GLIB_AVAILABLE_IN_2_58 void g_mount_operation_set_is_tcrypt_system_volume (GMountOperation *op, gboolean system_volume); GLIB_AVAILABLE_IN_2_58 guint g_mount_operation_get_pim (GMountOperation *op); GLIB_AVAILABLE_IN_2_58 void g_mount_operation_set_pim (GMountOperation *op, guint pim); G_END_DECLS #endif /* __G_MOUNT_OPERATION_H__ */ gio/gnetworkservice.h 0000644 00000005303 15125173651 0010723 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_NETWORK_SERVICE_H__ #define __G_NETWORK_SERVICE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_NETWORK_SERVICE (g_network_service_get_type ()) #define G_NETWORK_SERVICE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_NETWORK_SERVICE, GNetworkService)) #define G_NETWORK_SERVICE_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_NETWORK_SERVICE, GNetworkServiceClass)) #define G_IS_NETWORK_SERVICE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_NETWORK_SERVICE)) #define G_IS_NETWORK_SERVICE_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_NETWORK_SERVICE)) #define G_NETWORK_SERVICE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_NETWORK_SERVICE, GNetworkServiceClass)) typedef struct _GNetworkServiceClass GNetworkServiceClass; typedef struct _GNetworkServicePrivate GNetworkServicePrivate; struct _GNetworkService { GObject parent_instance; /*< private >*/ GNetworkServicePrivate *priv; }; struct _GNetworkServiceClass { GObjectClass parent_class; }; GLIB_AVAILABLE_IN_ALL GType g_network_service_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSocketConnectable *g_network_service_new (const gchar *service, const gchar *protocol, const gchar *domain); GLIB_AVAILABLE_IN_ALL const gchar *g_network_service_get_service (GNetworkService *srv); GLIB_AVAILABLE_IN_ALL const gchar *g_network_service_get_protocol (GNetworkService *srv); GLIB_AVAILABLE_IN_ALL const gchar *g_network_service_get_domain (GNetworkService *srv); GLIB_AVAILABLE_IN_ALL const gchar *g_network_service_get_scheme (GNetworkService *srv); GLIB_AVAILABLE_IN_ALL void g_network_service_set_scheme (GNetworkService *srv, const gchar *scheme); G_END_DECLS #endif /* __G_NETWORK_SERVICE_H__ */ gio/gio-autocleanups.h 0000644 00000021552 15125173651 0010765 0 ustar 00 /* * Copyright © 2015 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAction, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GActionMap, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAppInfo, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAppLaunchContext, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAppInfoMonitor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GApplicationCommandLine, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GApplication, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAsyncInitable, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GAsyncResult, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GBufferedInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GBufferedOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GBytesIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GCancellable, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GCharsetConverter, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GConverter, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GConverterInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GConverterOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GCredentials, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDatagramBased, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDataInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDataOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusActionGroup, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusAuthObserver, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusInterface, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusInterfaceSkeleton, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusMenuModel, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusMessage, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusMethodInvocation, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusNodeInfo, g_dbus_node_info_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObject, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObjectManagerClient, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObjectManager, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObjectManagerServer, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObjectProxy, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusObjectSkeleton, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusProxy, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDBusServer, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDrive, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GEmblemedIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GEmblem, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileEnumerator, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFile, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileAttributeInfoList, g_file_attribute_info_list_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileInfo, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileIOStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileMonitor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFilenameCompleter, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFileOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFilterInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GFilterOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInetAddress, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInetAddressMask, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInetSocketAddress, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInitable, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GIOModule, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GIOStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GLoadableIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMemoryInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMemoryOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMenu, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMenuItem, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMenuModel, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMenuAttributeIter, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMenuLinkIter, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMount, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GMountOperation, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNativeVolumeMonitor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNetworkAddress, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNetworkMonitor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNetworkService, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GNotification, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPermission, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPollableInputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPollableOutputStream, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GPropertyAction, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GProxyAddressEnumerator, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GProxyAddress, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GProxy, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GProxyResolver, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GRemoteActionGroup, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GResolver, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GResource, g_resource_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSeekable, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSettingsBackend, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSettingsSchema, g_settings_schema_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSettingsSchemaKey, g_settings_schema_key_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSettingsSchemaSource, g_settings_schema_source_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSettings, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSimpleActionGroup, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSimpleAction, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSimpleAsyncResult, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSimplePermission, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSimpleProxyResolver, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketAddressEnumerator, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketAddress, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketClient, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketConnectable, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketControlMessage, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocket, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketListener, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSocketService, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSubprocess, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GSubprocessLauncher, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTask, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTcpConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTcpWrapperConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTestDBus, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GThemedIcon, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GThreadedSocketService, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsBackend, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsCertificate, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsClientConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsDatabase, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsFileDatabase, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsInteraction, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsPassword, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GTlsServerConnection, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVfs, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVolume, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GVolumeMonitor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GZlibCompressor, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GZlibDecompressor, g_object_unref) gio/ginetaddress.h 0000644 00000010660 15125173651 0010160 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Christian Kellner, Samuel Cormier-Iijima * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Christian Kellner <gicmo@gnome.org> * Samuel Cormier-Iijima <sciyoshi@gmail.com> */ #ifndef __G_INET_ADDRESS_H__ #define __G_INET_ADDRESS_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_INET_ADDRESS (g_inet_address_get_type ()) #define G_INET_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_INET_ADDRESS, GInetAddress)) #define G_INET_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_INET_ADDRESS, GInetAddressClass)) #define G_IS_INET_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_INET_ADDRESS)) #define G_IS_INET_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_INET_ADDRESS)) #define G_INET_ADDRESS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_INET_ADDRESS, GInetAddressClass)) typedef struct _GInetAddressClass GInetAddressClass; typedef struct _GInetAddressPrivate GInetAddressPrivate; struct _GInetAddress { GObject parent_instance; /*< private >*/ GInetAddressPrivate *priv; }; struct _GInetAddressClass { GObjectClass parent_class; gchar * (*to_string) (GInetAddress *address); const guint8 * (*to_bytes) (GInetAddress *address); }; GLIB_AVAILABLE_IN_ALL GType g_inet_address_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GInetAddress * g_inet_address_new_from_string (const gchar *string); GLIB_AVAILABLE_IN_ALL GInetAddress * g_inet_address_new_from_bytes (const guint8 *bytes, GSocketFamily family); GLIB_AVAILABLE_IN_ALL GInetAddress * g_inet_address_new_loopback (GSocketFamily family); GLIB_AVAILABLE_IN_ALL GInetAddress * g_inet_address_new_any (GSocketFamily family); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_equal (GInetAddress *address, GInetAddress *other_address); GLIB_AVAILABLE_IN_ALL gchar * g_inet_address_to_string (GInetAddress *address); GLIB_AVAILABLE_IN_ALL const guint8 * g_inet_address_to_bytes (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gsize g_inet_address_get_native_size (GInetAddress *address); GLIB_AVAILABLE_IN_ALL GSocketFamily g_inet_address_get_family (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_any (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_loopback (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_link_local (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_site_local (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_multicast (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_mc_global (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_mc_link_local (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_mc_node_local (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_mc_org_local (GInetAddress *address); GLIB_AVAILABLE_IN_ALL gboolean g_inet_address_get_is_mc_site_local (GInetAddress *address); G_END_DECLS #endif /* __G_INET_ADDRESS_H__ */ gio/gfilenamecompleter.h 0000644 00000006022 15125173651 0011343 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_FILENAME_COMPLETER_H__ #define __G_FILENAME_COMPLETER_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_FILENAME_COMPLETER (g_filename_completer_get_type ()) #define G_FILENAME_COMPLETER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILENAME_COMPLETER, GFilenameCompleter)) #define G_FILENAME_COMPLETER_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILENAME_COMPLETER, GFilenameCompleterClass)) #define G_FILENAME_COMPLETER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILENAME_COMPLETER, GFilenameCompleterClass)) #define G_IS_FILENAME_COMPLETER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILENAME_COMPLETER)) #define G_IS_FILENAME_COMPLETER_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILENAME_COMPLETER)) /** * GFilenameCompleter: * * Completes filenames based on files that exist within the file system. **/ typedef struct _GFilenameCompleterClass GFilenameCompleterClass; struct _GFilenameCompleterClass { GObjectClass parent_class; /*< public >*/ /* signals */ void (* got_completion_data) (GFilenameCompleter *filename_completer); /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); }; GLIB_AVAILABLE_IN_ALL GType g_filename_completer_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GFilenameCompleter *g_filename_completer_new (void); GLIB_AVAILABLE_IN_ALL char * g_filename_completer_get_completion_suffix (GFilenameCompleter *completer, const char *initial_text); GLIB_AVAILABLE_IN_ALL char ** g_filename_completer_get_completions (GFilenameCompleter *completer, const char *initial_text); GLIB_AVAILABLE_IN_ALL void g_filename_completer_set_dirs_only (GFilenameCompleter *completer, gboolean dirs_only); G_END_DECLS #endif /* __G_FILENAME_COMPLETER_H__ */ gio/gfilteroutputstream.h 0000644 00000005473 15125173651 0011643 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Christian Kellner <gicmo@gnome.org> */ #ifndef __G_FILTER_OUTPUT_STREAM_H__ #define __G_FILTER_OUTPUT_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/goutputstream.h> G_BEGIN_DECLS #define G_TYPE_FILTER_OUTPUT_STREAM (g_filter_output_stream_get_type ()) #define G_FILTER_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILTER_OUTPUT_STREAM, GFilterOutputStream)) #define G_FILTER_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILTER_OUTPUT_STREAM, GFilterOutputStreamClass)) #define G_IS_FILTER_OUTPUT_STREAM(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILTER_OUTPUT_STREAM)) #define G_IS_FILTER_OUTPUT_STREAM_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILTER_OUTPUT_STREAM)) #define G_FILTER_OUTPUT_STREAM_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILTER_OUTPUT_STREAM, GFilterOutputStreamClass)) /** * GFilterOutputStream: * * A base class for all output streams that work on an underlying stream. **/ typedef struct _GFilterOutputStreamClass GFilterOutputStreamClass; struct _GFilterOutputStream { GOutputStream parent_instance; /*< protected >*/ GOutputStream *base_stream; }; struct _GFilterOutputStreamClass { GOutputStreamClass parent_class; /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); }; GLIB_AVAILABLE_IN_ALL GType g_filter_output_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GOutputStream * g_filter_output_stream_get_base_stream (GFilterOutputStream *stream); GLIB_AVAILABLE_IN_ALL gboolean g_filter_output_stream_get_close_base_stream (GFilterOutputStream *stream); GLIB_AVAILABLE_IN_ALL void g_filter_output_stream_set_close_base_stream (GFilterOutputStream *stream, gboolean close_base); G_END_DECLS #endif /* __G_FILTER_OUTPUT_STREAM_H__ */ gio/gsocketconnectable.h 0000644 00000005506 15125173651 0011344 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_SOCKET_CONNECTABLE_H__ #define __G_SOCKET_CONNECTABLE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SOCKET_CONNECTABLE (g_socket_connectable_get_type ()) #define G_SOCKET_CONNECTABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_SOCKET_CONNECTABLE, GSocketConnectable)) #define G_IS_SOCKET_CONNECTABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_SOCKET_CONNECTABLE)) #define G_SOCKET_CONNECTABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_SOCKET_CONNECTABLE, GSocketConnectableIface)) /** * GSocketConnectable: * * Interface for objects that contain or generate a #GSocketAddress. */ typedef struct _GSocketConnectableIface GSocketConnectableIface; /** * GSocketConnectableIface: * @g_iface: The parent interface. * @enumerate: Creates a #GSocketAddressEnumerator * @proxy_enumerate: Creates a #GProxyAddressEnumerator * @to_string: Format the connectable’s address as a string for debugging. * Implementing this is optional. (Since: 2.48) * * Provides an interface for returning a #GSocketAddressEnumerator * and #GProxyAddressEnumerator */ struct _GSocketConnectableIface { GTypeInterface g_iface; /* Virtual Table */ GSocketAddressEnumerator * (* enumerate) (GSocketConnectable *connectable); GSocketAddressEnumerator * (* proxy_enumerate) (GSocketConnectable *connectable); gchar * (* to_string) (GSocketConnectable *connectable); }; GLIB_AVAILABLE_IN_ALL GType g_socket_connectable_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSocketAddressEnumerator *g_socket_connectable_enumerate (GSocketConnectable *connectable); GLIB_AVAILABLE_IN_ALL GSocketAddressEnumerator *g_socket_connectable_proxy_enumerate (GSocketConnectable *connectable); GLIB_AVAILABLE_IN_2_48 gchar *g_socket_connectable_to_string (GSocketConnectable *connectable); G_END_DECLS #endif /* __G_SOCKET_CONNECTABLE_H__ */ gio/gdatagrambased.h 0000644 00000015005 15125173651 0010430 0 ustar 00 /* * Copyright 2015 Collabora Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Philip Withnall <philip.withnall@collabora.co.uk> */ #ifndef __G_DATAGRAM_BASED_H__ #define __G_DATAGRAM_BASED_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DATAGRAM_BASED (g_datagram_based_get_type ()) #define G_DATAGRAM_BASED(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_DATAGRAM_BASED, GDatagramBased)) #define G_IS_DATAGRAM_BASED(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_DATAGRAM_BASED)) #define G_DATAGRAM_BASED_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), \ G_TYPE_DATAGRAM_BASED, \ GDatagramBasedInterface)) #define G_TYPE_IS_DATAGRAM_BASED(type) (g_type_is_a ((type), \ G_TYPE_DATAGRAM_BASED)) /** * GDatagramBased: * * Interface for socket-like objects with datagram semantics. * * Since: 2.48 */ typedef struct _GDatagramBasedInterface GDatagramBasedInterface; /** * GDatagramBasedInterface: * @g_iface: The parent interface. * @receive_messages: Virtual method for g_datagram_based_receive_messages(). * @send_messages: Virtual method for g_datagram_based_send_messages(). * @create_source: Virtual method for g_datagram_based_create_source(). * @condition_check: Virtual method for g_datagram_based_condition_check(). * @condition_wait: Virtual method for * g_datagram_based_condition_wait(). * * Provides an interface for socket-like objects which have datagram semantics, * following the Berkeley sockets API. The interface methods are thin wrappers * around the corresponding virtual methods, and no pre-processing of inputs is * implemented — so implementations of this API must handle all functionality * documented in the interface methods. * * Since: 2.48 */ struct _GDatagramBasedInterface { GTypeInterface g_iface; /* Virtual table */ gint (*receive_messages) (GDatagramBased *datagram_based, GInputMessage *messages, guint num_messages, gint flags, gint64 timeout, GCancellable *cancellable, GError **error); gint (*send_messages) (GDatagramBased *datagram_based, GOutputMessage *messages, guint num_messages, gint flags, gint64 timeout, GCancellable *cancellable, GError **error); GSource *(*create_source) (GDatagramBased *datagram_based, GIOCondition condition, GCancellable *cancellable); GIOCondition (*condition_check) (GDatagramBased *datagram_based, GIOCondition condition); gboolean (*condition_wait) (GDatagramBased *datagram_based, GIOCondition condition, gint64 timeout, GCancellable *cancellable, GError **error); }; GLIB_AVAILABLE_IN_2_48 GType g_datagram_based_get_type (void); GLIB_AVAILABLE_IN_2_48 gint g_datagram_based_receive_messages (GDatagramBased *datagram_based, GInputMessage *messages, guint num_messages, gint flags, gint64 timeout, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_48 gint g_datagram_based_send_messages (GDatagramBased *datagram_based, GOutputMessage *messages, guint num_messages, gint flags, gint64 timeout, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_48 GSource * g_datagram_based_create_source (GDatagramBased *datagram_based, GIOCondition condition, GCancellable *cancellable); GLIB_AVAILABLE_IN_2_48 GIOCondition g_datagram_based_condition_check (GDatagramBased *datagram_based, GIOCondition condition); GLIB_AVAILABLE_IN_2_48 gboolean g_datagram_based_condition_wait (GDatagramBased *datagram_based, GIOCondition condition, gint64 timeout, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_DATAGRAM_BASED_H__ */ gio/glistmodel.h 0000644 00000005020 15125173651 0007641 0 ustar 00 /* * Copyright 2015 Lars Uebernickel * Copyright 2015 Ryan Lortie * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: * Lars Uebernickel <lars@uebernic.de> * Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_LIST_MODEL_H__ #define __G_LIST_MODEL_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_LIST_MODEL g_list_model_get_type () GLIB_AVAILABLE_IN_2_44 G_DECLARE_INTERFACE(GListModel, g_list_model, G, LIST_MODEL, GObject) struct _GListModelInterface { GTypeInterface g_iface; GType (* get_item_type) (GListModel *list); guint (* get_n_items) (GListModel *list); gpointer (* get_item) (GListModel *list, guint position); }; GLIB_AVAILABLE_IN_2_44 GType g_list_model_get_item_type (GListModel *list); GLIB_AVAILABLE_IN_2_44 guint g_list_model_get_n_items (GListModel *list); GLIB_AVAILABLE_IN_2_44 gpointer g_list_model_get_item (GListModel *list, guint position); GLIB_AVAILABLE_IN_2_44 GObject * g_list_model_get_object (GListModel *list, guint position); GLIB_AVAILABLE_IN_2_44 void g_list_model_items_changed (GListModel *list, guint position, guint removed, guint added); G_END_DECLS #endif /* __G_LIST_MODEL_H__ */ gio/gcancellable.h 0000644 00000007732 15125173651 0010106 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_CANCELLABLE_H__ #define __G_CANCELLABLE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_CANCELLABLE (g_cancellable_get_type ()) #define G_CANCELLABLE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_CANCELLABLE, GCancellable)) #define G_CANCELLABLE_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_CANCELLABLE, GCancellableClass)) #define G_IS_CANCELLABLE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_CANCELLABLE)) #define G_IS_CANCELLABLE_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CANCELLABLE)) #define G_CANCELLABLE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CANCELLABLE, GCancellableClass)) /** * GCancellable: * * Allows actions to be cancelled. */ typedef struct _GCancellableClass GCancellableClass; typedef struct _GCancellablePrivate GCancellablePrivate; struct _GCancellable { GObject parent_instance; /*< private >*/ GCancellablePrivate *priv; }; struct _GCancellableClass { GObjectClass parent_class; void (* cancelled) (GCancellable *cancellable); /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); }; GLIB_AVAILABLE_IN_ALL GType g_cancellable_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GCancellable *g_cancellable_new (void); /* These are only safe to call inside a cancellable op */ GLIB_AVAILABLE_IN_ALL gboolean g_cancellable_is_cancelled (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL gboolean g_cancellable_set_error_if_cancelled (GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL int g_cancellable_get_fd (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL gboolean g_cancellable_make_pollfd (GCancellable *cancellable, GPollFD *pollfd); GLIB_AVAILABLE_IN_ALL void g_cancellable_release_fd (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL GSource * g_cancellable_source_new (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL GCancellable *g_cancellable_get_current (void); GLIB_AVAILABLE_IN_ALL void g_cancellable_push_current (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL void g_cancellable_pop_current (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL void g_cancellable_reset (GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL gulong g_cancellable_connect (GCancellable *cancellable, GCallback callback, gpointer data, GDestroyNotify data_destroy_func); GLIB_AVAILABLE_IN_ALL void g_cancellable_disconnect (GCancellable *cancellable, gulong handler_id); /* This is safe to call from another thread */ GLIB_AVAILABLE_IN_ALL void g_cancellable_cancel (GCancellable *cancellable); G_END_DECLS #endif /* __G_CANCELLABLE_H__ */ gio/gdbusmethodinvocation.h 0000644 00000015346 15125173651 0012111 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_METHOD_INVOCATION_H__ #define __G_DBUS_METHOD_INVOCATION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DBUS_METHOD_INVOCATION (g_dbus_method_invocation_get_type ()) #define G_DBUS_METHOD_INVOCATION(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_METHOD_INVOCATION, GDBusMethodInvocation)) #define G_IS_DBUS_METHOD_INVOCATION(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_METHOD_INVOCATION)) /** * G_DBUS_METHOD_INVOCATION_HANDLED: * * The value returned by handlers of the signals generated by * the `gdbus-codegen` tool to indicate that a method call has been * handled by an implementation. It is equal to %TRUE, but using * this macro is sometimes more readable. * * In code that needs to be backwards-compatible with older GLib, * use %TRUE instead, often written like this: * * |[ * g_dbus_method_invocation_return_error (invocation, ...); * return TRUE; // handled * ]| * * Since: 2.68 */ #define G_DBUS_METHOD_INVOCATION_HANDLED TRUE GLIB_AVAILABLE_MACRO_IN_2_68 /** * G_DBUS_METHOD_INVOCATION_UNHANDLED: * * The value returned by handlers of the signals generated by * the `gdbus-codegen` tool to indicate that a method call has not been * handled by an implementation. It is equal to %FALSE, but using * this macro is sometimes more readable. * * In code that needs to be backwards-compatible with older GLib, * use %FALSE instead. * * Since: 2.68 */ #define G_DBUS_METHOD_INVOCATION_UNHANDLED FALSE GLIB_AVAILABLE_MACRO_IN_2_68 GLIB_AVAILABLE_IN_ALL GType g_dbus_method_invocation_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_method_invocation_get_sender (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_method_invocation_get_object_path (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_method_invocation_get_interface_name (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_method_invocation_get_method_name (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL const GDBusMethodInfo *g_dbus_method_invocation_get_method_info (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_2_38 const GDBusPropertyInfo *g_dbus_method_invocation_get_property_info (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL GDBusConnection *g_dbus_method_invocation_get_connection (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_method_invocation_get_message (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_method_invocation_get_parameters (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL gpointer g_dbus_method_invocation_get_user_data (GDBusMethodInvocation *invocation); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_value (GDBusMethodInvocation *invocation, GVariant *parameters); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_value_with_unix_fd_list (GDBusMethodInvocation *invocation, GVariant *parameters, GUnixFDList *fd_list); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_error (GDBusMethodInvocation *invocation, GQuark domain, gint code, const gchar *format, ...) G_GNUC_PRINTF(4, 5); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_error_valist (GDBusMethodInvocation *invocation, GQuark domain, gint code, const gchar *format, va_list var_args) G_GNUC_PRINTF(4, 0); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_error_literal (GDBusMethodInvocation *invocation, GQuark domain, gint code, const gchar *message); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_gerror (GDBusMethodInvocation *invocation, const GError *error); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_take_error (GDBusMethodInvocation *invocation, GError *error); GLIB_AVAILABLE_IN_ALL void g_dbus_method_invocation_return_dbus_error (GDBusMethodInvocation *invocation, const gchar *error_name, const gchar *error_message); G_END_DECLS #endif /* __G_DBUS_METHOD_INVOCATION_H__ */ gio/gremoteactiongroup.h 0000644 00000007063 15125173651 0011424 0 ustar 00 /* * Copyright © 2011 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_REMOTE_ACTION_GROUP_H__ #define __G_REMOTE_ACTION_GROUP_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_REMOTE_ACTION_GROUP (g_remote_action_group_get_type ()) #define G_REMOTE_ACTION_GROUP(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_REMOTE_ACTION_GROUP, GRemoteActionGroup)) #define G_IS_REMOTE_ACTION_GROUP(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_REMOTE_ACTION_GROUP)) #define G_REMOTE_ACTION_GROUP_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), \ G_TYPE_REMOTE_ACTION_GROUP, \ GRemoteActionGroupInterface)) typedef struct _GRemoteActionGroupInterface GRemoteActionGroupInterface; struct _GRemoteActionGroupInterface { GTypeInterface g_iface; void (* activate_action_full) (GRemoteActionGroup *remote, const gchar *action_name, GVariant *parameter, GVariant *platform_data); void (* change_action_state_full) (GRemoteActionGroup *remote, const gchar *action_name, GVariant *value, GVariant *platform_data); }; GLIB_AVAILABLE_IN_2_32 GType g_remote_action_group_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_32 void g_remote_action_group_activate_action_full (GRemoteActionGroup *remote, const gchar *action_name, GVariant *parameter, GVariant *platform_data); GLIB_AVAILABLE_IN_2_32 void g_remote_action_group_change_action_state_full (GRemoteActionGroup *remote, const gchar *action_name, GVariant *value, GVariant *platform_data); G_END_DECLS #endif /* __G_REMOTE_ACTION_GROUP_H__ */ gio/gpollableinputstream.h 0000644 00000007364 15125173651 0011750 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_POLLABLE_INPUT_STREAM_H__ #define __G_POLLABLE_INPUT_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gio.h> G_BEGIN_DECLS #define G_TYPE_POLLABLE_INPUT_STREAM (g_pollable_input_stream_get_type ()) #define G_POLLABLE_INPUT_STREAM(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_POLLABLE_INPUT_STREAM, GPollableInputStream)) #define G_IS_POLLABLE_INPUT_STREAM(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_POLLABLE_INPUT_STREAM)) #define G_POLLABLE_INPUT_STREAM_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_POLLABLE_INPUT_STREAM, GPollableInputStreamInterface)) /** * GPollableInputStream: * * An interface for a #GInputStream that can be polled for readability. * * Since: 2.28 */ typedef struct _GPollableInputStreamInterface GPollableInputStreamInterface; /** * GPollableInputStreamInterface: * @g_iface: The parent interface. * @can_poll: Checks if the #GPollableInputStream instance is actually pollable * @is_readable: Checks if the stream is readable * @create_source: Creates a #GSource to poll the stream * @read_nonblocking: Does a non-blocking read or returns * %G_IO_ERROR_WOULD_BLOCK * * The interface for pollable input streams. * * The default implementation of @can_poll always returns %TRUE. * * The default implementation of @read_nonblocking calls * g_pollable_input_stream_is_readable(), and then calls * g_input_stream_read() if it returns %TRUE. This means you only need * to override it if it is possible that your @is_readable * implementation may return %TRUE when the stream is not actually * readable. * * Since: 2.28 */ struct _GPollableInputStreamInterface { GTypeInterface g_iface; /* Virtual Table */ gboolean (*can_poll) (GPollableInputStream *stream); gboolean (*is_readable) (GPollableInputStream *stream); GSource * (*create_source) (GPollableInputStream *stream, GCancellable *cancellable); gssize (*read_nonblocking) (GPollableInputStream *stream, void *buffer, gsize count, GError **error); }; GLIB_AVAILABLE_IN_ALL GType g_pollable_input_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_pollable_input_stream_can_poll (GPollableInputStream *stream); GLIB_AVAILABLE_IN_ALL gboolean g_pollable_input_stream_is_readable (GPollableInputStream *stream); GLIB_AVAILABLE_IN_ALL GSource *g_pollable_input_stream_create_source (GPollableInputStream *stream, GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL gssize g_pollable_input_stream_read_nonblocking (GPollableInputStream *stream, void *buffer, gsize count, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_POLLABLE_INPUT_STREAM_H__ */ gio/gdbusmessage.h 0000644 00000026167 15125173651 0010166 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_MESSAGE_H__ #define __G_DBUS_MESSAGE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DBUS_MESSAGE (g_dbus_message_get_type ()) #define G_DBUS_MESSAGE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_MESSAGE, GDBusMessage)) #define G_IS_DBUS_MESSAGE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_MESSAGE)) GLIB_AVAILABLE_IN_ALL GType g_dbus_message_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new (void); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_signal (const gchar *path, const gchar *interface_, const gchar *signal); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_method_call (const gchar *name, const gchar *path, const gchar *interface_, const gchar *method); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_method_reply (GDBusMessage *method_call_message); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_method_error (GDBusMessage *method_call_message, const gchar *error_name, const gchar *error_message_format, ...) G_GNUC_PRINTF(3, 4); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_method_error_valist (GDBusMessage *method_call_message, const gchar *error_name, const gchar *error_message_format, va_list var_args); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_method_error_literal (GDBusMessage *method_call_message, const gchar *error_name, const gchar *error_message); GLIB_AVAILABLE_IN_ALL gchar *g_dbus_message_print (GDBusMessage *message, guint indent); GLIB_AVAILABLE_IN_ALL gboolean g_dbus_message_get_locked (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_lock (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_copy (GDBusMessage *message, GError **error); GLIB_AVAILABLE_IN_ALL GDBusMessageByteOrder g_dbus_message_get_byte_order (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_byte_order (GDBusMessage *message, GDBusMessageByteOrder byte_order); GLIB_AVAILABLE_IN_ALL GDBusMessageType g_dbus_message_get_message_type (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_message_type (GDBusMessage *message, GDBusMessageType type); GLIB_AVAILABLE_IN_ALL GDBusMessageFlags g_dbus_message_get_flags (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_flags (GDBusMessage *message, GDBusMessageFlags flags); GLIB_AVAILABLE_IN_ALL guint32 g_dbus_message_get_serial (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_serial (GDBusMessage *message, guint32 serial); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_message_get_header (GDBusMessage *message, GDBusMessageHeaderField header_field); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_header (GDBusMessage *message, GDBusMessageHeaderField header_field, GVariant *value); GLIB_AVAILABLE_IN_ALL guchar *g_dbus_message_get_header_fields (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_message_get_body (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_body (GDBusMessage *message, GVariant *body); GLIB_AVAILABLE_IN_ALL GUnixFDList *g_dbus_message_get_unix_fd_list (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_unix_fd_list (GDBusMessage *message, GUnixFDList *fd_list); GLIB_AVAILABLE_IN_ALL guint32 g_dbus_message_get_reply_serial (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_reply_serial (GDBusMessage *message, guint32 value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_interface (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_interface (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_member (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_member (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_path (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_path (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_sender (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_sender (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_destination (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_destination (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_error_name (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_error_name (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_signature (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_signature (GDBusMessage *message, const gchar *value); GLIB_AVAILABLE_IN_ALL guint32 g_dbus_message_get_num_unix_fds (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL void g_dbus_message_set_num_unix_fds (GDBusMessage *message, guint32 value); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_message_get_arg0 (GDBusMessage *message); GLIB_AVAILABLE_IN_ALL GDBusMessage *g_dbus_message_new_from_blob (guchar *blob, gsize blob_len, GDBusCapabilityFlags capabilities, GError **error); GLIB_AVAILABLE_IN_ALL gssize g_dbus_message_bytes_needed (guchar *blob, gsize blob_len, GError **error); GLIB_AVAILABLE_IN_ALL guchar *g_dbus_message_to_blob (GDBusMessage *message, gsize *out_size, GDBusCapabilityFlags capabilities, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_dbus_message_to_gerror (GDBusMessage *message, GError **error); G_END_DECLS #endif /* __G_DBUS_MESSAGE_H__ */ gio/gzlibcompressor.h 0000644 00000004456 15125173651 0010736 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2009 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_ZLIB_COMPRESSOR_H__ #define __G_ZLIB_COMPRESSOR_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gconverter.h> #include <gio/gfileinfo.h> G_BEGIN_DECLS #define G_TYPE_ZLIB_COMPRESSOR (g_zlib_compressor_get_type ()) #define G_ZLIB_COMPRESSOR(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_ZLIB_COMPRESSOR, GZlibCompressor)) #define G_ZLIB_COMPRESSOR_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_ZLIB_COMPRESSOR, GZlibCompressorClass)) #define G_IS_ZLIB_COMPRESSOR(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_ZLIB_COMPRESSOR)) #define G_IS_ZLIB_COMPRESSOR_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_ZLIB_COMPRESSOR)) #define G_ZLIB_COMPRESSOR_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_ZLIB_COMPRESSOR, GZlibCompressorClass)) typedef struct _GZlibCompressorClass GZlibCompressorClass; struct _GZlibCompressorClass { GObjectClass parent_class; }; GLIB_AVAILABLE_IN_ALL GType g_zlib_compressor_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GZlibCompressor *g_zlib_compressor_new (GZlibCompressorFormat format, int level); GLIB_AVAILABLE_IN_ALL GFileInfo *g_zlib_compressor_get_file_info (GZlibCompressor *compressor); GLIB_AVAILABLE_IN_ALL void g_zlib_compressor_set_file_info (GZlibCompressor *compressor, GFileInfo *file_info); G_END_DECLS #endif /* __G_ZLIB_COMPRESSOR_H__ */ gio/gdbusproxy.h 0000644 00000027462 15125173651 0007722 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_PROXY_H__ #define __G_DBUS_PROXY_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> #include <gio/gdbusintrospection.h> G_BEGIN_DECLS #define G_TYPE_DBUS_PROXY (g_dbus_proxy_get_type ()) #define G_DBUS_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_PROXY, GDBusProxy)) #define G_DBUS_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_PROXY, GDBusProxyClass)) #define G_DBUS_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_PROXY, GDBusProxyClass)) #define G_IS_DBUS_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_PROXY)) #define G_IS_DBUS_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_PROXY)) typedef struct _GDBusProxyClass GDBusProxyClass; typedef struct _GDBusProxyPrivate GDBusProxyPrivate; /** * GDBusProxy: * * The #GDBusProxy structure contains only private data and * should only be accessed using the provided API. * * Since: 2.26 */ struct _GDBusProxy { /*< private >*/ GObject parent_instance; GDBusProxyPrivate *priv; }; /** * GDBusProxyClass: * @g_properties_changed: Signal class handler for the #GDBusProxy::g-properties-changed signal. * @g_signal: Signal class handler for the #GDBusProxy::g-signal signal. * * Class structure for #GDBusProxy. * * Since: 2.26 */ struct _GDBusProxyClass { /*< private >*/ GObjectClass parent_class; /*< public >*/ /* Signals */ void (*g_properties_changed) (GDBusProxy *proxy, GVariant *changed_properties, const gchar* const *invalidated_properties); void (*g_signal) (GDBusProxy *proxy, const gchar *sender_name, const gchar *signal_name, GVariant *parameters); /*< private >*/ /* Padding for future expansion */ gpointer padding[32]; }; GLIB_AVAILABLE_IN_ALL GType g_dbus_proxy_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_new (GDBusConnection *connection, GDBusProxyFlags flags, GDBusInterfaceInfo *info, const gchar *name, const gchar *object_path, const gchar *interface_name, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GDBusProxy *g_dbus_proxy_new_finish (GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_ALL GDBusProxy *g_dbus_proxy_new_sync (GDBusConnection *connection, GDBusProxyFlags flags, GDBusInterfaceInfo *info, const gchar *name, const gchar *object_path, const gchar *interface_name, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_new_for_bus (GBusType bus_type, GDBusProxyFlags flags, GDBusInterfaceInfo *info, const gchar *name, const gchar *object_path, const gchar *interface_name, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GDBusProxy *g_dbus_proxy_new_for_bus_finish (GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_ALL GDBusProxy *g_dbus_proxy_new_for_bus_sync (GBusType bus_type, GDBusProxyFlags flags, GDBusInterfaceInfo *info, const gchar *name, const gchar *object_path, const gchar *interface_name, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL GDBusConnection *g_dbus_proxy_get_connection (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL GDBusProxyFlags g_dbus_proxy_get_flags (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_proxy_get_name (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL gchar *g_dbus_proxy_get_name_owner (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_proxy_get_object_path (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL const gchar *g_dbus_proxy_get_interface_name (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL gint g_dbus_proxy_get_default_timeout (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_set_default_timeout (GDBusProxy *proxy, gint timeout_msec); GLIB_AVAILABLE_IN_ALL GDBusInterfaceInfo *g_dbus_proxy_get_interface_info (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_set_interface_info (GDBusProxy *proxy, GDBusInterfaceInfo *info); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_proxy_get_cached_property (GDBusProxy *proxy, const gchar *property_name); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_set_cached_property (GDBusProxy *proxy, const gchar *property_name, GVariant *value); GLIB_AVAILABLE_IN_ALL gchar **g_dbus_proxy_get_cached_property_names (GDBusProxy *proxy); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_call (GDBusProxy *proxy, const gchar *method_name, GVariant *parameters, GDBusCallFlags flags, gint timeout_msec, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_proxy_call_finish (GDBusProxy *proxy, GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_proxy_call_sync (GDBusProxy *proxy, const gchar *method_name, GVariant *parameters, GDBusCallFlags flags, gint timeout_msec, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_dbus_proxy_call_with_unix_fd_list (GDBusProxy *proxy, const gchar *method_name, GVariant *parameters, GDBusCallFlags flags, gint timeout_msec, GUnixFDList *fd_list, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_proxy_call_with_unix_fd_list_finish (GDBusProxy *proxy, GUnixFDList **out_fd_list, GAsyncResult *res, GError **error); GLIB_AVAILABLE_IN_ALL GVariant *g_dbus_proxy_call_with_unix_fd_list_sync (GDBusProxy *proxy, const gchar *method_name, GVariant *parameters, GDBusCallFlags flags, gint timeout_msec, GUnixFDList *fd_list, GUnixFDList **out_fd_list, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_DBUS_PROXY_H__ */ gio/ginetsocketaddress.h 0000644 00000006047 15125173651 0011375 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008 Christian Kellner, Samuel Cormier-Iijima * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Christian Kellner <gicmo@gnome.org> * Samuel Cormier-Iijima <sciyoshi@gmail.com> */ #ifndef __G_INET_SOCKET_ADDRESS_H__ #define __G_INET_SOCKET_ADDRESS_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gsocketaddress.h> G_BEGIN_DECLS #define G_TYPE_INET_SOCKET_ADDRESS (g_inet_socket_address_get_type ()) #define G_INET_SOCKET_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_INET_SOCKET_ADDRESS, GInetSocketAddress)) #define G_INET_SOCKET_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_INET_SOCKET_ADDRESS, GInetSocketAddressClass)) #define G_IS_INET_SOCKET_ADDRESS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_INET_SOCKET_ADDRESS)) #define G_IS_INET_SOCKET_ADDRESS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_INET_SOCKET_ADDRESS)) #define G_INET_SOCKET_ADDRESS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_INET_SOCKET_ADDRESS, GInetSocketAddressClass)) typedef struct _GInetSocketAddressClass GInetSocketAddressClass; typedef struct _GInetSocketAddressPrivate GInetSocketAddressPrivate; struct _GInetSocketAddress { GSocketAddress parent_instance; /*< private >*/ GInetSocketAddressPrivate *priv; }; struct _GInetSocketAddressClass { GSocketAddressClass parent_class; }; GLIB_AVAILABLE_IN_ALL GType g_inet_socket_address_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSocketAddress *g_inet_socket_address_new (GInetAddress *address, guint16 port); GLIB_AVAILABLE_IN_2_40 GSocketAddress *g_inet_socket_address_new_from_string (const char *address, guint port); GLIB_AVAILABLE_IN_ALL GInetAddress * g_inet_socket_address_get_address (GInetSocketAddress *address); GLIB_AVAILABLE_IN_ALL guint16 g_inet_socket_address_get_port (GInetSocketAddress *address); GLIB_AVAILABLE_IN_2_32 guint32 g_inet_socket_address_get_flowinfo (GInetSocketAddress *address); GLIB_AVAILABLE_IN_2_32 guint32 g_inet_socket_address_get_scope_id (GInetSocketAddress *address); G_END_DECLS #endif /* __G_INET_SOCKET_ADDRESS_H__ */ gio/gloadableicon.h 0000644 00000007127 15125173651 0010273 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_LOADABLE_ICON_H__ #define __G_LOADABLE_ICON_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_LOADABLE_ICON (g_loadable_icon_get_type ()) #define G_LOADABLE_ICON(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_LOADABLE_ICON, GLoadableIcon)) #define G_IS_LOADABLE_ICON(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_LOADABLE_ICON)) #define G_LOADABLE_ICON_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_LOADABLE_ICON, GLoadableIconIface)) /** * GLoadableIcon: * * Generic type for all kinds of icons that can be loaded * as a stream. **/ typedef struct _GLoadableIconIface GLoadableIconIface; /** * GLoadableIconIface: * @g_iface: The parent interface. * @load: Loads an icon. * @load_async: Loads an icon asynchronously. * @load_finish: Finishes an asynchronous icon load. * * Interface for icons that can be loaded as a stream. **/ struct _GLoadableIconIface { GTypeInterface g_iface; /* Virtual Table */ GInputStream * (* load) (GLoadableIcon *icon, int size, char **type, GCancellable *cancellable, GError **error); void (* load_async) (GLoadableIcon *icon, int size, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GInputStream * (* load_finish) (GLoadableIcon *icon, GAsyncResult *res, char **type, GError **error); }; GLIB_AVAILABLE_IN_ALL GType g_loadable_icon_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GInputStream *g_loadable_icon_load (GLoadableIcon *icon, int size, char **type, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_loadable_icon_load_async (GLoadableIcon *icon, int size, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GInputStream *g_loadable_icon_load_finish (GLoadableIcon *icon, GAsyncResult *res, char **type, GError **error); G_END_DECLS #endif /* __G_LOADABLE_ICON_H__ */ gio/gdbusobjectproxy.h 0000644 00000005113 15125173651 0011076 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_OBJECT_PROXY_H__ #define __G_DBUS_OBJECT_PROXY_H__ #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DBUS_OBJECT_PROXY (g_dbus_object_proxy_get_type ()) #define G_DBUS_OBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_OBJECT_PROXY, GDBusObjectProxy)) #define G_DBUS_OBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_OBJECT_PROXY, GDBusObjectProxyClass)) #define G_DBUS_OBJECT_PROXY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_OBJECT_PROXY, GDBusObjectProxyClass)) #define G_IS_DBUS_OBJECT_PROXY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_OBJECT_PROXY)) #define G_IS_DBUS_OBJECT_PROXY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_OBJECT_PROXY)) typedef struct _GDBusObjectProxyClass GDBusObjectProxyClass; typedef struct _GDBusObjectProxyPrivate GDBusObjectProxyPrivate; /** * GDBusObjectProxy: * * The #GDBusObjectProxy structure contains private data and should * only be accessed using the provided API. * * Since: 2.30 */ struct _GDBusObjectProxy { /*< private >*/ GObject parent_instance; GDBusObjectProxyPrivate *priv; }; /** * GDBusObjectProxyClass: * @parent_class: The parent class. * * Class structure for #GDBusObjectProxy. * * Since: 2.30 */ struct _GDBusObjectProxyClass { GObjectClass parent_class; /*< private >*/ gpointer padding[8]; }; GLIB_AVAILABLE_IN_ALL GType g_dbus_object_proxy_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GDBusObjectProxy *g_dbus_object_proxy_new (GDBusConnection *connection, const gchar *object_path); GLIB_AVAILABLE_IN_ALL GDBusConnection *g_dbus_object_proxy_get_connection (GDBusObjectProxy *proxy); G_END_DECLS #endif /* __G_DBUS_OBJECT_PROXY_H */ gio/gsimpleactiongroup.h 0000644 00000010403 15125173651 0011412 0 ustar 00 /* * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_SIMPLE_ACTION_GROUP_H__ #define __G_SIMPLE_ACTION_GROUP_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include "gactiongroup.h" #include "gactionmap.h" G_BEGIN_DECLS #define G_TYPE_SIMPLE_ACTION_GROUP (g_simple_action_group_get_type ()) #define G_SIMPLE_ACTION_GROUP(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SIMPLE_ACTION_GROUP, GSimpleActionGroup)) #define G_SIMPLE_ACTION_GROUP_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_SIMPLE_ACTION_GROUP, GSimpleActionGroupClass)) #define G_IS_SIMPLE_ACTION_GROUP(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_SIMPLE_ACTION_GROUP)) #define G_IS_SIMPLE_ACTION_GROUP_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \ G_TYPE_SIMPLE_ACTION_GROUP)) #define G_SIMPLE_ACTION_GROUP_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_SIMPLE_ACTION_GROUP, GSimpleActionGroupClass)) typedef struct _GSimpleActionGroupPrivate GSimpleActionGroupPrivate; typedef struct _GSimpleActionGroupClass GSimpleActionGroupClass; /** * GSimpleActionGroup: * * The #GSimpleActionGroup structure contains private data and should only be accessed using the provided API. * * Since: 2.28 */ struct _GSimpleActionGroup { /*< private >*/ GObject parent_instance; GSimpleActionGroupPrivate *priv; }; struct _GSimpleActionGroupClass { /*< private >*/ GObjectClass parent_class; /*< private >*/ gpointer padding[12]; }; GLIB_AVAILABLE_IN_ALL GType g_simple_action_group_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSimpleActionGroup * g_simple_action_group_new (void); GLIB_DEPRECATED_IN_2_38_FOR (g_action_map_lookup_action) GAction * g_simple_action_group_lookup (GSimpleActionGroup *simple, const gchar *action_name); GLIB_DEPRECATED_IN_2_38_FOR (g_action_map_add_action) void g_simple_action_group_insert (GSimpleActionGroup *simple, GAction *action); GLIB_DEPRECATED_IN_2_38_FOR (g_action_map_remove_action) void g_simple_action_group_remove (GSimpleActionGroup *simple, const gchar *action_name); GLIB_DEPRECATED_IN_2_38_FOR (g_action_map_add_action_entries) void g_simple_action_group_add_entries (GSimpleActionGroup *simple, const GActionEntry *entries, gint n_entries, gpointer user_data); G_END_DECLS #endif /* __G_SIMPLE_ACTION_GROUP_H__ */ gio/gmenu.h 0000644 00000021354 15125173651 0006621 0 ustar 00 /* * Copyright © 2011 Canonical Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_MENU_H__ #define __G_MENU_H__ #include <gio/gmenumodel.h> G_BEGIN_DECLS #define G_TYPE_MENU (g_menu_get_type ()) #define G_MENU(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_MENU, GMenu)) #define G_IS_MENU(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_MENU)) #define G_TYPE_MENU_ITEM (g_menu_item_get_type ()) #define G_MENU_ITEM(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_MENU_ITEM, GMenuItem)) #define G_IS_MENU_ITEM(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_MENU_ITEM)) typedef struct _GMenuItem GMenuItem; typedef struct _GMenu GMenu; GLIB_AVAILABLE_IN_2_32 GType g_menu_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_32 GMenu * g_menu_new (void); GLIB_AVAILABLE_IN_2_32 void g_menu_freeze (GMenu *menu); GLIB_AVAILABLE_IN_2_32 void g_menu_insert_item (GMenu *menu, gint position, GMenuItem *item); GLIB_AVAILABLE_IN_2_32 void g_menu_prepend_item (GMenu *menu, GMenuItem *item); GLIB_AVAILABLE_IN_2_32 void g_menu_append_item (GMenu *menu, GMenuItem *item); GLIB_AVAILABLE_IN_2_32 void g_menu_remove (GMenu *menu, gint position); GLIB_AVAILABLE_IN_2_38 void g_menu_remove_all (GMenu *menu); GLIB_AVAILABLE_IN_2_32 void g_menu_insert (GMenu *menu, gint position, const gchar *label, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_32 void g_menu_prepend (GMenu *menu, const gchar *label, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_32 void g_menu_append (GMenu *menu, const gchar *label, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_32 void g_menu_insert_section (GMenu *menu, gint position, const gchar *label, GMenuModel *section); GLIB_AVAILABLE_IN_2_32 void g_menu_prepend_section (GMenu *menu, const gchar *label, GMenuModel *section); GLIB_AVAILABLE_IN_2_32 void g_menu_append_section (GMenu *menu, const gchar *label, GMenuModel *section); GLIB_AVAILABLE_IN_2_32 void g_menu_insert_submenu (GMenu *menu, gint position, const gchar *label, GMenuModel *submenu); GLIB_AVAILABLE_IN_2_32 void g_menu_prepend_submenu (GMenu *menu, const gchar *label, GMenuModel *submenu); GLIB_AVAILABLE_IN_2_32 void g_menu_append_submenu (GMenu *menu, const gchar *label, GMenuModel *submenu); GLIB_AVAILABLE_IN_2_32 GType g_menu_item_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_32 GMenuItem * g_menu_item_new (const gchar *label, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_34 GMenuItem * g_menu_item_new_from_model (GMenuModel *model, gint item_index); GLIB_AVAILABLE_IN_2_32 GMenuItem * g_menu_item_new_submenu (const gchar *label, GMenuModel *submenu); GLIB_AVAILABLE_IN_2_32 GMenuItem * g_menu_item_new_section (const gchar *label, GMenuModel *section); GLIB_AVAILABLE_IN_2_34 GVariant * g_menu_item_get_attribute_value (GMenuItem *menu_item, const gchar *attribute, const GVariantType *expected_type); GLIB_AVAILABLE_IN_2_34 gboolean g_menu_item_get_attribute (GMenuItem *menu_item, const gchar *attribute, const gchar *format_string, ...); GLIB_AVAILABLE_IN_2_34 GMenuModel *g_menu_item_get_link (GMenuItem *menu_item, const gchar *link); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_attribute_value (GMenuItem *menu_item, const gchar *attribute, GVariant *value); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_attribute (GMenuItem *menu_item, const gchar *attribute, const gchar *format_string, ...); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_link (GMenuItem *menu_item, const gchar *link, GMenuModel *model); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_label (GMenuItem *menu_item, const gchar *label); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_submenu (GMenuItem *menu_item, GMenuModel *submenu); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_section (GMenuItem *menu_item, GMenuModel *section); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_action_and_target_value (GMenuItem *menu_item, const gchar *action, GVariant *target_value); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_action_and_target (GMenuItem *menu_item, const gchar *action, const gchar *format_string, ...); GLIB_AVAILABLE_IN_2_32 void g_menu_item_set_detailed_action (GMenuItem *menu_item, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_38 void g_menu_item_set_icon (GMenuItem *menu_item, GIcon *icon); G_END_DECLS #endif /* __G_MENU_H__ */ gio/gnotification.h 0000644 00000011442 15125173651 0010340 0 ustar 00 /* * Copyright © 2013 Lars Uebernickel * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Lars Uebernickel <lars@uebernic.de> */ #ifndef __G_NOTIFICATION_H__ #define __G_NOTIFICATION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> #include <gio/gioenums.h> G_BEGIN_DECLS #define G_TYPE_NOTIFICATION (g_notification_get_type ()) #define G_NOTIFICATION(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_NOTIFICATION, GNotification)) #define G_IS_NOTIFICATION(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_NOTIFICATION)) GLIB_AVAILABLE_IN_2_40 GType g_notification_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_40 GNotification * g_notification_new (const gchar *title); GLIB_AVAILABLE_IN_2_40 void g_notification_set_title (GNotification *notification, const gchar *title); GLIB_AVAILABLE_IN_2_40 void g_notification_set_body (GNotification *notification, const gchar *body); GLIB_AVAILABLE_IN_2_40 void g_notification_set_icon (GNotification *notification, GIcon *icon); GLIB_DEPRECATED_IN_2_42_FOR(g_notification_set_priority) void g_notification_set_urgent (GNotification *notification, gboolean urgent); GLIB_AVAILABLE_IN_2_42 void g_notification_set_priority (GNotification *notification, GNotificationPriority priority); GLIB_AVAILABLE_IN_2_40 void g_notification_add_button (GNotification *notification, const gchar *label, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_40 void g_notification_add_button_with_target (GNotification *notification, const gchar *label, const gchar *action, const gchar *target_format, ...); GLIB_AVAILABLE_IN_2_40 void g_notification_add_button_with_target_value (GNotification *notification, const gchar *label, const gchar *action, GVariant *target); GLIB_AVAILABLE_IN_2_40 void g_notification_set_default_action (GNotification *notification, const gchar *detailed_action); GLIB_AVAILABLE_IN_2_40 void g_notification_set_default_action_and_target (GNotification *notification, const gchar *action, const gchar *target_format, ...); GLIB_AVAILABLE_IN_2_40 void g_notification_set_default_action_and_target_value (GNotification *notification, const gchar *action, GVariant *target); G_END_DECLS #endif gio/gsocketcontrolmessage.h 0000644 00000011426 15125173651 0012112 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2009 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_SOCKET_CONTROL_MESSAGE_H__ #define __G_SOCKET_CONTROL_MESSAGE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SOCKET_CONTROL_MESSAGE (g_socket_control_message_get_type ()) #define G_SOCKET_CONTROL_MESSAGE(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SOCKET_CONTROL_MESSAGE, \ GSocketControlMessage)) #define G_SOCKET_CONTROL_MESSAGE_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_SOCKET_CONTROL_MESSAGE, \ GSocketControlMessageClass)) #define G_IS_SOCKET_CONTROL_MESSAGE(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_SOCKET_CONTROL_MESSAGE)) #define G_IS_SOCKET_CONTROL_MESSAGE_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \ G_TYPE_SOCKET_CONTROL_MESSAGE)) #define G_SOCKET_CONTROL_MESSAGE_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_SOCKET_CONTROL_MESSAGE, \ GSocketControlMessageClass)) typedef struct _GSocketControlMessagePrivate GSocketControlMessagePrivate; typedef struct _GSocketControlMessageClass GSocketControlMessageClass; /** * GSocketControlMessageClass: * @get_size: gets the size of the message. * @get_level: gets the protocol of the message. * @get_type: gets the protocol specific type of the message. * @serialize: Writes out the message data. * @deserialize: Tries to deserialize a message. * * Class structure for #GSocketControlMessage. **/ struct _GSocketControlMessageClass { GObjectClass parent_class; gsize (* get_size) (GSocketControlMessage *message); int (* get_level) (GSocketControlMessage *message); int (* get_type) (GSocketControlMessage *message); void (* serialize) (GSocketControlMessage *message, gpointer data); GSocketControlMessage *(* deserialize) (int level, int type, gsize size, gpointer data); /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); }; struct _GSocketControlMessage { GObject parent_instance; GSocketControlMessagePrivate *priv; }; GLIB_AVAILABLE_IN_ALL GType g_socket_control_message_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gsize g_socket_control_message_get_size (GSocketControlMessage *message); GLIB_AVAILABLE_IN_ALL int g_socket_control_message_get_level (GSocketControlMessage *message); GLIB_AVAILABLE_IN_ALL int g_socket_control_message_get_msg_type (GSocketControlMessage *message); GLIB_AVAILABLE_IN_ALL void g_socket_control_message_serialize (GSocketControlMessage *message, gpointer data); GLIB_AVAILABLE_IN_ALL GSocketControlMessage *g_socket_control_message_deserialize (int level, int type, gsize size, gpointer data); G_END_DECLS #endif /* __G_SOCKET_CONTROL_MESSAGE_H__ */ gio/gtlsfiledatabase.h 0000644 00000003565 15125173651 0011010 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2010 Collabora, Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * See the included COPYING file for more information. * * Author: Stef Walter <stefw@collabora.co.uk> */ #ifndef __G_TLS_FILE_DATABASE_H__ #define __G_TLS_FILE_DATABASE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_TLS_FILE_DATABASE (g_tls_file_database_get_type ()) #define G_TLS_FILE_DATABASE(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), G_TYPE_TLS_FILE_DATABASE, GTlsFileDatabase)) #define G_IS_TLS_FILE_DATABASE(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_TLS_FILE_DATABASE)) #define G_TLS_FILE_DATABASE_GET_INTERFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), G_TYPE_TLS_FILE_DATABASE, GTlsFileDatabaseInterface)) typedef struct _GTlsFileDatabaseInterface GTlsFileDatabaseInterface; /** * GTlsFileDatabaseInterface: * @g_iface: The parent interface. * * Provides an interface for #GTlsFileDatabase implementations. * */ struct _GTlsFileDatabaseInterface { GTypeInterface g_iface; /*< private >*/ /* Padding for future expansion */ gpointer padding[8]; }; GLIB_AVAILABLE_IN_ALL GType g_tls_file_database_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GTlsDatabase* g_tls_file_database_new (const gchar *anchors, GError **error); G_END_DECLS #endif /* __G_TLS_FILE_DATABASE_H___ */ gio/gsocketclient.h 0000644 00000025713 15125173651 0010347 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2008, 2009 Codethink Limited * Copyright © 2009 Red Hat, Inc * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> * Alexander Larsson <alexl@redhat.com> */ #ifndef __G_SOCKET_CLIENT_H__ #define __G_SOCKET_CLIENT_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_SOCKET_CLIENT (g_socket_client_get_type ()) #define G_SOCKET_CLIENT(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_SOCKET_CLIENT, GSocketClient)) #define G_SOCKET_CLIENT_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_SOCKET_CLIENT, GSocketClientClass)) #define G_IS_SOCKET_CLIENT(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_SOCKET_CLIENT)) #define G_IS_SOCKET_CLIENT_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \ G_TYPE_SOCKET_CLIENT)) #define G_SOCKET_CLIENT_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_SOCKET_CLIENT, GSocketClientClass)) typedef struct _GSocketClientPrivate GSocketClientPrivate; typedef struct _GSocketClientClass GSocketClientClass; struct _GSocketClientClass { GObjectClass parent_class; void (* event) (GSocketClient *client, GSocketClientEvent event, GSocketConnectable *connectable, GIOStream *connection); /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); }; struct _GSocketClient { GObject parent_instance; GSocketClientPrivate *priv; }; GLIB_AVAILABLE_IN_ALL GType g_socket_client_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GSocketClient *g_socket_client_new (void); GLIB_AVAILABLE_IN_ALL GSocketFamily g_socket_client_get_family (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_family (GSocketClient *client, GSocketFamily family); GLIB_AVAILABLE_IN_ALL GSocketType g_socket_client_get_socket_type (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_socket_type (GSocketClient *client, GSocketType type); GLIB_AVAILABLE_IN_ALL GSocketProtocol g_socket_client_get_protocol (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_protocol (GSocketClient *client, GSocketProtocol protocol); GLIB_AVAILABLE_IN_ALL GSocketAddress *g_socket_client_get_local_address (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_local_address (GSocketClient *client, GSocketAddress *address); GLIB_AVAILABLE_IN_ALL guint g_socket_client_get_timeout (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_timeout (GSocketClient *client, guint timeout); GLIB_AVAILABLE_IN_ALL gboolean g_socket_client_get_enable_proxy (GSocketClient *client); GLIB_AVAILABLE_IN_ALL void g_socket_client_set_enable_proxy (GSocketClient *client, gboolean enable); GLIB_AVAILABLE_IN_2_28 gboolean g_socket_client_get_tls (GSocketClient *client); GLIB_AVAILABLE_IN_2_28 void g_socket_client_set_tls (GSocketClient *client, gboolean tls); GLIB_AVAILABLE_IN_2_28 GTlsCertificateFlags g_socket_client_get_tls_validation_flags (GSocketClient *client); GLIB_AVAILABLE_IN_2_28 void g_socket_client_set_tls_validation_flags (GSocketClient *client, GTlsCertificateFlags flags); GLIB_AVAILABLE_IN_2_36 GProxyResolver *g_socket_client_get_proxy_resolver (GSocketClient *client); GLIB_AVAILABLE_IN_2_36 void g_socket_client_set_proxy_resolver (GSocketClient *client, GProxyResolver *proxy_resolver); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect (GSocketClient *client, GSocketConnectable *connectable, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_to_host (GSocketClient *client, const gchar *host_and_port, guint16 default_port, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_to_service (GSocketClient *client, const gchar *domain, const gchar *service, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_26 GSocketConnection * g_socket_client_connect_to_uri (GSocketClient *client, const gchar *uri, guint16 default_port, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_socket_client_connect_async (GSocketClient *client, GSocketConnectable *connectable, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_finish (GSocketClient *client, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL void g_socket_client_connect_to_host_async (GSocketClient *client, const gchar *host_and_port, guint16 default_port, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_to_host_finish (GSocketClient *client, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL void g_socket_client_connect_to_service_async (GSocketClient *client, const gchar *domain, const gchar *service, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_to_service_finish (GSocketClient *client, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL void g_socket_client_connect_to_uri_async (GSocketClient *client, const gchar *uri, guint16 default_port, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GSocketConnection * g_socket_client_connect_to_uri_finish (GSocketClient *client, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL void g_socket_client_add_application_proxy (GSocketClient *client, const gchar *protocol); G_END_DECLS #endif /* __G_SOCKET_CLIENT_H___ */ gio/gnetworking.h 0000644 00000003645 15125173651 0010047 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2008-2011 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_NETWORKING_H__ #define __G_NETWORKING_H__ #include <glib.h> #ifdef G_OS_WIN32 #include <winsock2.h> #include <ws2tcpip.h> #include <windns.h> #include <mswsock.h> #include <wspiapi.h> #include <iphlpapi.h> #undef interface #else /* !G_OS_WIN32 */ #include <sys/types.h> #include <netdb.h> #include <netinet/in.h> #include <netinet/tcp.h> #include <resolv.h> #include <sys/socket.h> #include <sys/un.h> #include <net/if.h> #include <arpa/inet.h> #include <arpa/nameser.h> #ifndef T_SRV #define T_SRV 33 #endif #ifndef _PATH_RESCONF #define _PATH_RESCONF "/etc/resolv.conf" #endif #ifndef CMSG_LEN /* CMSG_LEN and CMSG_SPACE are defined by RFC 2292, but missing on * some older platforms. */ #define CMSG_LEN(len) ((size_t)CMSG_DATA((struct cmsghdr *)NULL) + (len)) /* CMSG_SPACE must add at least as much padding as CMSG_NXTHDR() * adds. We overestimate here. */ #define GLIB_ALIGN_TO_SIZEOF(len, obj) (((len) + sizeof (obj) - 1) & ~(sizeof (obj) - 1)) #define CMSG_SPACE(len) GLIB_ALIGN_TO_SIZEOF (CMSG_LEN (len), struct cmsghdr) #endif #endif G_BEGIN_DECLS GLIB_AVAILABLE_IN_2_36 void g_networking_init (void); G_END_DECLS #endif /* __G_NETWORKING_H__ */ gio/gpollableoutputstream.h 0000644 00000011466 15125173651 0012147 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_POLLABLE_OUTPUT_STREAM_H__ #define __G_POLLABLE_OUTPUT_STREAM_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gio.h> G_BEGIN_DECLS #define G_TYPE_POLLABLE_OUTPUT_STREAM (g_pollable_output_stream_get_type ()) #define G_POLLABLE_OUTPUT_STREAM(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_POLLABLE_OUTPUT_STREAM, GPollableOutputStream)) #define G_IS_POLLABLE_OUTPUT_STREAM(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_POLLABLE_OUTPUT_STREAM)) #define G_POLLABLE_OUTPUT_STREAM_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_POLLABLE_OUTPUT_STREAM, GPollableOutputStreamInterface)) /** * GPollableOutputStream: * * An interface for a #GOutputStream that can be polled for writeability. * * Since: 2.28 */ typedef struct _GPollableOutputStreamInterface GPollableOutputStreamInterface; /** * GPollableOutputStreamInterface: * @g_iface: The parent interface. * @can_poll: Checks if the #GPollableOutputStream instance is actually pollable * @is_writable: Checks if the stream is writable * @create_source: Creates a #GSource to poll the stream * @write_nonblocking: Does a non-blocking write or returns * %G_IO_ERROR_WOULD_BLOCK * @writev_nonblocking: Does a vectored non-blocking write, or returns * %G_POLLABLE_RETURN_WOULD_BLOCK * * The interface for pollable output streams. * * The default implementation of @can_poll always returns %TRUE. * * The default implementation of @write_nonblocking calls * g_pollable_output_stream_is_writable(), and then calls * g_output_stream_write() if it returns %TRUE. This means you only * need to override it if it is possible that your @is_writable * implementation may return %TRUE when the stream is not actually * writable. * * The default implementation of @writev_nonblocking calls * g_pollable_output_stream_write_nonblocking() for each vector, and converts * its return value and error (if set) to a #GPollableReturn. You should * override this where possible to avoid having to allocate a #GError to return * %G_IO_ERROR_WOULD_BLOCK. * * Since: 2.28 */ struct _GPollableOutputStreamInterface { GTypeInterface g_iface; /* Virtual Table */ gboolean (*can_poll) (GPollableOutputStream *stream); gboolean (*is_writable) (GPollableOutputStream *stream); GSource * (*create_source) (GPollableOutputStream *stream, GCancellable *cancellable); gssize (*write_nonblocking) (GPollableOutputStream *stream, const void *buffer, gsize count, GError **error); GPollableReturn (*writev_nonblocking) (GPollableOutputStream *stream, const GOutputVector *vectors, gsize n_vectors, gsize *bytes_written, GError **error); }; GLIB_AVAILABLE_IN_ALL GType g_pollable_output_stream_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_pollable_output_stream_can_poll (GPollableOutputStream *stream); GLIB_AVAILABLE_IN_ALL gboolean g_pollable_output_stream_is_writable (GPollableOutputStream *stream); GLIB_AVAILABLE_IN_ALL GSource *g_pollable_output_stream_create_source (GPollableOutputStream *stream, GCancellable *cancellable); GLIB_AVAILABLE_IN_ALL gssize g_pollable_output_stream_write_nonblocking (GPollableOutputStream *stream, const void *buffer, gsize count, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_2_60 GPollableReturn g_pollable_output_stream_writev_nonblocking (GPollableOutputStream *stream, const GOutputVector *vectors, gsize n_vectors, gsize *bytes_written, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_POLLABLE_OUTPUT_STREAM_H__ */ gio/gliststore.h 0000644 00000010122 15125173651 0007674 0 ustar 00 /* * Copyright 2015 Lars Uebernickel * Copyright 2015 Ryan Lortie * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: * Lars Uebernickel <lars@uebernic.de> * Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_LIST_STORE_H__ #define __G_LIST_STORE_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_LIST_STORE (g_list_store_get_type ()) GLIB_AVAILABLE_IN_2_44 G_DECLARE_FINAL_TYPE(GListStore, g_list_store, G, LIST_STORE, GObject) GLIB_AVAILABLE_IN_2_44 GListStore * g_list_store_new (GType item_type); GLIB_AVAILABLE_IN_2_44 void g_list_store_insert (GListStore *store, guint position, gpointer item); GLIB_AVAILABLE_IN_2_44 guint g_list_store_insert_sorted (GListStore *store, gpointer item, GCompareDataFunc compare_func, gpointer user_data); GLIB_AVAILABLE_IN_2_46 void g_list_store_sort (GListStore *store, GCompareDataFunc compare_func, gpointer user_data); GLIB_AVAILABLE_IN_2_44 void g_list_store_append (GListStore *store, gpointer item); GLIB_AVAILABLE_IN_2_44 void g_list_store_remove (GListStore *store, guint position); GLIB_AVAILABLE_IN_2_44 void g_list_store_remove_all (GListStore *store); GLIB_AVAILABLE_IN_2_44 void g_list_store_splice (GListStore *store, guint position, guint n_removals, gpointer *additions, guint n_additions); GLIB_AVAILABLE_IN_2_64 gboolean g_list_store_find (GListStore *store, gpointer item, guint *position); GLIB_AVAILABLE_IN_2_64 gboolean g_list_store_find_with_equal_func (GListStore *store, gpointer item, GEqualFunc equal_func, guint *position); G_END_DECLS #endif /* __G_LIST_STORE_H__ */ gio/gdbusobjectskeleton.h 0000644 00000007565 15125173651 0011556 0 ustar 00 /* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: David Zeuthen <davidz@redhat.com> */ #ifndef __G_DBUS_OBJECT_SKELETON_H__ #define __G_DBUS_OBJECT_SKELETON_H__ #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_DBUS_OBJECT_SKELETON (g_dbus_object_skeleton_get_type ()) #define G_DBUS_OBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_OBJECT_SKELETON, GDBusObjectSkeleton)) #define G_DBUS_OBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_OBJECT_SKELETON, GDBusObjectSkeletonClass)) #define G_DBUS_OBJECT_SKELETON_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_OBJECT_SKELETON, GDBusObjectSkeletonClass)) #define G_IS_DBUS_OBJECT_SKELETON(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_OBJECT_SKELETON)) #define G_IS_DBUS_OBJECT_SKELETON_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_OBJECT_SKELETON)) typedef struct _GDBusObjectSkeletonClass GDBusObjectSkeletonClass; typedef struct _GDBusObjectSkeletonPrivate GDBusObjectSkeletonPrivate; /** * GDBusObjectSkeleton: * * The #GDBusObjectSkeleton structure contains private data and should only be * accessed using the provided API. * * Since: 2.30 */ struct _GDBusObjectSkeleton { /*< private >*/ GObject parent_instance; GDBusObjectSkeletonPrivate *priv; }; /** * GDBusObjectSkeletonClass: * @parent_class: The parent class. * @authorize_method: Signal class handler for the #GDBusObjectSkeleton::authorize-method signal. * * Class structure for #GDBusObjectSkeleton. * * Since: 2.30 */ struct _GDBusObjectSkeletonClass { GObjectClass parent_class; /* Signals */ gboolean (*authorize_method) (GDBusObjectSkeleton *object, GDBusInterfaceSkeleton *interface_, GDBusMethodInvocation *invocation); /*< private >*/ gpointer padding[8]; }; GLIB_AVAILABLE_IN_ALL GType g_dbus_object_skeleton_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GDBusObjectSkeleton *g_dbus_object_skeleton_new (const gchar *object_path); GLIB_AVAILABLE_IN_ALL void g_dbus_object_skeleton_flush (GDBusObjectSkeleton *object); GLIB_AVAILABLE_IN_ALL void g_dbus_object_skeleton_add_interface (GDBusObjectSkeleton *object, GDBusInterfaceSkeleton *interface_); GLIB_AVAILABLE_IN_ALL void g_dbus_object_skeleton_remove_interface (GDBusObjectSkeleton *object, GDBusInterfaceSkeleton *interface_); GLIB_AVAILABLE_IN_ALL void g_dbus_object_skeleton_remove_interface_by_name (GDBusObjectSkeleton *object, const gchar *interface_name); GLIB_AVAILABLE_IN_ALL void g_dbus_object_skeleton_set_object_path (GDBusObjectSkeleton *object, const gchar *object_path); G_END_DECLS #endif /* __G_DBUS_OBJECT_SKELETON_H */ gio/gfileenumerator.h 0000644 00000014371 15125173651 0010677 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_FILE_ENUMERATOR_H__ #define __G_FILE_ENUMERATOR_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_FILE_ENUMERATOR (g_file_enumerator_get_type ()) #define G_FILE_ENUMERATOR(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_ENUMERATOR, GFileEnumerator)) #define G_FILE_ENUMERATOR_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_ENUMERATOR, GFileEnumeratorClass)) #define G_IS_FILE_ENUMERATOR(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_ENUMERATOR)) #define G_IS_FILE_ENUMERATOR_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_ENUMERATOR)) #define G_FILE_ENUMERATOR_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_ENUMERATOR, GFileEnumeratorClass)) /** * GFileEnumerator: * * A per matched file iterator. **/ typedef struct _GFileEnumeratorClass GFileEnumeratorClass; typedef struct _GFileEnumeratorPrivate GFileEnumeratorPrivate; struct _GFileEnumerator { GObject parent_instance; /*< private >*/ GFileEnumeratorPrivate *priv; }; struct _GFileEnumeratorClass { GObjectClass parent_class; /* Virtual Table */ GFileInfo * (* next_file) (GFileEnumerator *enumerator, GCancellable *cancellable, GError **error); gboolean (* close_fn) (GFileEnumerator *enumerator, GCancellable *cancellable, GError **error); void (* next_files_async) (GFileEnumerator *enumerator, int num_files, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GList * (* next_files_finish) (GFileEnumerator *enumerator, GAsyncResult *result, GError **error); void (* close_async) (GFileEnumerator *enumerator, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean (* close_finish) (GFileEnumerator *enumerator, GAsyncResult *result, GError **error); /*< private >*/ /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); void (*_g_reserved6) (void); void (*_g_reserved7) (void); }; GLIB_AVAILABLE_IN_ALL GType g_file_enumerator_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GFileInfo *g_file_enumerator_next_file (GFileEnumerator *enumerator, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_file_enumerator_close (GFileEnumerator *enumerator, GCancellable *cancellable, GError **error); GLIB_AVAILABLE_IN_ALL void g_file_enumerator_next_files_async (GFileEnumerator *enumerator, int num_files, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL GList * g_file_enumerator_next_files_finish (GFileEnumerator *enumerator, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL void g_file_enumerator_close_async (GFileEnumerator *enumerator, int io_priority, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); GLIB_AVAILABLE_IN_ALL gboolean g_file_enumerator_close_finish (GFileEnumerator *enumerator, GAsyncResult *result, GError **error); GLIB_AVAILABLE_IN_ALL gboolean g_file_enumerator_is_closed (GFileEnumerator *enumerator); GLIB_AVAILABLE_IN_ALL gboolean g_file_enumerator_has_pending (GFileEnumerator *enumerator); GLIB_AVAILABLE_IN_ALL void g_file_enumerator_set_pending (GFileEnumerator *enumerator, gboolean pending); GLIB_AVAILABLE_IN_ALL GFile * g_file_enumerator_get_container (GFileEnumerator *enumerator); GLIB_AVAILABLE_IN_2_36 GFile * g_file_enumerator_get_child (GFileEnumerator *enumerator, GFileInfo *info); GLIB_AVAILABLE_IN_2_44 gboolean g_file_enumerator_iterate (GFileEnumerator *direnum, GFileInfo **out_info, GFile **out_child, GCancellable *cancellable, GError **error); G_END_DECLS #endif /* __G_FILE_ENUMERATOR_H__ */ gio/gpropertyaction.h 0000644 00000003712 15125173651 0010735 0 ustar 00 /* * Copyright © 2013 Canonical Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_PROPERTY_ACTION_H__ #define __G_PROPERTY_ACTION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_PROPERTY_ACTION (g_property_action_get_type ()) #define G_PROPERTY_ACTION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_PROPERTY_ACTION, GPropertyAction)) #define G_IS_PROPERTY_ACTION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_PROPERTY_ACTION)) GLIB_AVAILABLE_IN_2_38 GType g_property_action_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_38 GPropertyAction * g_property_action_new (const gchar *name, gpointer object, const gchar *property_name); G_END_DECLS #endif /* __G_PROPERTY_ACTION_H__ */ gio/gvfs.h 0000644 00000014730 15125173651 0006453 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_VFS_H__ #define __G_VFS_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_VFS (g_vfs_get_type ()) #define G_VFS(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_VFS, GVfs)) #define G_VFS_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_VFS, GVfsClass)) #define G_VFS_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_VFS, GVfsClass)) #define G_IS_VFS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_VFS)) #define G_IS_VFS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_VFS)) /** * GVfsFileLookupFunc: * @vfs: a #GVfs * @identifier: the identifier to look up a #GFile for. This can either * be an URI or a parse name as returned by g_file_get_parse_name() * @user_data: user data passed to the function * * This function type is used by g_vfs_register_uri_scheme() to make it * possible for a client to associate an URI scheme to a different #GFile * implementation. * * The client should return a reference to the new file that has been * created for @uri, or %NULL to continue with the default implementation. * * Returns: (transfer full): a #GFile for @identifier. * * Since: 2.50 */ typedef GFile * (* GVfsFileLookupFunc) (GVfs *vfs, const char *identifier, gpointer user_data); /** * G_VFS_EXTENSION_POINT_NAME: * * Extension point for #GVfs functionality. * See [Extending GIO][extending-gio]. */ #define G_VFS_EXTENSION_POINT_NAME "gio-vfs" /** * GVfs: * * Virtual File System object. **/ typedef struct _GVfsClass GVfsClass; struct _GVfs { GObject parent_instance; }; struct _GVfsClass { GObjectClass parent_class; /* Virtual Table */ gboolean (* is_active) (GVfs *vfs); GFile * (* get_file_for_path) (GVfs *vfs, const char *path); GFile * (* get_file_for_uri) (GVfs *vfs, const char *uri); const gchar * const * (* get_supported_uri_schemes) (GVfs *vfs); GFile * (* parse_name) (GVfs *vfs, const char *parse_name); /*< private >*/ void (* local_file_add_info) (GVfs *vfs, const char *filename, guint64 device, GFileAttributeMatcher *attribute_matcher, GFileInfo *info, GCancellable *cancellable, gpointer *extra_data, GDestroyNotify *free_extra_data); void (* add_writable_namespaces) (GVfs *vfs, GFileAttributeInfoList *list); gboolean (* local_file_set_attributes) (GVfs *vfs, const char *filename, GFileInfo *info, GFileQueryInfoFlags flags, GCancellable *cancellable, GError **error); void (* local_file_removed) (GVfs *vfs, const char *filename); void (* local_file_moved) (GVfs *vfs, const char *source, const char *dest); GIcon * (* deserialize_icon) (GVfs *vfs, GVariant *value); /* Padding for future expansion */ void (*_g_reserved1) (void); void (*_g_reserved2) (void); void (*_g_reserved3) (void); void (*_g_reserved4) (void); void (*_g_reserved5) (void); void (*_g_reserved6) (void); }; GLIB_AVAILABLE_IN_ALL GType g_vfs_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL gboolean g_vfs_is_active (GVfs *vfs); GLIB_AVAILABLE_IN_ALL GFile * g_vfs_get_file_for_path (GVfs *vfs, const char *path); GLIB_AVAILABLE_IN_ALL GFile * g_vfs_get_file_for_uri (GVfs *vfs, const char *uri); GLIB_AVAILABLE_IN_ALL const gchar* const * g_vfs_get_supported_uri_schemes (GVfs *vfs); GLIB_AVAILABLE_IN_ALL GFile * g_vfs_parse_name (GVfs *vfs, const char *parse_name); GLIB_AVAILABLE_IN_ALL GVfs * g_vfs_get_default (void); GLIB_AVAILABLE_IN_ALL GVfs * g_vfs_get_local (void); GLIB_AVAILABLE_IN_2_50 gboolean g_vfs_register_uri_scheme (GVfs *vfs, const char *scheme, GVfsFileLookupFunc uri_func, gpointer uri_data, GDestroyNotify uri_destroy, GVfsFileLookupFunc parse_name_func, gpointer parse_name_data, GDestroyNotify parse_name_destroy); GLIB_AVAILABLE_IN_2_50 gboolean g_vfs_unregister_uri_scheme (GVfs *vfs, const char *scheme); G_END_DECLS #endif /* __G_VFS_H__ */ gio/gactionmap.h 0000644 00000007634 15125173651 0007635 0 ustar 00 /* * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_ACTION_MAP_H__ #define __G_ACTION_MAP_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_ACTION_MAP (g_action_map_get_type ()) #define G_ACTION_MAP(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_ACTION_MAP, GActionMap)) #define G_IS_ACTION_MAP(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \ G_TYPE_ACTION_MAP)) #define G_ACTION_MAP_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), \ G_TYPE_ACTION_MAP, GActionMapInterface)) typedef struct _GActionMapInterface GActionMapInterface; typedef struct _GActionEntry GActionEntry; struct _GActionMapInterface { GTypeInterface g_iface; GAction * (* lookup_action) (GActionMap *action_map, const gchar *action_name); void (* add_action) (GActionMap *action_map, GAction *action); void (* remove_action) (GActionMap *action_map, const gchar *action_name); }; struct _GActionEntry { const gchar *name; void (* activate) (GSimpleAction *action, GVariant *parameter, gpointer user_data); const gchar *parameter_type; const gchar *state; void (* change_state) (GSimpleAction *action, GVariant *value, gpointer user_data); /*< private >*/ gsize padding[3]; }; GLIB_AVAILABLE_IN_2_32 GType g_action_map_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_32 GAction * g_action_map_lookup_action (GActionMap *action_map, const gchar *action_name); GLIB_AVAILABLE_IN_2_32 void g_action_map_add_action (GActionMap *action_map, GAction *action); GLIB_AVAILABLE_IN_2_32 void g_action_map_remove_action (GActionMap *action_map, const gchar *action_name); GLIB_AVAILABLE_IN_2_32 void g_action_map_add_action_entries (GActionMap *action_map, const GActionEntry *entries, gint n_entries, gpointer user_data); G_END_DECLS #endif /* __G_ACTION_MAP_H__ */ gio/gfileinfo.h 0000644 00000126707 15125173651 0007460 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright (C) 2006-2007 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Author: Alexander Larsson <alexl@redhat.com> */ #ifndef __G_FILE_INFO_H__ #define __G_FILE_INFO_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_FILE_INFO (g_file_info_get_type ()) #define G_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_INFO, GFileInfo)) #define G_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_INFO, GFileInfoClass)) #define G_IS_FILE_INFO(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_INFO)) #define G_IS_FILE_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_INFO)) #define G_FILE_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_INFO, GFileInfoClass)) /** * GFileInfo: * * Stores information about a file system object referenced by a #GFile. **/ typedef struct _GFileInfoClass GFileInfoClass; /* Common Attributes: */ /** * G_FILE_ATTRIBUTE_STANDARD_TYPE: * * A key in the "standard" namespace for storing file types. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * The value for this key should contain a #GFileType. **/ #define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type" /* uint32 (GFileType) */ /** * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN: * * A key in the "standard" namespace for checking if a file is hidden. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden" /* boolean */ /** * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP: * * A key in the "standard" namespace for checking if a file is a backup file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup" /* boolean */ /** * G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK: * * A key in the "standard" namespace for checking if the file is a symlink. * Typically the actual type is something else, if we followed the symlink * to get the type. * On Windows NTFS mountpoints are considered to be symlinks as well. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink" /* boolean */ /** * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL: * * A key in the "standard" namespace for checking if a file is virtual. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual" /* boolean */ /** * G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE: * * A key in the "standard" namespace for checking if a file is * volatile. This is meant for opaque, non-POSIX-like backends to * indicate that the URI is not persistent. Applications should look * at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI. * * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.46 **/ #define G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE "standard::is-volatile" /* boolean */ /** * G_FILE_ATTRIBUTE_STANDARD_NAME: * * A key in the "standard" namespace for getting the name of the file. * The name is the on-disk filename which may not be in any known encoding, * and can thus not be generally displayed as is. It is guaranteed to be set on * every file. * Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the * name in a user interface. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name" /* byte string */ /** * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME: * * A key in the "standard" namespace for getting the display name of the file. * A display name is guaranteed to be in UTF-8 and can thus be displayed in * the UI. It is guaranteed to be set on every file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME: * * A key in the "standard" namespace for edit name of the file. * An edit name is similar to the display name, but it is meant to be * used when you want to rename the file in the UI. The display name * might contain information you don't want in the new filename (such as * "(invalid unicode)" if the filename was in an invalid encoding). * * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME: * * A key in the "standard" namespace for getting the copy name of the file. * The copy name is an optional version of the name. If available it's always * in UTF8, and corresponds directly to the original filename (only transcoded to * UTF8). This is useful if you want to copy the file to another filesystem that * might have a different encoding. If the filename is not a valid string in the * encoding selected for the filesystem it is in then the copy name will not be set. * * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION: * * A key in the "standard" namespace for getting the description of the file. * The description is a utf8 string that describes the file, generally containing * the filename, but can also contain further information. Example descriptions * could be "filename (on hostname)" for a remote file or "filename (in trash)" * for a file in the trash. This is useful for instance as the window title * when displaying a directory or for a bookmarks menu. * * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION "standard::description" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_ICON: * * A key in the "standard" namespace for getting the icon for the file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. * The value for this key should contain a #GIcon. **/ #define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon" /* object (GIcon) */ /** * G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON: * * A key in the "standard" namespace for getting the symbolic icon for the file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. * The value for this key should contain a #GIcon. * * Since: 2.34 **/ #define G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON "standard::symbolic-icon" /* object (GIcon) */ /** * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE: * * A key in the "standard" namespace for getting the content type of the file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * The value for this key should contain a valid content type. **/ #define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE: * * A key in the "standard" namespace for getting the fast content type. * The fast content type isn't as reliable as the regular one, as it * only uses the filename to guess it, but it is faster to calculate than the * regular content type. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * **/ #define G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_SIZE: * * A key in the "standard" namespace for getting the file's size (in bytes). * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. **/ #define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size" /* uint64 */ /** * G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE: * * A key in the "standard" namespace for getting the amount of disk space * that is consumed by the file (in bytes). This will generally be larger * than the file size (due to block size overhead) but can occasionally be * smaller (for example, for sparse files). * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. * * Since: 2.20 **/ #define G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE "standard::allocated-size" /* uint64 */ /** * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET: * * A key in the "standard" namespace for getting the symlink target, if the file * is a symlink. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */ /** * G_FILE_ATTRIBUTE_STANDARD_TARGET_URI: * * A key in the "standard" namespace for getting the target URI for the file, in * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri" /* string */ /** * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER: * * A key in the "standard" namespace for setting the sort order of a file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32. * An example use would be in file managers, which would use this key * to set the order files are displayed. Files with smaller sort order * should be sorted first, and files without sort order as if sort order * was zero. **/ #define G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER "standard::sort-order" /* int32 */ /* Entity tags, used to avoid missing updates on save */ /** * G_FILE_ATTRIBUTE_ETAG_VALUE: * * A key in the "etag" namespace for getting the value of the file's * entity tag. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value" /* string */ /* File identifier, for e.g. avoiding loops when doing recursive * directory scanning */ /** * G_FILE_ATTRIBUTE_ID_FILE: * * A key in the "id" namespace for getting a file identifier. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * An example use would be during listing files, to avoid recursive * directory scanning. **/ #define G_FILE_ATTRIBUTE_ID_FILE "id::file" /* string */ /** * G_FILE_ATTRIBUTE_ID_FILESYSTEM: * * A key in the "id" namespace for getting the file system identifier. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * An example use would be during drag and drop to see if the source * and target are on the same filesystem (default to move) or not (default * to copy). **/ #define G_FILE_ATTRIBUTE_ID_FILESYSTEM "id::filesystem" /* string */ /* Calculated Access Rights for current user */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_READ: * * A key in the "access" namespace for getting read privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to read the file. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read" /* boolean */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE: * * A key in the "access" namespace for getting write privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to write to the file. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write" /* boolean */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE: * * A key in the "access" namespace for getting execution privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to execute the file. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE: * * A key in the "access" namespace for checking deletion privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to delete the file. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete" /* boolean */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH: * * A key in the "access" namespace for checking trashing privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to move the file to * the trash. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access::can-trash" /* boolean */ /** * G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME: * * A key in the "access" namespace for checking renaming privileges. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * This attribute will be %TRUE if the user is able to rename the file. **/ #define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename" /* boolean */ /* TODO: Should we have special version for directories? can_enumerate, etc */ /* Mountable attributes */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE: * * A key in the "mountable" namespace for getting the unix device. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE: * * A key in the "mountable" namespace for getting the unix device file. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * * Since: 2.22 **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE "mountable::unix-device-file" /* string */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI: * * A key in the "mountable" namespace for getting the HAL UDI for the mountable * file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi" /* string */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START "mountable::can-start" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started * degraded. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED "mountable::can-start-degraded" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP "mountable::can-stop" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE: * * A key in the "mountable" namespace for getting the #GDriveStartStopType. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE "mountable::start-stop-type" /* uint32 (GDriveStartStopType) */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL "mountable::can-poll" /* boolean */ /** * G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC: * * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) * is automatically polled for media. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.22 */ #define G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC "mountable::is-media-check-automatic" /* boolean */ /* Time attributes */ /** * G_FILE_ATTRIBUTE_TIME_MODIFIED: * * A key in the "time" namespace for getting the time the file was last * modified. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the * file was modified, in seconds since the UNIX epoch. **/ #define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified" /* uint64 */ /** * G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC: * * A key in the "time" namespace for getting the microseconds of the time * the file was last modified. This should be used in conjunction with * #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */ /** * G_FILE_ATTRIBUTE_TIME_ACCESS: * * A key in the "time" namespace for getting the time the file was last * accessed. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the * file was last accessed, in seconds since the UNIX epoch. **/ #define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access" /* uint64 */ /** * G_FILE_ATTRIBUTE_TIME_ACCESS_USEC: * * A key in the "time" namespace for getting the microseconds of the time * the file was last accessed. This should be used in conjunction with * #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec" /* uint32 */ /** * G_FILE_ATTRIBUTE_TIME_CHANGED: * * A key in the "time" namespace for getting the time the file was last * changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, * and contains the time since the file was last changed, in seconds since the * UNIX epoch. * * This corresponds to the traditional UNIX ctime. **/ #define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed" /* uint64 */ /** * G_FILE_ATTRIBUTE_TIME_CHANGED_USEC: * * A key in the "time" namespace for getting the microseconds of the time * the file was last changed. This should be used in conjunction with * #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec" /* uint32 */ /** * G_FILE_ATTRIBUTE_TIME_CREATED: * * A key in the "time" namespace for getting the time the file was created. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, * and contains the time since the file was created, in seconds since the UNIX * epoch. * * This may correspond to Linux stx_btime, FreeBSD st_birthtim, NetBSD * st_birthtime or NTFS ctime. **/ #define G_FILE_ATTRIBUTE_TIME_CREATED "time::created" /* uint64 */ /** * G_FILE_ATTRIBUTE_TIME_CREATED_USEC: * * A key in the "time" namespace for getting the microseconds of the time * the file was created. This should be used in conjunction with * #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec" /* uint32 */ /* Unix specific attributes */ /** * G_FILE_ATTRIBUTE_UNIX_DEVICE: * * A key in the "unix" namespace for getting the device id of the device the * file is located on (see stat() documentation). This attribute is only * available for UNIX file systems. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_INODE: * * A key in the "unix" namespace for getting the inode of the file. * This attribute is only available for UNIX file systems. Corresponding * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. **/ #define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode" /* uint64 */ /** * G_FILE_ATTRIBUTE_UNIX_MODE: * * A key in the "unix" namespace for getting the mode of the file * (e.g. whether the file is a regular file, symlink, etc). See the * documentation for `lstat()`: this attribute is equivalent to the `st_mode` * member of `struct stat`, and includes both the file type and permissions. * This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_NLINK: * * A key in the "unix" namespace for getting the number of hard links * for a file. See lstat() documentation. This attribute is only available * for UNIX file systems. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_UID: * * A key in the "unix" namespace for getting the user ID for the file. * This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_GID: * * A key in the "unix" namespace for getting the group ID for the file. * This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_RDEV: * * A key in the "unix" namespace for getting the device ID for the file * (if it is a special file). See lstat() documentation. This attribute * is only available for UNIX file systems. Corresponding #GFileAttributeType * is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE: * * A key in the "unix" namespace for getting the block size for the file * system. This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size" /* uint32 */ /** * G_FILE_ATTRIBUTE_UNIX_BLOCKS: * * A key in the "unix" namespace for getting the number of blocks allocated * for the file. This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. **/ #define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks" /* uint64 */ /** * G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT: * * A key in the "unix" namespace for checking if the file represents a * UNIX mount point. This attribute is %TRUE if the file is a UNIX mount * point. Since 2.58, `/` is considered to be a mount point. * This attribute is only available for UNIX file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */ /* DOS specific attributes */ /** * G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE: * * A key in the "dos" namespace for checking if the file's archive flag * is set. This attribute is %TRUE if the archive flag is set. This attribute * is only available for DOS file systems. Corresponding #GFileAttributeType * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive" /* boolean */ /** * G_FILE_ATTRIBUTE_DOS_IS_SYSTEM: * * A key in the "dos" namespace for checking if the file's backup flag * is set. This attribute is %TRUE if the backup flag is set. This attribute * is only available for DOS file systems. Corresponding #GFileAttributeType * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system" /* boolean */ /** * G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT: * * A key in the "dos" namespace for checking if the file is a NTFS mount point * (a volume mount or a junction point). * This attribute is %TRUE if file is a reparse point of type * [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx). * This attribute is only available for DOS file systems. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.60 **/ #define G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT "dos::is-mountpoint" /* boolean */ /** * G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG: * * A key in the "dos" namespace for getting the file NTFS reparse tag. * This value is 0 for files that are not reparse points. * See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx) * page for possible reparse tag values. Corresponding #GFileAttributeType * is %G_FILE_ATTRIBUTE_TYPE_UINT32. * * Since: 2.60 **/ #define G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG "dos::reparse-point-tag" /* uint32 */ /* Owner attributes */ /** * G_FILE_ATTRIBUTE_OWNER_USER: * * A key in the "owner" namespace for getting the user name of the * file's owner. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_OWNER_USER "owner::user" /* string */ /** * G_FILE_ATTRIBUTE_OWNER_USER_REAL: * * A key in the "owner" namespace for getting the real name of the * user that owns the file. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real" /* string */ /** * G_FILE_ATTRIBUTE_OWNER_GROUP: * * A key in the "owner" namespace for getting the file owner's group. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group" /* string */ /* Thumbnails */ /** * G_FILE_ATTRIBUTE_THUMBNAIL_PATH: * * A key in the "thumbnail" namespace for getting the path to the thumbnail * image. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. **/ #define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path" /* bytestring */ /** * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED: * * A key in the "thumbnail" namespace for checking if thumbnailing failed. * This attribute is %TRUE if thumbnailing failed. Corresponding * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed" /* boolean */ /** * G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID: * * A key in the "thumbnail" namespace for checking whether the thumbnail is outdated. * This attribute is %TRUE if the thumbnail is up-to-date with the file it represents, * and %FALSE if the file has been modified since the thumbnail was generated. * * If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE, * it indicates that thumbnailing may be attempted again and may succeed. * * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. * * Since: 2.40 */ #define G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID "thumbnail::is-valid" /* boolean */ /* Preview */ /** * G_FILE_ATTRIBUTE_PREVIEW_ICON: * * A key in the "preview" namespace for getting a #GIcon that can be * used to get preview of the file. For example, it may be a low * resolution thumbnail without metadata. Corresponding * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value * for this key should contain a #GIcon. * * Since: 2.20 **/ #define G_FILE_ATTRIBUTE_PREVIEW_ICON "preview::icon" /* object (GIcon) */ /* File system info (for g_file_get_filesystem_info) */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE: * * A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, * used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType * is %G_FILE_ATTRIBUTE_TYPE_UINT64. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size" /* uint64 */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_FREE: * * A key in the "filesystem" namespace for getting the number of bytes of free space left on the * file system. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT64. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free" /* uint64 */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_USED: * * A key in the "filesystem" namespace for getting the number of bytes of used on the * file system. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_UINT64. * * Since: 2.32 */ #define G_FILE_ATTRIBUTE_FILESYSTEM_USED "filesystem::used" /* uint64 */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE: * * A key in the "filesystem" namespace for getting the file system's type. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type" /* string */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY: * * A key in the "filesystem" namespace for checking if the file system * is read only. Is set to %TRUE if the file system is read only. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly" /* boolean */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW: * * A key in the "filesystem" namespace for hinting a file manager * application whether it should preview (e.g. thumbnail) files on the * file system. The value for this key contain a * #GFilesystemPreviewType. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview" /* uint32 (GFilesystemPreviewType) */ /** * G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE: * * A key in the "filesystem" namespace for checking if the file system * is remote. Is set to %TRUE if the file system is remote. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. **/ #define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote" /* boolean */ /** * G_FILE_ATTRIBUTE_GVFS_BACKEND: * * A key in the "gvfs" namespace that gets the name of the current * GVFS backend in use. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_STRING. **/ #define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend" /* string */ /** * G_FILE_ATTRIBUTE_SELINUX_CONTEXT: * * A key in the "selinux" namespace for getting the file's SELinux * context. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only * available if GLib has been built with SELinux support. **/ #define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context" /* string */ /** * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT: * * A key in the "trash" namespace. When requested against * `trash:///` returns the number of (toplevel) items in the trash folder. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. **/ #define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count" /* uint32 */ /** * G_FILE_ATTRIBUTE_TRASH_ORIG_PATH: * * A key in the "trash" namespace. When requested against * items in `trash:///`, will return the original path to the file before it * was trashed. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. * * Since: 2.24 **/ #define G_FILE_ATTRIBUTE_TRASH_ORIG_PATH "trash::orig-path" /* byte string */ /** * G_FILE_ATTRIBUTE_TRASH_DELETION_DATE: * * A key in the "trash" namespace. When requested against * items in `trash:///`, will return the date and time when the file * was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * * Since: 2.24 **/ #define G_FILE_ATTRIBUTE_TRASH_DELETION_DATE "trash::deletion-date" /* string */ /** * G_FILE_ATTRIBUTE_RECENT_MODIFIED: * * A key in the "recent" namespace for getting time, when the metadata for the * file in `recent:///` was last changed. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_INT64. * * Since: 2.52 **/ #define G_FILE_ATTRIBUTE_RECENT_MODIFIED "recent::modified" /* int64 (time_t) */ GLIB_AVAILABLE_IN_ALL GType g_file_info_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GFileInfo * g_file_info_new (void); GLIB_AVAILABLE_IN_ALL GFileInfo * g_file_info_dup (GFileInfo *other); GLIB_AVAILABLE_IN_ALL void g_file_info_copy_into (GFileInfo *src_info, GFileInfo *dest_info); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_has_attribute (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_has_namespace (GFileInfo *info, const char *name_space); GLIB_AVAILABLE_IN_ALL char ** g_file_info_list_attributes (GFileInfo *info, const char *name_space); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_get_attribute_data (GFileInfo *info, const char *attribute, GFileAttributeType *type, gpointer *value_pp, GFileAttributeStatus *status); GLIB_AVAILABLE_IN_ALL GFileAttributeType g_file_info_get_attribute_type (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL void g_file_info_remove_attribute (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL GFileAttributeStatus g_file_info_get_attribute_status (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_set_attribute_status (GFileInfo *info, const char *attribute, GFileAttributeStatus status); GLIB_AVAILABLE_IN_ALL char * g_file_info_get_attribute_as_string (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_attribute_string (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_attribute_byte_string (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_get_attribute_boolean (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL guint32 g_file_info_get_attribute_uint32 (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL gint32 g_file_info_get_attribute_int32 (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL guint64 g_file_info_get_attribute_uint64 (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL gint64 g_file_info_get_attribute_int64 (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL GObject * g_file_info_get_attribute_object (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL char ** g_file_info_get_attribute_stringv (GFileInfo *info, const char *attribute); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute (GFileInfo *info, const char *attribute, GFileAttributeType type, gpointer value_p); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_string (GFileInfo *info, const char *attribute, const char *attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_byte_string (GFileInfo *info, const char *attribute, const char *attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_boolean (GFileInfo *info, const char *attribute, gboolean attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_uint32 (GFileInfo *info, const char *attribute, guint32 attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_int32 (GFileInfo *info, const char *attribute, gint32 attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_uint64 (GFileInfo *info, const char *attribute, guint64 attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_int64 (GFileInfo *info, const char *attribute, gint64 attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_object (GFileInfo *info, const char *attribute, GObject *attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_stringv (GFileInfo *info, const char *attribute, char **attr_value); GLIB_AVAILABLE_IN_ALL void g_file_info_clear_status (GFileInfo *info); /* Helper getters: */ GLIB_AVAILABLE_IN_2_36 GDateTime * g_file_info_get_deletion_date (GFileInfo *info); GLIB_AVAILABLE_IN_ALL GFileType g_file_info_get_file_type (GFileInfo *info); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_get_is_hidden (GFileInfo *info); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_get_is_backup (GFileInfo *info); GLIB_AVAILABLE_IN_ALL gboolean g_file_info_get_is_symlink (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_name (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_display_name (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_edit_name (GFileInfo *info); GLIB_AVAILABLE_IN_ALL GIcon * g_file_info_get_icon (GFileInfo *info); GLIB_AVAILABLE_IN_ALL GIcon * g_file_info_get_symbolic_icon (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_content_type (GFileInfo *info); GLIB_AVAILABLE_IN_ALL goffset g_file_info_get_size (GFileInfo *info); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_file_info_get_modification_date_time) void g_file_info_get_modification_time (GFileInfo *info, GTimeVal *result); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_2_62 GDateTime * g_file_info_get_modification_date_time (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_symlink_target (GFileInfo *info); GLIB_AVAILABLE_IN_ALL const char * g_file_info_get_etag (GFileInfo *info); GLIB_AVAILABLE_IN_ALL gint32 g_file_info_get_sort_order (GFileInfo *info); GLIB_AVAILABLE_IN_ALL void g_file_info_set_attribute_mask (GFileInfo *info, GFileAttributeMatcher *mask); GLIB_AVAILABLE_IN_ALL void g_file_info_unset_attribute_mask (GFileInfo *info); /* Helper setters: */ GLIB_AVAILABLE_IN_ALL void g_file_info_set_file_type (GFileInfo *info, GFileType type); GLIB_AVAILABLE_IN_ALL void g_file_info_set_is_hidden (GFileInfo *info, gboolean is_hidden); GLIB_AVAILABLE_IN_ALL void g_file_info_set_is_symlink (GFileInfo *info, gboolean is_symlink); GLIB_AVAILABLE_IN_ALL void g_file_info_set_name (GFileInfo *info, const char *name); GLIB_AVAILABLE_IN_ALL void g_file_info_set_display_name (GFileInfo *info, const char *display_name); GLIB_AVAILABLE_IN_ALL void g_file_info_set_edit_name (GFileInfo *info, const char *edit_name); GLIB_AVAILABLE_IN_ALL void g_file_info_set_icon (GFileInfo *info, GIcon *icon); GLIB_AVAILABLE_IN_ALL void g_file_info_set_symbolic_icon (GFileInfo *info, GIcon *icon); GLIB_AVAILABLE_IN_ALL void g_file_info_set_content_type (GFileInfo *info, const char *content_type); GLIB_AVAILABLE_IN_ALL void g_file_info_set_size (GFileInfo *info, goffset size); G_GNUC_BEGIN_IGNORE_DEPRECATIONS GLIB_DEPRECATED_IN_2_62_FOR(g_file_info_set_modification_date_time) void g_file_info_set_modification_time (GFileInfo *info, GTimeVal *mtime); G_GNUC_END_IGNORE_DEPRECATIONS GLIB_AVAILABLE_IN_2_62 void g_file_info_set_modification_date_time (GFileInfo *info, GDateTime *mtime); GLIB_AVAILABLE_IN_ALL void g_file_info_set_symlink_target (GFileInfo *info, const char *symlink_target); GLIB_AVAILABLE_IN_ALL void g_file_info_set_sort_order (GFileInfo *info, gint32 sort_order); #define G_TYPE_FILE_ATTRIBUTE_MATCHER (g_file_attribute_matcher_get_type ()) GLIB_AVAILABLE_IN_ALL GType g_file_attribute_matcher_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_ALL GFileAttributeMatcher *g_file_attribute_matcher_new (const char *attributes); GLIB_AVAILABLE_IN_ALL GFileAttributeMatcher *g_file_attribute_matcher_ref (GFileAttributeMatcher *matcher); GLIB_AVAILABLE_IN_ALL void g_file_attribute_matcher_unref (GFileAttributeMatcher *matcher); GLIB_AVAILABLE_IN_ALL GFileAttributeMatcher *g_file_attribute_matcher_subtract (GFileAttributeMatcher *matcher, GFileAttributeMatcher *subtract); GLIB_AVAILABLE_IN_ALL gboolean g_file_attribute_matcher_matches (GFileAttributeMatcher *matcher, const char *attribute); GLIB_AVAILABLE_IN_ALL gboolean g_file_attribute_matcher_matches_only (GFileAttributeMatcher *matcher, const char *attribute); GLIB_AVAILABLE_IN_ALL gboolean g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher, const char *ns); GLIB_AVAILABLE_IN_ALL const char * g_file_attribute_matcher_enumerate_next (GFileAttributeMatcher *matcher); GLIB_AVAILABLE_IN_2_32 char * g_file_attribute_matcher_to_string (GFileAttributeMatcher *matcher); G_END_DECLS #endif /* __G_FILE_INFO_H__ */ gio/gdtlsserverconnection.h 0000644 00000004616 15125173651 0012134 0 ustar 00 /* GIO - GLib Input, Output and Streaming Library * * Copyright © 2010 Red Hat, Inc. * Copyright © 2015 Collabora, Ltd. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. */ #ifndef __G_DTLS_SERVER_CONNECTION_H__ #define __G_DTLS_SERVER_CONNECTION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/gdtlsconnection.h> G_BEGIN_DECLS #define G_TYPE_DTLS_SERVER_CONNECTION (g_dtls_server_connection_get_type ()) #define G_DTLS_SERVER_CONNECTION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), G_TYPE_DTLS_SERVER_CONNECTION, GDtlsServerConnection)) #define G_IS_DTLS_SERVER_CONNECTION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_DTLS_SERVER_CONNECTION)) #define G_DTLS_SERVER_CONNECTION_GET_INTERFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), G_TYPE_DTLS_SERVER_CONNECTION, GDtlsServerConnectionInterface)) /** * GDtlsServerConnection: * * DTLS server-side connection. This is the server-side implementation * of a #GDtlsConnection. * * Since: 2.48 */ typedef struct _GDtlsServerConnectionInterface GDtlsServerConnectionInterface; /** * GDtlsServerConnectionInterface: * @g_iface: The parent interface. * * vtable for a #GDtlsServerConnection implementation. * * Since: 2.48 */ struct _GDtlsServerConnectionInterface { GTypeInterface g_iface; }; GLIB_AVAILABLE_IN_2_48 GType g_dtls_server_connection_get_type (void) G_GNUC_CONST; GLIB_AVAILABLE_IN_2_48 GDatagramBased *g_dtls_server_connection_new (GDatagramBased *base_socket, GTlsCertificate *certificate, GError **error); G_END_DECLS #endif /* __G_DTLS_SERVER_CONNECTION_H__ */ gio/gapplication.h 0000644 00000034327 15125173651 0010164 0 ustar 00 /* * Copyright © 2010 Codethink Limited * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. * * Authors: Ryan Lortie <desrt@desrt.ca> */ #ifndef __G_APPLICATION_H__ #define __G_APPLICATION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only <gio/gio.h> can be included directly." #endif #include <gio/giotypes.h> G_BEGIN_DECLS #define G_TYPE_APPLICATION (g_application_get_type ()) #define G_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \ G_TYPE_APPLICATION, GApplication)) #define G_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \ G_TYPE_APPLICATION, GApplicationClass)) #define G_IS_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_APPLICATION)) #define G_IS_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_APPLICATION)) #define G_APPLICATION_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \ G_TYPE_APPLICATION, GApplicationClass)) typedef struct _GApplicationPrivate GApplicationPrivate; typedef struct _GApplicationClass GApplicationClass; struct _GApplication { /*< private >*/ GObject parent_instance; GApplicationPrivate *priv; }; struct _GApplicationClass { /*< private >*/ GObjectClass parent_class; /*< public >*/ /* signals */ void (* startup) (GApplication *application); void (* activate) (GApplication *application); void (* open) (GApplication *application, GFile **files, gint n_files, const gchar *hint); int (* command_line) (GApplication *application, GApplicationCommandLine *command_line); /* vfuncs */ /** * GApplicationClass::local_command_line: * @application: a #GApplication * @arguments: (inout) (array zero-terminated=1): array of command line arguments * @exit_status: (out): exit status to fill after processing the command line. * * This virtual function is always invoked in the local instance. It * gets passed a pointer to a %NULL-terminated copy of @argv and is * expected to remove arguments that it handled (shifting up remaining * arguments). * * The last argument to local_command_line() is a pointer to the @status * variable which can used to set the exit status that is returned from * g_application_run(). * * See g_application_run() for more details on #GApplication startup. * * Returns: %TRUE if the commandline has been completely handled */ gboolean (* local_command_line) (GApplication *application, gchar ***arguments,
| ver. 1.6 |
Github
|
.
| PHP 8.2.30 | ??????????? ?????????: 1.41 |
proxy
|
phpinfo
|
???????????