File: NetworkService.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 (177 lines) | stat: -rw-r--r-- 4,714 bytes parent folder | download | duplicates (2)
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
/*
 * 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 gio.NetworkService;

private import gio.SocketConnectableIF;
private import gio.SocketConnectableT;
private import gio.c.functions;
public  import gio.c.types;
private import glib.ConstructionException;
private import glib.Str;
private import gobject.ObjectG;
public  import gtkc.giotypes;


/**
 * Like #GNetworkAddress does with hostnames, #GNetworkService
 * provides an easy way to resolve a SRV record, and then attempt to
 * connect to one of the hosts that implements that service, handling
 * service priority/weighting, multiple IP addresses, and multiple
 * address families.
 * 
 * See #GSrvTarget for more information about SRV records, and see
 * #GSocketConnectable for an example of using the connectable
 * interface.
 */
public class NetworkService : ObjectG, SocketConnectableIF
{
	/** the main Gtk struct */
	protected GNetworkService* gNetworkService;

	/** Get the main Gtk struct */
	public GNetworkService* getNetworkServiceStruct(bool transferOwnership = false)
	{
		if (transferOwnership)
			ownedRef = false;
		return gNetworkService;
	}

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

	/**
	 * Sets our main struct and passes it to the parent class.
	 */
	public this (GNetworkService* gNetworkService, bool ownedRef = false)
	{
		this.gNetworkService = gNetworkService;
		super(cast(GObject*)gNetworkService, ownedRef);
	}

	// add the SocketConnectable capabilities
	mixin SocketConnectableT!(GNetworkService);


	/** */
	public static GType getType()
	{
		return g_network_service_get_type();
	}

	/**
	 * Creates a new #GNetworkService representing the given @service,
	 * @protocol, and @domain. This will initially be unresolved; use the
	 * #GSocketConnectable interface to resolve it.
	 *
	 * Params:
	 *     service = the service type to look up (eg, "ldap")
	 *     protocol = the networking protocol to use for @service (eg, "tcp")
	 *     domain = the DNS domain to look up the service in
	 *
	 * Returns: a new #GNetworkService
	 *
	 * Since: 2.22
	 *
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this(string service, string protocol, string domain)
	{
		auto __p = g_network_service_new(Str.toStringz(service), Str.toStringz(protocol), Str.toStringz(domain));

		if(__p is null)
		{
			throw new ConstructionException("null returned by new");
		}

		this(cast(GNetworkService*) __p, true);
	}

	/**
	 * Gets the domain that @srv serves. This might be either UTF-8 or
	 * ASCII-encoded, depending on what @srv was created with.
	 *
	 * Returns: @srv's domain name
	 *
	 * Since: 2.22
	 */
	public string getDomain()
	{
		return Str.toString(g_network_service_get_domain(gNetworkService));
	}

	/**
	 * Gets @srv's protocol name (eg, "tcp").
	 *
	 * Returns: @srv's protocol name
	 *
	 * Since: 2.22
	 */
	public string getProtocol()
	{
		return Str.toString(g_network_service_get_protocol(gNetworkService));
	}

	/**
	 * Get's the URI scheme used to resolve proxies. By default, the service name
	 * is used as scheme.
	 *
	 * Returns: @srv's scheme name
	 *
	 * Since: 2.26
	 */
	public string getScheme()
	{
		return Str.toString(g_network_service_get_scheme(gNetworkService));
	}

	/**
	 * Gets @srv's service name (eg, "ldap").
	 *
	 * Returns: @srv's service name
	 *
	 * Since: 2.22
	 */
	public string getService()
	{
		return Str.toString(g_network_service_get_service(gNetworkService));
	}

	/**
	 * Set's the URI scheme used to resolve proxies. By default, the service name
	 * is used as scheme.
	 *
	 * Params:
	 *     scheme = a URI scheme
	 *
	 * Since: 2.26
	 */
	public void setScheme(string scheme)
	{
		g_network_service_set_scheme(gNetworkService, Str.toStringz(scheme));
	}
}