File: Private.d

package info (click to toggle)
gtk-d 3.10.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 20,152 kB
  • sloc: javascript: 565; sh: 71; makefile: 25
file content (127 lines) | stat: -rw-r--r-- 3,597 bytes parent folder | download | duplicates (4)
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
/*
 * 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.Private;

private import glib.c.functions;
public  import glib.c.types;
public  import gtkc.glibtypes;


/**
 * The #GPrivate struct is an opaque data structure to represent a
 * thread-local data key. It is approximately equivalent to the
 * pthread_setspecific()/pthread_getspecific() APIs on POSIX and to
 * TlsSetValue()/TlsGetValue() on Windows.
 * 
 * If you don't already know why you might want this functionality,
 * then you probably don't need it.
 * 
 * #GPrivate is a very limited resource (as far as 128 per program,
 * shared between all libraries). It is also not possible to destroy a
 * #GPrivate after it has been used. As such, it is only ever acceptable
 * to use #GPrivate in static scope, and even then sparingly so.
 * 
 * See G_PRIVATE_INIT() for a couple of examples.
 * 
 * The #GPrivate structure should be considered opaque.  It should only
 * be accessed via the g_private_ functions.
 */
public class Private
{
	/** the main Gtk struct */
	protected GPrivate* gPrivate;
	protected bool ownedRef;

	/** Get the main Gtk struct */
	public GPrivate* getPrivateStruct(bool transferOwnership = false)
	{
		if (transferOwnership)
			ownedRef = false;
		return gPrivate;
	}

	/** the main Gtk struct as a void* */
	protected void* getStruct()
	{
		return cast(void*)gPrivate;
	}

	/**
	 * Sets our main struct and passes it to the parent class.
	 */
	public this (GPrivate* gPrivate, bool ownedRef = false)
	{
		this.gPrivate = gPrivate;
		this.ownedRef = ownedRef;
	}


	/**
	 * Returns the current value of the thread local variable @key.
	 *
	 * If the value has not yet been set in this thread, %NULL is returned.
	 * Values are never copied between threads (when a new thread is
	 * created, for example).
	 *
	 * Returns: the thread-local value
	 */
	public void* get()
	{
		return g_private_get(gPrivate);
	}

	/**
	 * Sets the thread local variable @key to have the value @value in the
	 * current thread.
	 *
	 * This function differs from g_private_set() in the following way: if
	 * the previous value was non-%NULL then the #GDestroyNotify handler for
	 * @key is run on it.
	 *
	 * Params:
	 *     value = the new value
	 *
	 * Since: 2.32
	 */
	public void replace(void* value)
	{
		g_private_replace(gPrivate, value);
	}

	/**
	 * Sets the thread local variable @key to have the value @value in the
	 * current thread.
	 *
	 * This function differs from g_private_replace() in the following way:
	 * the #GDestroyNotify for @key is not called on the old value.
	 *
	 * Params:
	 *     value = the new value
	 */
	public void set(void* value)
	{
		g_private_set(gPrivate, value);
	}
}