~ubuntu-branches/ubuntu/natty/gnome-vfs/natty

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-MAGIC-CHR:CAPS" title="GNOME_VFS_URI_MAGIC_CHR">GNOME_VFS_URI_MAGIC_CHR</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-MAGIC-STR:CAPS" title="GNOME_VFS_URI_MAGIC_STR">GNOME_VFS_URI_MAGIC_STR</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-PATH-CHR:CAPS" title="GNOME_VFS_URI_PATH_CHR">GNOME_VFS_URI_PATH_CHR</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-PATH-STR:CAPS" title="GNOME_VFS_URI_PATH_STR">GNOME_VFS_URI_PATH_STR</a>

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-resolve-relative" title="gnome_vfs_uri_resolve_relative ()">gnome_vfs_uri_resolve_relative</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *base,

const gchar *relative_reference);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-resolve-symbolic-link" title="gnome_vfs_uri_resolve_symbolic_link ()">gnome_vfs_uri_resolve_symbolic_link</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *base,

const gchar *relative_reference);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-ref" title="gnome_vfs_uri_ref ()">gnome_vfs_uri_ref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-unref" title="gnome_vfs_uri_unref ()">gnome_vfs_uri_unref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-string" title="gnome_vfs_uri_append_string ()">gnome_vfs_uri_append_string</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const char *uri_fragment);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-path" title="gnome_vfs_uri_append_path ()">gnome_vfs_uri_append_path</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const char *path);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-file-name" title="gnome_vfs_uri_append_file_name ()">gnome_vfs_uri_append_file_name</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const gchar *filename);

gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-to-string" title="gnome_vfs_uri_to_string ()">gnome_vfs_uri_to_string</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURIHideOptions" title="enum GnomeVFSURIHideOptions">GnomeVFSURIHideOptions</a> hide_options);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-dup" title="gnome_vfs_uri_dup ()">gnome_vfs_uri_dup</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-is-local" title="gnome_vfs_uri_is_local ()">gnome_vfs_uri_is_local</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-has-parent" title="gnome_vfs_uri_has_parent ()">gnome_vfs_uri_has_parent</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-parent" title="gnome_vfs_uri_get_parent ()">gnome_vfs_uri_get_parent</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSToplevelURI" title="GnomeVFSToplevelURI">GnomeVFSToplevelURI</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-toplevel" title="gnome_vfs_uri_get_toplevel ()">gnome_vfs_uri_get_toplevel</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-host-name" title="gnome_vfs_uri_get_host_name ()">gnome_vfs_uri_get_host_name</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-scheme" title="gnome_vfs_uri_get_scheme ()">gnome_vfs_uri_get_scheme</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

guint <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-host-port" title="gnome_vfs_uri_get_host_port ()">gnome_vfs_uri_get_host_port</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-user-name" title="gnome_vfs_uri_get_user_name ()">gnome_vfs_uri_get_user_name</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-password" title="gnome_vfs_uri_get_password ()">gnome_vfs_uri_get_password</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-set-host-name" title="gnome_vfs_uri_set_host_name ()">gnome_vfs_uri_set_host_name</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const gchar *host_name);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-set-host-port" title="gnome_vfs_uri_set_host_port ()">gnome_vfs_uri_set_host_port</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

guint host_port);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-set-user-name" title="gnome_vfs_uri_set_user_name ()">gnome_vfs_uri_set_user_name</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const gchar *user_name);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-set-password" title="gnome_vfs_uri_set_password ()">gnome_vfs_uri_set_password</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

const gchar *password);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-equal" title="gnome_vfs_uri_equal ()">gnome_vfs_uri_equal</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *a,

const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *b);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-is-parent" title="gnome_vfs_uri_is_parent ()">gnome_vfs_uri_is_parent</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *possible_parent,

const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *possible_child,

gboolean recursive);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-path" title="gnome_vfs_uri_get_path ()">gnome_vfs_uri_get_path</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

const gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-get-fragment-identifier" title="gnome_vfs_uri_get_fragment_identifier ()">gnome_vfs_uri_get_fragment_identifier</a>

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-extract-dirname" title="gnome_vfs_uri_extract_dirname ()">gnome_vfs_uri_extract_dirname</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

100

gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-extract-short-name" title="gnome_vfs_uri_extract_short_name ()">gnome_vfs_uri_extract_short_name</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

101

gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-extract-short-path-name" title="gnome_vfs_uri_extract_short_path_name ()">gnome_vfs_uri_extract_short_path_name</a>

102

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);

103

gint <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-hequal" title="gnome_vfs_uri_hequal ()">gnome_vfs_uri_hequal</a> (gconstpointer a,

104

gconstpointer b);

105

guint <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-hash" title="gnome_vfs_uri_hash ()">gnome_vfs_uri_hash</a> (gconstpointer p);

106

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-parse" title="gnome_vfs_uri_list_parse ()">gnome_vfs_uri_list_parse</a> (const gchar *uri_list);

107

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-ref" title="gnome_vfs_uri_list_ref ()">gnome_vfs_uri_list_ref</a> (GList *list);

108

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-unref" title="gnome_vfs_uri_list_unref ()">gnome_vfs_uri_list_unref</a> (GList *list);

109

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-copy" title="gnome_vfs_uri_list_copy ()">gnome_vfs_uri_list_copy</a> (GList *list);

110

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-free" title="gnome_vfs_uri_list_free ()">gnome_vfs_uri_list_free</a> (GList *list);

111

char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-make-full-from-relative" title="gnome_vfs_uri_make_full_from_relative ()">gnome_vfs_uri_make_full_from_relative</a>

112

(const char *base_uri,

113

const char *relative_uri);

114

</pre>

115

</div>

116

117

<a name="gnome-vfs-2.0-gnome-vfs-uri.description"></a><h2>Description</h2>

118

<p>

119

A <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> is a semi-textual representation

120

of a uniform resource identifier. It contains the

121

information about a resource location encoded

122

as canononicalized text, but also holds extra

123

information about the context in which the

124

URI is used.

125

</p>

126

</div>

127

128

<a name="gnome-vfs-2.0-gnome-vfs-uri.details"></a><h2>Details</h2>

129

130

<a name="GnomeVFSURI"></a><h3>GnomeVFSURI</h3>

131

<pre class="programlisting">typedef struct {

132

guint ref_count;

133

134

gchar *text;

135

gchar *fragment_id;

136

137

gchar *method_string;

138

struct GnomeVFSMethod *method;

139

140

struct GnomeVFSURI *parent;

141

} GnomeVFSURI;

142

</pre>

143

<p>

144

Holds information about the location of a particular resource.</p>

145

<p>

