This project has been created as part of the 42 curriculum by kjurkows

libft

Description

libft is a substitute library for libc & libbsd.

All functions are prefixed by ft_.

It implements most used libc/libbsd functions in a safe way, while also implementing additional functions used in 42 curriculum, those include advanced string operations as well as linked lists.

See Detailed description for list of implemented functions.

Instructions

Compilation

To compile libft just use make

make targets

all : compile and link everything (default)
libft.a : link libft
clean : clean objects (remove *.o files)
fclean : full clean (remove everything compiled)
re : recompile and relink everything

Testing

The library is tested with a custom test suite, which can be found here.

Resources

• man
• doxygen manual
• C language section on cppreference
• GCC git repository

AI Usage

Google search AI mode & AI summaries

AI mode was used for searching through documentations and references.

AI summaries were used to summarize extensive documentations/references (for ease of reading).

GitHub Copilot (via VS Code)

AI inline suggestions were used for repetitive tasks, such as:

• Writing doxygen docs in libft.h
• Creating Makefile

Tools

Main IDE used was VS Code with a few extensions:

• 42 ft count line, 42 Header and 42 Norminette Highlighter were used as aid for La Norme compliance
• C/C++, C/C++ DevTools and Makefile Tools were used for IntelliSense

norminette was used to check La Norme compliance

make, gcc & ar are used for compilation

Detailed description

libft consists of 3 parts:

1. libc functions
2. Additional functions
3. linked list

Each function is implemented in a separate file and compliant with The Norme

See below for a list of implemented functions and their brief descriptions.
For detailed descriptions look inside libf.h or specific files.

Part 1 - libc functions

Functions from libc that are most commonly needed during 42 curriculum

character checking functions

• ft_isalpha - check for an alphabetic character
• ft_isdigit - check for a digit
• ft_isalnum - check for an alphanumeric character
• ft_isascii - check is the character in ASCII range
• ft_isprint - check is the character printable (non-control)

character converting functions

• ft_tolower - convert character to uppercase
• ft_toupper - convert character to lowercase

string manipulation functions

• ft_strlen - calculate string length
• ft_strlcpy¹ - safely copy a string
• ft_strlcat¹ - safely concatenate two strings
• ft_strchr - locate character in a string
• ft_strrchr - locate character in a string (reverse)
• ft_strncmp - compare two strings
• ft_strnstr¹ - locate a substring in a string
• ft_strdup - duplicate a string

memory manipulating functions

• ft_memset - fill memory area with constant byte
• ft_bzero - fill memory area with zero
• ft_memcpy - copy memory area
• ft_memmove - move memory area
• ft_memchr - scan memory for a byte
• ft_memcmp - compare memory areas
• ft_calloc - allocate dynamic memory for an array

string converting functions

• ft_atoi - convert string to a number

Part 2 - Additional functions

string creation function

• ft_substr - create a substring from a string
• ft_strjoin - join two strings into a new one
• ft_strtrim - trim a string
• ft_split - split a string
• ft_itoa - convert number to string
• ft_strmapi - map a string
• ft_striteri - iterate over a string

output writing functions

• ft_putchar_fd - write a character
• ft_putstr_fd - write a string
• ft_putendl_fd - write a string ending with new line
• ft_putnbr_fd - write a number

Part - linked list

type definition

Linked list node is implemented as such:

/// linked list node
typedef struct s_list
{
	void			*content; ///< data contained in the node
	struct s_list	*next; ///< pointer to the next node or `0` (last node)
}	t_list;

functions

• ft_lstnew - create a new list node
• ft_lstadd_front - add node to front of list
• ft_lstsize - count nodes in a list
• ft_lstlast - get last node of a list
• ft_lstadd_back - add node to the back of a list
• ft_lstdelone - delete a node
• ft_lstclear - delete a list
• ft_lstiter - iterate over a list
• ft_lstmap - map a list

Footnotes

1. Functions are from libbsd not libc ↩ ↩² ↩³