PC Laborator 2.1 (opțional)

Obiective

În urma parcurgerii acestui laborator studentul va fi capabil:

• să utilizeze stream-urile standard ale unui proces în Linux și în programe C;
• să înțeleagă funcționalitatea preprocesorului și să folosească directive de preprocesare;
• să utilizeze funcționalitatea de bază a unui sistem de revision control - Git.

Stream-urile standard ale unui proces

După cum se poate observa în schema de mai sus, un proces care rulează într-un sistem de operare dispune de trei stream-uri de intrare ieșire implicite:

• Stream-ul standard de intrare (stdin) - este utilizat pentru a introduce date în proces și este implicit atașat tastaturii;
• Stream-ul standard de ieșire (stdout) - este utilizat pentru a extrage rezultate ale execuției procesului și este implicit atașat consolei;
• Stream-ul standard de eroare (stderr) - este tradițional utilizat pentru a extrage informații legate de erorile apărute în execuția procesului și este implicit atașat consolei;

Se observă că ambele stream-uri de ieșire sunt implicit trimise către consolă, unde utilizatorul procesului le poate vedea. Motivul pentru care sunt două este acela că aceste stream-uri pot fi redirectate către alte procese sau către fișiere, astfel se poate face o separare simplă și rapidă a mesajelor de eroare, în scopul depanării programului.

Toate aceste stream-uri sunt formatate pe octet (byte). În cele mai multe din cazuri, acești bytes reprezintă caractere codate ASCII.

Scrierea pe stdout

Pentru a scrie pe stream-ul standard de ieșire se folosește generic funcția fprintf:

Funcția fprintf este definită în header-ul stdio.h (standard input/output) și este implimentată în biblioteca standard a limbajului C. Pentru scrierea pe stream-ul standard de ieșire, se folosește în felul următor:

fprintf(stdout, "[format]", val1, val2, ...);

Observație: Deoarece scrierea pe stream-ul standard de ieșire este atât de utilizată, s-a creat o funcție specială pentru aceasta, numită printf:

printf("[format]", val1, val2, ...);

Formatul reprezintă modelul de date pe care îl dorim afișat în consolă și este identic cu cel al funcției fscanf.

Specificatorul de format pentru fprintf, respectiv printf urmează următorul prototip:

%[flags][width][.precision][length]specifier 

unde caracterul specifier de la sfârșit este componenta cea mai importantă deoarece definește ce caractere sunt extrase din stream, interpretarea lor, și tipul de date corect al argumentului corespunzător:

specifier	Afișare	Exemplu
i, d	întreg decimal cu semn	-694
u	întreg decimal fără semn	1659
o	întreg în baza 8	254
x	întreg în baza 16 (litere mici)	1af43
X	întreg în baza 16 (litere mari)	1AF43
f	număr în virgulă mobilă	23.65
e	număr în virgulă mobilă, notație științifică (mantisa - exponent), litere mici	3.9265e+2
E	număr în virgulă mobilă, notație științifică (mantisa - exponent), litere mari	3.9265E+2
g	număr în virgulă mobilă, cea mai scurtă reprezentare (%f sau %e)	23.65
G	număr în virgulă mobilă, cea mai scurtă reprezentare (%F sau %E)	23.65
a	număr în virgulă mobilă în baza 16, litere mici	-0xc.90fep-2
A	număr în virgulă mobilă în baza 16, litere mari	-0xc.90FEP-2
c	caracter	a
s	șir de caracere	castravete
p	adresă în memorie	00000000b8000000
n	nu se printează nimic	numărul de caractere citit până în momentul curent este stocat în variabila specificată
%	%	Un caracter % urmat de alt caracter % afișează un singur %.

Specificatorul de format poate conține și sub-specificatori: flags, width, .precision și modifiers (în această ordine), care sunt opționale și respectă următoarele reguli:

flag	Descriere
-	Aliniere la stânga cu dimensiunea dată de câmpul width (implicit aliniera este la dreapta). Vezi descrierea lui width.
+	Forțează printarea unui semn (+ sau -), chiar și pentru valori pozitive (implicit se afișează semnul doar pentru numere negative).
(spațiu)	Dacă semnul nu se afișează, în locul lui se inserează un spațiu.
#	Folosit cu o, x, sau X, printează 0, 0x sau respectiv 0X în fața valorii, pentru numere diferite de 0. Folosit cu a, A, e, E, f, g sau G, forțează printarea punctului decimal, chiar dacă după el nu mai urmează alte cifre. Implicit, dacă după punct nu mai urmează alte cifre (numărul este întreg), punctul nu se mai afișează.
0	Când se specifică o dimensiune (width), numărul se completează la stânga cu 0 în loc de spațiu. Vezi descrierea lui width.

