\hypertarget{eina_hash_01_8c-example}{\section{eina\+\_\+hash\+\_\+01.\+c}
}

\begin{DoxyCodeInclude}
\textcolor{comment}{//Compile with:}
\textcolor{comment}{//gcc -g eina\_hash\_01.c -o eina\_hash\_01 `pkg-config --cflags --libs eina`}

\textcolor{preprocessor}{#include <stdio.h>}
\textcolor{preprocessor}{#include <string.h>}
\textcolor{preprocessor}{#include <\hyperlink{Eina_8h}{Eina.h}>}

\textcolor{comment}{/*}
\textcolor{comment}{ * Eina Hash - phonebook}
\textcolor{comment}{ *}
\textcolor{comment}{ * This example demonstrate the use of Eina Hash by implementing a phonebook}
\textcolor{comment}{ * that stores its contact data into the hash.}
\textcolor{comment}{ *}
\textcolor{comment}{ * It indexes the phone numbers by Contact Full Name, so it's a hash with}
\textcolor{comment}{ * string keys.}
\textcolor{comment}{ */}

\textcolor{keyword}{struct }\_Phone\_Entry \{
     \textcolor{keyword}{const} \textcolor{keywordtype}{char} *name; \textcolor{comment}{// Full name.}
     \textcolor{keyword}{const} \textcolor{keywordtype}{char} *number; \textcolor{comment}{// Phone number.}
\};

\textcolor{keyword}{typedef} \textcolor{keyword}{struct }\_Phone\_Entry Phone\_Entry;

\textcolor{keyword}{static} Phone\_Entry \_start\_entries[] = \{
       \{ \textcolor{stringliteral}{"Wolfgang Amadeus Mozart"}, \textcolor{stringliteral}{"+01 23 456-78910"} \},
       \{ \textcolor{stringliteral}{"Ludwig van Beethoven"}, \textcolor{stringliteral}{"+12 34 567-89101"} \},
       \{ \textcolor{stringliteral}{"Richard Georg Strauss"}, \textcolor{stringliteral}{"+23 45 678-91012"} \},
       \{ \textcolor{stringliteral}{"Heitor Villa-Lobos"}, \textcolor{stringliteral}{"+34 56 789-10123"} \},
       \{ NULL, NULL \}
\}; \textcolor{comment}{// \_start\_entries}

\textcolor{keyword}{static} \textcolor{keywordtype}{void}
\_phone\_entry\_free\_cb(\textcolor{keywordtype}{void} *data)
\{
   free(data);
\}

\textcolor{keyword}{static} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool}
\_phone\_book\_foreach\_cb(\textcolor{keyword}{const} \hyperlink{group__Eina__Hash__Group_ga9a89d7d3ee260d3a60572ebf651b07e0}{Eina\_Hash} *phone\_book \hyperlink{group__Eina__Types__Group_ga82d751be730f849719ca292f9558be87}{EINA\_UNUSED}, \textcolor{keyword}{const} \textcolor{keywordtype}{void} *key,
                       \textcolor{keywordtype}{void} *data, \textcolor{keywordtype}{void} *fdata EINA\_UNUSED)
\{
   \textcolor{keyword}{const} \textcolor{keywordtype}{char} *name = key;
   \textcolor{keyword}{const} \textcolor{keywordtype}{char} *number = data;
   printf(\textcolor{stringliteral}{"%s: %s\(\backslash\)n"}, name, number);

   \textcolor{comment}{// Return EINA\_FALSE to stop this callback from being called}
   \textcolor{keywordflow}{return} \hyperlink{group__Eina__Types__Group_ga05c12dacc8b4058994df842b41be85fc}{EINA\_TRUE};
\}

\textcolor{keywordtype}{int}
main(\textcolor{keywordtype}{int} argc, \textcolor{keyword}{const} \textcolor{keywordtype}{char} *argv[])
\{
   (void) argc;
   (void) argv;
   \hyperlink{group__Eina__Hash__Group_ga9a89d7d3ee260d3a60572ebf651b07e0}{Eina\_Hash} *phone\_book = NULL;
   \textcolor{keywordtype}{int} i;
   \textcolor{keyword}{const} \textcolor{keywordtype}{char} *entry\_name = \textcolor{stringliteral}{"Heitor Villa-Lobos"};
   \textcolor{keywordtype}{char} *phone = NULL;
   \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\_Bool} r;
   \hyperlink{struct__Eina__Iterator}{Eina\_Iterator} *it;
   \textcolor{keywordtype}{void} *data;

   \hyperlink{group__Eina__Main__Group_gabf448ada5bc81a07342b66c6f818ee5e}{eina\_init}();

   phone\_book = \hyperlink{group__Eina__Hash__Group_gad7203e20b1496445cb819c7862171c87}{eina\_hash\_string\_superfast\_new}(\_phone\_entry\_free\_cb);

   \textcolor{comment}{// Add initial entries to our hash}
   \textcolor{keywordflow}{for} (i = 0; \_start\_entries[i].name != NULL; i++)
     \{
        \hyperlink{group__Eina__Hash__Group_gafe3bb7c1f5616b4e158f60322e133260}{eina\_hash\_add}(phone\_book, \_start\_entries[i].name,
                      strdup(\_start\_entries[i].number));
     \}

   \textcolor{comment}{// Look for a specific entry and get its phone number}
   phone = \hyperlink{group__Eina__Hash__Group_ga45703d00fbabffc86e6836ffe98a4c92}{eina\_hash\_find}(phone\_book, entry\_name);
   \textcolor{keywordflow}{if} (phone)
     \{
        printf(\textcolor{stringliteral}{"Printing entry.\(\backslash\)n"});
        printf(\textcolor{stringliteral}{"Name: %s\(\backslash\)n"}, entry\_name);
        printf(\textcolor{stringliteral}{"Number: %s\(\backslash\)n\(\backslash\)n"}, phone);
     \}

   \textcolor{comment}{// Delete this entry}
   r = \hyperlink{group__Eina__Hash__Group_gad8a9ac3c61ead249a6927a12e9de871a}{eina\_hash\_del}(phone\_book, entry\_name, NULL);
   printf(\textcolor{stringliteral}{"Hash entry successfully deleted? %d\(\backslash\)n\(\backslash\)n"}, r);

   \textcolor{comment}{// Modify the pointer data of an entry and free the old one}
   phone = \hyperlink{group__Eina__Hash__Group_gaabf2f2af1d93f969591f2c5b7378c543}{eina\_hash\_modify}(phone\_book, \textcolor{stringliteral}{"Richard Georg Strauss"},
                            strdup(\textcolor{stringliteral}{"+23 45 111-11111"}));
   free(phone);

   \textcolor{comment}{// Modify or add an entry to the hash with eina\_hash\_set}
   \textcolor{comment}{// Let's first add a new entry}
   phone = \hyperlink{group__Eina__Hash__Group_ga53fd5f171289d63c5d8532bb28434cb3}{eina\_hash\_set}(phone\_book, \textcolor{stringliteral}{"Raul Seixas"},
                         strdup(\textcolor{stringliteral}{"+55 01 234-56789"}));
   \textcolor{keywordflow}{if} (!phone)
     \{
        printf(\textcolor{stringliteral}{"No previous phone found for Raul Seixas. "});
        printf(\textcolor{stringliteral}{"Creating new entry.\(\backslash\)n"});
     \}
   \textcolor{keywordflow}{else}
     \{
        printf(\textcolor{stringliteral}{"Old phone for Raul Seixas was %s\(\backslash\)n"}, phone);
        free(phone);
     \}

   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Now change the phone number}
   phone = \hyperlink{group__Eina__Hash__Group_ga53fd5f171289d63c5d8532bb28434cb3}{eina\_hash\_set}(phone\_book, \textcolor{stringliteral}{"Raul Seixas"},
                         strdup(\textcolor{stringliteral}{"+55 02 222-22222"}));
   \textcolor{keywordflow}{if} (phone)
     \{
        printf(\textcolor{stringliteral}{"Changing phone for Raul Seixas to +55 02 222-22222. "});
        printf(\textcolor{stringliteral}{"Old phone was %s\(\backslash\)n"}, phone);
        free(phone);
     \}
   \textcolor{keywordflow}{else}
     \{
        printf(\textcolor{stringliteral}{"No previous phone found for Raul Seixas. "});
        printf(\textcolor{stringliteral}{"Creating new entry.\(\backslash\)n"});
     \}

   \textcolor{comment}{// There are many ways to iterate over our Phone book.}
   \textcolor{comment}{// First, iterate showing the names and associated numbers.}
   printf(\textcolor{stringliteral}{"List of phones:\(\backslash\)n"});
   \hyperlink{group__Eina__Hash__Group_ga2c23f8425d3afcc61827ab67b46d7190}{eina\_hash\_foreach}(phone\_book, \_phone\_book\_foreach\_cb, NULL);
   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Now iterate using an iterator}
   printf(\textcolor{stringliteral}{"List of phones:\(\backslash\)n"});
   it = \hyperlink{group__Eina__Hash__Group_gaf0e7e38ec02c4bcfca3c3c4dd13c6af9}{eina\_hash\_iterator\_tuple\_new}(phone\_book);
   \textcolor{keywordflow}{while} (\hyperlink{group__Eina__Iterator__Group_ga83346e93c32dbebc8fd66e4f278140c5}{eina\_iterator\_next}(it, &data))
     \{
        \hyperlink{struct__Eina__Hash__Tuple}{Eina\_Hash\_Tuple} *t = data;
        \textcolor{keyword}{const} \textcolor{keywordtype}{char} *name = t->\hyperlink{struct__Eina__Hash__Tuple_ab8fe9b0df3353720473ecdd5907ca002}{key};
        \textcolor{keyword}{const} \textcolor{keywordtype}{char} *number = t->\hyperlink{struct__Eina__Hash__Tuple_a04b95450a8af76c6bd6e9f93be5efd1e}{data};
        printf(\textcolor{stringliteral}{"%s: %s\(\backslash\)n"}, name, number);
     \}
   \hyperlink{group__Eina__Iterator__Group_gaf9261991a4b05dc63e3401278a3281f8}{eina\_iterator\_free}(it); \textcolor{comment}{// Always free the iterator after its use}
   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Just iterate over the keys (names)}
   printf(\textcolor{stringliteral}{"List of names in the phone book:\(\backslash\)n"});
   it = \hyperlink{group__Eina__Hash__Group_ga1a090384b1c057daec8e19c6a1ea2c0d}{eina\_hash\_iterator\_key\_new}(phone\_book);
   \textcolor{keywordflow}{while} (\hyperlink{group__Eina__Iterator__Group_ga83346e93c32dbebc8fd66e4f278140c5}{eina\_iterator\_next}(it, &data))
     \{
        \textcolor{keyword}{const} \textcolor{keywordtype}{char} *name = data;
        printf(\textcolor{stringliteral}{"%s\(\backslash\)n"}, name);
     \}
   \hyperlink{group__Eina__Iterator__Group_gaf9261991a4b05dc63e3401278a3281f8}{eina\_iterator\_free}(it);
   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Just iterate over the data (numbers)}
   printf(\textcolor{stringliteral}{"List of numbers in the phone book:\(\backslash\)n"});
   it = \hyperlink{group__Eina__Hash__Group_ga5191350d6044d93b6518a957f12f5ac3}{eina\_hash\_iterator\_data\_new}(phone\_book);
   \textcolor{keywordflow}{while} (\hyperlink{group__Eina__Iterator__Group_ga83346e93c32dbebc8fd66e4f278140c5}{eina\_iterator\_next}(it, &data))
     \{
        \textcolor{keyword}{const} \textcolor{keywordtype}{char} *number = data;
        printf(\textcolor{stringliteral}{"%s\(\backslash\)n"}, number);
     \}
   \hyperlink{group__Eina__Iterator__Group_gaf9261991a4b05dc63e3401278a3281f8}{eina\_iterator\_free}(it);
   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Check how many items are in the phone book}
   printf(\textcolor{stringliteral}{"There are %d items in the hash.\(\backslash\)n\(\backslash\)n"},
          \hyperlink{group__Eina__Hash__Group_ga9289542f6724083eab306e5bb3ab10b0}{eina\_hash\_population}(phone\_book));

   \textcolor{comment}{// Change the name (key) on an entry}
   \hyperlink{group__Eina__Hash__Group_gaa390160f31c235d91947281244e77628}{eina\_hash\_move}(phone\_book, \textcolor{stringliteral}{"Raul Seixas"}, \textcolor{stringliteral}{"Alceu Valenca"});
   printf(\textcolor{stringliteral}{"List of phones after change:\(\backslash\)n"});
   \hyperlink{group__Eina__Hash__Group_ga2c23f8425d3afcc61827ab67b46d7190}{eina\_hash\_foreach}(phone\_book, \_phone\_book\_foreach\_cb, NULL);
   printf(\textcolor{stringliteral}{"\(\backslash\)n"});

   \textcolor{comment}{// Empty the phone book, but don't destroy it}
   \hyperlink{group__Eina__Hash__Group_gabe2ba51e5dbf6fd5f60628b8e8f00eaa}{eina\_hash\_free\_buckets}(phone\_book);
   printf(\textcolor{stringliteral}{"There are %d items in the hash.\(\backslash\)n\(\backslash\)n"},
          \hyperlink{group__Eina__Hash__Group_ga9289542f6724083eab306e5bb3ab10b0}{eina\_hash\_population}(phone\_book));

   \textcolor{comment}{// Phone book could still be used, but we are freeing it since we are}
   \textcolor{comment}{// done for now}
   \hyperlink{group__Eina__Hash__Group_gadb6acb720ce267cc1cd4f51893539f59}{eina\_hash\_free}(phone\_book);

   \hyperlink{group__Eina__Main__Group_ga6741fcaba116e31e96ce14dcfa03f568}{eina\_shutdown}();
\}
\end{DoxyCodeInclude}
 