This file is indexed.

/usr/include/d/gtkd-3/glib/Hostname.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
/*
 * 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.Hostname;

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


/** */
public struct Hostname
{

	/**
	 * Tests if @hostname contains segments with an ASCII-compatible
	 * encoding of an Internationalized Domain Name. If this returns
	 * %TRUE, you should decode the hostname with g_hostname_to_unicode()
	 * before displaying it to the user.
	 *
	 * Note that a hostname might contain a mix of encoded and unencoded
	 * segments, and so it is possible for g_hostname_is_non_ascii() and
	 * g_hostname_is_ascii_encoded() to both return %TRUE for a name.
	 *
	 * Params:
	 *     hostname = a hostname
	 *
	 * Returns: %TRUE if @hostname contains any ASCII-encoded
	 *     segments.
	 *
	 * Since: 2.22
	 */
	public static bool isAsciiEncoded(string hostname)
	{
		return g_hostname_is_ascii_encoded(Str.toStringz(hostname)) != 0;
	}

	/**
	 * Tests if @hostname is the string form of an IPv4 or IPv6 address.
	 * (Eg, "192.168.0.1".)
	 *
	 * Params:
	 *     hostname = a hostname (or IP address in string form)
	 *
	 * Returns: %TRUE if @hostname is an IP address
	 *
	 * Since: 2.22
	 */
	public static bool isIpAddress(string hostname)
	{
		return g_hostname_is_ip_address(Str.toStringz(hostname)) != 0;
	}

	/**
	 * Tests if @hostname contains Unicode characters. If this returns
	 * %TRUE, you need to encode the hostname with g_hostname_to_ascii()
	 * before using it in non-IDN-aware contexts.
	 *
	 * Note that a hostname might contain a mix of encoded and unencoded
	 * segments, and so it is possible for g_hostname_is_non_ascii() and
	 * g_hostname_is_ascii_encoded() to both return %TRUE for a name.
	 *
	 * Params:
	 *     hostname = a hostname
	 *
	 * Returns: %TRUE if @hostname contains any non-ASCII characters
	 *
	 * Since: 2.22
	 */
	public static bool isNonAscii(string hostname)
	{
		return g_hostname_is_non_ascii(Str.toStringz(hostname)) != 0;
	}

	/**
	 * Converts @hostname to its canonical ASCII form; an ASCII-only
	 * string containing no uppercase letters and not ending with a
	 * trailing dot.
	 *
	 * Params:
	 *     hostname = a valid UTF-8 or ASCII hostname
	 *
	 * Returns: an ASCII hostname, which must be freed, or %NULL if
	 *     @hostname is in some way invalid.
	 *
	 * Since: 2.22
	 */
	public static string toAscii(string hostname)
	{
		auto retStr = g_hostname_to_ascii(Str.toStringz(hostname));

		scope(exit) Str.freeString(retStr);
		return Str.toString(retStr);
	}

	/**
	 * Converts @hostname to its canonical presentation form; a UTF-8
	 * string in Unicode normalization form C, containing no uppercase
	 * letters, no forbidden characters, and no ASCII-encoded segments,
	 * and not ending with a trailing dot.
	 *
	 * Of course if @hostname is not an internationalized hostname, then
	 * the canonical presentation form will be entirely ASCII.
	 *
	 * Params:
	 *     hostname = a valid UTF-8 or ASCII hostname
	 *
	 * Returns: a UTF-8 hostname, which must be freed, or %NULL if
	 *     @hostname is in some way invalid.
	 *
	 * Since: 2.22
	 */
	public static string toUnicode(string hostname)
	{
		auto retStr = g_hostname_to_unicode(Str.toStringz(hostname));

		scope(exit) Str.freeString(retStr);
		return Str.toString(retStr);
	}
}