Your very first own library

124/100

Cette documentation contient des informations détaillées sur chaque fonction implémentée dans la bibliothèque libft, avec leurs prototypes, leur fonctionnement, les paramètres acceptés et les valeurs de retour.

• ft_abs
• ft_atoi
• ft_bzero
• ft_isalpha
• ft_isascii
• ft_isdigit
• ft_islower
• ft_isprint
• ft_isupper
• ft_isalnum
• ft_itoa
• ft_lstadd
• ft_lstdelone
• ft_lstiter
• ft_lstadd_back
• ft_lstadd_front
• ft_lstclear
• ft_lstlast
• ft_lstsize
• ft_lstnew
• ft_lstmap
• ft_calloc
• ft_memalloc
• ft_memccpy
• ft_memchr
• ft_memcmp
• ft_memcpy
• ft_memdel
• ft_memmove
• ft_memset
• ft_putchar_fd
• ft_putchar
• ft_putendl_fd
• ft_putendl
• ft_putnbr_fd
• ft_putnbr
• ft_putstr_fd
• ft_putstr
• ft_strchr
• ft_strclr
• ft_strcmp
• ft_strcpy
• ft_strdel
• ft_strdup
• ft_strequ
• ft_strnequ
• ft_striter
• ft_striteri
• ft_strjoin
• ft_strmap
• ft_strmapi
• ft_strlen
• ft_strlcat
• ft_strlcpy
• ft_strncmp
• ft_strcat
• ft_strncat
• ft_strncpy
• ft_strnstr
• ft_strnew
• ft_strrchr
• ft_strsplit
• ft_split
• ft_strsub
• ft_strtrim
• ft_substr
• ft_tolower
• ft_toupper

int ft_abs(int c);

Renvoie la valeur absolue d'un entier donné. Si l'entier est négatif, il sera converti en sa valeur positive.

• c : L'entier dont on veut obtenir la valeur absolue.

Renvoie la valeur absolue de c.

int ft_atoi(const char *str);

Convertit une chaîne de caractères en entier. La conversion s'arrête dès qu'un caractère non numérique est rencontré.

• str : La chaîne de caractères à convertir.

Renvoie l'entier correspondant à la chaîne. Si aucun entier valide n'est trouvé, la fonction renverra 0.

void ft_bzero(void *s, size_t n);

Met à zéro (remplit avec des octets de valeur 0) les n premiers octets de la zone mémoire pointée par s.

• s : Le pointeur vers la zone mémoire à remplir.
• n : Le nombre d'octets à mettre à zéro.

Aucune. La fonction agit directement sur la mémoire pointée par s.

int ft_isalpha(int c);

Vérifie si le caractère donné est une lettre de l'alphabet (a-z ou A-Z).

• c : Le caractère à vérifier.

Renvoie 1 si c est une lettre alphabétique, 0 sinon.

int ft_isascii(int c);

Vérifie si le caractère donné appartient à la table ASCII (valeur entre 0 et 127).

• c : Le caractère à vérifier.

Renvoie 1 si c est un caractère ASCII valide, 0 sinon.

int ft_isdigit(int c);

Vérifie si le caractère donné est un chiffre (0-9).

• c : Le caractère à vérifier.

Renvoie 1 si c est un chiffre, 0 sinon.

int ft_islower(int c);

Vérifie si le caractère donné est une lettre minuscule (a-z).

• c : Le caractère à vérifier.

Renvoie 1 si c est une lettre minuscule, 0 sinon.

int ft_isprint(int c);

Vérifie si le caractère donné est imprimable, y compris les espaces.

• c : Le caractère à vérifier.

Renvoie 1 si c est un caractère imprimable, 0 sinon.

int ft_isupper(int c);

Vérifie si le caractère donné est une lettre majuscule (A-Z).

• c : Le caractère à vérifier.

Renvoie 1 si c est une lettre majuscule, 0 sinon.

int ft_isalnum(int c);

Vérifie si le caractère donné est une lettre (majuscule ou minuscule) ou un chiffre (0-9).

• c : Le caractère à vérifier.

Renvoie 1 si c est une lettre ou un chiffre, 0 sinon.

char *ft_itoa(int n);

Convertit un entier donné en une chaîne de caractères (représentation en base 10).

• n : L'entier à convertir.

Renvoie une chaîne de caractères représentant l'entier n.

Très bien, voici la suite complète du README pour toutes les fonctions fournies :

void ft_lstadd(t_list **alst, t_list *new);

Ajoute un nouvel élément new au début de la liste pointée par alst.

• alst : Un pointeur vers le premier élément de la liste.
• new : Le nouvel élément à ajouter.

