diff --git a/Makefile b/Makefile index ee2d01b..4998630 100644 --- a/Makefile +++ b/Makefile @@ -6,7 +6,7 @@ # By: rparodi +#+ +:+ +#+ # # +#+#+#+#+#+ +#+ # # Created: 2023/11/12 11:05:05 by rparodi #+# #+# # -# Updated: 2025/12/11 16:34:31 by rparodi ### ########.fr # +# Updated: 2025/12/11 14:40:31 by rparodi ### ########.fr # # # # **************************************************************************** # @@ -23,9 +23,8 @@ RM = rm -rf # Flags CFLAGS = -Werror -Wextra -Wall -INC_DIR = includes/libft +INC_DIR = includes CPPFLAGS = $(addprefix -I, $(INC_DIR)) -MMD -MP -LDFLAGS = -L $(OBJDIRNAME) -lft # Objects OBJDIRNAME = ./build @@ -41,23 +40,45 @@ END = \033[0m # Rules # All (make all) -all: header lib footer +all: header lib $(NAME) footer lib: @make --no-print-directory -f ./libft.mk +# Bonus (make bonus) +bonus: header $(OBJ) $(LIB_OBJ) footer + @mkdir -p $(OBJDIRNAME) + @mkdir -p $(OBJDIRNAME)/$(SRCDIRNAME) + @printf '$(GREY) Be Carefull ur in $(END)$(GREEN)Debug Mode$(END)\n' + @$(CC) $(CFLAGS) $(CPPFLAGS) -D BONUS=1 -o $(NAME) $(OBJ) $(LIB_OBJ) + +# Clean (make clean) clean: @printf '$(GREY) Removing $(END)$(RED)Objects$(END)\n' @printf '$(GREY) Removing $(END)$(RED)Objects Folder$(END)\n' @$(RM) $(OBJDIRNAME) +# Clean (make fclean) fclean: clean @printf '$(GREY) Removing $(END)$(RED)Program$(END)\n' @$(RM) $(NAME) @$(RM) ./.test/ @echo "" -re: header fclean lib +# Restart (make re) +re: header fclean all + +# Dependences for all +$(NAME): $(OBJ) + @mkdir -p $(OBJDIRNAME) + @ar rc $(NAME) $(OBJ) + @ranlib $(NAME) + +# Creating the objects +$(OBJDIRNAME)/%.o: %.c + @mkdir -p $(dir $@) + @printf '$(GREY) Compiling $(END)$(GREEN)$<$(END)\n' + @$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ -c $< tmux: @tmux new-session -d -s $(PROJECT) @@ -104,11 +125,11 @@ TEST_SRCS := $(shell find test -type f -name '*.c' 2>/dev/null) TEST_BINS := $(patsubst test/%.c,.test/%,$(TEST_SRCS)) -test: fclean $(TEST_BINS) test-run footer +test: fclean $(NAME) $(TEST_BINS) test-run footer -.test/%: test/%.c lib $(LIB_NAME) +.test/%: test/%.c $(LIB_NAME) @mkdir -p $(dir $@) - @$(CC) $(CFLAGS) $(CPPFLAGS) $< $(LDFLAGS) -o $@ + @$(CC) $(CFLAGS) $(CPPFLAGS) $< -L. -lft $(LDFLAGS) -o $@ test-run: @set -e diff --git a/README.md b/README.md deleted file mode 100644 index 01f983a..0000000 --- a/README.md +++ /dev/null @@ -1,387 +0,0 @@ -# đź“š Libft - Custom C Library - -
- -*A comprehensive C library recreating standard library functions and more* - -[English](#english) | [Français](#français) - -
- ---- - -## English - -### 📖 Table of Contents -- [About](#about) -- [Features](#features) -- [Project Structure](#project-structure) -- [Installation](#installation) -- [Usage](#usage) -- [Testing](#testing) -- [Functions List](#functions-list) - -### 🎯 About - -**Libft** is a custom C library developed as part of the 42 school curriculum. This project involves recreating various standard C library functions and extending them with additional utilities. The library is organized into modular components, making it easy to maintain and extend. - -This library serves as a foundation for future C projects, providing reliable and well-tested implementations of common functions. - -### ✨ Features - -- **60+ functions** organized into logical modules -- **Modular architecture** with separate headers for each category -- **Well-documented** code with detailed function descriptions -- **Strict compilation** with `-Wall -Wextra -Werror` flags -- **Memory-safe** implementations -- **Extended functionality** beyond standard library functions - -### 📂 Project Structure - -``` -libft/ -├── char/ # Character manipulation functions -├── str/ # String manipulation functions -├── memory/ # Memory management functions -├── list/ # Linked list operations -├── math/ # Mathematical utilities -├── convert/ # Type conversion functions -├── print/ # Output functions (ft_printf, fd output) -├── gnl/ # Get Next Line implementation -├── includes/ # Header files -│ └── libft/ -└── Makefile # Build configuration -``` - -### 🚀 Installation - -#### Prerequisites -- GCC or Clang compiler -- Make - -#### Build Instructions - -1. **Clone the repository:** -```bash -git clone https://github.com/EniumRaphael/libft.git -cd libft -``` - -2. **Compile the library:** -```bash -make -``` - -This will create `libft.a`, a static library ready to use in your projects. - -3. **Clean build artifacts:** -```bash -make clean # Remove object files -make fclean # Remove object files and library -make re # Rebuild from scratch -``` - -### 💻 Usage - -#### Basic Usage Example - -1. **Include the headers in your code:** -```c -#include "libft/str.h" -#include "libft/memory.h" -#include "libft/print.h" -``` - -### 🧪 Testing - -Run the test suite: -```bash -make test -``` - -This will compile and run all tests in the `test/` directory. - -### 📋 Functions List - -#### Character Functions (`char/`) -| Function | Description | -|----------|-------------| -| `ft_isalpha` | Check if character is alphabetic | -| `ft_isdigit` | Check if character is a digit | -| `ft_isalnum` | Check if character is alphanumeric | -| `ft_isascii` | Check if character is ASCII | -| `ft_isprint` | Check if character is printable | -| `ft_isspace` | Check if character is whitespace | -| `ft_toupper` | Convert to uppercase | -| `ft_tolower` | Convert to lowercase | - -#### String Functions (`str/`) -| Function | Description | -|----------|-------------| -| `ft_strlen` | Calculate string length | -| `ft_strchr` | Locate character in string | -| `ft_strrchr` | Locate last occurrence of character | -| `ft_strcmp` | Compare two strings | -| `ft_strncmp` | Compare strings up to n characters | -| `ft_strcpy` | Copy string | -| `ft_strncpy` | Copy n characters of string | -| `ft_strdup` | Duplicate string | -| `ft_strjoin` | Concatenate two strings | -| `ft_strtrim` | Trim characters from string | -| `ft_split` | Split string by delimiter | -| `ft_substr` | Extract substring | -| `ft_strmapi` | Apply function to each character | -| `ft_striteri` | Iterate through string with function | -| `ft_strlcpy` | Size-bounded string copy | -| `ft_strlcat` | Size-bounded string concatenation | -| `ft_strnstr` | Locate substring in string | - -#### Memory Functions (`memory/`) -| Function | Description | -|----------|-------------| -| `ft_memset` | Fill memory with constant byte | -| `ft_bzero` | Zero a byte string | -| `ft_memcpy` | Copy memory area | -| `ft_memmove` | Copy memory with overlap handling | -| `ft_memchr` | Scan memory for character | -| `ft_memcmp` | Compare memory areas | -| `ft_calloc` | Allocate and zero memory | - -#### Linked List Functions (`list/`) -| Function | Description | -|----------|-------------| -| `ft_lstnew` | Create new list element | -| `ft_lstadd_front` | Add element at the beginning | -| `ft_lstadd_back` | Add element at the end | -| `ft_lstsize` | Count list elements | -| `ft_lstlast` | Get last element | -| `ft_lstdelone` | Delete one element | -| `ft_lstclear` | Delete and free all elements | -| `ft_lstiter` | Iterate through list | -| `ft_lstmap` | Map function over list | - -#### Mathematical Functions (`math/`) -| Function | Description | -|----------|-------------| -| `ft_abs` | Absolute value | -| `ft_power` | Power calculation | -| `ft_sqrt` | Square root | -| `ft_min` | Minimum of two numbers | -| `ft_max` | Maximum of two numbers | - -#### Conversion Functions (`convert/`) -| Function | Description | -|----------|-------------| -| `ft_atoi` | String to integer | -| `ft_atoll` | String to long long | -| `ft_atou` | String to unsigned | -| `ft_itoa` | Integer to string | - -#### Print Functions (`print/`) -| Function | Description | -|----------|-------------| -| `ft_printf` | Formatted output to stdout | -| `ft_dprintf` | Formatted output to file descriptor | -| `ft_putchar_fd` | Output character to fd | -| `ft_putstr_fd` | Output string to fd | -| `ft_putendl_fd` | Output string with newline to fd | -| `ft_putnbr_fd` | Output number to fd | - -#### Get Next Line (`gnl/`) -| Function | Description | -|----------|-------------| -| `get_next_line` | Read line from file descriptor | -| `get_next_line_clear` | Free GNL static memory | - ---- - -## Français - -### 📖 Table des matières -- [À propos](#à-propos) -- [Fonctionnalités](#fonctionnalités) -- [Structure du projet](#structure-du-projet) -- [Installation](#installation-1) -- [Utilisation](#utilisation-1) -- [Tests](#tests) -- [Liste des fonctions](#liste-des-fonctions) - -### 🎯 À propos - -**Libft** est une bibliothèque C personnalisée développée dans le cadre du cursus de l'école 42. Ce projet consiste à recréer diverses fonctions de la bibliothèque standard C et à les étendre avec des utilitaires supplémentaires. La bibliothèque est organisée en composants modulaires, ce qui la rend facile à maintenir et à étendre. - -Cette bibliothèque sert de fondation pour les futurs projets en C, fournissant des implémentations fiables et bien testées de fonctions courantes. - -### ✨ Fonctionnalités - -- **Plus de 60 fonctions** organisées en modules logiques -- **Architecture modulaire** avec des headers séparés pour chaque catégorie -- **Code bien documenté** avec des descriptions détaillées des fonctions -- **Compilation stricte** avec les flags `-Wall -Wextra -Werror` -- **Implémentations sûres** au niveau mémoire -- **Fonctionnalités étendues** au-delà de la bibliothèque standard - -### 📂 Structure du projet - -``` -libft/ -├── char/ # Fonctions de manipulation de caractères -├── str/ # Fonctions de manipulation de chaînes -├── memory/ # Fonctions de gestion mémoire -├── list/ # Opérations sur listes chaînées -├── math/ # Utilitaires mathématiques -├── convert/ # Fonctions de conversion de types -├── print/ # Fonctions de sortie (ft_printf, sortie fd) -├── gnl/ # Implémentation de Get Next Line -├── includes/ # Fichiers d'en-tête -│ └── libft/ -└── Makefile # Configuration de compilation -``` - -### 🚀 Installation - -#### Prérequis -- Compilateur GCC ou Clang -- Make - -#### Instructions de compilation - -1. **Cloner le dépôt :** -```bash -git clone https://github.com/EniumRaphael/libft.git -cd libft -``` - -2. **Compiler la bibliothèque :** -```bash -make -``` - -Cela créera `libft.a`, une bibliothèque statique prête à être utilisée dans vos projets. - -3. **Nettoyer les artifacts de compilation :** -```bash -make clean # Supprimer les fichiers objets -make fclean # Supprimer les fichiers objets et la bibliothèque -make re # Recompiler depuis zéro -``` - -### 💻 Utilisation - -#### Exemple d'utilisation basique - -1. **Inclure les headers dans votre code :** -```c -#include "libft/str.h" -#include "libft/memory.h" -#include "libft/print.h" -``` - -### 🧪 Tests - -Exécuter la suite de tests : -```bash -make test -``` - -Cela compilera et exécutera tous les tests du répertoire `test/`. - -### 📋 Liste des fonctions - -#### Fonctions de caractères (`char/`) -| Fonction | Description | -|----------|-------------| -| `ft_isalpha` | Vérifie si le caractère est alphabétique | -| `ft_isdigit` | Vérifie si le caractère est un chiffre | -| `ft_isalnum` | Vérifie si le caractère est alphanumérique | -| `ft_isascii` | Vérifie si le caractère est ASCII | -| `ft_isprint` | Vérifie si le caractère est imprimable | -| `ft_isspace` | Vérifie si le caractère est un espace blanc | -| `ft_toupper` | Convertit en majuscule | -| `ft_tolower` | Convertit en minuscule | - -#### Fonctions de chaînes (`str/`) -| Fonction | Description | -|----------|-------------| -| `ft_strlen` | Calcule la longueur d'une chaîne | -| `ft_strchr` | Localise un caractère dans une chaîne | -| `ft_strrchr` | Localise la dernière occurrence d'un caractère | -| `ft_strcmp` | Compare deux chaînes | -| `ft_strncmp` | Compare n caractères de chaînes | -| `ft_strcpy` | Copie une chaîne | -| `ft_strncpy` | Copie n caractères d'une chaîne | -| `ft_strdup` | Duplique une chaîne | -| `ft_strjoin` | Concatène deux chaînes | -| `ft_strtrim` | Supprime des caractères d'une chaîne | -| `ft_split` | Divise une chaîne par délimiteur | -| `ft_substr` | Extrait une sous-chaîne | -| `ft_strmapi` | Applique une fonction à chaque caractère | -| `ft_striteri` | Itère sur une chaîne avec une fonction | -| `ft_strlcpy` | Copie de chaîne avec limite de taille | -| `ft_strlcat` | Concaténation de chaîne avec limite | -| `ft_strnstr` | Localise une sous-chaîne | - -#### Fonctions mémoire (`memory/`) -| Fonction | Description | -|----------|-------------| -| `ft_memset` | Remplit la mémoire avec un octet constant | -| `ft_bzero` | Met à zéro une chaîne d'octets | -| `ft_memcpy` | Copie une zone mémoire | -| `ft_memmove` | Copie mémoire avec gestion de chevauchement | -| `ft_memchr` | Recherche un caractère en mémoire | -| `ft_memcmp` | Compare des zones mémoire | -| `ft_calloc` | Alloue et initialise à zéro | - -#### Fonctions de listes chaînées (`list/`) -| Fonction | Description | -|----------|-------------| -| `ft_lstnew` | Crée un nouvel élément de liste | -| `ft_lstadd_front` | Ajoute un élément au début | -| `ft_lstadd_back` | Ajoute un élément à la fin | -| `ft_lstsize` | Compte les éléments de la liste | -| `ft_lstlast` | Obtient le dernier élément | -| `ft_lstdelone` | Supprime un élément | -| `ft_lstclear` | Supprime et libère tous les éléments | -| `ft_lstiter` | Itère sur la liste | -| `ft_lstmap` | Applique une fonction sur la liste | - -#### Fonctions mathématiques (`math/`) -| Fonction | Description | -|----------|-------------| -| `ft_abs` | Valeur absolue | -| `ft_power` | Calcul de puissance | -| `ft_sqrt` | Racine carrée | -| `ft_min` | Minimum de deux nombres | -| `ft_max` | Maximum de deux nombres | - -#### Fonctions de conversion (`convert/`) -| Fonction | Description | -|----------|-------------| -| `ft_atoi` | Chaîne vers entier | -| `ft_atoll` | Chaîne vers long long | -| `ft_atou` | Chaîne vers unsigned | -| `ft_itoa` | Entier vers chaîne | - -#### Fonctions d'affichage (`print/`) -| Fonction | Description | -|----------|-------------| -| `ft_printf` | Sortie formatée vers stdout | -| `ft_dprintf` | Sortie formatée vers descripteur de fichier | -| `ft_putchar_fd` | Affiche un caractère sur fd | -| `ft_putstr_fd` | Affiche une chaîne sur fd | -| `ft_putendl_fd` | Affiche une chaîne avec retour ligne sur fd | -| `ft_putnbr_fd` | Affiche un nombre sur fd | - -#### Get Next Line (`gnl/`) -| Fonction | Description | -|----------|-------------| -| `get_next_line` | Lit une ligne depuis un descripteur de fichier | -| `get_next_line_clear` | Libère la mémoire statique de GNL | - ---- - -
- -**Made with ❤️ at 42 School** - -
diff --git a/gnl/gnl.mk b/gnl/gnl.mk index b15321e..821833f 100644 --- a/gnl/gnl.mk +++ b/gnl/gnl.mk @@ -6,7 +6,7 @@ # By: rparodi +#+ +:+ +#+ # # +#+#+#+#+#+ +#+ # # Created: 2023/11/12 11:05:05 by rparodi #+# #+# # -# Updated: 2025/12/11 16:51:41 by rparodi ### ########.fr # +# Updated: 2025/11/26 17:14:21 by rparodi ### ########.fr # # # # **************************************************************************** # @@ -17,7 +17,6 @@ MODULE_NAME = gnl NAME = lib$(MODULE_NAME).a SRC = get_next_line_utils.c \ - get_next_line_free.c \ get_next_line.c CC ?= clang diff --git a/libft.mk b/libft.mk index 3840763..8e825f9 100644 --- a/libft.mk +++ b/libft.mk @@ -6,7 +6,7 @@ # By: rparodi +#+ +:+ +#+ # # +#+#+#+#+#+ +#+ # # Created: 2023/11/12 11:05:05 by rparodi #+# #+# # -# Updated: 2025/12/11 16:53:11 by rparodi ### ########.fr # +# Updated: 2025/12/11 14:40:08 by rparodi ### ########.fr # # # # **************************************************************************** # @@ -18,7 +18,7 @@ RM = rm -rf CFLAGS = -Werror -Wextra -Wall -INC_DIR = includes/libft +INC_DIR = includes/ CPPFLAGS = $(addprefix -I, $(INC_DIR)) -MMD -MP OBJDIRNAME ?= ./build @@ -27,14 +27,14 @@ MAKE += --no-print-directory export CC CFLAGS CPPFLAGS INC_DIR OBJDIRNAME MAKE RM -SUB_MAKEFILE = char/char.mk \ - convert/convert.mk \ - gnl/gnl.mk \ - list/list.mk \ - math/math.mk \ +SUB_MAKEFILE = gnl/gnl.mk \ + char/char.mk \ memory/memory.mk \ print/print.mk \ - str/str.mk + math/math.mk \ + list/list.mk \ + str/str.mk \ + convert/convert.mk GREEN = \033[32m GREY = \033[0;90m @@ -47,14 +47,6 @@ all: @for PART in $(SUB_MAKEFILE); do \ $(MAKE) -f $$PART all; \ done - @( printf 'CREATE $(OBJDIRNAME)/$(NAME)\n'; \ - for f in build/*.a; do \ - [ -e "$$f" ] || continue; \ - [ "$$(basename "$$f")" = "$(NAME)" ] && continue; \ - printf 'ADDLIB %s\n' "$$f"; \ - done; \ - printf 'SAVE\nEND\n' ) | ar -M - @printf '$(GREY) Linking $(END)$(GOLD)$(NAME)$(END)\n' clean: @for PART in $(SUB_MAKEFILE); do \ @@ -72,6 +64,8 @@ re: fclean all $(NAME): $(OBJ) @mkdir -p $(OBJDIRNAME) + @ar rc $(OBJDIRNAME)/$(NAME) $(OBJ) + @ranlib -M $(OBJDIRNAME)/$(NAME) .PHONY: all bonus clean fclean re