vkannema/libft

My implementation of some of the Standard C Library functions including some additional ones.

Libft - @42Born2Code

My implementation of some of the Standard C Library functions including some additional ones.

TOC

• What is libft?
• What's in it?
• How does it work?
• How do I use the library?
• How do I test it? How do I test my own implementations?
  1. To test the code in this repo
• Example usage

What is libft?

Libft is an individual project at 42 that requires us to re-create some standard C library functions including some additional ones that can be used later to build a library of useful functions for the rest of the program.

Disclaimer: Reinventing the wheel is bad, 42 makes us do this just so we can have a deeper understanding of data structures and basic algorithms. At 42 we're not allowed to use some standard libraries on our projects, so we have to keep growing this library with our own functions as we go farther in the program.

What's in it?

There are 4 sections:

1. Libc Functions: Some of the standard C functions
2. Additional functions: Functions 42 deems will be useful for later projects
3. Bonus Functions: Functions 42 deems will be useful for linked list manipulation
4. Personal Functions: Functions I believe will be useful later.

Libc functions	Additional functions	Bonus Functions	Personal Functions
memset	ft_memalloc	ft_lstnew	ft_capitalize
bzero	ft_memdel	ft_lstdelone	ft_create_elem
memcpy	ft_strnew	ft_lstdel	ft_free_join
memccpy	ft_strdel	ft_lstadd	ft_isdigit_str
memmove	ft_strclr	ft_lstiter	ft_iswhitespace
memchr	ft_striter	ft_lstmap	ft_itoa
memcmp	ft_striteri		ft_list_push_back
strlen	ft_strmap		ft_list_push_front
strdup	ft_strmapi		ft_lstrev
strcpy	ft_strequ		ft_split_whitespaces
strncpy	ft_strnequ		ft_printf functions
strcat	ft_strsub		ft_strplitdel
strlcat	ft_strjoin		get_next_line
strchr	ft_strtrim
strrchr	ft_strsplit
strstr	ft_itoa
strnstr	ft_putchar
strcmp	ft_putstr
strncmp	ft_putendl
atoi	ft_putnbr
isalpha	ft_putchar_fd
isdigit	ft_putstr_fd
isalnum	ft_putendl_fd
isascii	ft_putnbr_fd
isprint
toupper
tolower

Notes:

• A lot of the files and functions are namespaced with an ft in front. It stands for Fourty Two

My code is not the best, but it passed all the 42 tests successfully.

How does it work?

The goal is to create a library called libft.a from the source files so I can later use that library from other projects at 42.

To create that library, after downloading/cloning this project, cd into the project, copy all the files from the sub folders to the root directory and finally, call make:

git clone https://github.com/vkannema/Libft/
cd Libft
make

You should see a libft.a file and some object files (.o).

Now to clean up (removing the .o files and the .c files from the root), call make clean

How do I use the library?

You have to tell the file where your library resides and which library it is using:

gcc -L. -lft example.c

-L takes the path to your library. . in this case
-l takes the name of your library. This is the set of characters that come after lib in your library name.

That's it. Now run it using ./a.out

How do I test it? How do I test my own implementations?

To test the code we're going to be using @alelievr's Libft Unit Test.

1. To test the code in this repo

1. Clone this repo and cd into it, make sure it's called libft:

    git clone https://github.com/vkannema/Libft/
    cd Libft/
   

2. Run Make so you can build the library:

    make
   

3. Go back to the root directory and download @alelievr's Libft Unit Test:

    cd ..
    git clone https://github.com/alelievr/libft-unit-test
   

4. Go into the test folder and run the test:

    cd libft-unit-test/
    make f
   

If you did everything correctly you should get a cool list of tests showing you the function names and if they passed or not.

That's it! If you're having some problems, just send me a tweet. If you think your problem is due to my code or this README, create a new issue. I'll definitely check it out.