Pular para o conteúdo principal

utilidades

Fonte: docs/exemplos/utilidades.c.

// utilidades.c — catalogo das funcoes e tipos de conveniencia da biblioteca.
// Perfil: M0 (macros).
// Compilar a partir da raiz: make exemplos
//
// Serve como folha de referencia executavel: cada bloco imprime o resultado de
// um grupo de funcoes. Os valores sao fixos, entao a saida e reproduzivel.
#include <basicgol.h>

CONSTANTE REAL k_pi = 3.14159265358979;
CONSTANTE INTEIRO k_amostras = 5;

// EXTERNO declara um simbolo definido mais adiante (ou em outra unidade).
EXTERNO INTEIRO contador_global;
INTEIRO contador_global = 7;

// Funcao privada deste arquivo (ESTATICO) que nao devolve nada (VAZIO).
ESTATICO FUNCAO VAZIO linha(char preenchimento) {
INTEIRO i = 0;
PARA (i, 1, 30) {
ESCREVA(preenchimento);
}
ESCREVA_LINHA();
}

PROCEDIMENTO mostra_tipos(void) {
CARACTERE letra = 'B';
LOGICO ok = VERDADEIRO;
INTEIRO8 pequeno = 100;
INTEIRO16 medio = 30000;
INTEIRO32 exato = 2000000000;
INTEIRO64 grande = 9000000000;
INTEIRO_CURTO curto = 12;
INTEIRO_LONGO longo = 1234567890L;
NATURAL natural = 60000u;
NATURAL8 byte = 250u;
NATURAL16 meio = 65000u;
NATURAL32 sem_sinal = 4000000000u;
NATURAL64 enorme = 18000000000000000000ull;
REAL_CURTO aproximado = 1.5f;
REAL_LONGO preciso = 2.5L;

ESCREVA("CARACTERE: "); ESCREVAL(letra);
ESCREVA("LOGICO: "); ESCREVAL(ok);
ESCREVA("INTEIRO8: "); ESCREVAL(pequeno);
ESCREVA("INTEIRO16: "); ESCREVAL(medio);
ESCREVA("INTEIRO32: "); ESCREVAL(exato);
ESCREVA("CURTO: "); ESCREVAL(curto);
ESCREVA("LONGO: "); ESCREVAL(longo);
ESCREVA("INTEIRO64: "); ESCREVAL(grande);
ESCREVA("NATURAL: "); ESCREVAL(natural);
ESCREVA("NATURAL8: "); ESCREVAL(byte);
ESCREVA("NATURAL16: "); ESCREVAL(meio);
ESCREVA("NATURAL32: "); ESCREVAL(sem_sinal);
ESCREVA("NATURAL64: "); ESCREVAL(enorme);
ESCREVA("REAL_CURTO:"); ESCREVAL(aproximado);
ESCREVA("REAL_LONGO:"); ESCREVAL(preciso);
}

PROCEDIMENTO mostra_matematica(void) {
ESCREVA("ABS(-7) = "); ESCREVAL(ABS(-7));
ESCREVA("MINIMO(3, 9) = "); ESCREVAL(MINIMO(3, 9));
ESCREVA("MAXIMO(3, 9) = "); ESCREVAL(MAXIMO(3, 9));
ESCREVA("POTENCIA(2, 10) = "); ESCREVAL(POTENCIA(2, 10));
ESCREVA("RAIZ(144) = "); ESCREVAL(RAIZ(144.0));
ESCREVA("ARREDONDA(2.6) = "); ESCREVAL(ARREDONDA(2.6));
ESCREVA("PISO(2.9) = "); ESCREVAL(PISO(2.9));
ESCREVA("TETO(2.1) = "); ESCREVAL(TETO(2.1));
ESCREVA("MOD: 17 MOD 5 = "); ESCREVAL(17 MOD 5);
ESCREVA("IGUAL(4, 4) = "); ESCREVAL(IGUAL(4, 4));
ESCREVA("DIFERENTE(4, 5) = "); ESCREVAL(DIFERENTE(4, 5));

// ABS, MINIMO e MAXIMO encaminham para funcoes C escolhidas por _Generic:
// o argumento e avaliado uma unica vez (P-11), ao contrario de uma macro
// ingenua do tipo "((x) < 0 ? -(x) : (x))".
}

