Strings library. More...

#include <strings.h>
#include <memory.h>
#include <utils.h>
#include <buffer.h>

Functions
	MODULE ("turnstone.lib.strings")

size_t	strlen (const char_t *string)
	calculates null ended string's length

int8_t	strcmp (const char_t string1, const char_t string2)
	compares two string

int8_t	strcopy (const char_t source, char_t destination)
	copies source string to destination string

char_t *	strrev (const char_t *source)
	reverse a string

number_t	ato_base (const char_t *source, number_t base)
	converts string into number

unumber_t	atou_base (const char_t *source, number_t base)
	converts string into number

char_t *	ito_base (number_t number, number_t base)
	convers number to its string representation

char_t *	uto_base (unumber_t number, number_t base)
	convers unsigned number to its string representation

char_t *	strndup_at_heap (memory_heap_t heap, const char_t src, size_t l)
	duplicate string at heap

int8_t	strstarts (const char_t str, const char_t prefix)
	checks str starts with prefix

int8_t	strends (const char_t str, const char_t suffix)
	checks str ends with suffix

char_t *	strchr (const char_t *s, int32_t c)
	finds first occurance of char in string

char_t *	strrchr (const char_t *s, int32_t c)
	finds first occurance of char in string

char_t *	strstr (const char_t haystack, const char_t needle)
	finds first occurance of char in string

char_t *	strcat_at_heap (memory_heap_t heap, const char_t string1, const char_t *string2)
	concanates two string and returns new one

int8_t	strncmp (const char_t string1, const char_t string2, size_t n)
	compares two string with first n bytes

char_t **	strsplit (const char_t str, const char_t token, int64_t lengths, int64_t count)
	splits string into array

char_t *	strupper (char_t *str)
	converts string to upper case

char_t *	struppercopy (const char_t *str)
	duplicates string and converts it to upper case

char_t *	strlower (char_t *str)
	converts string to lower case

char_t *	strlowercopy (const char_t *str)
	duplicates string and converts it to lower case

int64_t	wchar_size (const char16_t *str)

char_t *	char16_to_char (char16_t *src)

char16_t *	char_to_wchar (const char_t *str)

int64_t	lchar_size (const char32_t *str)

char_t *	char32_to_char (char32_t *src)

char32_t *	char_to_lchar (char_t *str)

char_t *	strtrim_right (char_t *str)

int8_t	str_is_upper (char_t *str)

uint64_t	strhash (const char_t *input)

char_t *	strprintf (const char_t *format,...)

char_t *	vstrprintf (const char_t *format, va_list args)

Detailed Description

Strings library.

This work is licensed under TURNSTONE OS Public License. Please read and understand latest version of Licence.

Function Documentation

◆ ato_base()

number_t ato_base	(	const char_t *	source,
		number_t	base )

converts string into number

Parameters

[in]	source	string represents number in base
[in]	base	base of number inside string

Returns: number

◆ atou_base()

unumber_t atou_base	(	const char_t *	source,
		number_t	base )

converts string into number

Parameters

[in]	source	string represents number in base
[in]	base	base of number inside string

Returns: number

◆ ito_base()

char_t * ito_base	(	number_t	number,
		number_t	base )

convers number to its string representation

Parameters

[in]	number	number to be converted string
[in]	base	base value of conversion

Returns: string represents number

return value should be freed or memory leak will be happened

◆ strcat_at_heap()

char_t * strcat_at_heap	(	memory_heap_t *	heap,
		const char_t *	string1,
		const char_t *	string2 )

concanates two string and returns new one

Parameters

string1	first string
string2	second string

Returns: new string, needs freeing or memory leak

◆ strchr()

char_t * strchr	(	const char_t *	s,
		int32_t	c )

finds first occurance of char in string

Parameters

s	string for look
c	char to find

Returns: pointer to first occurance of char in string

◆ strcmp()

int8_t strcmp	(	const char_t *	string1,
		const char_t *	string2 )

compares two string

