Skip to content
/ libft Public

The aim of this project is to code a C library regrouping usual functions.

Notifications You must be signed in to change notification settings

ykoh42/libft

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Welcome to the Libft! score

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

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

작성한 함수가 어떤 역할을 했었는지, 시간이 지나면 자꾸 까먹어서 다시 확인할 용도로 작성되었습니다.

Coding convention은 42의 convention을 따라 작성되었으며, 다음의 도구들로 테스트하였습니다.

  • Libftest by jtoty

    git clone https://github.com/jtoty/Libftest.git
  • libft-unit-test by alelievr

    git clone https://github.com/alelievr/libft-unit-test.git
  • libft-war-machine by ska42

    git clone https://github.com/ska42/libft-war-machine.git

Issues and pull requests

아직 학습하는 단계이기 때문에, 잘못된 이해 혹은 잘못된 코드가 작성되었을 수도 있습니다.
이런 문제들을 발견하셨다면, 그냥 지나치지 마시고, 코린이를 위해, 이슈 혹은 pr를 날려주시면 정말 감사하겠습니다. 😘😘😘😘

Getting started

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

    git clone https://github.com/kohyounghwan/Libft.git
  2. make 명령어를 통해 정적 라이브러리(libft.a)를 생성합니다.

    make
  3. 작성하신 코드를 라이브러리와 함께 컴파일 합니다.

    # If code you write is main.c
    gcc libft.a main.c

Contents

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

Prototype Declaration

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

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

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

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


ft_bzero

byte zero

Prototype Declaration

void    ft_bzero(void *s, size_t n);

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

Return
없음

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


ft_memchr

memory character

Prototype Declaration

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

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

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

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


ft_memcpy

memory copy

Prototype Declaration

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

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

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

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


ft_memccpy

memory copy until c found

Prototype Declaration

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

Description
메모리 영역 src에서 dstn bytes만큼 복사하는데, src에서 c가 나타날 때까지만 복사합니다(첫번째 c도 복사함). 절대 srcdst의 메모리 영역이 겹쳐서는 안됩니다.

Return
복사된 메모리 영역 dst의 다음 포인터(+1)

Ussage
특정 문자까지만 복사하고 싶을 때(?)

⚠️ 리턴 값은 어떻게 활용되는지 잘 모르겠습니다... 알려주세요.. 왜 리턴 값이 굳이 카피한 만큼의 다음 포인터일까요? 어떤 목적이 있을 것같긴한데..


ft_memmove

memory move

Prototype Declaration

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

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

Return
메모리 영역 dst

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


ft_memcmp

memory compare

Prototype Declaration

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

Description
메모리 영역 s1s2n bytes까지 비교합니다.

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

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


ft_strlen

string length

Prototype Declaration

size_t    ft_strlen(const char *s);

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

Return
문자열 s의 길이


ft_strlcpy

string l copy

Prototype Declaration

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

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

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

Ussage
문자열을 복사할 때 memcpy와 어떤차이가 있는지는 잘 모르겠습니다..


ft_strlcat

string l cat

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이 필요할 때 하지만, 리턴 값이 어떻게 사용되고 왜 그렇게 되는지 이해가 안됩니다..


ft_strchr

string chracter

Prototype Declaration

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

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

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

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


ft_strrchr

string reverse(rear(?)) chracter

Prototype Declaration

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

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

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

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


ft_strnstr

string n string

Prototype Declaration

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

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

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

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


ft_strncmp

string n compare

Prototype Declaration

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

Description
문자열 s1과 문자열 s2n만큼 비교해줍니다.

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

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


ft_atoi

ascii to int

Prototype Declaration

int    ft_atoi(const char *str);

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

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

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


ft_isalpha

is alphabetic character

Prototype Declaration

int    ft_isalpha(int c);

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

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

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


ft_isdigit

is digit character

Prototype Declaration

int    ft_isdigit(int c);

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

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

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


ft_isalnum

is alphanumeric character

Prototype Declaration

int    ft_isalnum(int c);

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

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

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


ft_isascii

is ASCII charecter

Prototype Declaration

int    ft_isascii(int c);

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

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

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


ft_isprint

is printable charecter

Prototype Declaration

int    ft_isprint(int c);

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

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

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


ft_toupper

to upper case charecter

Prototype Declaration

int    ft_toupper(int c);

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

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

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


ft_tolower

to lower case charecter

Prototype Declaration

int    ft_tolower(int c);

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

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

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


ft_calloc

contiguous allocation

Prototype Declaration

void    *ft_calloc(size_t count, size_t size);

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

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

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


ft_strdup

string duplicate

Prototype Declaration

char    *ft_strdup(const char *s1);

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

Return
복제한 문자열의 포인터

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


Part 2 - Additional functions

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

ft_substr

subpart of string

