Welcome to the Libft!

LIBFT는 42에서 필요한 라이브러리를 직접 구현한 프로젝트입니다.

라이브러리가 무엇이고 왜 사용하는지에 대한 이해가 필요하시면 라이브러리 만들기를 참고해주세요.

Coding convention은 42의 convention을 따라 작성되었습니다.

Getting started

Libft 프로젝트를 클론합니다.

git clone https://github.com/kohyounghwan/Libft.git

make 명령어를 통해 정적 라이브러리(libft.a)를 생성합니다.
```
make
```
작성하신 코드를 라이브러리와 함께 컴파일 합니다.
```
# If code you write is main.c
gcc libft.a main.c
```

Welcome to the Libft! !score
- Getting started
- Contents
- Makefile
- Part 1 - Libc functions
  - ft_memset
  - ft_bzero
  - ft_memchr
  - ft_memcpy
  - ft_memmove
  - ft_memcmp
  - ft_strlen
  - ft_strlcpy
  - ft_strlcat
  - ft_strchr
  - ft_strrchr
  - ft_strnstr
  - ft_strncmp
  - ft_atoi
  - ft_isalpha
  - ft_isdigit
  - ft_isalnum
  - ft_isascii
  - ft_isprint
  - ft_toupper
  - ft_tolower
  - ft_calloc
  - ft_strdup
- Part 2 - Additional functions
- Bonus

Makefile

Makefile은 다음과 같은 rules로 작성되었습니다.

all
Bonus 파트를 제외한 모든 파일을 컴파일하여 라이브러리(libft.a)를 만듭니다.
```
make
```
bonus
Bonus 파트만 컴파일 하여 라이브러리(libft.a)를 만듭니다.
```
make bonus
```
clean
object 파일들을 삭제합니다.
```
make clean
```
fclean
object 파일들과 라이브러리(libft.a)를 삭제합니다.
```
make fclean
```
re
fclean 후 다시 make 해줍니다.
```
make re
```

Part 1 - Libc functions

함수들의 프로토타입은 OS X의 BSD libc를 기준으로 작성되었습니다.

ft_memset

memory set

code

Here

Prototype Declaration

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

Description
메모리 영역 b의 len byte까지를 c로 초기화합니다.

Return
메모리 영역 b의 포인터를 반환

Ussage
메모리 영역을 특정 문자로 초기화할 때

↥ back to top

ft_bzero

byte zero

code

Here

Prototype Declaration

void    ft_bzero(void *s, size_t n);

Description
메모리 영역 s의 n bytes까지를 0으로 초기화합니다. 초기화 용도로 사용되며, memset과 동일한 역할을 합니다.

Return
없음

Ussage
메모리 영역을 0으로 초기화할 때

↥ back to top

ft_memchr

memory character

code

Here

Prototype Declaration

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

Description
n bytes 까지의 메모리 영역 s에서 문자 c가 처음 발견된 곳의 포인터를 반환한다.

Return
처음으로 값 c가 나타나는 포인터

Ussage
메모리영역에서 값 c의 위치를 찾아낼 때

↥ back to top

ft_memcpy

memory copy

code

Here

Prototype Declaration

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

Description
메모리 영역 src의 n bytes만큼을 dst로 복사합니다. 절대 src와 dst의 메모리 영역이 겹쳐서는 안됩니다. 메모리 영역이 겹치면, memcpy 대신 memmove를 사용해야합니다.

Return
메모리 영역 dst의 포인터를 반환

Ussage
메모리영역을 n만큼 복사할 때

↥ back to top

ft_memmove

memory move

code

Here

Prototype Declaration

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

Description
메모리 영역 src의 len bytes만큼을 dst로 복사합니다. memcpy와 동일하나, src와 dst의 메모리 영역이 겹칠 때 사용합니다.

Return
메모리 영역 dst

Ussage
메모리 영역을 len만큼 복사할 때 src와 dst의 메모리 영역이 겹칠 때

↥ back to top

ft_memcmp

memory compare

code

Here

Prototype Declaration

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

Description
메모리 영역 s1과 s2를 n bytes까지 비교합니다.

Return
s1이 크면 양수
s2가 크면 음수
같으면 0

Ussage
메모리 영역을 비교할 때 정렬에서 비교가 필요할 때

↥ back to top

ft_strlen

string length

code

Here

Prototype Declaration

