Conversões de Bases

Documentação das funções do módulo codigos.bases relacionadas à conversão de bases.

Documentação

As funções listadas abaixo implementam conversões entre bases numéricas (binário/decimal/hexadecimal). Todas seguem a convenção de entradas simples (strings para representações binárias/hexadecimais e inteiros para conversões de decimal) e levantam exceções quando aplicável.

Módulo para conversões entre sistemas de numeração.

Este módulo implementa funções para conversão entre diferentes bases numéricas: binário, decimal e hexadecimal.

Author: Pedro Henrique Rocha de Andrade Date: Dezembro 2025

codigos.bases.binario_para_decimal(string_binaria)[código-fonte]

Converte uma string binária para inteiro decimal.

Parâmetros:

string_binaria (str) – Representação binária (ex.: '1011').

Retorna:

Valor decimal correspondente.

Tipo de retorno:

int

codigos.bases.decimal_para_binario(numero_decimal)[código-fonte]

Converte um inteiro decimal para sua representação binária em string.

Parâmetros:

numero_decimal (int) – Número decimal não-negativo.

Retorna:

  • str – Representação binária (ex.: '1011').

  • Exemplos

  • ——–

  • >>> decimal_para_binario(11)

  • ’1011’

codigos.bases.decimal_para_hexadecimal(numero_decimal)[código-fonte]

Converte um inteiro decimal para representação hexadecimal (maiúscula).

Parâmetros:

numero_decimal (int) – Número decimal não-negativo.

Retorna:

  • str – Representação hexadecimal (ex.: 'FE').

  • Exemplos

  • ——–

  • >>> decimal_para_hexadecimal(254)

  • ’FE’

codigos.bases.hexadecimal_para_decimal(string_hexadecimal)[código-fonte]

Converte uma string hexadecimal (base 16) para inteiro decimal.

Parâmetros:

string_hexadecimal (str) – Representação hexadecimal (ex.: 'FE').

Retorna:

  • int – Valor decimal correspondente.

  • Exemplos

  • ——–

  • >>> hexadecimal_para_decimal(‘FE’)

  • 254

codigos.bases.binario_para_hexadecimal(string_binaria)[código-fonte]

Converte uma string binária para representação hexadecimal.

Parâmetros:

string_binaria (str) – Representação binária.

Retorna:

  • str – Representação hexadecimal em maiúsculas.

  • Exemplos

  • ——–

  • >>> binario_para_hexadecimal(‘1111’)

  • ’F’

codigos.bases.hexadecimal_para_binario(string_hexadecimal)[código-fonte]

Converte uma string hexadecimal para representação binária.

Parâmetros:

string_hexadecimal (str) – Representação hexadecimal (ex.: 'F').

Retorna:

  • str – Representação binária (ex.: '1111').

  • Exemplos

  • ——–

  • >>> hexadecimal_para_binario(‘F’)

  • ’1111’

Exemplo de Uso

1"""Exemplo: uso das conversões de bases em codigos.bases"""
2from codigos import bases
3
4if __name__ == '__main__':
5    print('1011 ->', bases.binario_para_decimal('1011'))
6    print('11 ->', bases.decimal_para_binario(11))
7    print('254 ->', bases.decimal_para_hexadecimal(254))
8    print('FE ->', bases.hexadecimal_para_decimal('FE'))

Testes de Integração

Coberto pelos seguintes testes:

  • Teste global: pytest -q (roda todos os testes do projeto)

  • Teste de calcnum: pytest tests/test_inputs_calcnum.py::test_calcnum_inputs_basic -q (valida integração via menu principal)

  • Teste individual: pytest tests/test_bases.py -v (testes específicos do módulo)

Teste correspondente: tests/inputs/inputBases.txt

Testes Unitários

Testes: test_bases