README.md

   1 # libstring [![Codacy Badge](https://app.codacy.com/project/badge/Grade/265e20e3a7b6416d85609612e600d16f)](https://www.codacy.com/gh/carmesim/libstring?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=carmesim/libstring&amp;utm_campaign=Badge_Grade) [![CodeFactor](https://www.codefactor.io/repository/github/carmesim/libstring/badge)](https://www.codefactor.io/repository/github/carmesim/libstring) [![TODOs](https://img.shields.io/endpoint?url=https://api.tickgit.com/badge?repo=github.com/carmesim/libstring)](https://www.tickgit.com/browse?repo=github.com/carmesim/libstring) [![Build Status](https://travis-ci.org/carmesim/libstring.svg?branch=master)](https://travis-ci.org/carmesim/libstring) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
   2
   3   **Early work in progress. ⚠️*
   4
   5 `libstring` aims to be a highly portable, [Valgrind](https://www.valgrind.org/)-passing, single-header library that brings better support for strings and string manipulation to ANSI C. This library does **not** depend on `string.h` or `strings.h`, using only `stdio.h`, `stdlib.h` and `stdbool.h` (although this one will likely be removed soon).
   6
   7 ## Currently implemented public functions
   8
   9 ```C
  10 cstr_t * string_init(const char * origin);                 // Initializes a new cstr_t *.
  11 void  string_free_all (void);                              // Frees all heap allocations made by libstring.
  12 cstr_t * string_to_lower_case(cstr_t * origin);            // Returns a new cstr_t * with the contents of origin lower-cased
  13 cstr_t * string_to_upper_case(cstr_t * origin);            // Returns a new cstr_t * with the contents of origin upper-cased
  14 cstr_t * string_concat(cstr_t * str1, const char * str2);  // Returns a new cstr_t * with the concatenation of str1 and str2
  15 size_t string_concat_to(cstr_t * str1, const char * str2); // Concatenates str1 and str2 to str1.
  16 bool string_contains(cstr_t * str1, const char * str2);    // Returns true if str2 is a substring of str1.
  17 size_t string_update(cstr_t * str, const char * new_val);  // Updates the value of str. Increases its memory reservation if needed.
  18 bool string_swap(cstr_t * str1, cstr_t * str2);            // Swaps the contents of str1 and str2.
  19 bool string_reserve(cstr_t *str, size_t capacity);         // Increases str's memory reservation
  20 size_t string_replace_char(cstr_t *str, char before, char after); // Replaces all instances of a char with another.
  21 ```
  22
  23 The other functions defined in `libstring.c` are internal and not accessible.