/usr/include/d/gtkd-3/glib/Once.d is in libgtkd-3-dev 3.7.5-2build1.
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 | /*
* This file is part of gtkD.
*
* gtkD 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 3
* of the License, or (at your option) any later version, with
* some exceptions, please read the COPYING file.
*
* gtkD 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 gtkD; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
*/
// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage
module glib.Once;
private import glib.c.functions;
public import glib.c.types;
public import gtkc.glibtypes;
private import gtkd.Loader;
/**
* A #GOnce struct controls a one-time initialization function. Any
* one-time initialization function must have its own unique #GOnce
* struct.
*
* Since: 2.4
*/
public final class Once
{
/** the main Gtk struct */
protected GOnce* gOnce;
protected bool ownedRef;
/** Get the main Gtk struct */
public GOnce* getOnceStruct(bool transferOwnership = false)
{
if (transferOwnership)
ownedRef = false;
return gOnce;
}
/** the main Gtk struct as a void* */
protected void* getStruct()
{
return cast(void*)gOnce;
}
/**
* Sets our main struct and passes it to the parent class.
*/
public this (GOnce* gOnce, bool ownedRef = false)
{
this.gOnce = gOnce;
this.ownedRef = ownedRef;
}
~this ()
{
if ( Linker.isLoaded(LIBRARY_GLIB) && ownedRef )
g_free(gOnce);
}
/**
* the status of the #GOnce
*/
public @property GOnceStatus status()
{
return gOnce.status;
}
/** Ditto */
public @property void status(GOnceStatus value)
{
gOnce.status = value;
}
/**
* the value returned by the call to the function, if @status
* is %G_ONCE_STATUS_READY
*/
public @property void* retval()
{
return gOnce.retval;
}
/** Ditto */
public @property void retval(void* value)
{
gOnce.retval = value;
}
/** */
public void* impl(GThreadFunc func, void* arg)
{
return g_once_impl(gOnce, func, arg);
}
/**
* Function to be called when starting a critical initialization
* section. The argument @location must point to a static
* 0-initialized variable that will be set to a value other than 0 at
* the end of the initialization section. In combination with
* g_once_init_leave() and the unique address @value_location, it can
* be ensured that an initialization section will be executed only once
* during a program's life time, and that concurrent threads are
* blocked until initialization completed. To be used in constructs
* like this:
*
* |[<!-- language="C" -->
* static gsize initialization_value = 0;
*
* if (g_once_init_enter (&initialization_value))
* {
* gsize setup_value = 42; // initialization code here
*
* g_once_init_leave (&initialization_value, setup_value);
* }
*
* // use initialization_value here
* ]|
*
* Params:
* location = location of a static initializable variable
* containing 0
*
* Returns: %TRUE if the initialization section should be entered,
* %FALSE and blocks otherwise
*
* Since: 2.14
*/
public static bool initEnter(void* location)
{
return g_once_init_enter(location) != 0;
}
/**
* Counterpart to g_once_init_enter(). Expects a location of a static
* 0-initialized initialization variable, and an initialization value
* other than 0. Sets the variable to the initialization value, and
* releases concurrent threads blocking in g_once_init_enter() on this
* initialization variable.
*
* Params:
* location = location of a static initializable variable
* containing 0
* result = new non-0 value for *@value_location
*
* Since: 2.14
*/
public static void initLeave(void* location, size_t result)
{
g_once_init_leave(location, result);
}
}
|