size_t    ft_strlen(const char *s);

Description
문자열 s의 길이를 구합니다.

Return
문자열 s의 길이

↥ back to top

ft_strlcpy

string l copy

code

Here

Prototype Declaration

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

Description
문자열 src에서 dst로 dstsize bytes 만큼 복사합니다. 문자열 끝에 NUL문자(\0)가 보장된 strcpy 입니다.

Return
src의 길이(복사를 시도하려고 하는 길이)

Ussage
문자열을 복사할 때 memcpy 는 메모리 단위로 복사를 하는 함수라고 한다면, 이 함수는 문자열 단위로 복사를 합니다.

↥ back to top

ft_strlcat

string l cat

code

Here

Prototype Declaration

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

Description
문자열 dst 뒤에 src를 이어 붙여주는데, dstsize bytes 만큼만 이어붙여줍니다. 문자열 끝에 NUL문자(\0)가 보장된 strcat 입니다. (dstsize의 제일 마지막에 \0을 붙임)

Return
만드려고 시도했던 최종 문자열의 길이

Ussage
NUL이 보장되는 strcat이 필요할 때

↥ back to top

ft_strchr

string chracter

code

Here

Prototype Declaration

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

Description
문자열 s에서 문자 c가 처음 발견된 곳의 포인터를 반환한다. s 가 정상적인 문자열이 아닐 경우, 문제가 생길 수 있음.

Return
문자 c가 처음 발견된 곳의 포인터 문자열 s에 문자 c가 없으면 NULL 포인터

Ussage
문자열 앞에서부터 특정 문자를 찾을 떄

↥ back to top

ft_strrchr

string reverse(rear(?)) chracter

code

Here

Prototype Declaration

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

Description
문자열 s의 뒤에서부터 문자 c가 처음 발견된 곳의 포인터를 반환한다. s 가 정상적인 문자열이 아닐 경우, 문제가 생길 수 있음.

Return
뒤에서부터 문자 c가 처음 발견된 곳의 포인터 문자열 s에 문자 c가 없으면 NULL 포인터

Ussage
문자열 뒤에서부터 특정 문자를 찾을 떄

↥ back to top

ft_strnstr

string n string

code

Here

Prototype Declaration

char    *ft_strnstr(const char *haystack, const char *needle, size_t len);

Description
문자열 haystack에서 needle을 찾아주는데, len길이까지만 찾아 줍니다.

Return
haystack 에서 찾은 문자열의 포인터

Ussage
문자열에서 특정 문자열이 포함되어 있는지 확인하고 싶을 때

↥ back to top

ft_strncmp

string n compare

code

Here

Prototype Declaration

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

Description
문자열 s1과 문자열 s2를 n만큼 비교해줍니다.

Return
s1이 크면 양수
s2가 크면 음수
같으면 0

Ussage
두 문자열을 비교하고 싶을 때

↥ back to top

ft_atoi

ascii to int

code

Here

Prototype Declaration

int    ft_atoi(const char *str);

Description
문자열 str을 정수로 바꿔줍니다.

Return
문자열에 str에 해당하는 정수

Ussage
문자로된 숫자를 진짜 숫자로 바꿔줄 때

↥ back to top

ft_isalpha

is alphabetic character

code

Here

Prototype Declaration

int    ft_isalpha(int c);

Description
c가 알파벳 문자인지 아닌지 확인해줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
알파벳이면 1
알파벳이 아니면 0

Ussage
알파벳 문자인지 아닌지 확인해야할 떄

↥ back to top

ft_isdigit

is digit character

code

Here

Prototype Declaration

int    ft_isdigit(int c);

Description
c가 숫자 문자인지 아닌지 확인해줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
숫자면 1
숫자가 아니면 0

Ussage
숫자 문자인지 아닌지 확인해야 할 때

↥ back to top

ft_isalnum

is alphanumeric character

code

Here

Prototype Declaration

int    ft_isalnum(int c);

Description
c가 알파벳 또는 숫자 문자인지 아닌지 확인해줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
알파벳이나 숫자면 1 알파벳이나 숫자가 아니면 0

Ussage
알파벳이랑 숫자만 골라내고 싶을 때

↥ back to top

ft_isascii

is ASCII charecter

code

Here

Prototype Declaration

int    ft_isascii(int c);

