Score: 125/100
Finished: 24.10.2024

get_next_line is a function that reads a file line by line. It is useful for processing files that need to be read incrementally rather than loading the entire content into memory. This function is implemented as part of the 42 School curriculum.

To use get_next_line, clone the repository in the root of your project using one of the following commands:

git clone git@github.com:blueyaGIT/get_next_line.git

git clone https://github.com/blueyaGIT/get_next_line.git

gh repo clone blueyaGIT/get_next_line

This will create a directory called get_next_line/. Enter it with the command:

cd get_next_line

get_next_line is provided in .c and .h files, which you can include in your project. To compile a test program, you can use:

gcc -Wall -Wextra -Werror -D BUFFER_SIZE=42 get_next_line.c get_next_line_utils.c main.c -o gnl

The BUFFER_SIZE macro defines how many bytes read() retrieves at a time. You can change this value when compiling.

#include <fcntl.h>
#include <stdio.h>
#include "get_next_line.h"

int main(void)
{
    int fd = open("example.txt", O_RDONLY);
    if (fd == -1)
        return (1);
    char *line;
    while ((line = get_next_line(fd)))
    {
        printf("%s", line);
        free(line);
    }
    close(fd);
    return (0);
}

• get_next_line.c - Contains the get_next_line() function implementation.
• get_next_line.h - Header file with function prototypes and necessary includes.
• get_next_line_utils.c - Utility functions used by get_next_line().

Reads a file descriptor fd line by line until the end of the file.

• Returns a NULL pointer if an error occurs or EOF is reached.
• Memory allocated for the returned string must be freed by the caller.

The get_next_line_bonus.c version supports multiple file descriptors, allowing you to read from different files at the same time.

To compile with bonus support, use:

gcc -Wall -Wextra -Werror -D BUFFER_SIZE=42 get_next_line_bonus.c get_next_line_utils_bonus.c main.c -o gnl_bonus

• Ensure BUFFER_SIZE is greater than zero to avoid undefined behavior.
• Properly free allocated memory after usage to prevent leaks.
• get_next_line() handles any file descriptor, including stdin.

For more details, refer to the project documentation or the 42 subject PDF.