Aucune.

void ft_lstdelone(t_list *lst, void (*del)(void *));

Libère la mémoire de l'élément lst en utilisant la fonction del, puis libère lst.

• lst : L'élément à supprimer.
• del : Fonction pour libérer le contenu de l'élément.

Aucune.

void ft_lstiter(t_list *lst, void (*f)(void *));

Applique la fonction f à chaque élément de la liste.

• lst : Le premier élément de la liste.
• f : La fonction à appliquer sur chaque élément.

Aucune.

void ft_lstadd_back(t_list **alst, t_list *new);

Ajoute un nouvel élément new à la fin de la liste pointée par alst.

• alst : Un pointeur vers le premier élément de la liste.
• new : Le nouvel élément à ajouter.

Aucune.

void ft_lstadd_front(t_list **alst, t_list *new);

Ajoute un nouvel élément new au début de la liste pointée par alst.

• alst : Un pointeur vers le premier élément de la liste.
• new : Le nouvel élément à ajouter.

Aucune.

void ft_lstclear(t_list **lst, void (*del)(void *));

Supprime et libère la mémoire de tous les éléments de la liste, en utilisant la fonction del pour libérer le contenu de chaque élément, puis libère la liste elle-même.

• lst : Un pointeur vers le premier élément de la liste.
• del : La fonction pour libérer le contenu de chaque élément.

Aucune.

t_list *ft_lstlast(t_list *lst);

Renvoie le dernier élément de la liste.

• lst : Le premier élément de la liste.

Renvoie le dernier élément de la liste, ou NULL si la liste est vide.

int ft_lstsize(t_list *lst);

Compte le nombre d'éléments dans la liste.

• lst : Le premier élément de la liste.

Renvoie le nombre d'éléments dans la liste.

t_list *ft_lstnew(void const *content);

Crée un nouvel élément de liste avec le contenu donné.

• content : Le contenu à ajouter dans le nouvel élément.

Renvoie le nouvel élément créé, ou NULL en cas d'échec de la création.

t_list *ft_lstmap(t_list *lst, void *(*f)(void *), void (*del)(void *));

Crée une nouvelle liste résultant de l'application de la fonction f à chaque élément de la liste, en utilisant del en cas d'échec pour nettoyer la mémoire.

• lst : Le premier élément de la liste d'origine.
• f : La fonction à appliquer à chaque élément.
• del : La fonction pour libérer le contenu en cas d'erreur.

Renvoie la nouvelle liste, ou NULL en cas d'échec.

void *ft_calloc(size_t count, size_t size);

Alloue la mémoire pour un tableau de count éléments de size octets chacun, et initialise tous les octets à 0.

• count : Le nombre d'éléments à allouer.
• size : La taille de chaque élément.

Renvoie un pointeur vers la mémoire allouée, ou NULL en cas d'échec.

void *ft_memalloc(size_t size);

Alloue et initialise à 0 une zone de mémoire de size octets.

• size : La taille de la zone mémoire à allouer.

Renvoie un pointeur vers la mémoire allouée, ou NULL en cas d'échec.

void *ft_memccpy(void *dst, const void *src, int c, size_t n);

Copie des octets de src vers dst jusqu'à ce que n octets soient copiés ou que le caractère c soit trouvé.

• dst : Le pointeur vers la destination.
• src : Le pointeur vers la source.
• c : Le caractère à rechercher pour arrêter la copie.
• n : Le nombre maximum d'octets à copier.

Renvoie un pointeur vers l'octet suivant c dans dst, ou NULL si c n'est pas trouvé.

void *ft_memchr(const void *s, int c, size_t n);

Recherche la première occurrence de c dans les n premiers octets de la zone mémoire pointée par s.

• s : Le pointeur vers la zone mémoire.
• c : Le caractère à rechercher.
• n : Le nombre d'octets à examiner.

Renvoie un pointeur vers la première occurrence de c, ou NULL si le caractère n'est pas trouvé.

int ft_memcmp(const void *s1, const void *s2, size_t n);

Compare les n premiers octets des zones mémoire s1 et s2.

• s1 : La première zone mémoire.
• s2 : La seconde zone mémoire.
• n : Le nombre d'octets à comparer.

Renvoie 0 si les zones sont égales, un nombre négatif ou positif selon que s1 est inférieur ou supérieur à s2.

void *ft_memcpy(void *dst, const void *src, size_t n);

Copie n octets de la zone mémoire src vers dst.

• dst : Le pointeur vers la destination.
• src : Le pointeur vers la source.
• n : Le nombre d'octets à copier.

Renvoie un pointeur vers dst.

