Trees       Indices       Help   
Module gwy :: Class Container
[hide private]
[frames] | no frames]

Class Container

source code

Instance Methods [hide private]
 
__init__()
Creates a new Container.		 source code
 
get_n_items()
Gets the number of items in a container.		 source code
 
value_type(key)
Returns the type of value in container identified by key.		 source code
 
contains(key)
Returns True if container contains a value identified by key.		 source code
 
get_value(key)
Returns the value in container identified by key.		 source code
 
UNIMPLEMENTED_gis_value(key, value)
Get-if-set a generic value from a container.		 source code
 
remove(key)
Removes a value identified by key from a container.		 source code
 
remove_by_prefix(prefix)
Removes a values whose key start with prefix from container container.		 source code
 
transfer(dest, source_prefix, dest_prefix, force)
Copies a items from one place in container to another place.		 source code
 
rename(key, newkey, force)
Makes a value in container identified by key to be identified by newkey.		 source code
 
UNIMPLEMENTED_foreach(prefix, function, user_data)
Calls function on each container item whose identifier starts with prefix.		 source code
 
keys()
Gets all quark keys of a container.		 source code
 
keys_by_name()
Gets all string keys of a container.		 source code
 
set_boolean(key, value)
Stores a boolean into container, identified by key.		 source code
 
get_boolean(key)
Returns the boolean in container identified by key.		 source code
 
UNIMPLEMENTED_gis_boolean(key, value)
Get-if-set a boolean from a container.		 source code
 
set_uchar(key, value)
Stores an unsigned character into container, identified by key.		 source code
 
get_uchar(key)
Returns the unsigned character in container identified by key.		 source code
 
UNIMPLEMENTED_gis_uchar(key, value)
Get-if-set an unsigned char from a container.		 source code
 
set_int32(key, value)
Stores a 32bit integer into container, identified by key.		 source code
 
get_int32(key)
Returns the 32bit integer in container identified by key.		 source code
 
UNIMPLEMENTED_gis_int32(key, value)
Get-if-set a 32bit integer from a container.		 source code
 
set_enum(key, value)
Stores an enum into container, identified by key.		 source code
 
get_enum(key)
Returns the enum in container identified by key.		 source code
 
UNIMPLEMENTED_gis_enum(key, value)
Get-if-set an enum from a container.		 source code
 
set_int64(key, value)
Stores a 64bit integer into container, identified by key.		 source code
 
get_int64(key)
Returns the 64bit integer in container identified by key.		 source code
 
UNIMPLEMENTED_gis_int64(key, value)
Get-if-set a 64bit integer from a container.		 source code
 
set_double(key, value)
Stores a double into container, identified by key.		 source code
 
get_double(key)
Returns the double in container identified by key.		 source code
 
UNIMPLEMENTED_gis_double(key, value)
Get-if-set a double from a container.		 source code
 
get_string(key)
Returns the string in container identified by key.		 source code
 
UNIMPLEMENTED_gis_string(key, value)
Get-if-set a string from a container.		 source code
 
set_object(key, value)
Stores an object into container, identified by key.		 source code
 
gis_object(key, value)
Get-if-set an object from a container.		 source code
 
UNIMPLEMENTED_serialize_to_text()
Creates a text representation of container contents.		 source code
 
contains_by_name(name)
Expands to True if container c contains a value identified by name n.		 source code
 
remove_by_name(name)
Removes a value identified by name n from container c.		 source code
 
rename_by_name(name, new_name, delete)
Makes a value in container c identified by name n to be identified by new name nn.		 source code
 
set_boolean_by_name(name, value)
Stores a boolean into container c, identified by name n.		 source code
 
set_double_by_name(name, value)
Stores a double into container c, identified by name n.		 source code
 
set_enum_by_name(name, value)
Stores an enum into container c, identified by name n.		 source code
 
set_int32_by_name(name, value)
Stores a 32bit integer into container c, identified by name n.		 source code
 
set_int64_by_name(name, value)
Stores a 64bit integer into container c, identified by name n.		 source code
 