146

</p>

147

148

149

<tbody>

150

<tr>

151

<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSURI.ref_count"></a>ref_count</code></em>;</span></p></td>

152

<td> Reference count. The URI is freed when it drops to zero.

153

</td>

154

</tr>

155

<tr>

156

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSURI.text"></a>text</code></em>;</span></p></td>

157

<td> A canonical representation of the path associated with this resource.

158

</td>

159

</tr>

160

<tr>

161

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSURI.fragment_id"></a>fragment_id</code></em>;</span></p></td>

162

<td> Extra data identifying this resource.

163

</td>

164

</tr>

165

<tr>

166

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSURI.method_string"></a>method_string</code></em>;</span></p></td>

167

<td> The <em class="parameter"><code>method</code></em>'s method associated with this resource.

168

One <span class="type">GnomeVFSMethod</span> can be used for multiple method strings.

169

</td>

170

</tr>

171

<tr>

172

<td><p><span class="term">struct GnomeVFSMethod *<em class="structfield"><code><a name="GnomeVFSURI.method"></a>method</code></em>;</span></p></td>

173

<td> The <span class="type">GnomeVFSMethod</span> associated with this resource.

174

</td>

175

</tr>

176

<tr>

177

<td><p><span class="term">struct <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *<em class="structfield"><code><a name="GnomeVFSURI.parent"></a>parent</code></em>;</span></p></td>

178

<td> Pointer to the parent element, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> for <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> that

179

have no enclosing <span class="type">GnomeVFSURI.</span> The process of encapsulating one

180

URI in another one is called URI chaining.

181

</td>

182

</tr>

183

</tbody>

184

</table></div>

185

</div>

186

<hr>

187

188

<a name="GnomeVFSToplevelURI"></a><h3>GnomeVFSToplevelURI</h3>

189

<pre class="programlisting">typedef struct {

190

GnomeVFSURI uri;

191

192

gchar *host_name;

193

guint host_port;

194

195

gchar *user_name;

196

gchar *password;

197

198

gchar *urn;

199

} GnomeVFSToplevelURI;

200

</pre>

201

<p>

202

This is the toplevel URI element used to access ressources stored on

203

a remote server. Toplevel method implementations should cast the <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a>

204

argument to this type to get the additional host and authentication information.

205

</p>

206

<p>

207

If any of the elements is 0 respectively <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, it is unspecified.</p>

208

<p>

209

</p>

210

211

212

<tbody>

213

<tr>

214

<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> <em class="structfield"><code><a name="GnomeVFSToplevelURI.uri"></a>uri</code></em>;</span></p></td>

215

<td>

216

</td>

217

</tr>

218

<tr>

219

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSToplevelURI.host_name"></a>host_name</code></em>;</span></p></td>

220

<td> The name of the host used to access this resource, o <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

221

</td>

222

</tr>

223

<tr>

224

<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSToplevelURI.host_port"></a>host_port</code></em>;</span></p></td>

225

<td> The port used to access this resource, or <code class="literal">0</code>.

226

</td>

227

</tr>

228

<tr>

229

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSToplevelURI.user_name"></a>user_name</code></em>;</span></p></td>

230

<td> Unescaped user name used to access this resource, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

231

</td>

232

</tr>

233

<tr>

234

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSToplevelURI.password"></a>password</code></em>;</span></p></td>

235

<td> Unescaped password used to access this resource, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

236

</td>

237

</tr>

238

<tr>

239

<td><p><span class="term">gchar *<em class="structfield"><code><a name="GnomeVFSToplevelURI.urn"></a>urn</code></em>;</span></p></td>

240

<td> The parent URN, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if it doesn't exist.

241

</td>

242

</tr>

243

</tbody>

244

</table></div>

245

</div>

246

<hr>

247

248

<a name="GnomeVFSURIHideOptions"></a><h3>enum GnomeVFSURIHideOptions</h3>

249

<pre class="programlisting">typedef enum

250

{

251

GNOME_VFS_URI_HIDE_NONE = 0,

252

GNOME_VFS_URI_HIDE_USER_NAME = 1 << 0,

253

GNOME_VFS_URI_HIDE_PASSWORD = 1 << 1,

254

GNOME_VFS_URI_HIDE_HOST_NAME = 1 << 2,

255

GNOME_VFS_URI_HIDE_HOST_PORT = 1 << 3,

256

GNOME_VFS_URI_HIDE_TOPLEVEL_METHOD = 1 << 4,

257

GNOME_VFS_URI_HIDE_FRAGMENT_IDENTIFIER = 1 << 8

258

} GnomeVFSURIHideOptions;

259

</pre>

260

<p>

261

Packed boolean bitfield controlling hiding of various elements

262

of a <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> when it is converted to a string using

263

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-to-string" title="gnome_vfs_uri_to_string ()"><code class="function">gnome_vfs_uri_to_string()</code></a>.</p>

264

<p>

265

</p>

266

267

268

<tbody>

269

<tr>

270

<td><p><a name="GNOME-VFS-URI-HIDE-NONE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_NONE</code></span></p></td>

271

<td> don't hide anything

272

</td>

273

</tr>

274

<tr>

275

<td><p><a name="GNOME-VFS-URI-HIDE-USER-NAME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_USER_NAME</code></span></p></td>

276

<td> hide the user name

277

</td>

278

</tr>

279

<tr>

280

<td><p><a name="GNOME-VFS-URI-HIDE-PASSWORD:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_PASSWORD</code></span></p></td>

281

<td> hide the password

282

</td>

283

</tr>

284

<tr>

285

<td><p><a name="GNOME-VFS-URI-HIDE-HOST-NAME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_HOST_NAME</code></span></p></td>

286

<td> hide the host name

287

</td>

288

</tr>

289

<tr>

290

<td><p><a name="GNOME-VFS-URI-HIDE-HOST-PORT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_HOST_PORT</code></span></p></td>

291

<td> hide the port

292

</td>

293

</tr>

294

<tr>

295

<td><p><a name="GNOME-VFS-URI-HIDE-TOPLEVEL-METHOD:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_TOPLEVEL_METHOD</code></span></p></td>

296

<td> hide the method (e.g. http, file)

297

</td>

298

</tr>

299

<tr>

300

<td><p><a name="GNOME-VFS-URI-HIDE-FRAGMENT-IDENTIFIER:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_URI_HIDE_FRAGMENT_IDENTIFIER</code></span></p></td>

301

<td> hide the fragment identifier

302

</td>

303

</tr>

304

</tbody>

305

</table></div>

306

</div>

307

<hr>

308

309