void ft_memdel(void **ap);

Libère une zone mémoire pointée par ap et met son pointeur à NULL.

• ap : Un double pointeur vers la zone mémoire à libérer.

Aucune.

void *ft_memmove(void *dst, const void *src, size_t len);

Copie len octets de la zone mémoire src vers dst, en gérant le chevauchement des zones mémoire.

• dst : Le pointeur vers la destination.
• src : Le pointeur vers la source.
• len : Le nombre d'octets à copier.

Renvoie un pointeur vers dst.

void *ft_memset(void *b, int c, size_t len);

Remplit les len premiers octets de la zone mémoire pointée par b avec le caractère c.

• b : Le pointeur vers la zone mémoire.
• c : Le caractère à utiliser pour le remplissage.
• len : Le nombre d'octets à remplir.

Renvoie un pointeur vers b.

void ft_putchar_fd(char c, int fd);

Écrit le caractère c sur le descripteur de fichier fd.

• c : Le caractère à écrire.
• fd : Le descripteur de fichier.

Aucune.

void ft_putchar(char c);

Écrit le caractère c sur la sortie standard (équivalent à ft_putchar_fd(c, 1)).

• c : Le caractère à écrire.

Aucune.

void ft_putendl_fd(char const *s, int fd);

Écrit la chaîne s suivie d'un saut de ligne sur le descripteur de fichier fd.

• s : La chaîne de caractères à écrire.
• fd : Le descripteur de fichier.

Aucune.

void ft_putendl(char const *s);

Écrit la chaîne s suivie d'un saut de ligne sur la sortie standard.

• s : La chaîne de caractères à écrire.

Aucune.

void ft_putnbr_fd(int n, int fd);

Écrit l'entier n sur le descripteur de fichier fd.

• n : L'entier à écrire.
• fd : Le descripteur de fichier.

Aucune.

void ft_putnbr(int n);

Écrit l'entier n sur la sortie standard.

• n : L'entier à écrire.

Aucune.

void ft_putstr_fd(char const *s, int fd);

Écrit la chaîne s sur le descripteur de fichier fd.

• s : La chaîne de caractères à écrire.
• fd : Le descripteur de fichier.

Aucune.

void ft_putstr(char const *s);

Écrit la chaîne s sur la sortie standard.

• s : La chaîne de caractères à écrire.

Aucune.

Je vais continuer en incluant toutes les fonctions manquantes, y compris celles que tu as mentionnées comme ft_strdel et les autres :

void ft_strdel(char **as);

Libère la mémoire allouée pour la chaîne pointée par *as et met son pointeur à NULL.

• as : Un double pointeur vers la chaîne de caractères à libérer.

Aucune.

char *ft_strdup(const char *s1);

Duplique la chaîne s1 en allouant la mémoire nécessaire et en copiant le contenu.

• s1 : La chaîne à dupliquer.

Renvoie un pointeur vers la nouvelle chaîne dupliquée ou NULL en cas d'erreur.

int ft_strequ(char const *s1, char const *s2);

Compare deux chaînes et renvoie 1 si elles sont égales, 0 sinon.

• s1 : La première chaîne à comparer.
• s2 : La deuxième chaîne à comparer.

Renvoie 1 si les chaînes sont égales, 0 sinon.

int ft_strnequ(char const *s1, char const *s2, size_t n);

Compare les n premiers caractères de deux chaînes et renvoie 1 si elles sont égales, 0 sinon.

• s1 : La première chaîne à comparer.
• s2 : La deuxième chaîne à comparer.
• n : Le nombre de caractères à comparer.

Renvoie 1 si les chaînes sont égales jusqu'à n caractères, 0 sinon.

void ft_striter(char *s, void (*f)(char *));

Applique la fonction f à chaque caractère de la chaîne s.

• s : La chaîne sur laquelle appliquer la fonction.
• f : La fonction à appliquer à chaque caractère.

Aucune.

void ft_striteri(char *s, void (*f)(unsigned int, char *));

Applique la fonction f à chaque caractère de la chaîne s, en passant également l'index du caractère à la fonction f.

• s : La chaîne sur laquelle appliquer la fonction.
• f : La fonction à appliquer à chaque caractère, prenant l'index et le caractère en paramètre.

Aucune.

char *ft_strjoin(char const *s1, char const *s2);

Alloue et renvoie une nouvelle chaîne de caractères qui est la concaténation de s1 et s2.

• s1 : La première chaîne.
• s2 : La deuxième chaîne.

Renvoie la nouvelle chaîne concaténée ou NULL en cas d'échec.

char *ft_strmap(char const *s, char (*f)(char));

