42cursus - Libft

My own library of useful C Programming functions.

Description :

This first project as a 42/1337 student will help you consolidate your Piscine skills. You will recode a number of functions from the standard C library, as well as other utility functions that you will use throughout your curriculum.

Summary

Makefile
Libc Functions
Additional functions
Bonus

Makefile

Commande	Actions
`make`	Compile .c and create libft.a
`make clean`	Delete .o.
`make flcean`	Delete .o and libft.a.
`make re`	Execute fclean et make.

Libc Functions

memset (see man)
bzero (see man)
memcpy (see man)
memccpy (see man)
memmove (see man)
memchr (see man)
memcmp (see man)
strlen (see man)
strlcpy (see man)
strlcat (see man)
strchr (see man)
strrchr (see man)
strnstr (see man)
strncmp (see man)
atoi (see man)
isalpha (see man)
isdigit (see man)
isalnum (see man)
isascii (see man)
isprint (see man)
toupper (see man)
tolower (see man)
strdup (see man)
calloc (see man)

Additional functions

Function	ft_substr
Prototype	char ft_substr(char const s, unsigned int start, size_t len);
Parameters	#1. The string from which to create the substring #2. The start index of the substring in the string ’s’. #3. The maximum length of the substring.
Return value	The substring. NULL if the allocation fails.
External functs	malloc
Description	Allocates (with malloc(3)) and returns a substring from the string ’s’. The substring begins at index ’start’ and is of maximum size ’len’.

Function	ft_strjoin
Prototype	char ft_strjoin(char const s1, char const *s2);
Parameters	#1. The prefix string. #2. The suffix string.
Return value	The new string. NULL if the allocation fails.
External functs	malloc
Description	Allocates (with malloc(3)) and returns a new string, which is the result of the concatenation of ’s1’ and ’s2’.

Function	ft_strtrim
Prototype	char ft_strtrim(char const s1, char const *set);
Parameters	#1. The string to be trimmed. #2. The reference set of characters to trim.
Return value	The trimmed string. NULL if the allocation fails.
External functs	malloc
Description	Allocates (with malloc(3)) and returns a copy of ’s1’ with the characters specified in ’set’ removed from the beginning and the end of the string.

Function	ft_split
Prototype	char *ft_split(char const s, char c);
Parameters	#1. The string to be split. #2. The delimiter character.
Return value	The array of new strings resulting from the split. NULL if the allocation fails.
External functs	malloc, free
Description	Allocates (with malloc(3)) and returns an array of strings obtained by splitting ’s’ using the character ’c’ as a delimiter. The array must be ended by a NULL pointer.

Function	ft_itoa
Prototype	char *ft_itoa(int n);
Parameters	#1. the integer to convert.
Return value	The string representing the integer. NULL if the allocation fails.
External functs	malloc
Description	Allocates (with malloc(3)) and returns a string representing the integer received as an argument. Negative numbers must be handled.

Function	ft_strmapi
Prototype	char ft_strmapi(char const s, char (*f)(unsigned int, char));
Parameters	#1. The string on which to iterate. #2. The function to apply to each character.
Return value	The string created from the successive applications of ’f’. Returns NULL if the allocation fails.
External functs	malloc
Description	Applies the function ’f’ to each character of the string ’s’ to create a new string (with malloc(3)) resulting from successive applications of ’f’.

Function	ft_putchar_fd
Prototype	void ft_putchar_fd(char c, int fd);
Parameters	#1. The character to output. #2. The file descriptor on which to write.
Return value	None
External functs	write
Description	Outputs the character ’c’ to the given file descriptor.

Function	ft_putstr_fd
Prototype	void ft_putstr_fd(char *s, int fd);
Parameters	#1. The string to output. #2. The file descriptor on which to write.
Return value	None
External functs	write
Description	Outputs the string ’s’ to the given file descriptor.

Function	ft_putendl_fd
Prototype	void ft_putendl_fd(char *s, int fd);
Parameters	#1. The string to output. #2. The file descriptor on which to write..
Return value	None
External functs	write
Description	Outputs the string ’s’ to the given file descriptor, followed by a newline.

Function	ft_putnbr_fd
Prototype	void ft_putnbr_fd(int n, int fd);
Parameters	#1. The integer to output. #2. The file descriptor on which to write.
Return value	None
External functs	write
Description	Outputs the integer ’n’ to the given file descriptor.

Bonus

For this part we implemented a struct defining the well-known linked lists

typedef	struct	s_list
{
	void		*content;
	struct	s_list	*next;
}			t_list;

Bonus functions to implement

Bonus Function	Description
`ft_lstnew`	Creates new node allocating with `malloc`
`ft_lstadd_front`	Adds new node at the beginning of the linked list
`ft_lstsize`	Returns number of elements of linked list
`ft_lstlast`	Retrieves last node of the list
`ft_lstadd_back`	Adds new node at the end of the linked list
`ft_lstdelone`	Deletes, frees, and applies function del to content of a given node
`ft_lstclear`	Deletes a given element and every element after that
`ft_lstiter`	Applies a function to the content of every node of the linked list
`ft_lstmap`	Applies function to a copy of the list, freeing when necessary