Eina String example

Whenever using eina we need to include it:

#include <stdio.h>
#include <Eina.h>

In our main function we declare (and initialize) some variables and initialize eina:

int main(int argc EINA_UNUSED, char **argv EINA_UNUSED)
{
   char *names = "Calvin;Leoben;D'anna;Simon;Doral;Six;Daniel;Sharon";
   char *str;
   char *tmp;
   char *prologue;
   char *part1 = "The Cylons were created by man. They evolved. They rebelled.";
   char *part2 = "There are many copies. And they have a plan.";
   char **arr;
   int i;
   char *time_arr;
   time_t curr_time;
   struct tm *info;

   eina_init();

It's frequently necessary to split a string into its constituent parts, eina_str_split() make's it easy to do so:

   arr = eina_str_split(names, ";", 0);
   for (i = 0; arr[i]; i++)
     printf("%s\n", arr[i]);

Another common need is to make a string uppercase or lowercase, so let's create a string and make it uppercase and then make it lowercase again:

   free(arr[0]);
   free(arr);

   str = malloc(sizeof(char) * 4);
   strcpy(str, "bsd");

   eina_str_toupper((char **)&str);
   printf("%s\n", str);
   eina_str_tolower(&str);
   printf("%s\n", str);

Next we use eina to check if our names string starts or ends with some values:

   if (eina_str_has_prefix(names, "Calvin"))
      printf("Starts with 'Calvin'\n");
   if (eina_str_has_suffix(names, "sharon"))
      printf("Ends with 'sharon'\n");
   if (eina_str_has_extension(names, "sharon"))
      printf("Has extension 'sharon'\n");

When strings will be used in a terminal (or a number of other places) it necessary to escape certain characters that appear in them:

   tmp = eina_str_escape("They'll start going ripe on us pretty soon.");
   printf("%s\n", tmp);

Much as we previously split a string we will now join two strings:

   free(tmp);

   prologue = malloc(sizeof(char) * 106);
   eina_str_join_len(prologue, 106, ' ', part1, strlen(part1), part2, strlen(part2));
   printf("%s\n", prologue);

With strlcpy() we can copy what portion of the prologue fits in str and be sure that it's still NULL terminated:

   eina_strlcpy(str, prologue, 4);
   printf("%s\n", str);

Since we are done with prologue and str we should free them:

   free(prologue);
   free(str);

Finally we see strlcat in action:

   str = malloc(sizeof(char) * 14);
   sprintf(str, "%s", "cylons+");
   eina_strlcat(str, "humans", 14);
   printf("%s\n", str);

And then shut eina down and exit:

   free(str);

   curr_time = time(NULL);
   info = localtime(&curr_time);
   time_arr = eina_strftime("%d/%m/%Y", info);
   printf("Today's Date: %s\n", time_arr);
   free(time_arr);

   eina_shutdown();

   return 0;
}