Description
c가 ASCII 문자인지 아닌지 확인해줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
ASCII 문자면 1 ASCII 문자가 아니면 0

Ussage
아스키 문자인지 아닌지 확인하고 싶을 때

↥ back to top

ft_isprint

is printable charecter

code

Here

Prototype Declaration

int    ft_isprint(int c);

Description
c가 출력 가능한 문자인지 아닌지 확인해줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
출력 가능한 문자면 1 출력 가능한 문자가 아니면 0

Ussage
출력할 수 있는 문자인지 아닌지 확인하고 싶을 때

↥ back to top

ft_toupper

to upper case charecter

code

Here

Prototype Declaration

int    ft_toupper(int c);

Description
c가 소문자면 대문자로 바꿔줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
대문자로 변환된 문자(int)

Ussage
소문자를 대문자로 바꾸고 싶을 때

↥ back to top

ft_tolower

to lower case charecter

code

Here

Prototype Declaration

int    ft_tolower(int c);

Description
c가 대문자면 소문자로 바꿔줍니다.
EOF(-1)를 처리해주기 위해 int로 받습니다.

Return
소문자로 변환된 문자(int)

Ussage
대문자를 소문자로 바꾸고 싶을 때

↥ back to top

ft_calloc

contiguous allocation

code

Here

Prototype Declaration

void    *ft_calloc(size_t count, size_t size);

Description
0으로 초기화된 연속적인 메모리공간(count x size)을 할당해줍니다.

Return
할당 성공시 할당된 공간의 포인터
할당 실패시 NULL 포인터

Ussage
메모리 할당과 동시에 초기화가 필요할 때

↥ back to top

ft_strdup

string duplicate

code

Here

Prototype Declaration

char    *ft_strdup(const char *s1);

Description
문자열 s1을 복제해줍니다.

Return
복제한 문자열의 포인터

Ussage
문자열을 복제하고 싶을 때

↥ back to top

Part 2 - Additional functions

libc에는 없지만, 유용한 함수들을 모아둔 파트입니다.

ft_substr

subpart of string

code

Here

Prototype Declaration

char    *ft_substr(char const *s, unsigned int start, size_t len);

Description
문자열 s에서 start index부터 len개 만큼의 부분 문자열을 만들어(복제해) 줍니다.

Return
만들어진(복제된) 부분 문자열의 포인터

Ussage
원래 문자열은 그대로 두고 특정부분만 따서 새로운 문자열을 만들고 싶을 때

↥ back to top

ft_strjoin

string join

code

Here

Prototype Declaration

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

Description
문자열 s1에 문자열 s2를 이어 붙여서 새로운 문자열로 반환힙니다.

Return
s1에 s2가 이어 붙여진 문자열

Ussage
원본 문자열을 수정하지 않고, 이어 붙여진 새로운 문자열이 필요할 떄
ft_strlcat과 유사하지만 새로운 문자열을 만들기 때문에 원본 문자열을 건드리지 않음

↥ back to top

ft_strtrim

string trim

code

Here

Prototype Declaration

char    *ft_strtrim(char const *s1, char const *set);

Description
문자열 s1의 앞 뒤로 set에 들어 있는 문자들을 제거해주고, 새로운 문자열로 반환해줍니다.

Return
s1 앞 뒤로 set에 들어 있는 문자들이 제거된 새로운 문자열

Ussage
특정 문자들을 기준으로 앞뒤 내용을 잘라내고 싶을 때

↥ back to top

ft_split

string split

code

Here

Prototype Declaration

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

Description
문자열 s1을 문자 c를 기준으로 잘라서, 새로운 문자열배열로 반환해줍니다.

Return
구분자를 기준으로 나뉘어진 문자열 배열

Ussage
특정 구분자를 기준으로 문자열을 쪼개고 싶을 때

↥ back to top

ft_itoa

integer to ascii character

code

Here

Prototype Declaration

char    *ft_itoa(int n);

Description
정수 n을 문자열로 반환해줍니다.

Return
정수 n을 문자로 바꾼 문자열

Ussage
정수를 문자열 형태로 변환하고 싶을 때

↥ back to top

ft_strmapi

string mapping iterate

code

Here

Prototype Declaration

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

Description
문자열 s를 순회하면서 각각의 문자에 f함수를 적용(mapping) 시켜준 뒤, 새로운 문자열로 반환합니다.(원본 문자열은 건드리지 않는다는 의미)
s는 문자열, f의 unsigned int는 index, char는 index에 해당하는 문자입니다.