Prototype Declaration

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

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

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

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


ft_strjoin

string join

Prototype Declaration

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

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

Return
s1s2가 이어 붙여진 문자열

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


ft_strtrim

string trim

Prototype Declaration

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

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

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

Ussage
특정 문자들을 기준으로 앞뒤 내용을 잘라내고 싶을 때(?)
정확히 어떤 경우 사용하기에 좋은지 모르겠다..


ft_split

string split

Prototype Declaration

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

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

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

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


ft_itoa

integer to ascii character

Prototype Declaration

char    *ft_itoa(int n);

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

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

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


ft_strmapi

string mapping iterate

Prototype Declaration

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

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

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

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


ft_putchar_fd

put character

Prototype Declaration

void    ft_putchar_fd(char c, int fd);

Description
문자 cfd대로 출력해줍니다.

Return
없음

Ussage
문자를 출력하고 싶을 때


ft_putstr_fd

put string

Prototype Declaration

void    ft_putstr_fd(char *s, int fd);

Description
문자열 sfd대로 출력해줍니다.

Return
없음

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


ft_putendl_fd

put string end line

Prototype Declaration

void    ft_putendl_fd(char *s, int fd);

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

Return
없음

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


ft_putnbr_fd

put number

Prototype Declaration

void    ft_putnbr_fd(int n, int fd);

Description
숫자 nfd대로 출력해줍니다.

Return
없음

Ussage
숫자를 출력하고 싶을 때


Bonus

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

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

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

ft_lstnew

list new

Prototype Declaration

t_list    *ft_lstnew(void *content);

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

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

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


ft_lstlast

list last

Prototype Declaration

t_list    *ft_lstlast(t_list *lst);

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

Return
Lst 마지막 요소의 포인터

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


ft_lstsize

list size

Prototype Declaration

int    ft_lstsize(t_list *lst);

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

Return
lst의 길이

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


ft_lstadd_front

list add front

Prototype Declaration

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

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

Return
없음

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


ft_lstadd_back

list add back

Prototype Declaration

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

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

Return
없음

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


ft_lstdelone

list delete one

Prototype Declaration

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

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

Return
없음

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


ft_lstclear

lst clear

Prototype Declaration

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

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

Return
없음

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


ft_lstiter

list iteration

Prototype Declaration

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

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

Return
없음

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


ft_lstmap

list mapping

Prototype Declaration

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

Description
리스트를 순회하면서 lstf를 적용하고, 적용에 성공한 함수들의 리스트를 반환합니다. (succesive를 잘못해석해서 성공한 함수를 반환하는게 아닌 것같아요 나중에 수정할게요)

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

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

lstiter는 반환형이 없는 f를 사용하였고, lstmap은 반환형이 있는 f이기 때문에 함수의 적용여부를 확인 할 수 있음(?)
그래서 함수가 적용된 리스트만 반환할 수 있다(?) 그럼 아얘 용도가 사라진 원 리스트의 next는 어떻게 되는 것이지,,?


Extra

개인적으로 필요한 함수들을 모아둔 파트입니다.

ft_isspace

is space character

Prototype Declaration

int    ft_isspace(int c);

Description
c가 공백문자인지 아닌지 확인합니다.

Return
공백문자이면 1 공백문자가 아니면 0

Ussage
공백문자인지 아닌지 알고 싶을 때


ft_islower

is lower case character

Prototype Declaration

int    ft_islower(int c);

Description
c가 소문자인지 아닌지 확인합니다.

Return
소문자이면 1 소문자가 아니면 0

Ussage
소문자인지 아닌지 알고 싶을 때


ft_isupper

is upper case character

Prototype Declaration

int    ft_isupper(int c);

Description
c가 대문자인지 아닌지 확인합니다.

Return
대문자이면 1 대문자가 아니면 0

Ussage
대문자인지 아닌지 알고 싶을 때


ft_strnlen

string n length

Prototype Declaration

size_t    ft_strnlen(const char *s, size_t maxlen);

Description
문자열 s에서 maxlen까지의 길이를 구합니다.

Return
문자열 s에서 maxlen까지의 길이

Ussage
문자열의 길이를 maxlen까지만 알고 싶을 때


ft_strrev

string reverse

Prototype Declaration

char    *ft_strrev(char *str);

Description
문자열 str을 뒤집어 줍니다.

Return
str을 뒤집어서 반환

Ussage
문자열을 뒤집고 싶을 때


ft_strndup

string n duplicate

Prototype Declaration

char    *ft_strndup(const char *s1, size_t n);

Description
문자열 s1n개만큼 복제해줍니다.

Return
복제한 문자열의 포인터

Ussage
문자열을 원하는 갯수만큼 복제하고 싶을 때

About

The aim of this project is to code a C library regrouping usual functions.

Topics

Resources

Stars

Watchers

Forks