• Ioana Alexandru
• Oana Bălan

• Data publicare: 17 Noiembrie 2018
• Deadline Soft: 11 Decembrie 2018 (23:55)
• Deadline Hard: 16 Decembrie 2018 (23:55)

• utilizarea tablourilor
• utilizarea funcțiilor de manipulare a șirurilor de caractere
• verificarea validității datelor de intrare

Pe Maria a șocat-o vestea că documentația pentru programele scrise în facultate se face în plain text, pentru că e obișnuită să lucreze în Microsoft Word și să formateze textul cât mai frumos. Ea vrea să găsească cât mai multe moduri prin care să înfrumusețeze un fișier simplu .txt, așa că folosește ASCII Art și vrea să creeze un program care să formateze textul pentru ea.

Maria vrea ca programul ei să primească trei argumente în linia de comandă. Primul argument reprezintă un șir de caractere care indică operațiile pe care dorește să le aplice textului dintr-un fișier (separate prin virgulă), al doilea argument este calea către fișierul respectiv, iar al treilea argument este numele fișierului formatat care va fi generat.

Puteți porni de la scheletul de cod de aici, care face citirea și scrierea în/din fișier pentru voi. Fișierul Makefile inclus conține regulile build, clean și run. Pentru a da argumente regulii run, formatul este conform exemplului următor:

make run ARGS='"W 50, C 0 0, L1" in.txt out.txt'

./format_text "W 50, C 0 0, L 1" in.txt out.txt

Maria știe că fișierele pe care le va formata nu vor avea niciodată mai mult de 1.000 de linii sau mai mult de 1.000 de caractere pe o singură linie.

În șirul de caractere care indică operațiile (îl vom numi “comandă”), pot exista oricâte spații între operații și parametri. Acestea nu influențează operațiile. În plus, primul caracter din operație (care diferă în funcție de tipul operației) poate fi atât lowercase, cât și uppercase, având aceeași semnificație. O comandă nu ar trebui să aibă mai mult de 10 operații, iar o operație validă nu are mai mult de 20 de caractere (cu tot cu spații).

W max_line_length

Operația wrap adaugă și elimină caractere newline din text astfel încât textul să se încadreze în max_line_length (să aibă lungimea - în octeți - mai mică sau egală), fără a permite linii prea scurte (în afara ultimei linii dintr-un paragraf) și fără a trunchia cuvintele. O linie este prea scurtă dacă primul cuvânt din linia următoare ar fi încăput în ea fără să depășească max_line_length.

Atunci când două linii l1 și l2 sunt concatenate în urma unei operații wrap, rezultatul obținut va fi “l1` l2`” unde l1` este l1 fără trailing whitespace, iar l2` este l2 fără starting whitespace.

C [start_line [end_line]]

Operația center folosește ca referință cea mai lungă linie din fișier (fără trailing whitespace) și adaugă spații la începutul liniilor care sunt mai scurte pentru a le centra.

L [start_line [end_line]]

Operația align left aliniază liniile precizate la marginea din stânga.

R [start_line [end_line]]

Operația align right folosește ca referință cea mai lungă linie din fișier (fără trailing whitespace) și adaugă spații la începutul liniilor care sunt mai scurte pentru a le alinia la marginea din dreapta.

J [start_line [end_line]]

Operația justify folosește ca referință cea mai lungă linie din fișier și distribuie în mod echilibrat spații în interiorul liniilor mai scurte pentru ca acestea să ajungă la aceeași lungime și să fie aliniate atât la dreapta, cât și la stânga.

Morbi     sit amet euismod leo. Quisque in hendrerit turpis,    ac
fringilla      ante. Sed id mi bibendum, scelerisque     arcu vel,
rutrum nibh.

P indent_length [start_line [end_line]]

Această operație realizează indentarea automată a paragrafelor din intervalul precizat (dacă există), cu indent_length spații (maxim 8). Se va indenta doar prima linie din fiecare paragraf.

I list_type special_character [start_line [end_line]]

Această operație formatează liniile corespunzătoare ca pe o listă (aliniată la stânga) a cărei indici sunt definiți în funcție de parametrii list_type și special_character.

Parametrul list_type indică tipul listei:

• n → listă numerotată
• a|A → listă alfabetică (cu litere mici sau mari)
• b → bullet list

În funcție de tipul listei, parametrul special_character indică:

• caracterul imediat următor indicelui numeric/alfabetic
• caracterul folosit pe post de bullet

Caracterele speciale folosite vor fi întotdeauna urmate de spațiu.

I n .