PROCEDIMENTO mostra_texto(void) {
TEXTO_FIXO(junto, 40);
TEXTO_FIXO(copia, 40);
LOGICO coube = FALSO;

ESCREVA("TAMANHO_TEXTO(\"BASICGOL\") = ");
ESCREVAL(TAMANHO_TEXTO("BASICGOL"));

ESCREVA("TEXTOS_IGUAIS(\"abc\", \"abc\") = ");
ESCREVAL(TEXTOS_IGUAIS("abc", "abc"));

ESCREVA("TEXTOS_DIFERENTES(\"abc\", \"abd\") = ");
ESCREVAL(TEXTOS_DIFERENTES("abc", "abd"));

coube = COPIA_TEXTO(copia, (INTEIRO) sizeof copia, "BASIC");
ESCREVA("COPIA_TEXTO coube? "); ESCREVAL(coube);

coube = JUNTA_TEXTO(junto, (INTEIRO) sizeof junto, copia, "GOL");
ESCREVA("JUNTA_TEXTO coube? "); ESCREVA(coube); ESCREVA(" -> "); ESCREVAL(junto);

// Truncamento tem que ser reportado, nunca silencioso (RB-3).
TEXTO_FIXO(apertado, 4);
coube = JUNTA_TEXTO(apertado, (INTEIRO) sizeof apertado, "BASIC", "GOL");
ESCREVA("JUNTA_TEXTO em buffer pequeno coube? ");
ESCREVAL(coube);
}

PROCEDIMENTO mostra_enumeracao(void) {
ENUMERACAO(Conceito)
CONCEITO_A = 10,
CONCEITO_B,
CONCEITO_C
FIM_ENUMERACAO(Conceito);

Conceito c = CONCEITO_B;
// enumeração é um tipo do usuário: o despacho de ESCREVA (_Generic) não
// cobre tipos definidos pelo usuário — converta para INTEIRO ao imprimir.
ESCREVA("CONCEITO_B vale ");
ESCREVAL((INTEIRO) c);

ESCOLHA (c)
CASO CONCEITO_A:
ESCREVAL("conceito A");
PARE;
CASO CONCEITO_B:
ESCREVAL("conceito B");
PARE;
CONTRARIO:
ESCREVAL("outro conceito");
FIM_ESCOLHA
}

PROCEDIMENTO mostra_conversoes(void) {
INTEIRO valor = 0;
REAL real = 0.0;

SE TEXTO_PARA_INTEIRO("42", &valor) ENTAO
ESCREVA("TEXTO_PARA_INTEIRO(\"42\") = ");
ESCREVAL(valor);
FIM_SE

SE NAO TEXTO_PARA_INTEIRO("4x2", &valor) ENTAO
ESCREVAL("TEXTO_PARA_INTEIRO rejeitou \"4x2\" (correto)");
FIM_SE

SE TEXTO_PARA_REAL("2.75", &real) ENTAO
ESCREVA("TEXTO_PARA_REAL(\"2.75\") = ");
ESCREVAL(real);
FIM_SE

// AFIRME verifica contratos internos; nao e para validar entrada do usuario.
AFIRME(k_amostras > 0, "k_amostras deve ser positiva");
ESCREVAL("AFIRME passou: contrato interno satisfeito.");

// ESCREVA_ERRO escreve em stderr, sem quebrar a linha de saida normal.
ESCREVA_ERRO("(esta linha vai para stderr)\n");
}

INICIO
linha('=');
ESCREVAL("TIPOS");
linha('-');
mostra_tipos();

linha('=');
ESCREVAL("MATEMATICA");
linha('-');
mostra_matematica();

linha('=');
ESCREVAL("TEXTO");
linha('-');
mostra_texto();

linha('=');
ESCREVAL("ENUMERACAO");
linha('-');
mostra_enumeracao();

linha('=');
ESCREVAL("CONVERSOES E CONTRATOS");
linha('-');
mostra_conversoes();

linha('=');
ESCREVA("pi = ");
ESCREVA_FMT("%.5f", k_pi);
ESCREVA(" contador_global (EXTERNO) = ");
ESCREVAL(contador_global);
ESCREVA_LINHA();
FIM

utilidades.esperado.txt​