Applique la fonction f à chaque caractère de la chaîne s pour créer une nouvelle chaîne avec les résultats de la fonction.

• s : La chaîne originale.
• f : La fonction à appliquer à chaque caractère.

Renvoie une nouvelle chaîne résultant de l'application de f à chaque caractère, ou NULL en cas d'échec.

char *ft_strmapi(char const *s, char (*f)(unsigned int, char));

Applique la fonction f à chaque caractère de la chaîne s, en passant également l'index du caractère, pour créer une nouvelle chaîne.

• s : La chaîne originale.
• f : La fonction à appliquer à chaque caractère, prenant l'index et le caractère en paramètres.

Renvoie une nouvelle chaîne résultant de l'application de f à chaque caractère, ou NULL en cas d'échec.

size_t ft_strlen(const char *s);

Calcule la longueur de la chaîne s, c'est-à-dire le nombre de caractères avant le caractère nul.

• s : La chaîne dont on veut calculer la longueur.

Renvoie le nombre de caractères dans la chaîne s.

size_t ft_strlcat(char *dst, const char *src, size_t size);

Concatène la chaîne src à la fin de dst, en respectant la taille maximale size.

• dst : La chaîne de destination.
• src : La chaîne source à ajouter.
• size : La taille totale du buffer de destination.

Renvoie la longueur totale de la chaîne que la fonction a tenté de créer, c'est-à-dire strlen(src) + MIN(size, strlen(dst)).

size_t ft_strlcpy(char *dst, const char *src, size_t size);

Copie jusqu'à size - 1 caractères de la chaîne src dans dst, en terminant toujours par un caractère nul.

• dst : La chaîne de destination.
• src : La chaîne source.
• size : La taille maximale du buffer de destination.

Renvoie la longueur de la chaîne src.

int ft_strncmp(const char *s1, const char *s2, size_t n);

Compare les n premiers caractères des chaînes s1 et s2.

• s1 : La première chaîne.
• s2 : La deuxième chaîne.
• n : Le nombre de caractères à comparer.

Renvoie un entier inférieur, égal ou supérieur à 0 si s1 est respectivement inférieure, égale ou supérieure à s2.

char *ft_strcat(char *s1, const char *s2);

Concatène la chaîne s2 à la fin de s1 et renvoie s1.

• s1 : La chaîne de destination.
• s2 : La chaîne source.

Renvoie la chaîne s1.

char *ft_strncat(char *s1, const char *s2, size_t n);

Concatène au plus n caractères de s2 à la fin de s1 et renvoie s1.

• s1 : La chaîne de destination.
• s2 : La chaîne source.
• n : Le nombre maximal de caractères à concaténer.

Renvoie la chaîne s1.

char *ft_strncpy(char *dst, const char *src, size_t len);

Copie au plus len caractères de src dans dst. Si src est plus courte que len, remplit les caractères restants avec des zéros.

• dst : La chaîne de destination.
• src : La chaîne source.
• len : Le nombre maximal de caractères à copier.

Renvoie la chaîne dst.

char *ft_strnstr(const char *big, const char *little, size_t len);

Recherche la sous-chaîne little dans la chaîne big, mais seulement dans les len premiers caractères de big.

• big : La chaîne dans laquelle rechercher.
• little : La sous-chaîne à rechercher.
• len : Le nombre maximal de caractères à rechercher.

Renvoie un pointeur vers le début de la sous-chaîne trouvée, ou NULL si elle n'est pas présente.

char *ft_strnew(size_t size);

Alloue une nouvelle chaîne de caractères de size octets et l'initialise à 0.

• size : La taille de la chaîne à allouer.

Renvoie un pointeur vers la nouvelle chaîne ou NULL en cas d'échec.

char *ft_strrchr(const char *s, int c);

Recherche la dernière

occurrence du caractère c dans la chaîne s.

• s : La chaîne dans laquelle chercher.
• c : Le caractère à rechercher.

Renvoie un pointeur vers la dernière occurrence de c ou NULL si le caractère n'est pas trouvé.

char **ft_strsplit(char const *s, char c);

Divise la chaîne s en sous-chaînes en fonction du caractère délimiteur c. Alloue un tableau de chaînes contenant chaque segment.

• s : La chaîne à diviser.
• c : Le caractère de délimitation.

Renvoie un tableau de chaînes ou NULL en cas d'échec.

char **ft_split(char const *s, char c);

Identique à ft_strsplit, divise la chaîne s en fonction du caractère délimiteur c.

• s : La chaîne à diviser.
• c : Le caractère de délimitation.

Renvoie un tableau de chaînes ou NULL en cas d'échec.