Parameters

string1	first string
string2	second string

Returns: <0 if string1>string2, 0 string1=string2, >0 string1<string2

◆ strcopy()

int8_t strcopy	(	const char_t *	source,
		char_t *	destination )

copies source string to destination string

Parameters

source	source string
destination	destination string

Returns: 0 on success

NULL will not be copied. destination should be equal or greater then source. destination should have space for NULL.

◆ strends()

int8_t strends	(	const char_t *	str,
		const char_t *	suffix )

checks str ends with suffix

Parameters

str	string for look
suffix	to compare

Returns: 0 if str ends with suffix, else -1

◆ strlen()

size_t strlen ( const char_t * string )

calculates null ended string's length

Parameters

[in] string string to calculate length

Returns: length

◆ strlower()

char_t * strlower ( char_t * str )

converts string to lower case

Parameters

[in] str string to lower case

Returns: input string

◆ strlowercopy()

char_t * strlowercopy ( const char_t * str )

duplicates string and converts it to lower case

Parameters

[in] str string to lower case

Returns: new lowercased string

◆ strncmp()

int8_t strncmp	(	const char_t *	string1,
		const char_t *	string2,
		size_t	n )

compares two string with first n bytes

Parameters

string1	first string
string2	second string
n	first n bytes

Returns: <0 if string1>string2, 0 string1=string2, >0 string1<string2

◆ strndup_at_heap()

char_t * strndup_at_heap	(	memory_heap_t *	heap,
		const char_t *	src,
		size_t	n )

duplicate string at heap

Parameters

[in]	heap	destination heap
[in]	src	source string
[in]	length	of destination string

Returns: duplicate at heap

◆ strrchr()

char_t * strrchr	(	const char_t *	s,
		int32_t	c )

finds first occurance of char in string

Parameters

s	string for look
c	char to find

Returns: pointer to first occurance of char in string

◆ strrev()

char_t * strrev ( const char_t * source )

reverse a string

Parameters

[in] source string to be reversed

Returns: reversed string

allocates new space, hence return value needs be freed, else leak will be happened

◆ strsplit()

char_t ** strsplit	(	const char_t *	str,
		const char_t	token,
		int64_t **	lengths,
		int64_t *	count )

splits string into array

Parameters

[in]	str	string to tokinize
[in]	token	split char
[out]	lengths	array of each splitted part's length
[out]	count	splitted array length

Returns: array of starts of each part

◆ strstarts()

int8_t strstarts	(	const char_t *	str,
		const char_t *	prefix )

checks str starts with prefix

Parameters

str	string for look
prefix	to compare

Returns: 0 if str starts with prefix, else -1

◆ strstr()

char_t * strstr	(	const char_t *	haystack,
		const char_t *	needle )

finds first occurance of char in string

Parameters

s	string for look
c	char to find

Returns: pointer to first occurance of char in string

◆ strupper()

char_t * strupper ( char_t * str )

converts string to upper case

Parameters

[in] str string to upper case

Returns: input string

◆ struppercopy()

char_t * struppercopy ( const char_t * str )

duplicates string and converts it to upper case

Parameters

[in] str string to upper case

Returns: new uppercased string

◆ uto_base()

char_t * uto_base	(	unumber_t	number,
		number_t	base )

convers unsigned number to its string representation

Parameters

[in]	number	unsigned number to be converted string
[in]	base	base value of conversion

Returns: string represents number

return value should be freed or memory leak will be happened

Functions

Detailed Description

Function Documentation

◆ ato_base()

◆ atou_base()

◆ ito_base()

◆ strcat_at_heap()

◆ strchr()

◆ strcmp()

◆ strcopy()

◆ strends()

◆ strlen()

◆ strlower()

◆ strlowercopy()

◆ strncmp()

◆ strndup_at_heap()

◆ strrchr()

◆ strrev()

◆ strsplit()

◆ strstarts()

◆ strstr()

◆ strupper()

◆ struppercopy()

◆ uto_base()