---
name: "Gnome2::VFS::URI"
section: "3pm"
platform: "linux"
package: "libgnome2-vfs-perl"
version: "1.082-1+b3"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/Gnome2::VFS::URI"
---

# Gnome2::VFS::URI(3pm)

uniform resource identifier

## NAME

Gnome2::VFS::URI - uniform resource identifier

## HIERARCHY

```
  Glib::Boxed
  +----Gnome2::VFS::URI
```

## METHODS

### uri = Gnome2::VFS::URI-\>new ($text\_uri)

- •

  `$text_uri` (string)

### uri = $base-\>append\_file\_name ($filename)

- •

  `$filename` (string)

### uri = $base-\>append\_path ($path)

- •

  `$path` (string)

### uri = $base-\>append\_string ($uri\_fragment)

- •

  `$uri_fragment` (string)

### list = $source\_uri-\>check\_same\_fs ($target\_uri)

- •

  `$target_uri` (Gnome2::VFS::URI)

Returns a GnomeVFSResult and a boolean.

### list = $uri-\>create ($open\_mode, $exclusive, $perm)

- •

  `$open_mode` (Gnome2::VFS::OpenMode)

- •

  `$exclusive` (boolean)

- •

  `$perm` (integer)

Returns a GnomeVFSResult and a GnomeVFSHandle.

### boolean = $a-\>equal ($b)

- •

  `$b` (Gnome2::VFS::URI)

### boolean = $uri-\>exists

### string = $uri-\>extract\_dirname

### string = $uri-\>extract\_short\_name

### string = $uri-\>extract\_short\_path\_name

### list = $uri-\>get\_file\_info ($options)

- •

  `$options` (Gnome2::VFS::FileInfoOptions)

Returns a GnomeVFSResult and a GnomeVFSFileInfo.

### result = $uri-\>set\_file\_info ($info, $mask)

- •

  `$info` (Gnome2::VFS::FileInfo)

- •

  `$mask` (Gnome2::VFS::SetFileInfoMask)

### string = $uri-\>get\_fragment\_identifier

### boolean = $uri-\>has\_parent

### string = $uri-\>get\_host\_name

### $uri-\>set\_host\_name ($host\_name)

- •

  `$host_name` (string)

### integer = $uri-\>get\_host\_port

### $uri-\>set\_host\_port ($host\_port)

- •

  `$host_port` (integer)

### boolean = $uri-\>is\_local

### boolean = $possible\_parent-\>is\_parent ($possible\_child, $recursive)

- •

  `$possible_child` (Gnome2::VFS::URI)

- •

  `$recursive` (boolean)

### list = Gnome2::VFS::URI-\>list\_parse ($uri\_list)

- •

  `$uri_list` (string)

Returns a list of GnomeVFSURI's.

### result = $uri-\>make\_directory ($perm)

- •

  `$perm` (integer)

### string = Gnome2::VFS::URI-\>make\_full\_from\_relative ($base\_uri, $relative\_uri)

- •

  `$base_uri` (string)

- •

  `$relative_uri` (string)

### result = $old\_uri-\>move ($new\_uri, $force\_replace)

- •

  `$new_uri` (Gnome2::VFS::URI)

- •

  `$force_replace` (boolean)

### list = $uri-\>open ($open\_mode)

- •

  `$open_mode` (Gnome2::VFS::OpenMode)

Returns a GnomeVFSResult and a GnomeVFSHandle.

### uri = $uri-\>get\_parent

### string = $uri-\>get\_password

### $uri-\>set\_password ($password)

- •

  `$password` (string)

### string = $uri-\>get\_path

### result = $uri-\>remove\_directory

### uri = $base-\>resolve\_relative ($relative\_reference)

- •

  `$relative_reference` (string)

### uri = $base-\>resolve\_symbolic\_link ($symbolic\_link)

- •

  `$symbolic_link` (string)

Since: vfs 2.16

### string = $uri-\>get\_scheme

### string = $uri-\>to\_string ($hide\_options=GNOME\_VFS\_URI\_HIDE\_NONE)

- •

  `$hide_options` (Gnome2::VFS::URI::HideOptions)

### result = $uri-\>truncate ($length)

- •

  `$length` (unsigned)

### result = $uri-\>unlink

### string = $uri-\>get\_user\_name

### $uri-\>set\_user\_name ($user\_name)

- •

  `$user_name` (string)

## ENUMS AND FLAGS

### flags Gnome2::VFS::FileInfoOptions

- •

  'default' / 'GNOME\_VFS\_FILE\_INFO\_DEFAULT'

- •

  'get-mime-type' / 'GNOME\_VFS\_FILE\_INFO\_GET\_MIME\_TYPE'

