This file is indexed.

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

public  import atk.c.functions;
public  import atk.c.types;
public  import glib.IOChannel;
public  import glib.Str;
public  import gtkc.atktypes;


/**
 * An interface whereby an object allows its backing content to be
 * streamed to clients.  Typical implementors would be images or
 * icons, HTML content, or multimedia display/rendering widgets.
 * 
 * Negotiation of content type is allowed. Clients may examine the
 * backing data and transform, convert, or parse the content in order
 * to present it in an alternate form to end-users.
 * 
 * The AtkStreamableContent interface is particularly useful for
 * saving, printing, or post-processing entire documents, or for
 * persisting alternate views of a document. If document content
 * itself is being serialized, stored, or converted, then use of the
 * AtkStreamableContent interface can help address performance
 * issues. Unlike most ATK interfaces, this interface is not strongly
 * tied to the current user-agent view of the a particular document,
 * but may in some cases give access to the underlying model data.
 */
public template StreamableContentT(TStruct)
{
	/** Get the main Gtk struct */
	public AtkStreamableContent* getStreamableContentStruct(bool transferOwnership = false)
	{
		if (transferOwnership)
			ownedRef = false;
		return cast(AtkStreamableContent*)getStruct();
	}


	/**
	 * Gets the character string of the specified mime type. The first mime
	 * type is at position 0, the second at position 1, and so on.
	 *
	 * Params:
	 *     i = a gint representing the position of the mime type starting from 0
	 *
	 * Returns: a gchar* representing the specified mime type; the caller
	 *     should not free the character string.
	 */
	public string getMimeType(int i)
	{
		return Str.toString(atk_streamable_content_get_mime_type(getStreamableContentStruct(), i));
	}

	/**
	 * Gets the number of mime types supported by this object.
	 *
	 * Returns: a gint which is the number of mime types supported by the object.
	 */
	public int getNMimeTypes()
	{
		return atk_streamable_content_get_n_mime_types(getStreamableContentStruct());
	}

	/**
	 * Gets the content in the specified mime type.
	 *
	 * Params:
	 *     mimeType = a gchar* representing the mime type
	 *
	 * Returns: A #GIOChannel which contains the content in the
	 *     specified mime type.
	 */
	public IOChannel getStream(string mimeType)
	{
		auto p = atk_streamable_content_get_stream(getStreamableContentStruct(), Str.toStringz(mimeType));

		if(p is null)
		{
			return null;
		}

		return new IOChannel(cast(GIOChannel*) p, true);
	}

	/**
	 * Get a string representing a URI in IETF standard format
	 * (see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content
	 * may be streamed in the specified mime-type, if one is available.
	 * If mime_type is NULL, the URI for the default (and possibly only) mime-type is
	 * returned.
	 *
	 * Note that it is possible for get_uri to return NULL but for
	 * get_stream to work nonetheless, since not all GIOChannels connect to URIs.
	 *
	 * Params:
	 *     mimeType = a gchar* representing the mime type, or NULL to request a URI
	 *         for the default mime type.
	 *
	 * Returns: Returns a string representing a URI, or %NULL
	 *     if no corresponding URI can be constructed.
	 *
	 * Since: 1.12
	 */
	public string getUri(string mimeType)
	{
		return Str.toString(atk_streamable_content_get_uri(getStreamableContentStruct(), Str.toStringz(mimeType)));
	}
}