Gnome2::VFS::URI(3)

📦
version 1.084 · 2 versions
, in fedora 43

💖 Gnome2::VFS::URI — bestie, let's talk URIs 💖

okay so this page is called Gnome2::VFS::URI and it lives in the User Contributed Perl Documentation corner of the manual-verse. It's literally a Perl wrapper for GnomeVFSURI. That's it, that's the vibe. 🌸

🌈 HIERARCHY

the family tree, and it's giving very much:

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

so it inherits from Glib::Boxed. iconic lineage, no cap. 👑

✨ METHODS ✨

every single one, bestie. I did not skip a single one. we're thorough in this house. 💅

uri = Gnome2::VFS::URI->new ($text_uri)

  • $text_uri — a string, and it's the text URI you're feeding in. 🍓

uri = $base->append_file_name ($filename)

  • $filename — a string. stick a file name onto the base, slay.

uri = $base->append_path ($path)

  • $path — a string. same energy, but with a whole path.

uri = $base->append_string ($uri_fragment)

  • $uri_fragment — a string. glue it on the end, periodt.

list = $source_uri->check_same_fs ($target_uri)

  • $target_uri — a Gnome2::VFS::URI. the one you're comparing against.

Returns a GnomeVFSResult and a boolean. two things! a little duo. 🫶

list = $uri->create ($open_mode, $exclusive, $perm)

  • $open_mode — a Gnome2::VFS::OpenMode.
  • $exclusive — a boolean.
  • $perm — an integer.

Returns a GnomeVFSResult and a GnomeVFSHandle.

boolean = $a->equal ($b)

  • $b — a Gnome2::VFS::URI.

are they the same? yes or no, bestie. ✨

boolean = $uri->exists

does it exist?? the suspense. 🙈

string = $uri->extract_dirname

  • gives you back a string — the directory name.

string = $uri->extract_short_name

  • a string. the short name. cute and brief. 🎀

string = $uri->extract_short_path_name

  • a string. the short path name, which is a different thing, okay, we don't make the rules.

list = $uri->get_file_info ($options)

  • $options — a Gnome2::VFS::FileInfoOptions.

Returns a GnomeVFSResult and a GnomeVFSFileInfo.

result = $uri->set_file_info ($info, $mask)

  • $info — a Gnome2::VFS::FileInfo.
  • $mask — a Gnome2::VFS::SetFileInfoMask.

string = $uri->get_fragment_identifier

  • a string. the fragment identifier. iykyk. 💜

boolean = $uri->has_parent

  • does it have a parent? we all do, spiritually.

string = $uri->get_host_name

  • a string. who's the host?

$uri->set_host_name ($host_name)

  • $host_name — a string. now set it. go off. 🔥

integer = $uri->get_host_port

  • an integer. the port. not the wine. 🍷 (jk it's a number)

$uri->set_host_port ($host_port)

  • $host_port — an integer.

boolean = $uri->is_local

  • is it local?? vibe check. 🌈

boolean = $possible_parent->is_parent ($possible_child, $recursive)

  • $possible_child — a Gnome2::VFS::URI.
  • $recursive — a boolean.

list = Gnome2::VFS::URI->list_parse ($uri_list)

  • $uri_list — a string.

Returns a list of GnomeVFSURI's. plural!! a whole squad. 👑

result = $uri->make_directory ($perm)

  • $perm — an integer.

string = Gnome2::VFS::URI->make_full_from_relative ($base_uri, $relative_uri)

  • $base_uri — a string.
  • $relative_uri — a string.

result = $old_uri->move ($new_uri, $force_replace)

  • $new_uri — a Gnome2::VFS::URI.
  • $force_replace — a boolean.

it MOVES. relocation era. 📦

list = $uri->open ($open_mode)

  • $open_mode — a Gnome2::VFS::OpenMode.

Returns a GnomeVFSResult and a GnomeVFSHandle.

uri = $uri->get_parent

  • get the parent URI. family reunion. 🫶

string = $uri->get_password

  • a string. 🔒 do not tell anyone. seriously.

$uri->set_password ($password)

  • $password — a string.

string = $uri->get_path

  • a string. the path. we love a path. 🌸

result = $uri->remove_directory

  • bye bye directory 💀

uri = $base->resolve_relative ($relative_reference)

  • $relative_reference — a string.
  • $symbolic_link — a string.
Since: vfs 2.16 — so if you're on something ancient, this one isn't there for you, bestie. 😭

string = $uri->get_scheme

  • a string. the scheme!! like http or whatever. iconic. ✨

string = $uri->to_string ($hide_options=GNOME_VFS_URI_HIDE_NONE)

  • $hide_options — a Gnome2::VFS::URI::HideOptions. defaults to GNOME_VFS_URI_HIDE_NONE, because by default we hide nothing. transparency queen. 💅

result = $uri->truncate ($length)

  • $length — an unsigned. chop chop. ✂️
  • unlink it. gone. no notes. 💀

string = $uri->get_user_name

  • a string. who dis? 🙈

$uri->set_user_name ($user_name)

  • $user_name — a string.

🎀 ENUMS AND FLAGS 🎀

the full menu, every last one, in order. don't skip, bestie.

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

okay this one is LONG and I love that for it. every single one:

  • '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'

that's the whole roster. breathe. 🧚

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 👀

go read these next, bestie, they're the friends of this page:

  • Gnome2::VFS
  • Glib::Boxed

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

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

and that's the whole page, bestie!! 🎀 this one came out with perl v5.42.0 on 2025-07-25, filed under Gnome2::VFS::URI(3). go forth and URI responsibly. 💅✨🦋

📦 where this page comes from