eina_hash_08.c

This example shows the the usage of eina_hash_add(), eina_hash_add_by_hash(), eina_hash_direct_add_by_hash(), eina_hash_del(), eina_hash_del_by_key_hash(), eina_hash_del_by_key(), eina_hash_del_by_data(), eina_hash_find_by_hash() and eina_hash_modify_by_hash().

This example shows the the usage of eina_hash_add(), eina_hash_add_by_hash(), eina_hash_direct_add_by_hash(), eina_hash_del(), eina_hash_del_by_key_hash(), eina_hash_del_by_key(), eina_hash_del_by_data(), eina_hash_find_by_hash() and eina_hash_modify_by_hash().

//Compile with:
//gcc -g eina_hash_08.c -o eina_hash_08 `pkg-config --cflags --libs eina`
#include <stdio.h>
#include <string.h>
#include <Eina.h>
/*
* Eina Hash - phonebook
*
* This example demonstrate the use of Eina Hash by implementing a phonebook
* that stores its contact data into the hash.
*
* It indexes the phone numbers by Contact Full Name, so it's a hash with
* string keys.
*/
struct _Phone_Entry {
const char *name; // Full name.
const char *number; // Phone number.
};
typedef struct _Phone_Entry Phone_Entry;
static Phone_Entry _start_entries[] = {
{ "Wolfgang Amadeus Mozart", "+01 23 456-78910" },
{ "Ludwig van Beethoven", "+12 34 567-89101" },
{ "Richard Georg Strauss", "+23 45 678-91012" },
{ "Heitor Villa-Lobos", "+34 56 789-10123" },
{ NULL, NULL }
}; // _start_entries
static void
_phone_entry_free_cb(void *data)
{
free(data);
}
int
main(int argc EINA_UNUSED, const char *argv[] EINA_UNUSED)
{
Eina_Hash *phone_book = NULL;
int i;
const char *entry_name = "Heitor Villa-Lobos";
int entry_size;
const char *saved_entry_name = "Alceu Valenca";
int saved_entry_size = sizeof("Alceu Valenca");
const char *phone = NULL;
Eina_Bool r;
eina_init();
phone_book = eina_hash_string_superfast_new(_phone_entry_free_cb);
// Add initial entries to our hash
for (i = 0; _start_entries[i].name != NULL; i++)
{
eina_hash_add(phone_book, _start_entries[i].name,
strdup(_start_entries[i].number));
}
// Delete entries
r = eina_hash_del(phone_book, entry_name, NULL);
printf("Hash entry successfully deleted? %d\n\n", r);
int hash = eina_hash_superfast("Ludwig van Beethoven",
sizeof("Ludwig van Beethoven"));
r = eina_hash_del_by_key_hash(phone_book, "Ludwig van Beethoven",
sizeof("Ludwig van Beethoven"), hash);
printf("Hash entry successfully deleted? %d\n\n", r);
r = eina_hash_del_by_key(phone_book, "Richard Georg Strauss");
printf("Hash entry successfully deleted? %d\n\n", r);
// add entry by hash
entry_name = "Raul_Seixas";
entry_size = sizeof("Raul Seixas");
phone = strdup("+33 33 333-33333");
hash = eina_hash_superfast(entry_name, entry_size);
eina_hash_add_by_hash(phone_book, entry_name, entry_size, hash, phone);
// don't need to free 'phone' after the next del:
r = eina_hash_del_by_data(phone_book, phone);
printf("Hash entry successfully deleted? %d\n\n", r);
// add entry by hash directly - no copy of the key will be done
hash = eina_hash_superfast(saved_entry_name, saved_entry_size);
phone = strdup("+44 44 444-44444");
eina_hash_direct_add_by_hash(phone_book, saved_entry_name,
saved_entry_size, hash, phone);
// find the added entry by its hash:
phone = eina_hash_find_by_hash(phone_book, saved_entry_name,
saved_entry_size, hash);
if (phone)
{
char *newphone = strdup("+55 55 555-55555");
phone = eina_hash_modify_by_hash(phone_book, saved_entry_name,
saved_entry_size, hash, newphone);
if (phone)
printf("changing phone to %s, old one was %s\n", newphone, phone);
else
printf("couldn't modify entry identified by %d\n", hash);
}
else
{
printf("couldn't find entry identified by %d\n", hash);
}
eina_hash_free(phone_book);
eina_shutdown();
}
Eina.h
Eina Utility library.
Eina_Hash
struct _Eina_Hash Eina_Hash
Type for a generic hash table.
Definition eina_hash.h:285
eina_hash_superfast
EINA_API int eina_hash_superfast(const char *key, int len)
Paul Hsieh (http://www.azillionmonkeys.com/qed/hash.html) hash function used by WebCore (http://webki...
Definition eina_hash.c:1330
eina_hash_del
EINA_API Eina_Bool eina_hash_del(Eina_Hash *hash, const void *key, const void *data)
Removes the entry identified by a key or a data from the given hash table.
Definition eina_hash.c:1030
eina_hash_direct_add_by_hash
EINA_API Eina_Bool eina_hash_direct_add_by_hash(Eina_Hash *hash, const void *key, int key_length, int key_hash, const void *data)
Adds an entry to a hash table by its key hash without duplicating the string key.
Definition eina_hash.c:921
eina_hash_add
EINA_API Eina_Bool eina_hash_add(Eina_Hash *hash, const void *key, const void *data)
Adds an entry to the given hash table.
Definition eina_hash.c:931
eina_hash_free
EINA_API void eina_hash_free(Eina_Hash *hash)
Frees the given hash table's resources.
Definition eina_hash.c:868
eina_hash_modify_by_hash
EINA_API void * eina_hash_modify_by_hash(Eina_Hash *hash, const void *key, int key_length, int key_hash, const void *data)
Modifies the entry pointer at the specified key and returns the previous entry.
Definition eina_hash.c:1090
eina_hash_string_superfast_new
EINA_API Eina_Hash * eina_hash_string_superfast_new(Eina_Free_Cb data_free_cb)
Creates a new hash table for use with strings.
Definition eina_hash.c:790
eina_hash_find_by_hash
EINA_API void * eina_hash_find_by_hash(const Eina_Hash *hash, const void *key, int key_length, int key_hash)
Retrieves a specific entry from the given hash table.
Definition eina_hash.c:1042
eina_hash_del_by_data
EINA_API Eina_Bool eina_hash_del_by_data(Eina_Hash *hash, const void *data)
Removes an entry from a hash table identified by its data value.
Definition eina_hash.c:986
eina_hash_add_by_hash
EINA_API Eina_Bool eina_hash_add_by_hash(Eina_Hash *hash, const void *key, int key_length, int key_hash, const void *data)
Adds an entry to the given hash table by its key hash.
Definition eina_hash.c:906
eina_hash_del_by_key
EINA_API Eina_Bool eina_hash_del_by_key(Eina_Hash *hash, const void *key)
Removes the entry identified by a key from the given hash table.
Definition eina_hash.c:977
eina_hash_del_by_key_hash
EINA_API Eina_Bool eina_hash_del_by_key_hash(Eina_Hash *hash, const void *key, int key_length, int key_hash)
Removes the entry identified by a key and a key hash from the given hash table.
Definition eina_hash.c:965
eina_shutdown
EINA_API int eina_shutdown(void)
Shuts down the Eina library.
Definition eina_main.c:379
eina_init
EINA_API int eina_init(void)
Initializes the Eina library.
Definition eina_main.c:291
Eina_Bool
unsigned char Eina_Bool
Type to mimic a boolean.
Definition eina_types.h:527
EINA_UNUSED
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition eina_types.h:339