width	Descriere
(număr)	Numărul minim de caractere care trebuie scrise. Dacă lungimea numărului este mai mică decât această valoare, el este completat cu spații. Dacă lungimea este mai mare, numărul este afișat în întregime.
*	Valoarea width nu este specificată în string-ul format, ci într-un argument suplimentar al funcției, care precede argumentul ce trebuie formatat.

.precision	Descriere
(număr)	Pentru valori întregi (d, i, o, u, x, X), precision specifică numărul minim de cifre care trebuie afișate. Dacă numărul ce trebuie afișat este mai scurt decât această valoare, rezultatul este completat la stânga cu cifra 0. Dacă numărul este mai lung, el este afișat în întregime. O precizie 0 înseamnă că pentru valoarea 0 nu se va afișa nimic. Pentru specificatorii a, A, e, E, f și F, aceasta este numărul de cifre ce a fi afișat după punct (implicit valoarea aceasta este 6). Pentru specificatorii g și G, acesta este numărul maxim de cifre semnificative ce trebuie afișat. Pentru s, acesta este numărul maxim de caractere ce trebuie afișat. Implicit toate caracterele sunt afișate, până la întâlnirea unui terminator de string. Dacă punctul este scris fără o valoare pentru precizie, aceasta se consideră implicit 0.
*	Valoarea precision nu este specificată în string-ul format, ci într-un argument suplimentar al funcției, care precede argumentul ce trebuie formatat.

Specificatorul length modifică dimensunea tipului de date. Tabelul următor arată tipurile folosite pentru a interpreta argumentele corespunzătoare, cu și fără specificatorul length (dacă un alt tip este folosit, se realizează promovarea sau conversia tipului, dacă este posibil):

	specifiers
length	d i	u o x X	f F e E g G a A	c	s	p	n
(none)	int	unsigned int	double	int	char*	void*	int*
hh	signed char	unsigned char					signed char*
h	short int	unsigned short int					short int*
l	long int	unsigned long int		wint_t	wchar_t*		long int*
ll	long long int	unsigned long long int					long long int*
j	intmax_t	uintmax_t					intmax_t*
z	size_t	size_t					size_t*
t	ptrdiff_t	ptrdiff_t					ptrdiff_t*
L			long double

Observație: Tabelele de mai sus pot fi înțelese abia după parcurgerea cursurilor și laboratoarelor legate de tipuri și dimensiuni de date. Ele vor fi folosite pe parcursul cursului drept referință și nu trebuie memorate.

Observație: Rândurile marcate cu galben au fost introduse în standardul C99.

Scrierea pe stderr

Scrierea pe stream-ul standard de eroare se face identic cu scrierea pe stdout, specificând numele streamului ca prim argument al funcției fprintf:

fprintf(stderr, "[format]", val1, val2, ...);

Observație: Nu se poate folosi funcția printf pentru scrierea pe stream-ul standard de ieșire.

Citirea din stdin

Pentru a citi de pe stream-ul standard de intrare se folosește generic funcția fscanf:

Funcția fscanf este definită în header-ul stdio.h (standard input/output) și se folosește în felul următor:

fscanf(stdin, "[format]", val1, val2, ...);

Observație: Deoarece citirea de pe stream-ul standard este atât de utilizată, s-a creat o funcție specială pentru aceasta, numită scanf:

scanf("[format]", val1, val2, ...);

Formatul reprezintă modelul de date pe care ne așteptăm să-l primim de la tastatură. Acesta este un șir de caractere unde fiecare caracter este tratat în următorul fel:

• caracter alb - se va citi și ignora din stream orice caractere albe până la întâlnirea unui caracter care nu este alb (caracerele albe includ spații, linie nouă, caractere tab); un singur caracter alb în format validează oricâte caractere albe extrase din stream (inclusiv nici unul).
• caracter care nu este alb, exceptând specificatorul de format (%) - orice caracter care nu este alb (spațiu, linie nouă sau tab) sau care nu face parte dintr-un specificator de format (care începe cu %) face ca următorul caracter să fie citit din stream, comparat cu acest caracter din format, iar dacă sunt identice, ele sunt ignorate și se continuă cu următorul caracter; dacă nu sunt identice, fscanf se va opri cu eroare;
• specificator de format - o secvență care începe cu caracterul "la sută" (%) indică un specificator de format, utilizat pentru a indica tipul și formatul unei date care trebuie citită și stocată într-una din variabilele specificate în apelul lui fscanf.

Specificatorul de format pentru fscanf urmează următorul prototip:

%[*][width][length]specifier 

unde caracterul specifier de la sfârșit este componenta cea mai importantă deoarece definește ce caractere sunt extrase din stream, interpretarea lor, și tipul de date corect al argumentului corespunzător:

specifier	Descriere	Caractere extrase din stream
i, u	întreg	Orice număr de cifre, opțional precedate de un semn (+ sau -). Baza zece este considerată implicit (0-9), dar un 0 ca prefix marchează baza ca fiind opt (0-7), iar "0x" ca prefix marchează baza șaisprezece (0-f).
d	întreg în baza 10	Orice număr de cifre decimale (0-9), opțional precedate de un semn (+ sau -).
o	întreg în baza 8	Orice număr de cifre octale (0-7), opțional precedate de un semn (+ sau -).
x	întreg în baza 16	Orice număr de cifre hexazecimale (0-7, a-f, A-F), opțional precedate de "0x" sau "0X", și totul opțional precedat de un semn (+ sau -).
f, e, g, a (C99)	număr în virgulă mobilă	O serie de cifre decimale, conținând opțional un punct decimal, opțional precedat de un semn (+ sau -), opțional urmat de un caracter e sau E, și un întreg în baza 10. În standardul C99 se acceptă și numere în virgulă mobilă în baza hexazecimală, precedate de 0x sau 0X.
c	caracter	Următorul caracter. Dacă width este specificat, se vor citi exact width caractere și vor fi stocate în locații succesive în vectorul primit ca argument. Nu este adăugat terminator de șir la final.
s	șir de caractere	Orice număr de caractere care nu sunt albe, oprindu-se la primul caracter alb înlâlnit. Este automat adăugat terminator de șir la final.
p	adresă în memorie	O secvență de caractere reprezentând o adresă în memorie. Formatul folosit depinde de sistem și de implementarea bibliotecii, dar este identic cu cel folosit de formatul %p în fprintf.
[characters]	set de caractere	Orice număr de caractere dintre cele specificate între parantezele drepte. O liniuță (-) care nu este pe prima poziție între paranteze poate produce comportamente nedefinite în unele implementări de bibliotecă standard.
[^characters]	set de caractere negat	Orice număr de caractere care nu sunt specificate între parantezele drepte.
n	număr caractere citite	Nu este consumat nimic din stream. Numărul de caractere citit până în momentul curent este stocat în variabila specificată.
%	%	Un caracter % urmat de alt caracter % consumă un singur % din stream.

În afară de n, cel puțin un caracter va fi consumat din stream de către oricare alt specificator. Altfel, operația eșuează și citirea se încheie în acel punct.

Specificatorul de format poate conține de asemenea și sub-specificatori: steluță (*), width și length (în această ordine), care sunt opționale și respectă următoarele specificații:

sub-specifcator	Descriere
*	O steluță ca sub-specifiator indică faptul că data citită nu este stocată într-o variabilă ci este ignorată.
width	Specifică numărul maxim de caractere ce vor fi citite din stream de operația curentă.
length	Unul din hh, h, l, ll, j, z, t, L. Acest caracter modifică tipul de date așteptat ca argument.

Atenție: Variabilele care nu sunt de tip vector sau pointer și sunt folosite în apelul funcției fscanf pentru a stoca date din stream, trebuie obligatoriu precedate de operatorul &. Explicația pentru această regulă va fi prezentată în cursul legat de pointeri și adrese de memorie.

Exemple

1. Scrieți următorul program într-un fișier numit exemplu_stdin.c

   #include <stdio.h>
   
   int main(){
       fprintf(stdout, "Introduceti o valoare numerica: ");
       int integerValue
       fscanf(stdin, "%d", &integerValue);
       printf("Valoarea introdusa este %d\n", integerValue);
       return 0;
   }