/usr/include/gwyddion/libgwyddion/gwyinventory.h is in libgwyddion20-dev 2.44-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | /*
* @(#) $Id: gwyinventory.h 15598 2013-11-11 12:33:32Z yeti-dn $
* Copyright (C) 2003,2004 David Necas (Yeti), Petr Klapetek.
* E-mail: yeti@gwyddion.net, klapetek@gwyddion.net.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GWY_INVENTORY_H__
#define __GWY_INVENTORY_H__
#include <glib-object.h>
#include <libgwyddion/gwyutils.h>
G_BEGIN_DECLS
#define GWY_TYPE_INVENTORY (gwy_inventory_get_type ())
#define GWY_INVENTORY(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GWY_TYPE_INVENTORY, GwyInventory))
#define GWY_INVENTORY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GWY_TYPE_INVENTORY, GwyInventoryClass))
#define GWY_IS_INVENTORY(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GWY_TYPE_INVENTORY))
#define GWY_IS_INVENTORY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GWY_TYPE_INVENTORY))
#define GWY_INVENTORY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GWY_TYPE_INVENTORY, GwyInventoryClass))
/* Rationale:
* 1. Prescribing access methods is better than prescribing data members,
* because it introduces one level indirection, but allows for example to
* get_name, get_text and get_data return the same string.
* 2. All deep-derivable types in GLib type system are not useful (objects),
* and we would need deep derivation some GLib type <- Abstract item
* <- Particular items. So it seems use of the type system would be too
* much pain, too little gain. The basic trouble is we want to derive
* interfaces, but don't want instantiable types.
*/
typedef struct _GwyInventoryItemType GwyInventoryItemType;
struct _GwyInventoryItemType {
GType type;
const gchar *watchable_signal;
gboolean (*is_fixed) (gconstpointer item);
const gchar* (*get_name) (gpointer item);
gint (*compare) (gconstpointer item1,
gconstpointer item2);
void (*rename) (gpointer item,
const gchar *newname);
void (*dismantle) (gpointer item);
gpointer (*copy) (gpointer item);
const GType* (*get_traits) (gint *ntraits);
const gchar* (*get_trait_name) (gint i);
void (*get_trait_value)(gpointer item,
gint i,
GValue *value);
};
typedef struct _GwyInventory GwyInventory;
typedef struct _GwyInventoryClass GwyInventoryClass;
struct _GwyInventory {
GObject parent_instance;
GwyInventoryItemType item_type;
gboolean needs_reindex;
gboolean is_sorted;
gboolean is_const;
gboolean is_object;
gboolean is_watchable;
gboolean can_make_copies;
gboolean has_default;
GString *default_key;
/* Item pointers (called storage). */
GPtrArray *items;
/* Index. A map from storage position to sort position. May be %NULL. */
GArray *idx;
/* Reverse index. A map from sort position to storage position. May be
* %NULL */
GArray *ridx;
/* Name hash. A map from name to storage position. */
GHashTable *hash;
gpointer reserved1;
gpointer reserved2;
gint int1;
gint int2;
};
struct _GwyInventoryClass {
GObjectClass parent_class;
/* Signals */
void (*item_inserted)(GwyInventory *inventory,
guint position);
void (*item_deleted)(GwyInventory *inventory,
guint position);
void (*item_updated)(GwyInventory *inventory,
guint position);
void (*items_reordered)(GwyInventory *inventory,
const gint *new_order);
void (*default_changed)(GwyInventory *inventory);
void (*reserved1)(void);
void (*reserved2)(void);
};
GType gwy_inventory_get_type (void) G_GNUC_CONST;
/* Constructors */
GwyInventory* gwy_inventory_new (const GwyInventoryItemType *itype);
GwyInventory* gwy_inventory_new_filled (const GwyInventoryItemType *itype,
guint nitems,
gpointer *items);
GwyInventory* gwy_inventory_new_from_array (const GwyInventoryItemType *itype,
guint item_size,
guint nitems,
gconstpointer items);
/* Information */
guint gwy_inventory_get_n_items (GwyInventory *inventory);
gboolean gwy_inventory_can_make_copies (GwyInventory *inventory);
gboolean gwy_inventory_is_const (GwyInventory *inventory);
const GwyInventoryItemType* gwy_inventory_get_item_type(GwyInventory *inventory);
/* Retrieving items */
gpointer gwy_inventory_get_item (GwyInventory *inventory,
const gchar *name);
gpointer gwy_inventory_get_item_or_default (GwyInventory *inventory,
const gchar *name);
gpointer gwy_inventory_get_nth_item (GwyInventory *inventory,
guint n);
guint gwy_inventory_get_item_position (GwyInventory *inventory,
const gchar *name);
void gwy_inventory_foreach (GwyInventory *inventory,
GHFunc function,
gpointer user_data);
gpointer gwy_inventory_find (GwyInventory *inventory,
GHRFunc predicate,
gpointer user_data);
void gwy_inventory_set_default_item_name(GwyInventory *inventory,
const gchar *name);
const gchar* gwy_inventory_get_default_item_name(GwyInventory *inventory);
gpointer gwy_inventory_get_default_item (GwyInventory *inventory);
/* Modifiable inventories */
void gwy_inventory_item_updated (GwyInventory *inventory,
const gchar *name);
void gwy_inventory_nth_item_updated (GwyInventory *inventory,
guint n);
void gwy_inventory_restore_order (GwyInventory *inventory);
void gwy_inventory_forget_order (GwyInventory *inventory);
gpointer gwy_inventory_insert_item (GwyInventory *inventory,
gpointer item);
gpointer gwy_inventory_insert_nth_item (GwyInventory *inventory,
gpointer item,
guint n);
gboolean gwy_inventory_delete_item (GwyInventory *inventory,
const gchar *name);
gboolean gwy_inventory_delete_nth_item (GwyInventory *inventory,
guint n);
gpointer gwy_inventory_rename_item (GwyInventory *inventory,
const gchar *name,
const gchar *newname);
gpointer gwy_inventory_new_item (GwyInventory *inventory,
const gchar *name,
const gchar *newname);
G_END_DECLS
#endif /* __GWY_INVENTORY_H__ */
/* vim: set cin et ts=4 sw=4 cino=>1s,e0,n0,f0,{0,}0,^0,\:1s,=0,g1s,h0,t0,+1s,c3,(0,u0 : */
|