libStringEXT

string.h extended ~ Developed by Christian Visintin

Current Version: 1.0.0 - 2018/11/24

Introduction

StringEXT is a library which extends string.h introducing a lot of functions missing in standard string C library.

Build

It is possible to build libStringext with autotools

./autogen.sh
./configure
make
make install

Functions

indexOf

Returns the index of needle in haystack. Returns -1 if needle is not found.

int indexOf(char* haystack, char* needle);

lastIndexOf

Returns the index of the last occurrence of needle in haystack.
Returns -1 if needle is not found.

int lastIndexOf(char* haystack, char* needle);

count

Count occurrences of needle in haystack.
Returns the occurrences of needle in haystack.

int count(char* haystack, char* needle);

concat

Concatenate to destination toConcat.
Destination will be reallocated.
The only difference with strcat is the fact that destination gets reallocated inside the function.
Returns a pointer to destination.

char* concat(char* destination, char* toConcat);

endsWith

Tests whether haystacks ends with needle.
Returns 0 if haystack ends with needle.

int endsWith(char* haystack, char* needle);

startsWith

Tests whether haystacks starts with needle.
Returns 0 if haystack starts with needle.

int startsWith(char* haystack, char* needle);

replace

Replace the first occurrence of oldChar with newChar in str
str will be reallocated if needed.
Be aware that oldChar and newChar can be a string too
Returns a pointer to str.

char* replace(char* str, char* oldChar, char* newChar);

replaceAll

Replace all the occurrences of oldChar with newChar in str
str will be reallocated if needed.
Be aware that oldChar and newChar can be a string too
Returns a pointer to str.

char* replaceAll(char* str, char* oldChar, char* newChar);

substr

Returns a new string that is a substring of str. The new string is made up of the character of str from beginIndex for count characters.

char* substr(char* str, int beginIndex, int count);

substring

Returns a new string that is a substring of str. The new string is made up of the character of str between beginIndex and endIndex.

char* substring(char* str, int beginIndex, int endIndex);

toLowerCase

Converts all of the characters in this String to lower case using the rules of the default locale.
Returns a pointer to str

char* toLowerCase(char* str);

toUpperCase

Converts all of the characters in this String to upper case using the rules of the default locale.
Returns a pointer to str

char* toUpperCase(char* str);

reverse

Reverse the content of a string.
Returns a pointer to str.

char* reverse(char* str);

isPalindrome

Check if the provided string is a Palindrome.
Returns 0 if the provided string is a palindrome

int isPalindrome(char* str);

strsplit

Split the provided string into tokens.
Delimiter is passed as argument.
Returns a char array of pointers, each position contains a token.

//NOTE: to access token => *(tokens + index)
//NOTE: to free token array => free(*(tokens + index)); for each index, and eventually free(tokens);
//Yes, we all know about strtok; feel free not to use this function indeed
char** strsplit(int* tokenCount, char* haystack, char* delimiter);

strjoin

Joins a series of char tokens into a single string, delimiting them with a value passed to the function.
Returns a pointer to the joined string.

char* strjoin(char** tokens, int tokenCount, char* delimiter);

ltrim

Removes leading whitespaces omitted from the provided string.
String will be reallocated to preserve space if needed.
Returns a pointer to the reallocated string

char* ltrim(char* str);

rtrim

Removes trailing whitespaces omitted from the provided string.
String will be reallocated to preserve space if needed.
Returns a pointer to the reallocated string

char* rtrim(char* str);

trim

Removes leading and trailing whitespaces omitted from the provided string.
String will be reallocated to preserve space if needed.
Returns a pointer to the reallocated string

char* trim(char* str);

ljust

Justify the text to the left of its box, which size is defined as a parameter (width).
Empty spaces are filled with the character passed to the function.
If the length of the string passed to the function is greater or equal to width, the function will just return a pointer to the passed string.
Returns a pointer to the reallocated string.

char* ljust(char* str, int width, char fillChar);

cjust

Justify the text to the center of its box, which size is defined as a parameter (width).
Empty spaces are filled with the character passed to the function.
If the length of the string passed to the function is greater or equal to width, the function will just return a pointer to the passed string.
If the difference between the width provided and the length of the string is an odd number, left justify is preferred.
Returns a pointer to the reallocated string.

char* cjust(char* str, int width, char fillChar);

rjust

Justify the text to the right of its box, which size is defined as a parameter (width).
Empty spaces are filled with the character passed to the function.
If the length of the string passed to the function is greater or equal to width, the function will just return a pointer to the passed string.
Returns a pointer to the reallocated string.

char* rjust(char* str, int width, char fillChar);

asciiToHex

Given a string representing a series of hex values in ASCII, it returns real hex values (e.g. if "01ABEF" is provided, the function will return in dest [0x01, 0xAB, 0xEF])
If a character of str is not an hex representation it will be conveted to 0.
str must be NULL terminated.
Returns the destination length

int asciiToHex(uint8_t* dest, char* str);

hexToAscii

Converts a hex buffer to its ASCII representation (e.g. if [0x01, 0xAB, 0xEF] is provided as argument, the function will return "01ABEF").

char* hexToAscii(char* dest, uint8_t* bytes, size_t len);

Contributions

Everybody can contribute to this library, indeed any improvement will be appreciated.

---

License

MIT License

Copyright (c) 2018 Christian Visintin

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.