set_object_by_name(name, value)
Stores an object into container c, identified by name n.		 source code
 
set_uchar_by_name(name, value)
Stores an unsigned character into container c, identified by name n.		 source code
 
set_string_by_name(name, value)
Stores a string into container c, identified by name n.		 source code
 
get_boolean_by_name(name)
Gets the boolean in container c identified by name n.		 source code
 
get_double_by_name(name)
Gets the double in container c identified by name n.		 source code
 
get_enum_by_name(name)
Gets the enum in container c identified by name n.		 source code
 
get_int32_by_name(name)
Gets the 32bit integer in container c identified by name n.		 source code
 
get_int64_by_name(name)
Gets the 64bit integer in container c identified by name n.		 source code
 
get_object_by_name(name)
Gets the object in container c identified by name n.		 source code
 
get_uchar_by_name(name)
Gets the unsigned character in container c identified by name n.		 source code
 
get_value_by_name(name)
Gets the value in container c identified by name n.		 source code
 
get_string_by_name(name)
Gets the string in container c identified by name n.		 source code
 
get_object(key)
Get object of given key from container.		 source code
 
set_string(key, value)
Set string for key to given value		 source code
Method Details [hide private]

__init__()
(Constructor)

source code 

Creates a new Container.

Returns:
The container, as a GObject.

get_n_items()

source code 

Gets the number of items in a container.

Returns:
The number of items.

value_type(key)

source code 

Returns the type of value in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The value type as GType; 0 if there is no such value.

contains(key)

source code 

Returns True if container contains a value identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
Whether container contains something identified by key.

get_value(key)

source code 

Returns the value in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The value as a GValue.

UNIMPLEMENTED_gis_value(key, value)

source code 

Get-if-set a generic value from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to a GValue to update. If item does not exist, it is left untouched. (GValue*)
Returns:
True if v was actually updated, False when there is no such value in the container.

remove(key)

source code 

Removes a value identified by key from a container.

Parameters:
  • key - A GQuark key. (int)
Returns:
True if there was such a value and was removed.

remove_by_prefix(prefix)

source code 

Removes a values whose key start with prefix from container container.

prefix can be NULL, all values are then removed.

Parameters:
  • prefix - A nul-terminated id prefix. (string)
Returns:
The number of values removed.

transfer(dest, source_prefix, dest_prefix, force)

source code 

Copies a items from one place in container to another place.

The copies are shallow, objects are not physically duplicated, only referenced in dest.

Parameters:
  • dest - Destination container. It may be the same container as source, but source_prefix and dest_prefix may not overlap then. (Container)
  • source_prefix - Prefix in source to take values from. (string)
  • dest_prefix - Prefix in dest to put values to. (string)
  • force - True to replace existing values in dest. (bool)
Returns:
The number of actually transferred items.

rename(key, newkey, force)

source code 

Makes a value in container identified by key to be identified by newkey.

When force is True existing value at newkey is removed from container. When it's False, an existing value newkey inhibits the rename and False is returned.

Parameters:
  • key - The current key. (int)
  • newkey - A new key for the value. (int)
  • force - Whether to replace existing value at newkey. (bool)
Returns:
Whether the rename succeeded.

UNIMPLEMENTED_foreach(prefix, function, user_data)

source code 

Calls function on each container item whose identifier starts with prefix.

The function is called function(GQuark key, GValue *value, user_data).

Parameters:
  • prefix - A nul-terminated id prefix. (string)
  • function - The function called on the items. (GHFunc)
  • user_data - The user data passed to function. (gpointer)
Returns:
The number of items function was called on.

keys()

source code 

Gets all quark keys of a container.

Since: 2.7

Returns:
A newly allocated array with quark keys of all container items, in no particular order. The number of items can be obtained with Container.get_n_items(). If there are no items, NULL is returned.

keys_by_name()

source code 

Gets all string keys of a container.

Since: 2.7

Returns:
A newly allocated array with string keys of all container items, in no particular order. The number of items can be obtained with Container.get_n_items(). If there are no items, NULL is returned. Unlike the array the strings are owned by GLib and must not be freed.

set_boolean(key, value)

source code 

Stores a boolean into container, identified by key.

Parameters:
  • key - A GQuark key. (int)
  • value - A boolean. (bool)

get_boolean(key)

source code 

Returns the boolean in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The boolean as gboolean.

UNIMPLEMENTED_gis_boolean(key, value)

source code 

Get-if-set a boolean from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the boolean to update. (gboolean*)
Returns:
True if v was actually updated, False when there is no such boolean in the container.

set_uchar(key, value)

source code 

Stores an unsigned character into container, identified by key.

Parameters:
  • key - A GQuark key. (int)
  • value - An unsigned character. (guchar)

get_uchar(key)

source code 

Returns the unsigned character in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The character as guchar.

UNIMPLEMENTED_gis_uchar(key, value)

source code 

Get-if-set an unsigned char from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the unsigned char to update. (guchar*)
Returns:
True if v was actually updated, False when there is no such unsigned char in the container.

set_int32(key, value)

source code 

Stores a 32bit integer into container, identified by key.

Parameters:
  • key - A GQuark key. (int)
  • value - A 32bit integer. (int)

get_int32(key)

source code 

Returns the 32bit integer in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The integer as guint32.

UNIMPLEMENTED_gis_int32(key, value)

source code 

Get-if-set a 32bit integer from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the 32bit integer to update. (int)
Returns:
True if v was actually updated, False when there is no such 32bit integer in the container.

set_enum(key, value)

source code 

Stores an enum into container, identified by key.

Note enums are treated as 32bit integers.

Parameters:
  • key - A GQuark key. (int)
  • value - An enum integer. (int)

get_enum(key)

source code 

Returns the enum in container identified by key.

Note enums are treated as 32bit integers.

Parameters:
  • key - A GQuark key. (int)
Returns:
The enum as gint.

UNIMPLEMENTED_gis_enum(key, value)

source code 

Get-if-set an enum from a container.

Note enums are treated as 32bit integers.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the enum to update. (int)
Returns:
True if v was actually updated, False when there is no such enum in the container.

set_int64(key, value)

source code 

Stores a 64bit integer into container, identified by key.

Parameters:
  • key - A GQuark key. (int)
  • value - A 64bit integer. (gint64)

get_int64(key)

source code 

Returns the 64bit integer in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The 64bit integer as guint64.

UNIMPLEMENTED_gis_int64(key, value)

source code 

Get-if-set a 64bit integer from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the 64bit integer to update. (int)
Returns:
True if v was actually updated, False when there is no such 64bit integer in the container.

set_double(key, value)

source code 

Stores a double into container, identified by key.

Parameters:
  • key - A GQuark key. (int)
  • value - A double. (float)

get_double(key)

source code 

Returns the double in container identified by key.

Parameters:
  • key - A GQuark key. (int)
Returns:
The double as gdouble.

UNIMPLEMENTED_gis_double(key, value)

source code 

Get-if-set a double from a container.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the double to update. (float)
Returns:
True if v was actually updated, False when there is no such double in the container.

get_string(key)

source code 

Returns the string in container identified by key.

The returned string must be treated as constant and never freed or modified.

Parameters:
  • key - A GQuark key. (int)
Returns:
The string.

UNIMPLEMENTED_gis_string(key, value)

source code 

Get-if-set a string from a container.

The string eventually stored in value must be treated as constant and never freed or modified.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the string pointer to update. (const-guchar**)
Returns:
True if v was actually updated, False when there is no such string in the container.

set_object(key, value)

source code 

Stores an object into container, identified by key.

The container claims ownership on the object, i.e. its reference count is incremented.

The object must implement Serializable interface to allow serialization of the container.

Parameters:
  • key - A GQuark key. (int)
  • value - An object to store into container. (gpointer)

gis_object(key, value)

source code 

Get-if-set an object from a container.

The object eventually stored in value doesn't have its reference count increased, use g_object_ref() if you want to access it even when container may cease to exist.

Parameters:
  • key - A GQuark key. (int)
  • value - Pointer to the object pointer to update. (gpointer)
Returns:
True if v was actually updated, False when there is no such object in the container.

UNIMPLEMENTED_serialize_to_text()

source code 

Creates a text representation of container contents.

Note only simple data types are supported as serialization of compound objects is not controllable.

Returns:
A pointer array, each item containing string with one container item representation (name, type, value). The array is sorted by name.

contains_by_name(name)

source code 

Expands to True if container c contains a value identified by name n.

Parameters:
  • n - A nul-terminated name (id).

remove_by_name(name)

source code 

Removes a value identified by name n from container c.

Expands to True if there was such a value and was removed.

Parameters:
  • n - A nul-terminated name (id).

rename_by_name(name, new_name, delete)

source code 

Makes a value in container c identified by name n to be identified by new name nn.

See Container.rename() for details.

Parameters:
  • n - A nul-terminated name (id).
  • nn - A nul-terminated name (id).
  • f - Whether to delete existing value at newkey.

set_boolean_by_name(name, value)

source code 

Stores a boolean into container c, identified by name n.

Parameters:
  • n - A nul-terminated name (id).
  • v - A boolean.

set_double_by_name(name, value)

source code 

Stores a double into container c, identified by name n.

Parameters:
  • n - A nul-terminated name (id).
  • v - A double integer.

set_enum_by_name(name, value)

source code 

Stores an enum into container c, identified by name n.

Note enums are treated as 32bit integers.

Parameters:
  • n - A nul-terminated name (id).
  • v - An enum.

set_int32_by_name(name, value)

source code 

Stores a 32bit integer into container c, identified by name n.

Parameters:
  • n - A nul-terminated name (id).
  • v - A 32bit integer.

set_int64_by_name(name, value)

source code 

Stores a 64bit integer into container c, identified by name n.

Parameters:
  • n - A nul-terminated name (id).
  • v - A 64bit integer.

set_object_by_name(name, value)

source code 

Stores an object into container c, identified by name n.

See Container.set_object() for details.

Parameters:
  • n - A nul-terminated name (id).
  • v - An object to store into container.

set_uchar_by_name(name, value)

source code 

Stores an unsigned character into container c, identified by name n.

Parameters:
  • n - A nul-terminated name (id).
  • v - An unsigned character.

set_string_by_name(name, value)

source code 

Stores a string into container c, identified by name n.

The container takes ownership of the string, so it can't be used on static strings, use g_strdup() to duplicate them first.

Parameters:
  • n - A nul-terminated name (id).
  • v - A nul-terminated string.

get_boolean_by_name(name)

source code 

Gets the boolean in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_double_by_name(name)

source code 

Gets the double in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_enum_by_name(name)

source code 

Gets the enum in container c identified by name n.

Note enums are treated as 32bit integers.

Parameters:
  • n - A nul-terminated name (id).

get_int32_by_name(name)

source code 

Gets the 32bit integer in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_int64_by_name(name)

source code 

Gets the 64bit integer in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_object_by_name(name)

source code 

Gets the object in container c identified by name n.

The returned object doesn't have its reference count increased, use g_object_ref() if you want to access it even when container may cease to exist.

Parameters:
  • n - A nul-terminated name (id).

get_uchar_by_name(name)

source code 

Gets the unsigned character in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_value_by_name(name)

source code 

Gets the value in container c identified by name n.

Parameters:
  • n - A nul-terminated name (id).

get_string_by_name(name)

source code 

Gets the string in container c identified by name n.

The returned string must be treated as constant and never freed or modified.

Parameters:
  • n - A nul-terminated name (id).

get_object(key)

source code 

Get object of given key from container.

Returns:
object of given key

set_string(key, value)

source code 

Set string for key to given value

Parameters:
  • value - new string (some_type)

   Trees       Indices       Help   
Generated by Epydoc 3.0.1 on Sat Feb 11 04:00:59 2012 http://epydoc.sourceforge.net