==============================
TIPOS
------------------------------
CARACTERE: B
LOGICO: 1
INTEIRO8: 100
INTEIRO16: 30000
INTEIRO32: 2000000000
CURTO: 12
LONGO: 1234567890
INTEIRO64: 9000000000
NATURAL: 60000
NATURAL8: 250
NATURAL16: 65000
NATURAL32: 4000000000
NATURAL64: 18000000000000000000
REAL_CURTO:1.5
REAL_LONGO:2.5
==============================
MATEMATICA
------------------------------
ABS(-7) = 7
MINIMO(3, 9) = 3
MAXIMO(3, 9) = 9
POTENCIA(2, 10) = 1024
RAIZ(144) = 12
ARREDONDA(2.6) = 3
PISO(2.9) = 2
TETO(2.1) = 3
MOD: 17 MOD 5 = 2
IGUAL(4, 4) = 1
DIFERENTE(4, 5) = 1
==============================
TEXTO
------------------------------
TAMANHO_TEXTO("BASICGOL") = 8
TEXTOS_IGUAIS("abc", "abc") = 1
TEXTOS_DIFERENTES("abc", "abd") = 1
COPIA_TEXTO coube? 1
JUNTA_TEXTO coube? 1 -> BASICGOL
JUNTA_TEXTO em buffer pequeno coube? 0
==============================
ENUMERACAO
------------------------------
CONCEITO_B vale 11
conceito B
==============================
CONVERSOES E CONTRATOS
------------------------------
TEXTO_PARA_INTEIRO("42") = 42
TEXTO_PARA_INTEIRO rejeitou "4x2" (correto)
TEXTO_PARA_REAL("2.75") = 2.75
AFIRME passou: contrato interno satisfeito.
==============================
pi = 3.14159 contador_global (EXTERNO) = 7

utilidades.esperado_stderr.txt​

(esta linha vai para stderr)

Referência relacionada​

Nenhum símbolo inventariado.

Perguntas frequentes​

Perguntas frequentes sobre o exemplo utilidades, seu build e sua saída.

Como compilar e executar utilidades?​

O exemplo é um .c comum que inclui basicgol.h; o Makefile também compila a coleção com make exemplos.

cc -std=c11 -Wall -Wextra -Wformat=2 -I include docs/exemplos/utilidades.c \
build/libbasicgol.a -lm -o utilidades
./utilidades

Que saída este exemplo produz?​

Saída dourada versionada em docs/exemplos/utilidades.esperado.txt:

==============================
TIPOS
------------------------------
CARACTERE: B
LOGICO: 1
INTEIRO8: 100
INTEIRO16: 30000
INTEIRO32: 2000000000
CURTO: 12
LONGO: 1234567890
INTEIRO64: 9000000000
NATURAL: 60000
NATURAL8: 250
NATURAL16: 65000
NATURAL32: 4000000000
NATURAL64: 18000000000000000000
REAL_CURTO:1.5
REAL_LONGO:2.5
==============================
MATEMATICA
------------------------------
ABS(-7) = 7
MINIMO(3, 9) = 3
MAXIMO(3, 9) = 9
POTENCIA(2, 10) = 1024
RAIZ(144) = 12
ARREDONDA(2.6) = 3
PISO(2.9) = 2
TETO(2.1) = 3
MOD: 17 MOD 5 = 2
IGUAL(4, 4) = 1
DIFERENTE(4, 5) = 1
==============================
TEXTO
------------------------------
TAMANHO_TEXTO("BASICGOL") = 8
TEXTOS_IGUAIS("abc", "abc") = 1
TEXTOS_DIFERENTES("abc", "abd") = 1
COPIA_TEXTO coube? 1
JUNTA_TEXTO coube? 1 -> BASICGOL
JUNTA_TEXTO em buffer pequeno coube? 0
==============================
ENUMERACAO
------------------------------
CONCEITO_B vale 11
conceito B
==============================
CONVERSOES E CONTRATOS
------------------------------
TEXTO_PARA_INTEIRO("42") = 42
TEXTO_PARA_INTEIRO rejeitou "4x2" (correto)
TEXTO_PARA_REAL("2.75") = 2.75
AFIRME passou: contrato interno satisfeito.
==============================
pi = 3.14159 contador_global (EXTERNO) = 7

O exemplo precisa de entrada?​

Não há arquivo de entrada versionado; o exemplo não lê stdin para produzir o resultado dourado.

O exemplo é coberto pela suíte?​

Os exemplos são compilados por make exemplos e o bloco 10_exemplos de tests/run.sh confere os resultados dourados quando existem.