hdoc/README.md
2025-06-19 12:29:07 -03:00

48 lines
1.2 KiB
Markdown

# hdoc
Emula um dos usos do mecanismo de "here doc" (didático). Equivale à linhas de comando como:
```
here document
cat << END > arquivo
```
Mas...
- Não utiliza uma palavra de término (termina com `Ctrl+D`);
- Por padrão, escreve apenas em novos arquivos (termina com erro se o arquivo existir);
- Com opções, a sobrescrita ou o *append* de arquivos existentes pode ser forçada.
## Como utilizar
```
Here Document (hdoc) 0.1
Uso: hdoc [OPÇÕES] ARQUIVO
Sem OPÇÕES, cria um novo ARQUIVO para receber linhas
digitadas no terminal.
OPÇÕES:
-o Força abertura de ARQUIVO para sobrescrevê-lo.
-a Força abertura de ARQUIVO para append.
-h Exibe esta ajuda.
```
## Como compilar
No diretório da sua escolha...
```
:~$ git clone https://bolha.dev/blau_araujo/hdoc.git
:~$ cd hdoc
:~/hdoc$ gcc -Wall -Wextra hdoc.c messages.c -o hdoc
```
O executável (`hdoc`) pode ser movido ou linkado para um diretório pessoal de executáveis ou para `/usr/local/bin`.
## Importante!
Este programa é apenas um exemplo didático para as pessoas que estão aprendendo C com o [Curso Básico da Linguagem C](https://www.youtube.com/playlist?list=PLXoSGejyuQGrDX08GVrQHAhh4j3KJ4iYN): use por sua conta e risco!