https://github.com/ygor-sena/42cursus-ft-printf
The third project of 42 curriculum asks students to reproduce some features of the famous printf() function.
https://github.com/ygor-sena/42cursus-ft-printf
42 42-ft-printf 42cursus 42saopaulo 42school 42sp ansi-c c ecole42
Last synced: 7 months ago
JSON representation
The third project of 42 curriculum asks students to reproduce some features of the famous printf() function.
- Host: GitHub
- URL: https://github.com/ygor-sena/42cursus-ft-printf
- Owner: ygor-sena
- License: gpl-3.0
- Created: 2022-07-11T14:53:48.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-04T16:41:55.000Z (over 1 year ago)
- Last Synced: 2025-02-24T06:17:37.008Z (8 months ago)
- Topics: 42, 42-ft-printf, 42cursus, 42saopaulo, 42school, 42sp, ansi-c, c, ecole42
- Language: C
- Homepage:
- Size: 79.1 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## đź“Ł Introduction
This project is pretty straightforward. It asks students to recode `printf()` in order to make them learn about how a **variadic function** works. It also aims to make students think about how they are going to implement the project. After all, the key to a successful `ft_printf` is a well-structured and extensible code.
Inside the folder [`ft-printf-studies`](https://github.com/ygor-sena/42cursus-ft-printf/blob/main/ft-printf-studies/ft_printf_studies.c) there is a file that test all the possible combinations of `printf` flags.
## ✨ Implemented features
#### Mandatory
- âś… The function has to implement the following conversions: `cspdiuxX%`
| Conversion | Description |
|:----|:-----|
| `c` | Prints a single character. |
| `s` | Prints a string (as defined by the common C convention). |
| `p` | The `void *` pointer argument has to be printed in hexadecimal format. |
| `d` | Prints a decimal (base 10) number. |
| `i` | Prints an integer in base 10. |
| `u` | Prints an unsigned decimal (base 10) number. |
| `x` | Prints a number in hexadecimal (base 16) lowercase format. |
| `X` | Prints a number in hexadecimal (base 16) uppercase format. |
| `%` | Prints a percent sign. |
#### Bonus 1
- ❌ Manage any combination of the following flags: `-0.` and the field minimum width under all conversions.
| Flag | Description |
|:----|:-----|
| `-` | Left aligns the argument passed. |
| `0` | Add '0' as a padding character in numeric conversions (single space is default). |
| `.` | Precision definition, followed by a number. |
#### Bonus 2
- âś… Manage all the following flags: `# +` (Yes, one of them is a space).
| Flag | Description |
|:----|:-----|
| `' '` | Adds a single space (`' '`) in the front of positive numeric conversions. |
| `#` | Adds the corresponding prefix in front of `x` and `X` conversions. |
| `+` | Adds a plus sign (`+`) in the front of positive numeric conversions. |
## ⚒️ How to use the project
Run `make` or `make bonus` if you want to compile the mandatory project or the bonus project respectively.
After that, to use the `ft_printf()` in your project it's necessary to include the library `libftprintf.a` and the header as follows:
```c
#include "ft_printf.h"
```
If you want to include the bonus version, use:
```c
#include "ft_printf_bonus.h"
```
Don't forget to add the following flags when compiling your project:
```bash
gcc ... -lftprintf -L path/to/libftprintf.a -I path/to/libftprintf.h
```
## đź“– References
- [Criando Funções Com Número Variável De Argumentos Em C](https://daemoniolabs.wordpress.com/tag/como-utilizar-va_start-va_arg-va_end-e-va_list/) by [Daemonio Labs](https://daemoniolabs.wordpress.com/).
- [Formatted output](https://www.gnu.org/software/libc/manual/html_node/Formatted-Output.html) in _12. Input/Output on Streams_ by [The GNU C Library Reference Manual](https://www.gnu.org/software/libc/manual/2.36/html_mono/libc.html).
- COLTON, Don. [Secrets of “printf”](https://www.studocu.com/en-us/document/florida-institute-of-technology/ae-comp-techniques/secrets-of-printf/3918181). Brigham Young University Hawaii, 2014.
- [C++ Documentation of printf()](https://cplusplus.com/reference/cstdio/printf/) by [cplusplus.com](https://cplusplus.com/reference/).
- To test the project features, I used the [ft_printf_tester](https://github.com/paulo-santana/ft_printf_tester.git) made by [Paulo Santana](https://github.com/paulo-santana).