- •

  'force-fast-mime-type' / 'GNOME\_VFS\_FILE\_INFO\_FORCE\_FAST\_MIME\_TYPE'

- •

  'force-slow-mime-type' / 'GNOME\_VFS\_FILE\_INFO\_FORCE\_SLOW\_MIME\_TYPE'

- •

  'follow-links' / 'GNOME\_VFS\_FILE\_INFO\_FOLLOW\_LINKS'

- •

  'get-access-rights' / 'GNOME\_VFS\_FILE\_INFO\_GET\_ACCESS\_RIGHTS'

- •

  'name-only' / 'GNOME\_VFS\_FILE\_INFO\_NAME\_ONLY'

- •

  'get-acl' / 'GNOME\_VFS\_FILE\_INFO\_GET\_ACL'

- •

  'get-selinux-context' / 'GNOME\_VFS\_FILE\_INFO\_GET\_SELINUX\_CONTEXT'

### flags Gnome2::VFS::OpenMode

- •

  'none' / 'GNOME\_VFS\_OPEN\_NONE'

- •

  'read' / 'GNOME\_VFS\_OPEN\_READ'

- •

  'write' / 'GNOME\_VFS\_OPEN\_WRITE'

- •

  'random' / 'GNOME\_VFS\_OPEN\_RANDOM'

- •

  'truncate' / 'GNOME\_VFS\_OPEN\_TRUNCATE'

### enum Gnome2::VFS::Result

- •

  'ok' / 'GNOME\_VFS\_OK'

- •

  'error-not-found' / 'GNOME\_VFS\_ERROR\_NOT\_FOUND'

- •

  'error-generic' / 'GNOME\_VFS\_ERROR\_GENERIC'

- •

  'error-internal' / 'GNOME\_VFS\_ERROR\_INTERNAL'

- •

  'error-bad-parameters' / 'GNOME\_VFS\_ERROR\_BAD\_PARAMETERS'

- •

  'error-not-supported' / 'GNOME\_VFS\_ERROR\_NOT\_SUPPORTED'

- •

  'error-io' / 'GNOME\_VFS\_ERROR\_IO'

- •

  'error-corrupted-data' / 'GNOME\_VFS\_ERROR\_CORRUPTED\_DATA'

- •

  'error-wrong-format' / 'GNOME\_VFS\_ERROR\_WRONG\_FORMAT'

- •

  'error-bad-file' / 'GNOME\_VFS\_ERROR\_BAD\_FILE'

- •

  'error-too-big' / 'GNOME\_VFS\_ERROR\_TOO\_BIG'

- •

  'error-no-space' / 'GNOME\_VFS\_ERROR\_NO\_SPACE'

- •

  'error-read-only' / 'GNOME\_VFS\_ERROR\_READ\_ONLY'

- •

  'error-invalid-uri' / 'GNOME\_VFS\_ERROR\_INVALID\_URI'

- •

  'error-not-open' / 'GNOME\_VFS\_ERROR\_NOT\_OPEN'

- •

  'error-invalid-open-mode' / 'GNOME\_VFS\_ERROR\_INVALID\_OPEN\_MODE'

- •

  'error-access-denied' / 'GNOME\_VFS\_ERROR\_ACCESS\_DENIED'

- •

  'error-too-many-open-files' / 'GNOME\_VFS\_ERROR\_TOO\_MANY\_OPEN\_FILES'

- •

  'error-eof' / 'GNOME\_VFS\_ERROR\_EOF'

- •

  'error-not-a-directory' / 'GNOME\_VFS\_ERROR\_NOT\_A\_DIRECTORY'

- •

  'error-in-progress' / 'GNOME\_VFS\_ERROR\_IN\_PROGRESS'

- •

  'error-interrupted' / 'GNOME\_VFS\_ERROR\_INTERRUPTED'

- •

  'error-file-exists' / 'GNOME\_VFS\_ERROR\_FILE\_EXISTS'

- •

  'error-loop' / 'GNOME\_VFS\_ERROR\_LOOP'

- •

  'error-not-permitted' / 'GNOME\_VFS\_ERROR\_NOT\_PERMITTED'

- •

  'error-is-directory' / 'GNOME\_VFS\_ERROR\_IS\_DIRECTORY'

- •

  'error-no-memory' / 'GNOME\_VFS\_ERROR\_NO\_MEMORY'

- •

  'error-host-not-found' / 'GNOME\_VFS\_ERROR\_HOST\_NOT\_FOUND'

- •

  'error-invalid-host-name' / 'GNOME\_VFS\_ERROR\_INVALID\_HOST\_NAME'

- •

  'error-host-has-no-address' / 'GNOME\_VFS\_ERROR\_HOST\_HAS\_NO\_ADDRESS'

