Like all examples we start by including Eina:

Here we declare some variables and initialize eina:

We start the substantive part of the example by showing how to make a part of a string shared and how to get the length of a shared string:

There are many ways of creating shared strings including an equivalent to sprintf:

An equivalent to snprintf:

But the simplest way of creating a shared string is through eina_stringshare_add():

Sometimes you already have a pointer to a shared string and want to use it, so to make sure the provider of the pointer won't free it while you're using it you can increase the shared string's ref count:

Whenever you have a pointer to a shared string and would like to change it's value you should use eina_stringshare_replace():

Warning:

Don't use eina_stringshare_del() followed by eina_share_common_add(), under some circunstances you might end up deleting a shared string some other piece of code is using.

We created str but haven't deleted it yet, and while we called eina_stringshare_del() on str2, we created it and then increased the ref count so it's still alive:

You can see the full source code here.