dpetrosy / 42-Libft

42 School's first project: libft. The goal is to create our own C library for use in future projects.

Libft Project

42 Yerevan Libft
For further information about 42cursus and its projects, please refer to 42cursus repo.

📜 About Project · 📑 Functions List · 👨‍💻 Usage

---

📜 About Project

The aim of this project is to code a C library regrouping usual functions that you'll be allowed to use in all your other projects.

For detailed information, refer to the subject of this project.

🚀 TLDR: this project consists of coding basic C functions (see below), which are then
compiled into a library for use in other projects of the cursus.

Note

Because of 42 School norm requirements:

• Each function can't have more than 25 lines of code.
• All variables are declared and aligned at the top of each function.
• Project should be created just with allowed functions otherwise it's cheating.

📑 Functions List

Functions from <ctype.h> library

• ft_isascii - test for ASCII character.
• ft_isalnum - alphanumeric character test.
• ft_isalpha - alphabetic character test.
• ft_isdigit - decimal-digit character test.
• ft_isprint - printing character test (space character inclusive).
• ft_tolower - upper case to lower case letter conversion.
• ft_toupper - lower case to upper case letter conversion.

Functions from <stdlib.h> library

• ft_atoi - convert ASCII string to integer.
• ft_calloc - memory allocation.

Functions from <strings.h> library

• ft_bzero - write zeroes to a byte string.
• ft_memset - write a byte to a byte string.
• ft_memchr - locate byte in byte string.
• ft_memcmp - compare byte string.
• ft_memmove - copy byte string.
• ft_memcpy - copy memory area.

Functions from <string.h> library

• ft_strlen - find length of string.
• ft_strchr - locate character in string (first occurrence).
• ft_strrchr - locate character in string (last occurence).
• ft_strnstr - locate a substring in a string (size-bounded).
• ft_strncmp - compare strings (size-bounded).
• ft_strdup - save a copy of a string (with malloc).
• ft_strlcpy - size-bounded string copying.
• ft_strlcat - size-bounded string concatenation.

Non-standard functions

• ft_putchar_fd - output a character to given file.
• ft_putstr_fd - output string to given file.
• ft_putendl_fd - output string to given file with newline.
• ft_putnbr_fd - output integer to given file.
• ft_itoa - convert integer to ASCII string.
• ft_substr - extract substring from string.
• ft_strtrim - trim beginning and end of string with the specified characters.
• ft_strjoin - concatenate two strings into a new string (with malloc).
• ft_split - split string, with specified character as delimiter, into an array of strings.
• ft_strmapi - create new string from modifying string with specified function.
• ft_striteri - applies the specific function on each character of the string.

Linked list functions

• ft_lstnew - create new list.
• ft_lstsize - count elements of a list.
• ft_lstlast - find last element of list.
• ft_lstadd_back - add new element at end of list.
• ft_lstadd_front - add new element at beginning of list.
• ft_lstdelone - delete element from list.
• ft_lstclear - delete sequence of elements of list from a starting point.
• ft_lstiter - apply function to content of all list's elements.
• ft_lstmap - apply function to content of all list's elements into new list.

👨‍💻 Usage

Requirements

The library is written in C language and thus needs the gcc compiler and some standard C libraries to run.

Instructions

1. Compiling the library

To compile the library, run:

$ cd path/to/libft && make

2. Using it in your code

To use the library functions in your code, simply include its header:

#include "libft.h"

and, when compiling your code, add the required flags:

-lft -L path/to/libft.a -I path/to/libft.h