Get Next Line - Line Reading

Get Next Line is a project from the 42 São Paulo Common Core curriculum. It focuses on creating a function that reads a line from a file descriptor, returning it one line at a time, enhancing C programming skills with practical utility.

About 42

42 São Paulo is a tuition-free, global coding school emphasizing peer-to-peer learning and project-based education. This project introduces key C concepts, including static variables, through hands-on implementation.

Project Overview

Get Next Line delivers a function, get_next_line(), that retrieves a line from a file descriptor. It’s divided into two parts:

• Mandatory Part: A single function to read lines sequentially from a file descriptor or standard input.
• Bonus Part: Enhanced version supporting multiple file descriptors simultaneously with a single static variable.

Key Features

• Returns a line ending with \n (unless EOF is reached without it).
• Handles both file input and standard input efficiently.
• Uses static variables for state persistence across calls.
• Bonus: manages multiple file descriptors without mixing their reading threads.

Restrictions

• Written in C, adhering to the 42 Norm.
• No unexpected crashes (e.g., segmentation faults).
• No memory leaks from heap allocations.
• Compiled with -Wall -Wextra -Werror and -D BUFFER_SIZE=n (e.g., 42).
• No use of libft, lseek(), or global variables.

Getting Started

Prerequisites

• C compiler (e.g., clang or gcc).
• make utility.

How to Build and Run

1. Clone the repository:

   git clone https://github.com/LuizGandra/get-next-line-42.git
   cd get-next-line-42
   

2. Build the mandatory part:

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

3. Build the bonus part (optional, separately):

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

4. Run with a file or standard input:

   ./gnl <file>
   

Project Structure

• get_next_line.h: function prototype for mandatory part.
• get_next_line.c: main function source.
• get_next_line_utils.c: helper functions.
• get_next_line_bonus.h: bonus function prototype.
• get_next_line_bonus.c: bonus main source.
• get_next_line_utils_bonus.c: bonus helper functions.

License

This project is part of the 42 curriculum and intended for educational use.