Biblioteca console.h

Biblioteca com funções para manipulação do console.

Características

• Linguagem: C e C++
• Compilador: MinGW (GCC)
• Autor: desconhecido
• Edição: David Gomesh

Sumário

• Funções
  • gotoxy()
  • textcolor()
  • backgroundcolor()
• Como usar
• Cores disponíveis
• Definição de COLORS
• Inclusões duplicadas
• Bibliotecas utilizadas
• Variáveis importantes
• Tipos importantes
• Exemplos

Funções

Função gotoxy

int gotoxy(DWORD x, DWORD y);

Funcionalidade: Aponta o cursor para determinada posição do console.

Retorno:

• 1: caso a função consiga apontar para posição indicada.
• 0: caso a função não consiga apontar para posição indicada.

Obs 1.: x representa colunas e y representa linhas.

Obs 2.: DWORD é o tipo unsigned long.

Obs 3.: As linhas e colunas devem ser contadas a partir de 1. A função automaticamente decrementará o número passado.

---

Função textcolor

void textcolor(int color);

Funcionalidade: Altera a cor a ser usado nos próximos textos.

Retorno: sem retorno.

Obs 1.: Pode-se passar um número inteiro de 0 a 15, ou usar os elementos da estrutura enum definida como COLORS.

Veja a estrutura COLORS

---

Função backgroundcolor

void backgroundcolor(int color);

Funcionalidade: Altera a cor do fundo a ser usado nos próximos textos.

Retorno: sem retorno.

Obs 1.: Pode-se passar um número inteiro de 0 a 15, ou usar os elementos da estrutura enum definida como COLORS.

Veja a estrutura COLORS

Como usar a biblioteca

1. coloque o arquivo console.h na pasta do projeto.
2. faça a inclusão da biblioteca console.h no projeto:

//Incluindo a biblioteca
#include "console.h"

int main(){
  return 0;
}

Feito isso, as funções estão prontas para uso.

Cores disponíveis

Cor	Valor decimal	Valor hexadecimal	Disponível como	Visualização
Preto	0	0	BLACK
Azul	1	1	BLUE
Verde	2	2	GREEN
Verde-água	3	3	CYAN
Vermelho	4	4	RED
Roxo	5	5	MAGENTA
Amarelo	6	6	BROWN
Branco	7	7	LIGHTGRAY
Cinza	8	8	DARKGRAY
Azul claro	9	9	LIGHTBLUE
Verde claro	10	A	LIGHTGREEN
Verde-água claro	11	B	LIGHTCYAN
Vermelho claro	12	C	LIGHTRED
Lilás	13	D	LIGHTMAGENTA
Amarelo claro	14	E	YELLOW
Branco brilhante	15	F	WHITE

Definição de COLORS

typedef enum{
    BLACK,
    BLUE,
    GREEN,
    CYAN,
    RED,
    MAGENTA,
    BROWN,
    LIGHTGRAY,
    DARKGRAY,
    LIGHTBLUE,
    LIGHTGREEN,
    LIGHTCYAN,
    LIGHTRED,
    LIGHTMAGENTA,
    YELLOW,
    WHITE
} COLORS;

Inclusões duplicadas

A fim de evitar inclusões duplicadas, foram adicionadas as seguintes condições:

#ifndef CONSOLE_H_INCLUDED
#define CONSOLE_H_INCLUDED

/*
    Implementação
*/

#endif /* CONSOLE_H_INCLUDED */

Bibliotecas utilizadas

• windows.h

Variáveis importantes

• __BACKGROUND: guarda a cor de fundo;
• __FOREGROUND: guarda a cor do texto;

Tipos importantes

• DWORD: unsigned long.
• COLORS: enum.

Exemplos

Usando a textcolor e backgroundcolor

Exemplo de código usando as funções textcolor() e backgroundcolor()

A saída será com as cores que foram informadas

Usando a gotoxy

Exemplo de código usando a função gotoxy()

A saída será nas posições que foram informadas