<a name="GNOME-VFS-URI-MAGIC-CHR:CAPS"></a><h3>GNOME_VFS_URI_MAGIC_CHR</h3>

310

<pre class="programlisting">#define GNOME_VFS_URI_MAGIC_CHR '#'

311

</pre>

312

<p>

313

The character used to divide location from

314

extra "arguments" passed to the method.</p>

315

<p>

316

</p>

317

</div>

318

<hr>

319

320

<a name="GNOME-VFS-URI-MAGIC-STR:CAPS"></a><h3>GNOME_VFS_URI_MAGIC_STR</h3>

321

<pre class="programlisting">#define GNOME_VFS_URI_MAGIC_STR "#"

322

</pre>

323

<p>

324

The character used to divide location from

325

extra "arguments" passed to the method.</p>

326

<p>

327

</p>

328

</div>

329

<hr>

330

331

<a name="GNOME-VFS-URI-PATH-CHR:CAPS"></a><h3>GNOME_VFS_URI_PATH_CHR</h3>

332

<pre class="programlisting">#define GNOME_VFS_URI_PATH_CHR '/'

333

</pre>

334

<p>

335

Defines the path seperator character.</p>

336

<p>

337

</p>

338

</div>

339

<hr>

340

341

<a name="GNOME-VFS-URI-PATH-STR:CAPS"></a><h3>GNOME_VFS_URI_PATH_STR</h3>

342

<pre class="programlisting">#define GNOME_VFS_URI_PATH_STR "/"

343

</pre>

344

<p>

345

Defines the path seperator string.</p>

346

<p>

347

</p>

348

</div>

349

<hr>

350

351

<a name="gnome-vfs-uri-new"></a><h3>gnome_vfs_uri_new ()</h3>

352

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_new (const gchar *text_uri);</pre>

353

<p>

354

Create a new uri from <em class="parameter"><code>text_uri</code></em>. Unsupported and unsafe methods

355

are not allowed and will result in <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> being returned. URL

356

transforms are allowed.

357

</p>

358

<p>

359

The <em class="parameter"><code>a</code></em> text_uri must be an escaped URI string such as returned by

360

<a class="link" href="gnome-vfs-2.0-gnome-vfs-utils.html#gnome-vfs-get-uri-from-local-path" title="gnome_vfs_get_uri_from_local_path ()"><code class="function">gnome_vfs_get_uri_from_local_path()</code></a>, <a class="link" href="gnome-vfs-2.0-gnome-vfs-utils.html#gnome-vfs-make-uri-from-input" title="gnome_vfs_make_uri_from_input ()"><code class="function">gnome_vfs_make_uri_from_input()</code></a>,

361

or <code class="function">gtk_file_chooser_get_uri()</code>.</p>

362

<p>

363

</p>

364

365

366

<tbody>

367

<tr>

368

369

<td> an escaped string representing a uri.

370

</td>

371

</tr>

372

<tr>

373

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

374

<td> The new uri.

375

</td>

376

</tr>

377

</tbody>

378

</table></div>

379

</div>

380

<hr>

381

382

<a name="gnome-vfs-uri-resolve-relative"></a><h3>gnome_vfs_uri_resolve_relative ()</h3>

383

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_resolve_relative (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *base,

384

const gchar *relative_reference);</pre>

385

<p>

386

Create a new uri from <em class="parameter"><code>relative_reference</code></em>, relative to <em class="parameter"><code>base</code></em>. The resolution

387

algorithm in some aspects follows <a class="ulink" href="http://www.ietf.org/rfc/rfc2396.txt" target="_top">RFC

388

2396</a>, section 5.2, but is not identical due to some extra assumptions GnomeVFS

389

makes about URIs.

390

</p>

391

<p>

392

If <em class="parameter"><code>relative_reference</code></em> begins with a valid scheme identifier followed by ':',

393

it is assumed to refer to an absolute URI, and a <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> is created from

394

it using <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-new" title="gnome_vfs_uri_new ()"><code class="function">gnome_vfs_uri_new()</code></a>.

395

</p>

396

<p>

397

Otherwise, depending on its precise syntax, it inherits some aspects of the parent URI,

398

but the parents' fragment and query components are ignored.

399

</p>

400

<p>

401

If <em class="parameter"><code>relative_reference</code></em> begins with "//", it only inherits the <em class="parameter"><code>base</code></em> scheme,

402

if it begins with '/' (i.e. is an absolute path reference), it inherits everything

403

ecxept the <em class="parameter"><code>base</code></em> path. Otherwise, it replaces the part of <em class="parameter"><code>base</code></em> after the last '/'.

404

</p>

405

<p>

406

</p>

407

408

409

This function should not be used by application authors unless they expect very

410

distinct semantics. Instead, authors should use <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-file-name" title="gnome_vfs_uri_append_file_name ()"><code class="function">gnome_vfs_uri_append_file_name()</code></a>,

411

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-path" title="gnome_vfs_uri_append_path ()"><code class="function">gnome_vfs_uri_append_path()</code></a>, <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-append-string" title="gnome_vfs_uri_append_string ()"><code class="function">gnome_vfs_uri_append_string()</code></a> or

412

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-resolve-symbolic-link" title="gnome_vfs_uri_resolve_symbolic_link ()"><code class="function">gnome_vfs_uri_resolve_symbolic_link()</code></a>.

413

</div>

414

<p>

415

</p>

416

417

418

<tbody>

419

<tr>

420

421

<td> base uri.

422

</td>

423

</tr>

424

<tr>

425

<td><p><span class="term"><em class="parameter"><code>relative_reference</code></em> :</span></p></td>

426

<td> a string representing a possibly relative uri reference.

427

</td>

428

</tr>

429

<tr>

430

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

431

<td> A <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> referring to <em class="parameter"><code>relative_reference</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>

432

if <em class="parameter"><code>relative_reference</code></em> was malformed.

433

</td>

434

</tr>

435

</tbody>

436

</table></div>

437

</div>

438

<hr>

439

440

<a name="gnome-vfs-uri-resolve-symbolic-link"></a><h3>gnome_vfs_uri_resolve_symbolic_link ()</h3>

441

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_resolve_symbolic_link (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *base,

442

const gchar *relative_reference);</pre>

443

<p>

444

Create a new uri from <em class="parameter"><code>symbolic_link</code></em>, relative to <em class="parameter"><code>base</code></em>.

445

</p>

446

<p>

447

If <em class="parameter"><code>symbolic_link</code></em> begins with a '/', it replaces the path of <em class="parameter"><code>base</code></em>,

448

otherwise it is appended after the last '/' character of <em class="parameter"><code>base</code></em>.</p>

449

<p>

450

</p>

451

452

453

<tbody>

454