- •

  'error-login-failed' / 'GNOME\_VFS\_ERROR\_LOGIN\_FAILED'

- •

  'error-cancelled' / 'GNOME\_VFS\_ERROR\_CANCELLED'

- •

  'error-directory-busy' / 'GNOME\_VFS\_ERROR\_DIRECTORY\_BUSY'

- •

  'error-directory-not-empty' / 'GNOME\_VFS\_ERROR\_DIRECTORY\_NOT\_EMPTY'

- •

  'error-too-many-links' / 'GNOME\_VFS\_ERROR\_TOO\_MANY\_LINKS'

- •

  'error-read-only-file-system' / 'GNOME\_VFS\_ERROR\_READ\_ONLY\_FILE\_SYSTEM'

- •

  'error-not-same-file-system' / 'GNOME\_VFS\_ERROR\_NOT\_SAME\_FILE\_SYSTEM'

- •

  'error-name-too-long' / 'GNOME\_VFS\_ERROR\_NAME\_TOO\_LONG'

- •

  'error-service-not-available' / 'GNOME\_VFS\_ERROR\_SERVICE\_NOT\_AVAILABLE'

- •

  'error-service-obsolete' / 'GNOME\_VFS\_ERROR\_SERVICE\_OBSOLETE'

- •

  'error-protocol-error' / 'GNOME\_VFS\_ERROR\_PROTOCOL\_ERROR'

- •

  'error-no-master-browser' / 'GNOME\_VFS\_ERROR\_NO\_MASTER\_BROWSER'

- •

  'error-no-default' / 'GNOME\_VFS\_ERROR\_NO\_DEFAULT'

- •

  'error-no-handler' / 'GNOME\_VFS\_ERROR\_NO\_HANDLER'

- •

  'error-parse' / 'GNOME\_VFS\_ERROR\_PARSE'

- •

  'error-launch' / 'GNOME\_VFS\_ERROR\_LAUNCH'

- •

  'error-timeout' / 'GNOME\_VFS\_ERROR\_TIMEOUT'

- •

  'error-nameserver' / 'GNOME\_VFS\_ERROR\_NAMESERVER'

- •

  'error-locked' / 'GNOME\_VFS\_ERROR\_LOCKED'

- •

  'error-deprecated-function' / 'GNOME\_VFS\_ERROR\_DEPRECATED\_FUNCTION'

- •

  'error-invalid-filename' / 'GNOME\_VFS\_ERROR\_INVALID\_FILENAME'

- •

  'error-not-a-symbolic-link' / 'GNOME\_VFS\_ERROR\_NOT\_A\_SYMBOLIC\_LINK'

- •

  'num-errors' / 'GNOME\_VFS\_NUM\_ERRORS'

### flags Gnome2::VFS::SetFileInfoMask

- •

  'none' / 'GNOME\_VFS\_SET\_FILE\_INFO\_NONE'

- •

  'name' / 'GNOME\_VFS\_SET\_FILE\_INFO\_NAME'

- •

  'permissions' / 'GNOME\_VFS\_SET\_FILE\_INFO\_PERMISSIONS'

- •

  'owner' / 'GNOME\_VFS\_SET\_FILE\_INFO\_OWNER'

- •

  'time' / 'GNOME\_VFS\_SET\_FILE\_INFO\_TIME'

- •

  'acl' / 'GNOME\_VFS\_SET\_FILE\_INFO\_ACL'

- •

  'selinux-context' / 'GNOME\_VFS\_SET\_FILE\_INFO\_SELINUX\_CONTEXT'

- •

  'symlink-name' / 'GNOME\_VFS\_SET\_FILE\_INFO\_SYMLINK\_NAME'

### flags Gnome2::VFS::URI::HideOptions

- •

  'none' / 'GNOME\_VFS\_URI\_HIDE\_NONE'

- •

  'user-name' / 'GNOME\_VFS\_URI\_HIDE\_USER\_NAME'

- •

  'password' / 'GNOME\_VFS\_URI\_HIDE\_PASSWORD'

- •

  'host-name' / 'GNOME\_VFS\_URI\_HIDE\_HOST\_NAME'

- •

  'host-port' / 'GNOME\_VFS\_URI\_HIDE\_HOST\_PORT'

- •

  'toplevel-method' / 'GNOME\_VFS\_URI\_HIDE\_TOPLEVEL\_METHOD'

- •

  'fragment-identifier' / 'GNOME\_VFS\_URI\_HIDE\_FRAGMENT\_IDENTIFIER'

## SEE ALSO

Gnome2::VFS, Glib::Boxed

## COPYRIGHT

Copyright (C) 2003-2007, 2013 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gnome2::VFS for a full notice.