sc/string

Length prefixed string

Length prefixed C strings, length is at the start of the allocated memory

e.g :
-----------------------------------------------
| 0 | 0 | 0 | 4 | 'T' | 'E' | 'S' | 'T' | '\0'|
-----------------------------------------------
                ^
              return
User can keep pointer to first character, so it's like C style strings with
additional functionality.

Pros

• User gets a null terminated char*, so it still works with c style string
  functions, e.g printf, strcmp.
• Faster length access and copy.
• Provides a few more functions to make easier create/append/trim/substring
  operations.

Performance

• 4 bytes fixed overhead per string.
• Faster length access and copy.
• When you create/set/append a string, new memory is allocated. If you are
  modifying strings a lot, consider using buffer-like implementation for that if
  performance is critical for your use-case. I modify strings rarely but access
  a lot (copy/move etc.), so ease of use and read/copy/move performance was
  primary goal for this implementation.

#include "sc_str.h"

#include <stdio.h>


int main(int argc, char *argv[])
{
    char* s1;

    s1 = sc_str_create("**hello**");
    printf("%s \n", s1); // prints **hello**

    sc_str_append_fmt(&s1, " %s", "world--");
    printf("%s \n", s1); // prints **hello** world--

    sc_str_trim(&s1, "*-");
    printf("%s \n", s1); // prints hello** world

    sc_str_substring(&s1, 8, 13);
    printf("%s \n", s1); // world

    sc_str_destroy(s1);

    return 0;
}