<tr>

455

456

<td> base uri.

457

</td>

458

</tr>

459

<tr>

460

<td><p><span class="term"><em class="parameter"><code>relative_reference</code></em> :</span></p></td>

461

<td>

462

</td>

463

</tr>

464

<tr>

465

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

466

<td> A new <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> referring to <em class="parameter"><code>symbolic_link</code></em>.

467

468

</td>

469

</tr>

470

</tbody>

471

</table></div>

472

<p class="since">Since 2.16</p>

473

</div>

474

<hr>

475

476

<a name="gnome-vfs-uri-ref"></a><h3>gnome_vfs_uri_ref ()</h3>

477

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_ref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

478

<p>

479

Increment <em class="parameter"><code>uri</code></em>'s reference count.</p>

480

<p>

481

</p>

482

483

484

<tbody>

485

<tr>

486

487

<td> a <span class="type">GnomeVFSURI.</span>

488

</td>

489

</tr>

490

<tr>

491

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

492

<td> <em class="parameter"><code>uri</code></em>.

493

</td>

494

</tr>

495

</tbody>

496

</table></div>

497

</div>

498

<hr>

499

500

<a name="gnome-vfs-uri-unref"></a><h3>gnome_vfs_uri_unref ()</h3>

501

<pre class="programlisting">void gnome_vfs_uri_unref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

502

<p>

503

Decrement <em class="parameter"><code>uri</code></em>'s reference count. If the reference count reaches zero,

504

<em class="parameter"><code>uri</code></em> is destroyed.</p>

505

<p>

506

</p>

507

508

509

510

511

<td> a <span class="type">GnomeVFSURI.</span>

512

</td>

513

</tr></tbody>

514

</table></div>

515

</div>

516

<hr>

517

518

<a name="gnome-vfs-uri-append-string"></a><h3>gnome_vfs_uri_append_string ()</h3>

519

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_append_string (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

520

const char *uri_fragment);</pre>

521

<p>

522

Create a new uri obtained by appending <em class="parameter"><code>uri_fragment</code></em> to <em class="parameter"><code>uri</code></em>. This will take care

523

of adding an appropriate directory separator between the end of <em class="parameter"><code>uri</code></em> and

524

the start of <em class="parameter"><code>uri_fragment</code></em> if necessary.</p>

525

<p>

526

</p>

527

528

529

<tbody>

530

<tr>

531

532

<td> a <span class="type">GnomeVFSURI.</span>

533

</td>

534

</tr>

535

<tr>

536

<td><p><span class="term"><em class="parameter"><code>uri_fragment</code></em> :</span></p></td>

537

<td> a piece of a uri (ie a fully escaped partial path).

538

</td>

539

</tr>

540

<tr>

541

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

542

<td> The new uri obtained by combining <em class="parameter"><code>uri</code></em> and <em class="parameter"><code>uri_fragment</code></em>.

543

</td>

544

</tr>

545

</tbody>

546

</table></div>

547

</div>

548

<hr>

549

550

<a name="gnome-vfs-uri-append-path"></a><h3>gnome_vfs_uri_append_path ()</h3>

551

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_append_path (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

552

const char *path);</pre>

553

<p>

554

Create a new uri obtained by appending <em class="parameter"><code>path</code></em> to <em class="parameter"><code>uri</code></em>. This will take care

555

of adding an appropriate directory separator between the end of <em class="parameter"><code>uri</code></em> and

556

the start of <em class="parameter"><code>path</code></em> if necessary as well as escaping <em class="parameter"><code>path</code></em> as necessary.</p>

557

<p>

558

</p>

559

560

561

<tbody>

562

<tr>

563

564

<td> a <span class="type">GnomeVFSURI.</span>

565

</td>

566

</tr>

567

<tr>

568

569

<td> a non-escaped file path.

570

</td>

571

</tr>

572

<tr>

573

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

574

<td> The new uri obtained by combining <em class="parameter"><code>uri</code></em> and <em class="parameter"><code>path</code></em>.

575

</td>

576

</tr>

577

</tbody>

578

</table></div>

579

</div>

580

<hr>

581

582

<a name="gnome-vfs-uri-append-file-name"></a><h3>gnome_vfs_uri_append_file_name ()</h3>

583

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_append_file_name (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

584

const gchar *filename);</pre>

585

<p>

586

Create a new uri obtained by appending <em class="parameter"><code>file_name</code></em> to <em class="parameter"><code>uri</code></em>. This will take care

587

of adding an appropriate directory separator between the end of <em class="parameter"><code>uri</code></em> and

588

the start of <em class="parameter"><code>file_name</code></em> if necessary. <em class="parameter"><code>file_name</code></em> might, for instance, be the

589

result of a call to <code class="function">g_dir_read_name()</code>.</p>

590

<p>

591

</p>

592

593

594

<tbody>

595

<tr>

596

597

<td> a <span class="type">GnomeVFSURI.</span>

598

</td>

599

</tr>

600

<tr>

601

<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>

602