I a )

I A .

I b -

I b *

Se știe că nu vor exista niciodată mai mult de 26 de elemente în listă, așadar în cazul indicilor alfabetici, nu se va depăși niciodată indicele 'Z'.

O list_type special_character ordering [start_line [end_line]]

Această operație funcționează exact la fel ca operația precedentă I (formatează liniile corespunzătoare ca pe o listă a cărei indici sunt definiți în funcție de parametrii list_type și special_character), dar în plus face și ordonarea alfabetică a elementelor din listă.

Parametrul ordering indică dacă ordonarea se face alfabetic sau invers alfabetic, putând lua valorile:

• a → sortare alfabetică normală (de la A la Z)
• z → sortare alfabetică inversă (de la Z la A)

O n . a

O b - z

• Dacă parametrul start_line este mai mare decât numărul de linii din fișier (atenție, nu neapărat din fișierul original! numărul de linii se poate modifica pe măsură ce se aplică operațiile) , operația este ignorată.
• Dacă parametrul end_line este mai mare decât numărul de linii din fișier, dar parametrul start_line este valid, se va efectua operația de la start_line până la sfârșitul fișierului (ca și cum end_line nu ar fi fost precizat).
• Dacă valoarea parametrului max_line_length de la operația wrap este mai mică decât lungimea celui mai lung cuvânt din fișierul inițial, se va afișa la stdout mesajul “Cannot wrap!”, iar fișierul obținut va fi identic cu fișierul inițial.
• În cazul în care comanda conține mai mult de 10 operații, se va afișa la stdout mesajul “Too many operations! Only the first 10 will be applied.”, iar fișierul obținut va avea aplicate doar primele 10 operații din comandă.
• Se va afișa la stdout mesajul “Invalid operation!”, iar fișierul obținut va fi identic cu fișierul inițial, dacă:
  • unul sau mai mulți parametri nu are tipul corect sau are o valoare invalidă (spre exemplu list_type cu o altă valoare decât cele precizate);
  • o operație invalidă este folosită (operațiile valide sunt W, C, L, R, J, P, I, O și au maximum 20 de caractere);
  • un număr incorect de parametri este precizat pentru o operație (atenție la parametrii opționali);
  • parametrul start_line este mai mare ca parametrul end_line.

• [30p] Wrap text
• [5p] Center
• [5p] Align left
• [5p] Align right
• [30p] Justify (bonus)
• [5p] Paragrafe
• [10p] Liste
• [20p] Liste ordonate
• [45p] Operații combinate
• [15p] Tratarea operațiilor invalide
• [10p] README și Coding Style.

TOTAL: 180p

Tema va fi trimisă folosind vmchecker, cursul Programarea Calculatoarelor (CB & CD).
Găsiți checker-ul aici.

Formatul arhivei va fi următorul:

1. fișier(ele) .c (și fișiere .h - dacă este cazul).
2. Un fișier Makefile (detalii aici) care să conțină următoarele reguli:
   1. build: creează executabilul aferent (numele executabilului: format_text)
   2. run: rulează executabilul aferent
   3. clean: șterge fișierele obiect/executabile create.
3. Un fișier README în care vă descrieți rezolvarea temei.

• Nu folosiți variabile globale.
• Fiți consistenți în ceea ce privește Coding Style-ul.
• Nu este nevoie să folosiți alocare dinamică.
• Fișierele obținute nu trebuie să conțină trailing whitespace (cu excepția situației în care aveți o operație invalidă). În urma unei operații goale (””), fișierul obținut va avea același conținut ca cel inițial, dar nu va conține trailing whitespace.

• o temă care nu compilează și nu a rulat pe vmchecker nu va fi luată în considerare
• o temă care nu rezolvă cerința și trece testele prin alte mijloace nu va fi luată în considerare
• [-1.0]: warning-uri la compilare (este obligatorie folosirea în fișierul Makefile a flag-ului de compilare -Wall pentru regula build)
• [-1.0]: numele variabilelor nu sunt sugestive
• [-1.0]: linii mai lungi de 80 de caractere
• [-1.0]: cod nemodular, funcții prea lungi (inclusiv main)
• [-5.0]: abordare ineficientă
  • în cadrul cursului de programare nu avem ca obiectiv rezolvarea în cel mai eficient mod posibil a programelor; totuși, ne dorim ca abordarea să nu fie una ineficientă, de genul să nu folosiți instrucțiuni repetitive acolo unde clar era cazul, etc.

• Typographic alignment
• Line wrap and word wrap
• Biblioteca string.h