Return
f함수로 mapping(적용)된 새로운 문자열

Ussage
문자열의 모든 문자열에 동일한 함수를 적용하고 싶을 때
특정 index에 해당하는 값에만 매핑하고 싶을 때

↥ back to top

ft_striteri

string iterate

code

Here

Prototype Declaration

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

Description
인수로 전달된 문자열의 각 문자에 함수 f를 적용하며, f 함수의 첫 번째 인수로 문자엻의 인덱스를 전달합니다. 각 문자는 f 함수를 향해 주소로 전달되며, 필요하다면 수정됩니다.

Return
없음

Ussage
문자열의 모든 문자열에 동일한 함수를 적용하고 싶을 때 다만 적용만 하고 반환하지는 않고 싶을 때

↥ back to top

ft_putchar_fd

put character

code

Here

Prototype Declaration

void    ft_putchar_fd(char c, int fd);

Description
문자 c를 fd대로 출력해줍니다.

Return
없음

Ussage
문자를 출력하고 싶을 때

↥ back to top

ft_putstr_fd

put string

Prototype Declaration

code

Here

void    ft_putstr_fd(char *s, int fd);

Description
문자열 s를 fd대로 출력해줍니다.

Return
없음

Ussage
문자열을 출력하고 싶을 때

↥ back to top

ft_putendl_fd

put string end line

code

Here

Prototype Declaration

void    ft_putendl_fd(char *s, int fd);

Description
문자열 s를 fd대로 출력해주고 개행(\n)을 붙여줍니다.

Return
없음

Ussage
문자열을 출력하고 개행해주고 싶을 때

↥ back to top

ft_putnbr_fd

put number

code

Here

Prototype Declaration

void    ft_putnbr_fd(int n, int fd);

Description
숫자 n을 fd대로 출력해줍니다.

Return
없음

Ussage
숫자를 출력하고 싶을 때

↥ back to top

Bonus

list에 관련된 함수들을 모아둔 파트입니다.

본 파트에서 사용할 list는 다음과 같은 structure를 가지고 있습니다.

typedef struct      s_list
{
    void            *content;
    struct s_list   *next;
}                   t_list;

ft_lstnew

list new

code

Here

Prototype Declaration

t_list    *ft_lstnew(void *content);

Description
content의 내용으로 새로운 요소(element)를 만들어 줍니다.
content가 NULL일 때도 content가 NULL인 요소를 만들어 줍니다.

Return
새로 만들어진 요소의 포인터를 반환합니다.

Ussage
새로운 요소(element)를 만들고 싶을 때

↥ back to top

ft_lstlast

list last

code

Here

Prototype Declaration

t_list    *ft_lstlast(t_list *lst);

Description
lst의 마지막 요소를 찾아줍니다.

Return
Lst 마지막 요소의 포인터

Ussage
리스트의 마지막 요소에 접근하고 싶을 때
마지막 요소에 접근해서 무언가 하고 싶을 때

↥ back to top

ft_lstsize

list size

code

Here

Prototype Declaration

int    ft_lstsize(t_list *lst);

Description
lst의 길이를 구해서 반환해줍니다.

Return
lst의 길이

Ussage
리스트의 길이를 구하고 싶을 때

↥ back to top

ft_lstadd_front

list add front

code

Here

Prototype Declaration

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

Description
lst 리스트 앞에 new 요소를 붙여 줍니다.

Return
없음

Ussage
리스트 앞에 새로운 요소를 이어 붙이고 싶을 때

↥ back to top

ft_lstadd_back

list add back

code

Here

Prototype Declaration

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

Description
lst 리스트 뒤에 new 요소를 붙여 줍니다.

Return
없음

Ussage
리스트 뒤에 새로운 요소를 이어 붙이고 싶을 때

↥ back to top

ft_lstdelone

list delete one

code

Here

Prototype Declaration

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

Description
lst 요소를 삭제합니다.
lst->content에 del을 적용해주고 lst를 free합니다.
lst->next는 free하지 않습니다.

Return
없음

Ussage
요소의 content을 지우고 싶을 때

↥ back to top

ft_lstclear

lst clear

code

Here

Prototype Declaration

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

