Struct
RBExtDBKey
Description [src]
struct RBExtDBKey {
/* No available fields */
}
An external metadata key consists of one or more required fields (such as the album name for album art lookups), zero or more optional fields (such as the artist name), and zero or more informational fields (such as the musicbrainz album ID).
Functions
rb_ext_db_key_create_lookup
Creates a new metadata lookup key with a single field.
Use rb_ext_db_key_add_field
to add more.
rb_ext_db_key_create_storage
Creates a new metadata storage key with a single field.
Use rb_ext_db_key_add_field
to add more.
Instance methods
rb_ext_db_key_field_matches
Checks whether a specified field in key
matches a value.
This can be used to match keys against other types of data.
To match keys against each other, use rb_ext_db_key_matches
.
rb_ext_db_key_get_field_names
Returns a NULL-terminated array containing the names of the fields present in the key.
rb_ext_db_key_get_info_names
Returns a NULL-terminated array containing the names of the info fields * present in the key.
rb_ext_db_key_is_null_match
Checks whether store
has a null value in an optional
field of lookup
, which means it’s not the most specific
possible match for a query.
rb_ext_db_key_lookups
Generates the set of possible lookup keys for key
and
passes them to callback
in order. If the callback returns
FALSE
, processing will stop.
rb_ext_db_key_matches
Checks whether the fields specified in a
match b
.
For keys to match, they must have the same set of required fields,
and the values for all must match. Optional fields must have the
same values if present in both. Informational fields are ignored.
rb_ext_db_key_to_store_key
Generates the storage key for key
. This is the value that should
be used to store an item identified by this key in the store.
The storage key includes all optional fields, so keys passed to
this function should be constructed using only the optional fields
that were used to locate the item. The caller must free the data
pointer inside data
.