Biblioteca de funções

Funções de entrada e saída

Funções que realizam a interação com o usuário, seja lendo valores digitados ou arquivos, seja mostrando valores na tela.

alerta(*args)

Similar à função mostrar, mas mostra a mensagem resultante em uma

caixa de diálogo.

Notes

Também pode ser chamada como alerte ou alertar

ler_arquivo(arquivo=None)

Lê conteúdo de um arquivo texto e retorna uma string de texto.

Notes

Também pode ser chamada como leia_arquivo, leia_ficheiro ou ler_ficheiro

Examples

>>> dados = ler_arquivo("foo.txt")

ler_número(mensagem='')

Pede ao usuário uma entrada numérica.

Notes

Também pode ser chamada como leia_número

Examples

>>> x = ler_número('Um número: ')  # usuário digita um 2...
>>> x + 40
42

ler_texto(mensagem='')

Pede ao usuário uma entrada de texto.

Notes

Também pode ser chamada como leia_texto

Examples

>>> nome = ler_texto('Seu nome: ')
>>> mostrar("olá, " + nome)  # usuário digita "maria"
olá, maria

mostrar(*args)

Mostra o objeto ou texto fornecido na tela.

Se for chamada com vários argumentos, imprime os mesmos em sequência, separando-os com um espaço.

Notes

Também pode ser chamada como mostre

Examples

>>> mostrar("Olá, mundo!")
Olá, mundo!

mostrar_formatado(texto, *args)

Mostra uma string de texto aplicando os argumentos de formatação

fornecidos

Notes

Também pode ser chamada como mostre_formatado, mostref ou mostrarf

pausar()

Interrompe a execução até o usuário apertar a tecla <enter>

Notes

Também pode ser chamada como pausa ou pause

salvar_em_arquivo(texto, arquivo=None)

Salva o conteúdo de texto no arquivo indicado, apagando qualquer conteúdo anterior.

CUIDADO! Caso o arquivo dado exista, esta função sobrescreverá seu conteúdo sem perguntar nada!

Notes

Também pode ser chamada como salve_em_arquivo, salvar_em_ficheiro ou salve_em_ficheiro

Examples

>>> salvar_em_arquivo(dados, "foo.txt")

Outras funções

Outras funções que não se encaixam em nenhuma categoria específica.

ajuda(*args)

Fornece ajuda sobre módulos, palavras chaves ou tôpicos do Pytuguês.

