strings.h File Reference

main string operations interface More...

#include <types.h>
#include <memory.h>
#include <sunday_match.h>

Macros
#define	___STRINGS_H   0
#define	strcontains(str, pattern)   (strstr(str, pattern) != NULL)
	checks str contains pattern More...
#define	strcat(s1, s2)   strcat_at_heap(NULL, s1, s2)
#define	atoi(number)   ato_base(number, 10)
#define	atou(number)   atou_base(number, 16)
#define	atoh(number)   atou_base(number, 16)
#define	itoa(number)   ito_base(number, 10)
#define	itoh(number)   ito_base(number, 16)
#define	utoa(number)   uto_base(number, 10)
#define	utoh(number)   uto_base(number, 16)
#define	strdup_at_heap(heap, src)   strndup_at_heap(heap, src, strlen(src))
#define	strdup(src)   strndup_at_heap(NULL, src, strlen(src))
#define	strndup(src, n)   strndup_at_heap(NULL, src, n)

Functions
size_t	strlen (const char_t *string)
	calculates null ended string's length More...
int8_t	strcmp (const char_t *string1, const char_t *string2)
	compares two string More...
int8_t	strncmp (const char_t *string1, const char_t *string2, size_t n)
	compares two string with first n bytes More...
int8_t	strstarts (const char_t *str, const char_t *prefix)
	checks str starts with prefix More...
int8_t	strends (const char_t *str, const char_t *suffix)
	checks str ends with suffix More...
char_t *	strchr (const char_t *s, int32_t c)
	finds first occurance of char in string More...
char_t *	strrchr (const char_t *s, int32_t c)
	finds first occurance of char in string More...
char_t *	strstr (const char_t *haystack, const char_t *needle)
	finds first occurance of char in string More...
char_t *	strcat_at_heap (memory_heap_t *heap, const char_t *string1, const char_t *string2)
	concanates two string and returns new one More...
int8_t	strcpy (const char_t *source, char_t *destination)
	copies source string to destination string More...
char *	strrev (const char_t *source)
	reverse a string More...
number_t	ato_base (const char_t *source, number_t base)
	converts string into number More...
unumber_t	atou_base (const char_t *source, number_t base)
	converts string into number More...
char_t *	ito_base (number_t number, number_t base)
	convers number to its string representation More...
char_t *	uto_base (unumber_t number, number_t base)
	convers unsigned number to its string representation More...
char_t *	strndup_at_heap (memory_heap_t *heap, const char_t *src, size_t n)
	duplicate string at heap More...
char_t **	strsplit (const char_t *str, const char_t token, int64_t **lengths, int64_t *count)
	splits string into array More...
char_t *	strupper (char_t *str)
	converts string to upper case More...
char_t *	struppercopy (const char_t *str)
	duplicates string and converts it to upper case More...
char_t *	strlower (char_t *str)
	converts string to lower case More...
char_t *	strlowercopy (const char_t *str)
	duplicates string and converts it to lower case More...
char_t *	strtrim_right (char_t *str)
int8_t	str_is_upper (char_t *str)
int64_t	wchar_size (const wchar_t *str)
char_t *	wchar_to_char (wchar_t *src)
wchar_t *	char_to_wchar (const char_t *str)
int64_t	lchar_size (const lchar_t *str)
char_t *	lchar_to_char (lchar_t *src)
lchar_t *	char_to_lchar (char_t *str)
uint64_t	strhash (const char_t *input)
char_t *	sprintf (const char_t *format,...)
char_t *	vsprintf (const char_t *format, va_list args)

Detailed Description

main string operations interface

>

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

Macro Definition Documentation

___STRINGS_H

#define ___STRINGS_H   0

prevent duplicate header error macro

atoh

#define atoh

(

number

)

atou_base(number, 16)

atou_base macro for base 16

atoi

#define atoi

(

number

)

ato_base(number, 10)

ato_base macro for base 10

atou

#define atou

(

number

)

atou_base(number, 16)

atou_base macro for base 10

itoa

#define itoa

(

number

)

ito_base(number, 10)

ito_base macro for base 10

itoh

#define itoh

(

number

)

ito_base(number, 16)

ito_base macro for base 16

strcat

#define strcat	(		s1,
			s2
	)		strcat_at_heap(NULL, s1, s2)

strcat at default heap

strcontains

#define strcontains	(		str,
			pattern
	)		(strstr(str, pattern) != NULL)

checks str contains pattern

Parameters

str	string for look
pattern	to check

Returns

-1 if str does not contain pattern, else position

strdup

#define strdup

(

src

)

strndup_at_heap(NULL, src, strlen(src))

string duplicate at default heap

strdup_at_heap

#define strdup_at_heap	(		heap,
			src
	)		strndup_at_heap(heap, src, strlen(src))

string duplicate at heap

strndup

#define strndup	(		src,
			n
	)		strndup_at_heap(NULL, src, n)

string duplicate with length at default heap

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

strcpy()

int8_t strcpy	(	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 * 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