<td> any "regular" file name (can include #, /, etc) in the file system encoding. This is not an escaped URI.

603

</td>

604

</tr>

605

<tr>

606

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

607

<td> The new uri obtained by combining <em class="parameter"><code>uri</code></em> and <em class="parameter"><code>path</code></em>.

608

</td>

609

</tr>

610

</tbody>

611

</table></div>

612

</div>

613

<hr>

614

615

<a name="gnome-vfs-uri-to-string"></a><h3>gnome_vfs_uri_to_string ()</h3>

616

<pre class="programlisting">gchar * gnome_vfs_uri_to_string (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

617

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURIHideOptions" title="enum GnomeVFSURIHideOptions">GnomeVFSURIHideOptions</a> hide_options);</pre>

618

<p>

619

Translate <em class="parameter"><code>uri</code></em> into a printable string. The string will not

620

contain the uri elements specified by <em class="parameter"><code>hide_options</code></em>.

621

</p>

622

<p>

623

A file: URI on Win32 might look like file:///x:/foo/bar.txt. Note

624

that the part after file:// is not a legal file name, you need to

625

remove the / in front of the drive letter. This function does that

626

automatically if <em class="parameter"><code>hide_options</code></em> specifies that the toplevel method,

627

user name, password, host name and host port should be hidden.

628

</p>

629

<p>

630

On the other hand, a file: URI for a UNC path looks like

631

file:////server/share/foo/bar.txt, and in that case the part after

632

file:// is the correct file name.</p>

633

<p>

634

</p>

635

636

637

<tbody>

638

<tr>

639

640

<td> a <span class="type">GnomeVFSURI.</span>

641

</td>

642

</tr>

643

<tr>

644

<td><p><span class="term"><em class="parameter"><code>hide_options</code></em> :</span></p></td>

645

<td> bitmask specifying what uri elements (e.g. password,

646

user name etc.) should not be represented in the returned string.

647

</td>

648

</tr>

649

<tr>

650

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

651

<td> a malloc'd printable string representing <em class="parameter"><code>uri</code></em>.

652

</td>

653

</tr>

654

</tbody>

655

</table></div>

656

</div>

657

<hr>

658

659

<a name="gnome-vfs-uri-dup"></a><h3>gnome_vfs_uri_dup ()</h3>

660

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_dup (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

661

<p>

662

Duplicate <em class="parameter"><code>uri</code></em>.</p>

663

<p>

664

</p>

665

666

667

<tbody>

668

<tr>

669

670

<td> a <span class="type">GnomeVFSURI.</span>

671

</td>

672

</tr>

673

<tr>

674

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

675

<td> a pointer to a new uri that is exactly the same as <em class="parameter"><code>uri</code></em>.

676

</td>

677

</tr>

678

</tbody>

679

</table></div>

680

</div>

681

<hr>

682

683

<a name="gnome-vfs-uri-is-local"></a><h3>gnome_vfs_uri_is_local ()</h3>

684

<pre class="programlisting">gboolean gnome_vfs_uri_is_local (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

685

<p>

686

Check if <em class="parameter"><code>uri</code></em> is a local URI. Note that the return value of this

687

function entirely depends on the <span class="type">GnomeVFSMethod</span> associated with the

688

URI. It is up to the method author to distinguish between remote URIs

689

add URIs referring to entities on the local computer.

690

</p>

691

<p>

692

Warning, this can be slow, as it does i/o to detect things like NFS mounts.</p>

693

<p>

694

</p>

695

696

697

<tbody>

698

<tr>

699

700

<td> a <span class="type">GnomeVFSURI.</span>

701

</td>

702

</tr>

703

<tr>

704

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

705

<td> <code class="literal">TRUE</code> if <em class="parameter"><code>uri</code></em> refers to a local entity, <code class="literal">FALSE</code> otherwise.

706

</td>

707

</tr>

708

</tbody>

709

</table></div>

710

</div>

711

<hr>

712

713

<a name="gnome-vfs-uri-has-parent"></a><h3>gnome_vfs_uri_has_parent ()</h3>

714

<pre class="programlisting">gboolean gnome_vfs_uri_has_parent (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

715

<p>

716

Check if uri has a parent or not.</p>

717

<p>

718

</p>

719

720

721

<tbody>

722

<tr>

723

724

<td> a <span class="type">GnomeVFSURI.</span>

725

</td>

726

</tr>

727

<tr>

728

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

729

<td> <code class="literal">TRUE</code> if <em class="parameter"><code>uri</code></em> has a parent, <code class="literal">FALSE</code> otherwise.

730

</td>

731

</tr>

732

</tbody>

733

</table></div>

734

</div>

735

<hr>

736

737

<a name="gnome-vfs-uri-get-parent"></a><h3>gnome_vfs_uri_get_parent ()</h3>

738

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> * gnome_vfs_uri_get_parent (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

739

<p>

740

Retrieve <em class="parameter"><code>uri</code></em>'s parent uri.</p>

741

<p>

742

</p>

743

744

745

<tbody>

746

<tr>

747

748

<td> a <span class="type">GnomeVFSURI.</span>

749

</td>

750

</tr>

751

<tr>

752

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

753

<td> a pointer to <em class="parameter"><code>uri</code></em>'s parent uri.

754

</td>

755

</tr>

756

</tbody>

757

</table></div>

758

</div>

759

<hr>

760

761

<a name="gnome-vfs-uri-get-toplevel"></a><h3>gnome_vfs_uri_get_toplevel ()</h3>

762

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSToplevelURI" title="GnomeVFSToplevelURI">GnomeVFSToplevelURI</a> * gnome_vfs_uri_get_toplevel (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

763

<p>

764

Retrieve the toplevel uri in <em class="parameter"><code>uri</code></em>.</p>

765

<p>

766

</p>

767

768

769

<tbody>

770

<tr>

771

772

<td> a <span class="type">GnomeVFSURI.</span>

773

</td>

774

</tr>

775

<tr>

776

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

777

<td> a pointer to the toplevel uri object.

778

</td>

779

</tr>

780

</tbody>

781

</table></div>

782

</div>

783

<hr>

784

785

<a name="gnome-vfs-uri-get-host-name"></a><h3>gnome_vfs_uri_get_host_name ()</h3>

786

<pre class="programlisting">const gchar * gnome_vfs_uri_get_host_name (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

787

<p>

788

Retrieve the host name for <em class="parameter"><code>uri</code></em>.</p>

789

<p>

790

</p>

791

792

793

<tbody>

794

<tr>

795

796

<td> a <span class="type">GnomeVFSURI.</span>

797

</td>

798

</tr>

799

<tr>

800

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

801

<td> a string representing the host name.

802

</td>

803

</tr>

804

</tbody>

805

</table></div>

806

</div>

807

<hr>

808

809

<a name="gnome-vfs-uri-get-scheme"></a><h3>gnome_vfs_uri_get_scheme ()</h3>

810

<pre class="programlisting">const gchar * gnome_vfs_uri_get_scheme (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

811

<p>

812

Retrieve the scheme used for <em class="parameter"><code>uri</code></em>.</p>

813

<p>

814

</p>

815

816

817

<tbody>

818

<tr>

819

820

<td> a <span class="type">GnomeVFSURI.</span>

821

</td>

822

</tr>

823

<tr>

824

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

825

<td> a string representing the scheme.

826

</td>

827

</tr>

828

</tbody>

829

</table></div>

830

</div>

831

<hr>

832

833

<a name="gnome-vfs-uri-get-host-port"></a><h3>gnome_vfs_uri_get_host_port ()</h3>

834

<pre class="programlisting">guint gnome_vfs_uri_get_host_port (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

835

<p>

836

Retrieve the host port number in <em class="parameter"><code>uri</code></em>.</p>

837

<p>

838

</p>

839

840

841

<tbody>

842

<tr>

843

844

<td> a <span class="type">GnomeVFSURI.</span>

845

</td>

846

</tr>

847

<tr>

848

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

849

<td> The host port number used by <em class="parameter"><code>uri</code></em>. If the value is zero, the

850

default port value for the specified toplevel access method is used.

851

</td>

852

</tr>

853

</tbody>

854

</table></div>

855

</div>

856

<hr>

857

858

<a name="gnome-vfs-uri-get-user-name"></a><h3>gnome_vfs_uri_get_user_name ()</h3>

859

<pre class="programlisting">const gchar * gnome_vfs_uri_get_user_name (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

860

<p>

861

Retrieve the user name in <em class="parameter"><code>uri</code></em>.</p>

862

<p>

863

</p>

864

865

866

<tbody>

867

<tr>

868

869

<td> a <span class="type">GnomeVFSURI.</span>

870

</td>

871

</tr>

872

<tr>

873

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

874

<td> a string representing the user name in <em class="parameter"><code>uri</code></em>.

875

</td>

876

</tr>

877

</tbody>

878

</table></div>

879

</div>

880

<hr>

881

882

<a name="gnome-vfs-uri-get-password"></a><h3>gnome_vfs_uri_get_password ()</h3>

883

<pre class="programlisting">const gchar * gnome_vfs_uri_get_password (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

884

<p>

885

Retrieve the password for <em class="parameter"><code>uri</code></em>.</p>

886

<p>

887

</p>

888

889

890

<tbody>

891

<tr>

892

893

<td> a <span class="type">GnomeVFSURI.</span>

894

</td>

895

</tr>

896

<tr>

897

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

898

<td> The password for <em class="parameter"><code>uri</code></em>.

899

</td>

900

</tr>

901

</tbody>

902

</table></div>

903

</div>

904

<hr>

905

906

<a name="gnome-vfs-uri-set-host-name"></a><h3>gnome_vfs_uri_set_host_name ()</h3>

907

<pre class="programlisting">void gnome_vfs_uri_set_host_name (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

908

const gchar *host_name);</pre>

909

<p>

910

Set <em class="parameter"><code>host_name</code></em> as the host name accessed by <em class="parameter"><code>uri</code></em>.</p>

911

<p>

912

</p>

913

914

915

<tbody>

916

<tr>

917

918

<td> a <span class="type">GnomeVFSURI.</span>

919

</td>

920

</tr>

921

<tr>

922

923

<td> a string representing a host name.

924

</td>

925

</tr>

926

</tbody>

927

</table></div>

928

</div>

929

<hr>

930

931

<a name="gnome-vfs-uri-set-host-port"></a><h3>gnome_vfs_uri_set_host_port ()</h3>

932

<pre class="programlisting">void gnome_vfs_uri_set_host_port (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

933

guint host_port);</pre>

934

<p>

935

Set the host port number in <em class="parameter"><code>uri</code></em>. If <em class="parameter"><code>host_port</code></em> is zero, the default port

936

for <em class="parameter"><code>uri</code></em>'s toplevel access method is used.</p>

937

<p>

938

</p>

939

940

941

<tbody>

942

<tr>

943

944

<td> a <span class="type">GnomeVFSURI.</span>

945

</td>

946

</tr>

947

<tr>

948

949

<td> a TCP/IP port number.

950

</td>

951

</tr>

952

</tbody>

953

</table></div>

954

</div>

955

<hr>

956

957

<a name="gnome-vfs-uri-set-user-name"></a><h3>gnome_vfs_uri_set_user_name ()</h3>

958

<pre class="programlisting">void gnome_vfs_uri_set_user_name (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

959

const gchar *user_name);</pre>

960

<p>

961

Set <em class="parameter"><code>user_name</code></em> as the user name for <em class="parameter"><code>uri</code></em>.</p>

962

<p>

963

</p>

964

965

966

<tbody>

967

<tr>

968

969

<td> a <span class="type">GnomeVFSURI.</span>

970

</td>

971

</tr>

972

<tr>

973

974

<td> a string representing a user name on the host accessed by <em class="parameter"><code>uri</code></em>.

975

</td>

976

</tr>

977

</tbody>

978

</table></div>

979

</div>

980

<hr>

981

982

<a name="gnome-vfs-uri-set-password"></a><h3>gnome_vfs_uri_set_password ()</h3>

983

<pre class="programlisting">void gnome_vfs_uri_set_password (<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri,

984

const gchar *password);</pre>

985

<p>

986

Set <em class="parameter"><code>password</code></em> as the password for <em class="parameter"><code>uri</code></em>.</p>

987

<p>

988

</p>

989

990

991

<tbody>

992

<tr>

993

994

<td> a <span class="type">GnomeVFSURI.</span>

995

</td>

996

</tr>

997

<tr>

998

<td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>

999

<td> a password string.

1000

</td>

1001

</tr>

1002

</tbody>

1003

</table></div>

1004

</div>

1005

<hr>

1006

1007

<a name="gnome-vfs-uri-equal"></a><h3>gnome_vfs_uri_equal ()</h3>

1008

<pre class="programlisting">gboolean gnome_vfs_uri_equal (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *a,

1009

const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *b);</pre>

1010

<p>

1011

Compare <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em>.

1012

</p>

1013

<p>

1014

FIXME: This comparison should take into account the possiblity

1015

that unreserved characters may be escaped.

1016

...or perhaps <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-new" title="gnome_vfs_uri_new ()"><code class="function">gnome_vfs_uri_new()</code></a> should unescape unreserved characters?</p>

1017

<p>

1018

</p>

1019

1020

1021

<tbody>

1022

<tr>

1023

1024

<td> a <span class="type">GnomeVFSURI.</span>

1025

</td>

1026

</tr>

1027

<tr>

1028

1029

<td> a <span class="type">GnomeVFSURI.</span>

1030

</td>

1031

</tr>

1032

<tr>

1033

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1034

<td> <code class="literal">TRUE</code> if <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> are equal, <code class="literal">FALSE</code> otherwise.

1035

</td>

1036

</tr>

1037

</tbody>

1038

</table></div>

1039

</div>

1040

<hr>

1041

1042

<a name="gnome-vfs-uri-is-parent"></a><h3>gnome_vfs_uri_is_parent ()</h3>

1043

<pre class="programlisting">gboolean gnome_vfs_uri_is_parent (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *possible_parent,

1044

const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *possible_child,

1045

gboolean recursive);</pre>

1046

<p>

1047

Check if <em class="parameter"><code>possible_child</code></em> is contained by <em class="parameter"><code>possible_parent</code></em>.

1048

If <em class="parameter"><code>recursive</code></em> is <code class="literal">FALSE</code>, just try the immediate parent directory, else

1049

search up through the hierarchy.</p>

1050

<p>

1051

</p>

1052

1053

1054

<tbody>

1055

<tr>

1056

<td><p><span class="term"><em class="parameter"><code>possible_parent</code></em> :</span></p></td>

1057

<td> a <span class="type">GnomeVFSURI.</span>

1058

</td>

1059

</tr>

1060

<tr>

1061

<td><p><span class="term"><em class="parameter"><code>possible_child</code></em> :</span></p></td>

1062

<td> a <span class="type">GnomeVFSURI.</span>

1063

</td>

1064

</tr>

1065

<tr>

1066

<td><p><span class="term"><em class="parameter"><code>recursive</code></em> :</span></p></td>

1067

<td> a flag to turn recursive check on.

1068

</td>

1069

</tr>

1070

<tr>

1071

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1072

<td> <code class="literal">TRUE</code> if <em class="parameter"><code>possible_child</code></em> is contained in <em class="parameter"><code>possible_parent</code></em>.

1073

</td>

1074

</tr>

1075

</tbody>

1076

</table></div>

1077

</div>

1078

<hr>

1079

1080

<a name="gnome-vfs-uri-get-path"></a><h3>gnome_vfs_uri_get_path ()</h3>

1081

<pre class="programlisting">const gchar * gnome_vfs_uri_get_path (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

1082

<p>

1083

Retrieve full path name for <em class="parameter"><code>uri</code></em>.</p>

1084

<p>

1085

</p>

1086

1087

1088

<tbody>

1089

<tr>

1090

1091

<td> a <span class="type">GnomeVFSURI.</span>

1092

</td>

1093

</tr>

1094

<tr>

1095

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1096

<td> a pointer to the full path name in <em class="parameter"><code>uri</code></em>. Notice that the

1097

pointer points to the path name stored in <em class="parameter"><code>uri</code></em>, so the path name returned must not

1098

be modified nor freed.

1099

</td>

1100

</tr>

1101

</tbody>

1102

</table></div>

1103

</div>

1104

<hr>

1105

1106

<a name="gnome-vfs-uri-get-fragment-identifier"></a><h3>gnome_vfs_uri_get_fragment_identifier ()</h3>

1107

<pre class="programlisting">const gchar * gnome_vfs_uri_get_fragment_identifier

1108

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

1109

<p>

1110

</p>

1111

1112

1113

<tbody>

1114

<tr>

1115

1116

<td>

1117

</td>

1118

</tr>

1119

<tr>

1120

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1121

<td>

1122

</td>

1123

</tr>

1124

</tbody>

1125

</table></div>

1126

</div>

1127

<hr>

1128

1129

<a name="gnome-vfs-uri-extract-dirname"></a><h3>gnome_vfs_uri_extract_dirname ()</h3>

1130

<pre class="programlisting">gchar * gnome_vfs_uri_extract_dirname (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

1131

<p>

1132

Extract the name of the directory in which the file pointed to by <em class="parameter"><code>uri</code></em> is

1133

stored as a newly allocated string. The string will end with a

1134

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-PATH-CHR:CAPS" title="GNOME_VFS_URI_PATH_CHR"><code class="literal">GNOME_VFS_URI_PATH_CHR</code></a>.</p>

1135

<p>

1136

</p>

1137

1138

1139

<tbody>

1140

<tr>

1141

1142

<td> a <span class="type">GnomeVFSURI.</span>

1143

</td>

1144

</tr>

1145

<tr>

1146

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1147

<td> a pointer to the newly allocated string representing the

1148

parent directory.

1149

</td>

1150

</tr>

1151

</tbody>

1152

</table></div>

1153

</div>

1154

<hr>

1155

1156

<a name="gnome-vfs-uri-extract-short-name"></a><h3>gnome_vfs_uri_extract_short_name ()</h3>

1157

<pre class="programlisting">gchar * gnome_vfs_uri_extract_short_name (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

1158

<p>

1159

Retrieve base file name for <em class="parameter"><code>uri</code></em>, ignoring any trailing path separators.

1160

This matches the XPG definition of basename, but not g_basename. This is

1161

often useful when you want the name of something that's pointed to by a

1162

uri, and don't care whether the uri has a directory or file form.

1163

If <em class="parameter"><code>uri</code></em> points to the root of a domain, returns the host name. If there's

1164

no host name, returns <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-PATH-STR:CAPS" title="GNOME_VFS_URI_PATH_STR"><code class="literal">GNOME_VFS_URI_PATH_STR</code></a>.

1165

</p>

1166

<p>

1167

See also: <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-extract-short-path-name" title="gnome_vfs_uri_extract_short_path_name ()"><code class="function">gnome_vfs_uri_extract_short_path_name()</code></a>.</p>

1168

<p>

1169

</p>

1170

1171

1172

<tbody>

1173

<tr>

1174

1175

<td> a <span class="type">GnomeVFSURI.</span>

1176

</td>

1177

</tr>

1178

<tr>

1179

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1180

<td> a pointer to the newly allocated string representing the

1181

unescaped short form of the name.

1182

</td>

1183

</tr>

1184

</tbody>

1185

</table></div>

1186

</div>

1187

<hr>

1188

1189

<a name="gnome-vfs-uri-extract-short-path-name"></a><h3>gnome_vfs_uri_extract_short_path_name ()</h3>

1190

<pre class="programlisting">gchar * gnome_vfs_uri_extract_short_path_name

1191

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *uri);</pre>

1192

<p>

1193

Retrieve base file name for <em class="parameter"><code>uri</code></em>, ignoring any trailing path separators.

1194

This matches the XPG definition of basename, but not g_basename. This is

1195

often useful when you want the name of something that's pointed to by a

1196

uri, and don't care whether the uri has a directory or file form.

1197

If <em class="parameter"><code>uri</code></em> points to the root (including the root of any domain),

1198

returns <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GNOME-VFS-URI-PATH-STR:CAPS" title="GNOME_VFS_URI_PATH_STR"><code class="literal">GNOME_VFS_URI_PATH_STR</code></a>.

1199

</p>

1200

<p>

1201

See also: <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-extract-short-name" title="gnome_vfs_uri_extract_short_name ()"><code class="function">gnome_vfs_uri_extract_short_name()</code></a>.</p>

1202

<p>

1203

</p>

1204

1205

1206

<tbody>

1207

<tr>

1208

1209

<td> a <span class="type">GnomeVFSURI.</span>

1210

</td>

1211

</tr>

1212

<tr>

1213

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1214

<td> a pointer to the newly allocated string representing the

1215

escaped short form of the name.

1216

</td>

1217

</tr>

1218

</tbody>

1219

</table></div>

1220

</div>

1221

<hr>

1222

1223

<a name="gnome-vfs-uri-hequal"></a><h3>gnome_vfs_uri_hequal ()</h3>

1224

<pre class="programlisting">gint gnome_vfs_uri_hequal (gconstpointer a,

1225

gconstpointer b);</pre>

1226

<p>

1227

Function intended for use as a hash table "are these two items

1228

the same" comparison. Useful for creating a hash table of uris.</p>

1229

<p>

1230

</p>

1231

1232

1233

<tbody>

1234

<tr>

1235

1236

<td> a pointer to a <span class="type">GnomeVFSURI.</span>

1237

</td>

1238

</tr>

1239

<tr>

1240

1241

<td> a pointer to a <span class="type">GnomeVFSURI.</span>

1242

</td>

1243

</tr>

1244

<tr>

1245

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1246

<td> <code class="literal">TRUE</code> if the uris are the same.

1247

</td>

1248

</tr>

1249

</tbody>

1250

</table></div>

1251

</div>

1252

<hr>

1253

1254

<a name="gnome-vfs-uri-hash"></a><h3>gnome_vfs_uri_hash ()</h3>

1255

<pre class="programlisting">guint gnome_vfs_uri_hash (gconstpointer p);</pre>

1256

<p>

1257

Creates an integer value from a <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a>, appropriate

1258

for using as the key to a hash table entry.</p>

1259

<p>

1260

</p>

1261

1262

1263

<tbody>

1264

<tr>

1265

1266

<td> a pointer to a <span class="type">GnomeVFSURI.</span>

1267

</td>

1268

</tr>

1269

<tr>

1270

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1271

<td> a hash key corresponding to <em class="parameter"><code>p</code></em>.

1272

</td>

1273

</tr>

1274

</tbody>

1275

</table></div>

1276

</div>

1277

<hr>

1278

1279

<a name="gnome-vfs-uri-list-parse"></a><h3>gnome_vfs_uri_list_parse ()</h3>

1280

<pre class="programlisting">GList * gnome_vfs_uri_list_parse (const gchar *uri_list);</pre>

1281

<p>

1282

Extracts a list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> objects from a standard text/uri-list,

1283

such as one you would get on a drop operation. Use

1284

<a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-list-free" title="gnome_vfs_uri_list_free ()"><code class="function">gnome_vfs_uri_list_free()</code></a> when you are done with the list.</p>

1285

<p>

1286

</p>

1287

1288

1289

<tbody>

1290

<tr>

1291

1292

<td> string consists of <span class="type">GnomeVFSURIs</span> and/or paths seperated by newline character.

1293

</td>

1294

</tr>

1295

<tr>

1296

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1297

<td> a <span class="type">GList</span> of <span class="type">GnomeVFSURIs.</span>

1298

</td>

1299

</tr>

1300

</tbody>

1301

</table></div>

1302

</div>

1303

<hr>

1304

1305

<a name="gnome-vfs-uri-list-ref"></a><h3>gnome_vfs_uri_list_ref ()</h3>

1306

<pre class="programlisting">GList * gnome_vfs_uri_list_ref (GList *list);</pre>

1307

<p>

1308

Increments the reference count of the items in <em class="parameter"><code>list</code></em> by one.</p>

1309

<p>

1310

</p>

1311

1312

1313

<tbody>

1314

<tr>

1315

1316

<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> elements.

1317

</td>

1318

</tr>

1319

<tr>

1320

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1321

<td> <em class="parameter"><code>list</code></em>.

1322

</td>

1323

</tr>

1324

</tbody>

1325

</table></div>

1326

</div>

1327

<hr>

1328

1329

<a name="gnome-vfs-uri-list-unref"></a><h3>gnome_vfs_uri_list_unref ()</h3>

1330

<pre class="programlisting">GList * gnome_vfs_uri_list_unref (GList *list);</pre>

1331

<p>

1332

Decrements the reference count of the items in <em class="parameter"><code>list</code></em> by one.

1333

Note that the list is *not freed* even if each member of the list

1334

is freed.</p>

1335

<p>

1336

</p>

1337

1338

1339

<tbody>

1340

<tr>

1341

1342

<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> elements.

1343

</td>

1344

</tr>

1345

<tr>

1346

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1347

<td> <em class="parameter"><code>list</code></em>.

1348

</td>

1349

</tr>

1350

</tbody>

1351

</table></div>

1352

</div>

1353

<hr>

1354

1355

<a name="gnome-vfs-uri-list-copy"></a><h3>gnome_vfs_uri_list_copy ()</h3>

1356

<pre class="programlisting">GList * gnome_vfs_uri_list_copy (GList *list);</pre>

1357

<p>

1358

Creates a duplicate of <em class="parameter"><code>list</code></em>, and references each member of

1359

that list.</p>

1360

<p>

1361

</p>

1362

1363

1364

<tbody>

1365

<tr>

1366

1367

<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> elements.

1368

</td>

1369

</tr>

1370

<tr>

1371

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1372

<td> a newly referenced duplicate of <em class="parameter"><code>list</code></em>.

1373

</td>

1374

</tr>

1375

</tbody>

1376

</table></div>

1377

</div>

1378

<hr>

1379

1380

<a name="gnome-vfs-uri-list-free"></a><h3>gnome_vfs_uri_list_free ()</h3>

1381

<pre class="programlisting">void gnome_vfs_uri_list_free (GList *list);</pre>

1382

<p>

1383

Decrements the reference count of each member of <em class="parameter"><code>list</code></em> by one,

1384

and frees the list itself.</p>

1385

<p>

1386

</p>

1387

1388

1389

1390

1391

<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> elements.

1392

</td>

1393

</tr></tbody>

1394

</table></div>

1395

</div>

1396

<hr>

1397

1398

<a name="gnome-vfs-uri-make-full-from-relative"></a><h3>gnome_vfs_uri_make_full_from_relative ()</h3>

1399

<pre class="programlisting">char * gnome_vfs_uri_make_full_from_relative

1400

(const char *base_uri,

1401

const char *relative_uri);</pre>

1402

<p>

1403

Returns a full uri given a full base uri, and a secondary uri which may

1404

be relative.</p>

1405

<p>

1406

</p>

1407

1408

1409

<tbody>

1410

<tr>

1411

1412

<td> a string representing the base uri.

1413

</td>

1414

</tr>

1415

<tr>

1416

<td><p><span class="term"><em class="parameter"><code>relative_uri</code></em> :</span></p></td>

1417

<td> a uri fragment/reference to be appended to <em class="parameter"><code>base_uri</code></em>.

1418

</td>

1419

</tr>

1420

<tr>

1421

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

1422

<td> a newly allocated string containing the uri

1423

(<a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> for some bad errors).

1424

</td>

1425

</tr>

1426

</tbody>

1427

</table></div>

1428

</div>

1429

</div>

1430

</div>

1431

1432

<hr>

1433

Generated by GTK-Doc V1.12</div>

1434

</body>

1435

</html>

Older »