Pode ser chamada sem argumentos como ajuda() para uma ajuda geral sobre como utilizar o Pytuguês ou pode ser chamada com um argumento (como em ajuda(binário) para obter ajuda sobre um tópico específico.

binário(x)

Retorna a representação binária de um [inteiro/número inteiro].

Examples

>>> bin(2796202)
'0b1010101010101010101010'

booleano(x)

Retorna verdadeiro quando o argumento x é verdadeiro, falso em caso contrário.

Os booleanos podem ser usados como inteiros, sendo que falso equivale a 0 e verdadeiro equivale a 1.

Examples

>>> booleano(0)
Falso
>>> booleano(1)
Verdadeiro

caractere(x)

Retorna um texto Unicode associado a um ordinal (Unicode é um padrão de representãção de qualquer caractere de um sistema de escrita).

Examples

>>> caractere(227)
'ã'
>>> caractere(231)
'ç'
>>> caractere(224)
'à'

dicionário(dados, **kwds)

Retorna um dicionário a partir da sequẽncia de elementos (chave, valor).

Examples

>>> dicionário([(0, 'zero'), (1, 'um'), (2, 'dois')])
{0: 'zero', 1: 'um', 2: 'dois'}

dormir(intervalo)

Permanece sem fazer nada o intervalo de tempo fornecido (em segundos)

Notes

Também pode ser chamada como durma

enumerar(x)

Retorna uma enumeração.

Notes

Também pode ser chamada como enumere

Examples

>>> música = ['uni', 'duni', 'te']
>>> listar(enumerar(música))
[(0, 'uni'), (1, 'duni'), (2, 'te')]

hexadecimal(x)

Retorna a representação hexadecimal de um inteiro.

Examples

>>> hex(6745)
'0x1a59'

inteiro(x)

Converte um número ou texto num inteiro, ou retorna 0 se nenhum argumento for fornecido.

Examples

>>> int(4.3)
4
>>> int(44.6E-1)
4
>>> int()
0

lista(seq=None)

Cria uma lista a partir da sequência fornecida.

Se nenhuma sequência for fornecida, retorna uma lista vazia.

listar(seq)

Retorna uma lista com todos os elementos da sequência fornecida.

Notes

Também pode ser chamada como liste

Examples

>>> listar('olá')
['o', 'l', 'á']

listar_invertido(seq)

Lista os elementos da sequência fornecida na ordem inversa.

Notes

Também pode ser chamada como liste_invertido

Examples

>>> música = ['uni', 'duni', 'te']
>>> listar_invertido(música)
['te', 'duni', 'uni']

octal(x)

Retorna a representação octal de um inteiro.

Examples

>>> octal(22052015)
'0o124076257'

ordenado(seq, chave=None)

Retorna uma cópia da sequência fornecida com os elementos ordenados.

Examples

>>> sorted([5, 2, 3, 1, 4])
[1, 2, 3, 4, 5]

real(x)

Converte um texto ou número a um número de ponto flutuante.

Examples

>>> real(5)
5.0
>>> real(673.23)
673.23
>>> real("673.23")
673.23

sair(código_erro=0)

Termina a execução do programa fornecendo um código de erro ou código de saída.

Um código_erro=0 sinaliza que o programa terminou com sucesso. Qualquer outro número ou um texto representa falha

Notes

Também pode ser chamada como saia

tamanho(x)

Retorna o número de itens de uma sequência ou coleção.

Examples

>>> texto = "programando em python"
>>> tamanho(texto)
21

terminar()

Termina a execução do programa.

Semelhante à função sair(cod_erro), mas não requer a especificação de um código de erro

Notes

Também pode ser chamada como termine

texto(obj, codificacao=None)

Cria um novo texto a partir do objeto fornecido.

Examples

>>> texto(42)
"42"

tipo(x)

Retorna o tipo do objeto.

Examples

>>> tipo(2) == inteiro
Verdadeiro

tupla(x)

Retorna uma tupla com todos os elementos da sequência fornecida. Uma tupla se assemelha com uma lista, mas não pode ser modificada após criada.

Examples

>>> tupla([1, 2, 3])
(1, 2, 3)

Funções matemáticas

O pytuga fornece algumas funções matemáticas comuns para a conveniência do usuário.

aleatório()

Retorna um número aleatório no intervalo [0, 1]

algum(sequência)

Retorna Verdadeiro se algum dos objetos da sequência dada for verdadeiro e Falso caso contrário.

Examples

>>> algum([Verdadeiro, Verdadeiro])  # doctest: +SKIP
Verdadeiro
>>> algum([Verdadeiro, Falso])       # doctest: +SKIP
Falso

arredondar(x)

Arredonda o número x para o inteiro mais pŕoximo.

Notes

Também pode ser chamada como arredonde

Examples

>>> arredondar(1.6)
2
>>> arredondar(1.4)
1

cosseno(x)

Retorna o cosseno de x, onde x é medido em radianos.

Pode ser chamada na forma curta (cos) ou longa (cosseno).

Notes

Também pode ser chamada como cos

Examples

>>> cosseno(0)
1.0

exponencial(x)

Retorna a exponencial de x.

Pode ser chamada na forma curta (exp) ou longa (exponencial).

Notes

Também pode ser chamada como exp

Examples

>>> exponencial(1)
2.718281828459045

inteiro_aleatório(início, fim)

Retorna um inteiro aleatório dentro do intervalo [início, fim]

lançar_dado()

Retorna um número aleatório entre 1 e 6, como num lance de dados

comuns

Notes

Também pode ser chamada como lance_dados

log10(x)

Retorna o logarítimo de x na base 10.

Examples

>>> log10(10)
1.0

logarítimo(x)

Retorna o logarítimo natural de x.

Pode ser chamada na forma curta (log) ou longa (logarítimo).

Notes

Também pode ser chamada como log ou ln

Examples

>>> logarítimo(1)
0.0

máximo(lista)

Retorna o maior valor da lista dada.

Examples

>>> máximo([1, 5, 42, 0])
42

mínimo(lista)

Retorna o menor valor da lista dada.

Examples

>>> mínimo([1, 5, 42, 0])
0

módulo(x)

Retorna o módulo de x.

Examples

>>> módulo(-1)
1
>>> módulo(1)
1

produto(números)

Retorna o resultado do produto dos números dados.

Examples

>>> produto([1, 2, 3, 4, 5])
120

raiz(x)

Retorna a raiz quadrada de x.

Examples

>>> raiz(4)
2.0

seno(x)

Retorna o seno de x, onde x é medido em radianos.

Pode ser chamada na forma curta (sen) ou longa (seno).

Notes

Também pode ser chamada como sen

Examples

>>> seno(0)
0.0

sinal(x)

Retorna 1, -1 ou 0, dependendo do sinal de x.

Examples

>>> sinal(-32.0)
-1

soma(números)

Retorna o resultado da soma da sequência de números dada.

Examples

>>> soma([1, 2, 3, 4])
10

tangente(x)

Retorna a tangente de x, onde x é medido em radianos.

Pode ser chamada na forma curta (tan) ou longa (tangente).

Notes

Também pode ser chamada como tan ou tg

Examples

>>> tangente(0)
0.0

todos(sequência)

Retorna Verdadeiro se todos os objetos da sequência dada forem verdadeiros e Falso caso contrário.

Examples

>>> todos([Verdadeiro, Verdadeiro])  # doctest: +SKIP
Verdadeiro
>>> todos([Verdadeiro, Falso])       # doctest: +SKIP
Falso

truncar(x)

Remove a parte decimal do número.

Notes

Também pode ser chamada como trunque

Examples

>>> truncar(1.6)
1
>>> truncar(1.4)
1

Textos (strings)

Funções para processamento de texto.

concatenar(*args)

Converte os argumentos para texto e concatena o resultado

Notes

Também pode ser chamada como concatene

Examples

>>> concatenar('x = ', 2)
'x = 2'

concatenar_lista(lista)

Converte os argumentos da lista em texto e concatena o resultado.

Notes

Também pode ser chamada como concatene_lista

Examples

>>> concatenar_lista(['a', 'b', 'c', 1, 2, 3])
'abc123'

formatar(texto, *args, **kwds)

Formata o texto inserindo os parâmetros dados nas posições coringa.

Existem duas sintaxes diferentes para a formatação de texto. A primeira, baseada em C, utiliza o símbolo %s, %f, %d, etc para delimitar os pontos de inserção por posição.

>>> formatar('%i = %.2f', 42, 42)
'42 = 42.00'

A segunda usa esta sintaxe (explicar!)

>>> formatar('{0} = {1}', 42, 42)
'42 = 42'

Notes

Também pode ser chamada como formate

maiúsculas(texto)

Converte um texto para letras maiúsculas

Examples

>>> maiúsculas('olá, mundo!')
'OLÁ, MUNDO!'

minúsculas(texto)

Converte um texto para letras minúsculas

Examples

>>> minúsculas('OLÁ, MUNDO!')
'olá, mundo!'

substituir(texto, valor, substituição)

Substitui no texto todas as ocorrências de valor pela substituição dada.

Notes

Também pode ser chamada como substitua

Examples

>>> substituir('Olá, pessoal!', 'pessoal', 'mundo')
'Olá, mundo!'

unir_lista(separador, lista)

Semelhante à concatenar_lista(), mas une os valores pelo texto separador especificado

Notes

Também pode ser chamada como una_lista

Examples

>>> unir_lista(', ', [1, 2, 3])
'1, 2, 3'

unir_valores(separador, *args)

Semelhante à concatenar(), mas une os valores pelo texto separador especificado

Notes

Também pode ser chamada como una_valores

Examples

>>> unir_valores(', ', 1, 2, 3)
'1, 2, 3'