man_3_printf

.\" _printf man page
.\"
.\"
.\"
.\"
.\"
.TH _PRINTF "August 22 2023" "0.1" "Library functions manual"

.SH NAME
.SH ""

.B _printf
- custom version for printf function.

.SH SYNOPSIS
.SH ""

#include "main.h"

int _printf(const char *[FORMAT], ...);

.SH DESCRIPTION
.SH ""


The printf function sends formatted output to stdout.
A custom _printf() for learning purposes was developed by cohort  #8 students Nicks and Mose Parsanka.
_printf() function format string is a character string, beginning and ending in its initial shift state, if any. 
These arguments are placed using the percentage '%' operator

.SS Compilation

.P
.RS
#include "main.h"

$ gcc -Wall -Werror -Wextra -pedantic -Wno-format *.c
$ gcc -Wall -Werror -Wextra -pedantic -g -Wno-format *.c (for gdb debbuging)
.RE

.SS Printing
.RS

int _printf(const char *[FORMAT], ...);

FORMAT is the string that takes n specifier followed by a '%'
symbol. i.e. "Hello this is %s from %d cohort". '...' is the variadic \
(any type of variable).

.SS Example

.RS

.B Input
.PP
_printf("Hello this is %s from %d cohort\\n\\", 33);
.PP
.B Output
.PP
Hello this is %s from %d cohort
.RE

.SS Return Value

Return value is a n number of characters except NULL

.SH FLAG SPECIFIERS
.SH ""

custom and non-custom specifier modifiers

.SH THE LENGTH MODIFIERS
.SH ""

Length modifiers.

.SH THE CONVERSION SPECIFIERS
.SH ""

.RS
Current arguments handled by conversion specifiers:

.IT
.B %
- % symbol is set without argument and conversion specification has to be'%%'.

.IT
.B c
- integer or char argument converted to unsigned char.

.IT
.B d, i
- int argument is converted to signed decimal integer.

.IT
.B s
- string argument. _printf handles s conversion specifier if the argument value
 is not a pointer to a literal string. \

.IT

.B o, u, x, X
- unsigned int argument converted to unsigned octal (o), unsigned decimal (u),
unsigned hexidecimal notation (x) for lower case and (X) for upper case

.IT
.B b
- The unsigned int argument is converted to binary.

.IT
.B p
- The pointer is printed in hexidecimal format preceded by '0x'.

.IT
.B r, R
- 'r' prints string in reverse. 'R' prints encrypted rot13.

.IT
.B S
- ascii <32 & >127 has to appear in the argument string. converted to
hexadecimal preceded by \x

.RE

.P

.SH "AUTHORS"
.SH ""

George S Mulbah II and Deborah Sunday