{{indexmenu_n>4}}
======== HW 04 - Hledání textu v souborech ========

^ Termín odevzdání | <wrap important>  24.03.2018 23:59 PDT</wrap> (([[https://www.timeanddate.com/time/zones/pst|PDT]]))|
^ Povinné zadání |  2b |
^ Volitelné zadání |  <wrap tip>3b</wrap>|
^ Bonusové zadání |  není |
^ Počet uploadů |  20 | 

===== Povinné zadání =====

<wrap alert>Bez použití knihovny <string.h></wrap> (nebo podobné) napište program, který ze zadaného souboru vypíše všechny řádky obsahující zadaný řetězec. Budete tak implementovat zjednodušenou verzi programu grep pro příkazový řádek, který je dostupný ve většině operačních systémů Unixového typu.

Program bude volán ve tvaru:
<code>./program PATTERN FILE</code>
kde PATTERN je hledaný řetězec, FILE název souboru.

V případě jakékoli chyby vypište smysluplný důvod chyby na standardní chybový výstup a program bude ukončen s nenulovou návratovou hodnotou.

Program implementujte v souboru grep.c

Pro rozpoznání konce řádku je možné používat znak '\n'.

<wrap important>V případě prázdeného výstupu ukončete program s návratovou hodnotou **1**.</wrap>

/*
Příklad možných situací k ošetření:
     * Vstupní argumenty nejsou zadány.
     * Vstupní soubor neexistuje nebo nejde načíst.
     * Při čtení se vyskytla chyba např. čtení se nezdařilo nebo dynamická alokace paměti selhala. 

*/

==== Příklad 1 ====

První příklad je motivován praktickou ukázkou, jak v Ubuntu zjistit velikost volné operační paměti z příkazové řádky.

<code>grep MemFr /proc/meminfo</code>
<code>./program MemFr /proc/meminfo</code>

^  Obsah vstupního souboru  ^  Řetězec PATTERN  ^  Očekávaný výstup  ^  Očekávaný chybový výstup  ^  Návratová hodnota  ^
| <code>
MemTotal:       16430396 kB
MemFree:         4848016 kB
MemAvailable:   11697864 kB
Buffers:         1139932 kB
Cached:          5662728 kB
...
</code> | <code>
MemFr
</code> | <code>
MemFree:         4848016 kB
</code> |  žádný  |  0  |

==== Příklad 2 ====

Prázdný výstup
<code>grep NeexistujiciText /proc/meminfo</code>

^  Obsah vstupního souboru  ^  Řetězec PATTERN  ^  Očekávaný výstup  ^  Očekávaný chybový výstup  ^  Návratová hodnota  ^
| <code>
MemTotal:       16430396 kB
MemFree:         4848016 kB
MemAvailable:   11697864 kB
Buffers:         1139932 kB
Cached:          5662728 kB
...
</code> | <code>
NeexistujiciText
</code> |  žádný  |  žádný  |  1  |


===== Volitelné zadání =====

Ve volitelné části můžete přidat tři různé funkcionality, za které můžete získat body. Počet argumentů tedy již nebude konstantní a program bude volán ve tvaru:
<code>./program [OPTIONS] PATTERN [FILE]</code>
kde PATTERN je hledaný řetězec, FILE název souboru a OPTIONS jsou volitelné argumenty pro volitelné zadání.

==== A - Přesměrování na standartní vstup (0.5b) ====

Pokud nebude zadán argument volitelný argument FILE, bude jako vstup použit **stdin**. Díky tomu je možné přesměrovat výstup jiného programu a filtrovat tak jeho výstup.

<code>dmesg | grep dvd</code>

Příklad výstupu:
<code>
[    2.653604] sr 5:0:0:0: [sr0] scsi3-mmc drive: 48x/48x writer dvd-ram cd/rw xa/form2 cdda tray
</code>

==== B - Regulární výrazy (1b) ====

Pouze speciální symboly [*,+,?] bez závorkování. Speciální symbol se vyskytuje maximálně jednou.

<code>./program -E PATTERN [FILE]</code>

[[https://en.wikipedia.org/wiki/Regular_expression|Regulární výrazy]]

=== Příklad 2 ===

^  Obsah vstupního souboru  ^  Řetězec 'colou?r'  ^  Řetězec 'colou*r'  ^  Řetězec 'colou+r'  ^
| <code>
color
colour
colouur
colouuur
</code> | <code>
color
colour
</code> | <code>
color
colour
colouur
colouuur
</code> | <code>
colour
colouur
colouuur
</code> |

==== C - Obarvení výstupu (1.5b) ====

Obarvení PATTERN ve výstupu červenou barvou, stejně jako originální grep. Text je možné obarvit v terminálu pomocí přidání přesné sekvence znaku (Escape sequence) před a za obarvovaný text, viz. [[https://en.wikipedia.org/wiki/ANSI_escape_code|ANSI escape code]].  Tato funkcionalita se zapíná následujícím přepínačem:

<code>./program --color=always PATTERN [FILE]</code>

Používejte prosím stejné escape sekvence jako systémový grep, aby bylo možné výstup jednoduše zkontrolovat. 

^ ^ Před obarvený test ^ Za obarvený text ^
| Textový zápis| ESC[01;31m + ESC[K | ESC[m + ESC[K |
| Hexadecimální zápis | 1b 5b 30 31 3b 33 31 6d  + 1b 5b 4b | 1b 5b 6d + 1b 5b 4b  | 

=== Příklad pub05-C ===

^  Obsah vstupního souboru  ^  Řetězec PATTERN  ^  Očekávaný výstup  ^  Očekávaný výstup (hexdump -C)  ^ 
| <code>
Hello, hello
Bye
</code> | <code>
el
</code> |  H<fc #FF0000>el</fc>lo, h<fc #FF0000>el</fc>lo  | <code>
00000000  48 1b 5b 30 31 3b 33 31  6d 1b 5b 4b 65 6c 1b 5b  |H.[01;31m.[Kel.[|
00000010  6d 1b 5b 4b 6c 6f 2c 20  68 1b 5b 30 31 3b 33 31  |m.[Klo, h.[01;31|
00000020  6d 1b 5b 4b 65 6c 1b 5b  6d 1b 5b 4b 6c 6f 0a     |m.[Kel.[m.[Klo.|
0000002f
</code>  |


====== Odevzdání ======

Veřejné příklady + Makefile: {{:courses:b3b36prg:hw:prg-hw04.zip}}

^  ^  Povinné zadání  ^  Volitelné zadání  |
^ Název v BRUTE |  HW04  ||
^ Odevzdávané soubory |  grep.c  ||
^ Argumenty při spuštění |  žádné  |  --color=always -E  | 
^ Kompilace pomocí |  clang -pedantic -Wall -Werror -std=c99  ||
^ Očekávaná časová složitost ((Kde $n$ je velikost vstupního souboru.)) |  $\mathcal{O}(n)$  |  $\mathcal{O}(n^2)$ ((Složitost je dána použitím reulárních výrazů, jinak $\mathcal{O}(n)$. ))  |

/* Toť otázka - motivací bylo přepoužít zajímavé zadání
^ Procvičované oblasti |    |   |
*/