Description
lst 의 content를 지워줍니다.(리스트를 초기화 해줍니다.)
lst->next는 free하지 않습니다.

Return
없음

Ussage
리스트 전체를 지우고 싶을 때

↥ back to top

ft_lstiter

list iteration

code

Here

Prototype Declaration

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

Description
리스트를 순회하면서 lst에 f를 적용해줍니다.

Return
없음

Ussage
리스트 전체에 함수를 적용하고 싶을 때

↥ back to top

ft_lstmap

list mapping

code

Here

Prototype Declaration

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

Description
리스트를 순회하면서 lst에 f를 적용하고, 적용에 성공한 함수들의 리스트를 반환합니다. del 함수는 요소를 지우고 싶을 때 사용합니다. 이는 필요할 때에만 쓰입니다.

Return
f가 적용된 리스트의 포인터

Ussage
리스트에서 f가 적용된 리스트들만 추리고 싶을 때

lstiter는 반환형이 없는 f를 사용하였고, lstmap은 반환형이 있는 f입니다.

↥ back to top

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
Makefile		Makefile
README.md		README.md
ft_atoi.c		ft_atoi.c
ft_bzero.c		ft_bzero.c
ft_calloc.c		ft_calloc.c
ft_isalnum.c		ft_isalnum.c
ft_isalpha.c		ft_isalpha.c
ft_isascii.c		ft_isascii.c
ft_isdigit.c		ft_isdigit.c
ft_isprint.c		ft_isprint.c
ft_itoa.c		ft_itoa.c
ft_lstadd_back.c		ft_lstadd_back.c
ft_lstadd_front.c		ft_lstadd_front.c
ft_lstclear.c		ft_lstclear.c
ft_lstdelone.c		ft_lstdelone.c
ft_lstiter.c		ft_lstiter.c
ft_lstlast.c		ft_lstlast.c
ft_lstmap.c		ft_lstmap.c
ft_lstnew.c		ft_lstnew.c
ft_lstsize.c		ft_lstsize.c
ft_memchr.c		ft_memchr.c
ft_memcmp.c		ft_memcmp.c
ft_memcpy.c		ft_memcpy.c
ft_memmove.c		ft_memmove.c
ft_memset.c		ft_memset.c
ft_putchar_fd.c		ft_putchar_fd.c
ft_putendl_fd.c		ft_putendl_fd.c
ft_putnbr_fd.c		ft_putnbr_fd.c
ft_putstr_fd.c		ft_putstr_fd.c
ft_split.c		ft_split.c
ft_strchr.c		ft_strchr.c
ft_strdup.c		ft_strdup.c
ft_striteri.c		ft_striteri.c
ft_strjoin.c		ft_strjoin.c
ft_strlcat.c		ft_strlcat.c
ft_strlcpy.c		ft_strlcpy.c
ft_strlen.c		ft_strlen.c
ft_strmapi.c		ft_strmapi.c
ft_strncmp.c		ft_strncmp.c
ft_strnstr.c		ft_strnstr.c
ft_strrchr.c		ft_strrchr.c
ft_strtrim.c		ft_strtrim.c
ft_substr.c		ft_substr.c
ft_tolower.c		ft_tolower.c
ft_toupper.c		ft_toupper.c
libft.h		libft.h
tester.sh		tester.sh

42-seoul-projects-kyungsle/libft

Folders and files

Latest commit

History

Repository files navigation

Welcome to the Libft!

Getting started

Contents

Makefile

Part 1 - Libc functions

ft_memset

ft_bzero

ft_memchr

ft_memcpy

ft_memmove

ft_memcmp

ft_strlen

ft_strlcpy

ft_strlcat

ft_strchr

ft_strrchr

ft_strnstr

ft_strncmp

ft_atoi

ft_isalpha

ft_isdigit

ft_isalnum

ft_isascii

ft_isprint

ft_toupper

ft_tolower

ft_calloc

ft_strdup

Part 2 - Additional functions

ft_substr

ft_strjoin

ft_strtrim

ft_split

ft_itoa

ft_strmapi

ft_striteri

ft_putchar_fd

ft_putstr_fd

ft_putendl_fd

ft_putnbr_fd

Bonus

ft_lstnew

ft_lstlast

ft_lstsize

ft_lstadd_front

ft_lstadd_back

ft_lstdelone

ft_lstclear

ft_lstiter

ft_lstmap

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages