Gnome2:...::Engine(3)

📦
version 1.047 · 2 versions
, in fedora 43

💖 Gnome2::GConf::Engine — the configuration engine, bestie edition 💖

okay so this is a page from the User Contributed Perl Documentation set, and it's literally all about Gnome2::GConf::Engine(3) — yes the man name has a lil Gnome2:...::Engine(3) thing going on, don't worry about it, we're here for the engine 🫶

✨ NAME ✨

Gnome2::GConf::Engine — A Configuration Engine 🎀

✨ SYNOPSIS ✨

(no synopsis, bestie. it's giving mysterious. it's giving "read the DESCRIPTION". 💅)

✨ DESCRIPTION ✨

So Gnome2::GConf::Engine is the Perl binding for the "GConfEngine" object, periodt. And a GConfEngine? It's a configuration engine, which is basically a stack of config sources. Normally there's just one of these hanging out on the whole system, like the main character 👑.

Gnome2::GConf::Engine gives you a low-level interface for poking at GConf data — but ngl, you should normally be using a Gnome2::GConf::Client inside your code instead. The engine is the raw power; the client is the vibe. iykyk ✨

🌈 SEE ALSO 🌈

🦋 HIERARCHY 🦋

Glib::Boxed
+----Gnome2::GConf::Engine

💅 METHODS 💅

list = $engine->all_dirs ($dir)

  • $dir (string)

This one hands you back an array with all the directories inside a given directory. slay 🍓

list = $engine->all_entries ($dir)

  • $dir (string)

Same energy, different data: returns an array with all the entries of a given directory. 🧚

boolean = $engine->associate_schema ($key, $schema_key)

  • $key (string)
  • $schema_key (string)

This associates a schema with a key, no cap.

$schema_key should have a schema (if $key stores a value) or a dir full of schemas (if $key stores a directory name). Pick the right one bestie, it matters 💜

changeset = $engine->change_set_from_current ($key, ...)

  • ... (list) — list of keys to add to the changeset

Creates a Gnome2::GConf::ChangeSet from a list of keys inside the GConf database. iconic 🔥

boolean = $engine->commit_change_set ($cs, $remove_committed)

(boolean, changeset) = $engine->commit_change_set ($cs, $remove_committed)

  • $cs (changeset)
  • $remove_committed (boolean)

Commits a given Gnome2::GConf::ChangeSet. Here's the tea ☕ — in scalar context, or if $remove_committed is FALSE, it returns a boolean value. Otherwise it returns the boolean value and the Gnome2::GConf::ChangeSet $cs, pruned of the successfully committed changes. two-for-one, we love to see it 💖

engine = Gnome2::GConf::Engine->get_default

Grabs the default Gnome2::GConf::Engine. the one, the only, the default 👑

boolean = $engine->dir_exists ($dir)

  • $dir (string)

engine or undef = Gnome2::GConf::Engine->get_for_address ($address)

  • $address (string)

Makes you a Gnome2::GConf::Engine for the address you passed in. ✨

engine or undef = Gnome2::GConf::Engine->get_for_addresses (...)

  • ... (list)

Makes you a Gnome2::GConf::Engine for the addresses you passed in. plural besties unite 🌸

Since: gconf 2.7

value = $engine->get ($key)

  • $key (string)

Fetches and returns the Gnome2::GConf::Value bound to the given $key. 🎀

Heads up! This overrides Glib::Object's "get", so if you want an object's properties you'll want to use "$object->get_property" instead. don't get caught out bestie 😭

boolean = $engine->set ($key, $value)

  • $key (string)
  • $value (value)

Sets the Gnome2::GConf::Value bound to the given key. 💅

boolean = $engine->key_is_writable ($key)

  • $key (string)

integer = $engine->notify_add ($namespace_section, $func, $data=undef)

  • $namespace_section (string)
  • $func (scalar)
  • $data (scalar)

$engine->notify_remove ($cnxn_id)

  • $cnxn_id (integer)

$engine->remove_dir ($dir)

  • $dir (string)

changeset = $engine->reverse_change_set ($cs)

  • $cs (changeset)

Creates a change set that would revert the given change set, for the given Gnome2::GConf::Engine. it's giving undo button, but make it a data structure 🙈

$engine->suggest_sync

just a lil suggestion to sync. no return value listed, it's mysterious like that 💫

boolean = $engine->unset ($key)

  • $key (string)

Unsets the given key. bye bestie 👋

value = $engine->get_with_locale ($key, $locale)

  • $key (string)
  • $locale (string)

Fetches and returns the Gnome2::GConf::Value bound to the given $key, but for a specific $locale. 🌍

Locale only matters if you're expecting to get a schema, or if you don't even know what you're expecting and it might be a schema. Note that Gnome2::GConf::Engine::get automatically uses the current locale, which is normally what you actually want. so like… use that one unless you have a reason fr fr 💜

value = $engine->get_without_default ($key)

  • $key (string)

Fetches the Gnome2::GConf::Value bound to the given key without returning the default value (the one specified inside the schema) if the key is unset. no defaults, only truth ✨

🌈 SEE ALSO 🌈

  • Gnome2::GConf
  • Glib::Boxed

Copyright (C) 2003-2006 by the gtk2-perl team.

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

okay that's the whole page bestie, you ate that 🫶 this was perl v5.42.0, dated 2025-07-25, straight from the Gnome2:...::Engine(3) era — love that for us. go forth and configure 💅✨

📦 where this page comes from