Portugol Bibliotecas

Bibliotecas
Arquivos Esta biblioteca permite ler e escrever arquivos
Calendario Esta biblioteca é utilizada para retornar a data e(ou) hora do computador
Graficos Esta biblioteca permite inicializar e utilizar um ambiente gráfico com suporte ao desenho de
primitivas gráficas e de imagens carregadas do sistema de arquivos
Internet Esta biblioteca contém diversas funções de conexão com a web
Matematica Esta biblioteca contém uma série das funções matemáticas mais comuns
Mouse Esta biblioteca contém um conjunto de funções para manipular a entrada de dados através do
mouse do computador
IMPORTANTE: Esta biblioteca não funciona no console de entrada e saída de
dados do Portugol Studio, ela só funciona com a biblioteca Graficos, se o modo gráfico estiver
iniciado.
Objetos Esta biblioteca contém uma série de funções para criar e trabalhar com objetos
ServicosWeb Esta biblioteca contém uma série de funções para trabalhar com serviços web
Sons Esta biblioteca contém funções que permitem reproduzir sons dentro de um programa. No
momento, somente o formato MP3 é suportado.
Teclado Esta biblioteca contém um conjunto de funções para manipular a entrada de dados através do
teclado do computador
IMPORTANTE: Esta biblioteca não funciona no console de entrada e saída de
dados do Portugol Studio, ela só funciona com a biblioteca Graficos, se o modo gráfico estiver
iniciado.
Texto Esta biblioteca contém funções para manipulação de texto (dados do tipo cadeia)
Tipos Esta biblioteca contém funções que permitem converter os tipos de dado do Portugol entre si
Util Esta biblioteca contém diversas funções utilitárias
Arquivos
Esta biblioteca permite ler e escrever arquivos
Constantes:
inteiro MODO_LEITURA: indica à biblioteca que o arquivo deve ser aberto apenas para leitura
inteiro MODO_ESCRITA: indica à biblioteca que o arquivo deve ser aberto apenas para escrita
inteiro MODO_ACRESCENTAR: indica à biblioteca que o arquivo deve ser aberto apenas para
escrita que acrescenta ao final do arquivo
Índice das Funções:
funcao vazio listar_arquivos_por_tipo(cadeia caminho_pai, cadeia

vetor_arquivos[], cadeia vetor_tipos[])
funcao inteiro abrir_arquivo(cadeia caminho_arquivo, inteiro

modo_acesso)
funcao logico fim_arquivo(inteiro endereco)
funcao vazio substituir_texto(cadeia endereco, cadeia texto_pesquisa,

cadeia texto_substituto, logico primeira_ocorrencia)
funcao vazio escrever_linha(cadeia linha, inteiro endereco)
funcao vazio fechar_arquivo(inteiro endereco)
funcao cadeia ler_linha(inteiro endereco)
funcao logico arquivo_existe(cadeia caminho_arquivo)
funcao cadeia selecionar_arquivo(cadeia formatos_suportados[], logico

aceitar_todos_arquivos)
funcao vazio listar_pastas(cadeia caminho_pai, cadeia vetor_pastas[])
funcao vazio apagar_arquivo(cadeia caminho_arquivo)
funcao vazio listar_arquivos(cadeia caminho_pai, cadeia

vetor_arquivos[])
funcao vazio criar_pasta(cadeia caminho)
Detalhamento das Funções:
listar_arquivos_por_tipo
funcao vazio listar_arquivos_por_tipo(cadeia caminho_pai, cadeia
vetor_arquivos[], cadeia vetor_tipos[])
Altera um vetor para que ele represente os arquivos existentes em um diretório
Parâmetros:
caminho_pai - Define o diretório cujas pastas serão listadas
vetor_arquivos - Vetor destino que contará com as pastas encontradas
vetor_tipos - Vetor destino que contará com as pastas encontradas
abrir_arquivo
funcao inteiro abrir_arquivo(cadeia caminho_arquivo, inteiro
modo_acesso)
Abre um arquivo para leitura ou escrita. No modo leitura, caso o arquivo informado não exista,
será gerado um erro. No modo escrita, caso o arquivo informado não exista, ele tentará ser criado,
se a criação do arquivo falhar, então será gerado um erro.
IMPORTANTE: ao abrir o arquivo no modo de escrita, o conteúdo do arquivo é apagado para

que o novo conteúdo seja escrito. Caso seja necessário manter o conteúdo atual do arquivo, deve-
se armazená-lo em uma variável e depois escrevê-lo novamente no arquivo.
Parâmetros:
caminho_arquivo - o nome do arquivo que se quer abrir
modo_acesso - determina se o arquivo será aberto para leitura ou para escrita.
Constantes aceitas: MODO_LEITURA | MODO_ESCRITA | MODO_ACRESCENTAR
Retorna: o endereço de memória onde o arquivo foi carregado
fim_arquivo
funcao logico fim_arquivo(inteiro endereco)
Verifica se o arquivo chegou ao fim, isto é, se todas as linhas já foram lidas. Esta função só é
executada se o arquivo estiver aberto em modo de leitura. Se o arquivo estiver em modo de
escrita, será gerado um erro.
Parâmetros:
endereco - o endereço de memória do arquivo
Retorna: verdadeiro se o arquivo tiver chegado ao fim. Caso contrário retorna falso
substituir_texto
funcao vazio substituir_texto(cadeia endereco, cadeia texto_pesquisa,
cadeia texto_substituto, logico primeira_ocorrencia)
Pesquisa por um determinado texto no arquivo e substitui todas as ocorrências por um texto
alternativo
Parâmetros:
endereco - o endereço do arquivo
texto_pesquisa - o texto que será pesquisado no arquivo
texto_substituto - o texto pelo qual as ocorrências serão substituídas
primeira_ocorrencia - confirma se substituirá apenas a primeira ocorrência no texto, caso
contrário, substituirá todas
escrever_linha
funcao vazio escrever_linha(cadeia linha, inteiro endereco)
Escreve uma linha no arquivo. Esta função só é executada se o arquivo estiver aberto em modo de
escrita. Se o arquivo estiver em modo de leitura, será gerado um erro.
Parâmetros:
linha - a linha a ser escrita no arquivo
fechar_arquivo
funcao vazio fechar_arquivo(inteiro endereco)
Fecha um arquivo aberto anteriormente
Parâmetros:
ler_linha
funcao cadeia ler_linha(inteiro endereco)
Lê a próxima linha do arquivo. Esta função só é executada se o arquivo estiver aberto em modo de
leitura. Se o arquivo estiver em modo de escrita, será gerado um erro.
Parâmetros:
Retorna: Uma cadeia contendo o conteudo da linha lida.
arquivo_existe
funcao logico arquivo_existe(cadeia caminho_arquivo)
Verifica se um determinado arquivo existe no sistema de arquivos
Parâmetros:
caminho_arquivo - o caminho do arquivo que se quer verificar
Retorna: verdadeiro se o arquivo existir
selecionar_arquivo
funcao cadeia selecionar_arquivo(cadeia formatos_suportados[], logico
aceitar_todos_arquivos)
Abre um janela que permite ao usuário navegar nos diretórios do computador e selecionar um
arquivo
Parâmetros:
formatos_suportados - Define os formatos de arquivos que poderão ser selecionados. Um
formato de arquivo é formado por uma descrição e uma lista de extensões válidas. A
descrição deve estar separada da lista de extensões pelo caracter '|' e cada extensão deverá
estar separada da outra pelo caracter ','. Ex.: 'Arquivos de texto|txt', 'Arquivos de
imagem|png,jpg,jpeg,bmp'
aceitar_todos_arquivos - Quando verdadeiro, inclui automaticamente um formato que
permite selecionar qualquer arquivo. Este formato também será incluído se nenhum outro
formato for informado no parâmetro 'formatos_suportados'
Retorna: O arquivo_selecionado ou uma string vazia caso o usuário tenha cancelado.
listar_pastas
funcao vazio listar_pastas(cadeia caminho_pai, cadeia vetor_pastas[])
Altera um vetor para que ele represente as pastas existentes em um diretório
Parâmetros:
vetor_pastas - Vetor destino que contará com as pastas encontradas
apagar_arquivo
funcao vazio apagar_arquivo(cadeia caminho_arquivo)
Remove um arquivo do sistema de arquivos
Parâmetros:
caminho_arquivo - o caminho do arquivo que ser quer apagar
listar_arquivos
funcao vazio listar_arquivos(cadeia caminho_pai, cadeia
vetor_arquivos[])
Altera um vetor para que ele represente os arquivos existentes em um diretório
Parâmetros:
vetor_arquivos - Vetor destino que contará com as pastas encontradas
criar_pasta
funcao vazio criar_pasta(cadeia caminho)
Cria pastas no caminho informado caso elas não existam
Parâmetros:
caminho - Caminho onde as pastas serão criadas
Calendario
Esta biblioteca é utilizada para retornar a data e(ou) hora do computador
Constantes:
inteiro DIA_DOMINGO: constante que representa o 'Domingo'
inteiro DIA_SEGUNDA_FEIRA: constante que representa a 'Segunda-Feira'
inteiro DIA_TERCA_FEIRA: constante que representa a 'Terça-Feira'
inteiro DIA_QUARTA_FEIRA: constante que representa a 'Quarta-Feira'
inteiro DIA_QUINTA_FEIRA: constante que representa a 'Quinta-Feira'
inteiro DIA_SEXTA_FEIRA: constante que representa a 'Sexta-Feira'
inteiro DIA_SABADO: constante que representa o 'Sábado'
inteiro MES_JANEIRO: constante que representa o mês de 'Janeiro'
inteiro MES_FEVEREIRO: constante que representa o mês de 'Fevereiro'
inteiro MES_MARCO: constante que representa o mês de 'Março'
inteiro MES_ABRIL: constante que representa o mês de 'Abril'
inteiro MES_MAIO: constante que representa o mês de 'Maio'
inteiro MES_JUNHO: constante que representa o mês de 'Junho'
inteiro MES_JULHO: constante que representa o mês de 'Julho'
inteiro MES_AGOSTO: constante que representa o mês de 'Agosto'
inteiro MES_SETEMBRO: constante que representa o mês de 'Setembro'
inteiro MES_OUTUBRO: constante que representa o mês de 'Outubro'
inteiro MES_NOVEMBRO: constante que representa o mês de 'Novembro'
inteiro MES_DEZEMBRO: constante que representa o mês de 'Dezembro'
funcao cadeia dia_semana_completo(inteiro numero_dia, logico

caixa_alta, logico caixa_baixa)
funcao cadeia dia_semana_abreviado(inteiro numero_dia, logico

funcao inteiro dia_semana_atual()
funcao inteiro mes_atual()
funcao inteiro dia_mes_atual()
funcao cadeia dia_semana_curto(inteiro numero_dia, logico caixa_alta,

logico caixa_baixa)
funcao inteiro hora_atual(logico formato_12h)
funcao inteiro milisegundo_atual()
funcao inteiro ano_atual()
funcao inteiro minuto_atual()
funcao inteiro segundo_atual()
dia_semana_completo
funcao cadeia dia_semana_completo(inteiro numero_dia, logico
De acordo com o valor de 1 a 7 informado retornará um dia da semana completo.
Parâmetros:
numero_dia - um inteiro referente a um dia da semana
caixa_alta - logico para retorno em em caracteres maiúsculos
caixa_baixa - logico para retorno em em caracteres minúsculos
Retorna: uma cadeia com o dia da semana completo. Ex: Segunda-Feira.
dia_semana_abreviado
funcao cadeia dia_semana_abreviado(inteiro numero_dia, logico
De acordo com o valor de 1 a 7 informado retornará um dia da semana abreviado.
Parâmetros:
Retorna: uma cadeia com o dia da semana abreviado. Ex: Seg, para Segunda-Feira.
dia_semana_atual
funcao inteiro dia_semana_atual()
Recupera o dia da semana de 1 a 7.
Retorna: um inteiro com o dia da semana. Ex: 1, para Domingo.
mes_atual
funcao inteiro mes_atual()
Recupera o mês atual do computador de 1 a 12.
Retorna: um inteiro com o mês com dois digitos, se forem menores que 10 apenas com um
digito. Ex: 10.
dia_mes_atual
funcao inteiro dia_mes_atual()
Recupera o dia no mês atual do computador.
Retorna: um inteiro com o dia no mês com dois digitos, se forem menores que 10 apenas com um
digito. Ex: 26.
dia_semana_curto
funcao cadeia dia_semana_curto(inteiro numero_dia, logico caixa_alta,
logico caixa_baixa)
De acordo com o valor de 1 a 7 informado retornará um dia da semana de forma curta.
Parâmetros:
Retorna: uma cadeia com o dia da semana de forma curta. Ex: Segunda, para Segunda-Feira.
hora_atual
funcao inteiro hora_atual(logico formato_12h)
Recupera os digitos da hora atual do computador.

Parâmetros:
formato_12h - um logico que se verdadeiro o retorno será no formato 12h se falso será em
24h
Retorna: um inteiro com a hora atual no formato 12h ou 24h com dois digitos, se forem menores
que 10 apenas com um digito. Ex: 22 para 24h, se o parâmetro for falso ou 10 para 12h, se o
parâmetro for verdadeiro.
milisegundo_atual
funcao inteiro milisegundo_atual()
Recupera os digitos dos milisegundos atuais do computador.
Retorna: um inteiro com os milisegundos atuais, com um, dois ou três digitos. Ex: 426.
ano_atual
funcao inteiro ano_atual()
Recupera o ano atual do computador.
Retorna: um inteiro com o ano. Ex: 2012.
minuto_atual
funcao inteiro minuto_atual()
Recupera os digitos do minuto atual do computador.
Retorna: um inteiro com os minutos atuais com dois digitos, se forem menores que 10 apenas
com um digito. Ex: 45.
segundo_atual
funcao inteiro segundo_atual()
Recupera os digitos dos segundos atuais do computador.
Retorna: um inteiro com os segundos atuais com dois digitos, se forem menores que 10 apenas
com um digito. Ex: 32.
Graficos
Esta biblioteca permite inicializar e utilizar um ambiente gráfico com suporte ao desenho de
primitivas gráficas e de imagens carregadas do sistema de arquivos
Constantes:
inteiro COR_PRETO: constante que representa a cor 'preto'
inteiro COR_BRANCO: constante que representa a cor 'branca'
inteiro COR_AZUL: constante que representa a cor 'azul'
inteiro COR_VERMELHO: constante que representa a cor 'vermelho'
inteiro COR_VERDE: constante que representa a cor 'verde'
inteiro COR_AMARELO: constante que representa a cor 'amarelo'
inteiro GRADIENTE_DIREITA: constante que representa o gradiente na rotação 0
inteiro GRADIENTE_ESQUERDA: constante que representa o gradiente na rotação 0
inteiro GRADIENTE_ACIMA: constante que representa o gradiente na rotação 0
inteiro GRADIENTE_ABAIXO: constante que representa o gradiente na rotação 0
inteiro GRADIENTE_INFERIOR_DIREITO: constante que representa o gradiente na rotação

inferior direito
inteiro GRADIENTE_INFERIOR_ESQUERDO: constante que representa o gradiente na rotação

inferior direito
inteiro GRADIENTE_SUPERIOR_DIREITO: constante que representa o gradiente na rotação

inferior direito
inteiro GRADIENTE_SUPERIOR_ESQUERDO: constante que representa o gradiente na rotação

inferior direito
inteiro CANAL_R: constante que representa o canal 'VERMELHO'
inteiro CANAL_G: constante que representa o canal 'VERDE'
inteiro CANAL_B: constante que representa o canal 'AZUL'
funcao vazio definir_estilo_texto(logico italico, logico negrito,

logico sublinhado)
funcao inteiro obter_numero_quadro_atual_gif(inteiro endereco)

funcao vazio sair_modo_tela_cheia()
funcao vazio desenhar_quadro_atual_gif(inteiro x, inteiro y, inteiro

endereco)
funcao vazio definir_icone_janela(inteiro endereco)
funcao vazio definir_tamanho_texto(real tamanho)
funcao inteiro obter_numero_quadros_gif(inteiro endereco)
funcao vazio desenhar_porcao_imagem(inteiro x, inteiro y, inteiro xi,

inteiro yi, inteiro largura, inteiro altura, inteiro endereco)
funcao inteiro obter_intervalo_gif(inteiro endereco)
funcao vazio definir_fonte_texto(cadeia nome)
funcao inteiro transformar_porcao_imagem(inteiro endereco, inteiro x,

inteiro y, inteiro largura, inteiro altura, logico
espelhamento_horizontal, logico espelhamento_vertical, inteiro rotacao,
inteiro cor_transparente)
funcao vazio entrar_modo_tela_cheia()
funcao vazio definir_dimensoes_janela(inteiro largura, inteiro altura)
funcao inteiro redimensionar_imagem(inteiro endereco, inteiro largura,

inteiro altura, logico manter_qualidade)
funcao vazio exibir_borda_janela()
funcao vazio encerrar_modo_grafico()
funcao vazio iniciar_modo_grafico(logico manter_visivel)
funcao vazio ocultar_borda_janela()
funcao vazio definir_titulo_janela(cadeia titulo)
funcao vazio minimizar_janela()
funcao vazio renderizar()
funcao vazio limpar()
funcao vazio fechar_janela()
funcao inteiro renderizar_imagem(inteiro largura, inteiro altura)
funcao vazio restaurar_janela()
funcao vazio desenhar_linha(inteiro x1, inteiro y1, inteiro x2, inteiro

y2)
funcao vazio desenhar_retangulo(inteiro x, inteiro y, inteiro largura,
inteiro altura, logico arredondar_cantos, logico preencher)
funcao vazio desenhar_elipse(inteiro x, inteiro y, inteiro largura,

inteiro altura, logico preencher)
funcao inteiro transformar_imagem(inteiro endereco, logico

funcao vazio desenhar_poligono(inteiro pontos[][], logico preencher)
funcao inteiro carregar_imagem(cadeia caminho)
funcao vazio proximo_frame_gif(inteiro endereco)
funcao vazio desenhar_ponto(inteiro x, inteiro y)
funcao inteiro obter_cor_pixel(inteiro endereco, inteiro x, inteiro y)
funcao inteiro obter_RGB(inteiro cor, inteiro canal)
funcao vazio desenhar_imagem(inteiro x, inteiro y, inteiro endereco)
funcao vazio salvar_imagem(inteiro endereco, cadeia caminho)
funcao vazio definir_gradiente(inteiro tipo, inteiro cor1, inteiro

cor2)
funcao vazio definir_quadro_gif(inteiro endereco, inteiro quadro)
funcao vazio definir_cor(inteiro cor)
funcao inteiro largura_texto(cadeia texto)
funcao inteiro obter_quadro_gif(inteiro endereco, inteiro quadro)
funcao vazio liberar_imagem(inteiro endereco)
funcao vazio desenhar_texto(inteiro x, inteiro y, cadeia texto)
funcao inteiro criar_cor(inteiro vermelho, inteiro verde, inteiro azul)
funcao inteiro largura_janela()
funcao inteiro largura_tela()
funcao vazio definir_opacidade(inteiro opacidade)
funcao vazio carregar_fonte(cadeia caminho_fonte)
funcao inteiro altura_texto(cadeia texto)
funcao inteiro altura_janela()

funcao inteiro largura_imagem(inteiro endereco)
funcao inteiro altura_imagem(inteiro endereco)
funcao vazio definir_rotacao(inteiro rotacao)
funcao inteiro altura_tela()
definir_estilo_texto
funcao vazio definir_estilo_texto(logico italico, logico negrito,
logico sublinhado)
Define o estilo da fonte que será utilizada para desenhar um texto no ambiente gráfico
Parâmetros:
italico - define se a fonte terá o estilo itálico
negrito - define se a fonte terá o estilo negrito
sublinhado - define se a fonte terá o estilo sublinhado
obter_numero_quadro_atual_gif
funcao inteiro obter_numero_quadro_atual_gif(inteiro endereco)
Obtêm o numero do quadro atual de um gif
Parâmetros:
endereco - o endereço de memória do gif
Retorna: o número do quadro atual que o gif está
sair_modo_tela_cheia
funcao vazio sair_modo_tela_cheia()
Faz com que a janela gráfica seja redimensionada para o tamanho que possuía antes de entrar no
modo de tela cheia
desenhar_quadro_atual_gif
funcao vazio desenhar_quadro_atual_gif(inteiro x, inteiro y, inteiro
endereco)
Desenha um frame de um gif previamente carregado, na posição especificada pelos parâmetros x e

y
Parâmetros:
x - a posição (distância) da imagem no eixo horizontal, em relação ao lado esquerdo da
janela
y - a posição (distância) da imagem no eixo vertical, em relação ao topo da janela
endereco - o endereço de memória da imagem a ser desenhada
definir_icone_janela
funcao vazio definir_icone_janela(inteiro endereco)
Altera o ícone que é exibido na janela do ambiente gráfico. Este ícone aparece ao lado do título da
janela e na barra de tarefas do sistema operacional
Parâmetros:
endereco - o endereço da imagem que será usada como ícone
definir_tamanho_texto
funcao vazio definir_tamanho_texto(real tamanho)
Define o tamanho da fonte que será utilizada para desenhar um texto no ambiente gráfico
Parâmetros:
tamanho - o tamanho da fonte a ser utilizada
obter_numero_quadros_gif
funcao inteiro obter_numero_quadros_gif(inteiro endereco)
Obtêm o numero de quadros de um gif
Parâmetros:
Retorna: o número de quadros que o gif possui
desenhar_porcao_imagem
funcao vazio desenhar_porcao_imagem(inteiro x, inteiro y, inteiro xi,
inteiro yi, inteiro largura, inteiro altura, inteiro endereco)
Desenha uma porção de uma imagem previamente carregada, na posição especificada pelos
parâmetros x e y
Parâmetros:
janela
xi - a posição (distância) no eixo horizontal a partir da qual a imagem começará a ser
desenhada
yi - a posição (distância) no eixo vertical a partir da qual a imagem começará a ser
desenhada
largura - a largura da porção da imagem a ser desenhada
altura - a altura da porção da imagem a ser desenhada
obter_intervalo_gif
funcao inteiro obter_intervalo_gif(inteiro endereco)
Obtêm o intervalo entre os quadros de um gif
Parâmetros:
Retorna: intervalo em milissegundos do quadro atual
definir_fonte_texto
funcao vazio definir_fonte_texto(cadeia nome)
Define a fonte que será utilizada para desenhar um texto no ambiente gráfico
Parâmetros:
nome - o nome da fonte a ser utilizada (Ex.: Arial, Times New Roman, Tahoma). Se a fonte
informada não existir no sistema operacional do computador, será utilizada a fonte padrão
transformar_porcao_imagem
funcao inteiro transformar_porcao_imagem(inteiro endereco, inteiro x,
inteiro y, inteiro largura, inteiro altura, logico
Esta função permite transformar uma porção de uma imagem previamente carregada no ambiente
gráfico com a função carregar_imagem(). As transformações possíveis são: espelhamento, rotação
e remoção de cor.
O espelhamento permite inverter uma porção da imagem tanto na direção horizontal quanto na
direção vertical.
A rotação, permite girar e inclinar uma porção da imagem em um ângulo de 360 graus.
A remoção de cor, permite escolher uma cor da imagem e torná-la transparente.
Esta função copia uma porção da imagem original antes de aplicar as transformações, portanto, a
imagem original não é perdida ao realizar a transformação e a nova imagem é alocada em outro
endereço de memória
Parâmetros:
endereco - o endereço de memória da imagem que será transformada
x - a posição (distância) no eixo horizontal a partir da qual a imagem será transformada
y - a posição (distância) no eixo vertical a partir da qual a imagem será transformada
largura - a largura da porção da imagem a ser transformada
altura - a altura da porção da imagem a ser transformada
espelhamento_horizontal - define se a imagem será invertida (espelhada) na direção
horizontal
espelhamento_vertical - define se a imagem será invertida (espelhada) na direção vertical
rotacao - define em quantos graus a imagem será rotacionada. Se o valor 0 for informado, a
imagem não será rotacionada. É importante notar que, ao rotacionar a imagem, as suas
dimensões (largura e altura) poderão se alterar
cor_transparente - define a cor que será removida da imagem, ou seja, que irá se tornar
transparente. Se o valor 0 for informado, nenhuma cor será removida
entrar_modo_tela_cheia
funcao vazio entrar_modo_tela_cheia()
Faz com que a janela gráfica seja redimensionada para ocupar o tamanho total da tela
definir_dimensoes_janela
funcao vazio definir_dimensoes_janela(inteiro largura, inteiro altura)
altera as dimensões da janela do ambiente gráfico
Parâmetros:
largura - a nova largura da janela
altura - a nova altura da janela
redimensionar_imagem
funcao inteiro redimensionar_imagem(inteiro endereco, inteiro largura,
inteiro altura, logico manter_qualidade)
Esta função permite redimensionar uma imagem previamente carregada no ambiente gráfico com
a função carregar_imagem(). Caso um dos parametros de dimensão seja 0, o outro parametro será
proporcional ao dado
Parâmetros:
largura - a largura desejada da imagem
altura - a altura desejada da imagem
manter_qualidade - define se a qualidade da imagem deve ser mantida ao redimensionar
Retorna: o endereço de memória da nova imagem

exibir_borda_janela
funcao vazio exibir_borda_janela()
Exibe novamente a borda da janela do modo gráfico, caso ela esteja oculta
encerrar_modo_grafico
funcao vazio encerrar_modo_grafico()
Encerra o modo gráfico e fecha a janela criada com a função 'iniciar_modo_grafico'
iniciar_modo_grafico
funcao vazio iniciar_modo_grafico(logico manter_visivel)
Inicia o modo gráfico e exibe uma janela com as configurações padrão (tamanho 640x480 e fundo
preto). Se o modo gráfico já estiver iniciado, nada acontecerá
Parâmetros:
manter_visivel - define se a janela do ambiente gráfico deve permanecer sempre visível
sobre as outras janelas (útil durante a depuração)
ocultar_borda_janela
funcao vazio ocultar_borda_janela()
Oculta a borda da janela do modo gráfico, fazendo com que somente o conteúdo da janela seja
exibido
definir_titulo_janela
funcao vazio definir_titulo_janela(cadeia titulo)
define o texto da janela do ambiente gráfico
Parâmetros:
titulo - o novo título da janela
minimizar_janela
funcao vazio minimizar_janela()
Minimiza a janela do ambiente gráfico, como se o usuário tivesse clicado no botão 'Minimizar' da
janela
renderizar
funcao vazio renderizar()
Quando uma função de desenho da biblioteca é chamada, o desenho não é realizado

imediatamente na tela, mas sim, em uma área reservada da memória. Isto é feito com o objetivo de
aumentar o desempenho do programa e minimizar outros problemas. Esta técnica é chamada de
Back Buffer ou Double Buffer.
A função renderizar, faz com que os desenhos existentes no Back Buffer sejam desenhados na
tela.
Esta função deve ser chamada sempre após todas as outras funções de desenho, para garantir que
todos os desenhos sejam exibidos
http://en.wikipedia.org/wiki/Multiple_buffering#Double_buffering_in_computer_graphics
limpar
funcao vazio limpar()
limpa o desenho do ambiente e gráfico e preenche o fundo com a cor atual
fechar_janela
funcao vazio fechar_janela()
Encerra o programa como se o usuário tivesse clicado no botão 'Fechar' da janela
renderizar_imagem
funcao inteiro renderizar_imagem(inteiro largura, inteiro altura)
Esta função cria uma nova imagem em memória e renderiza todos os desenhos do ambiente
gráfico nesta nova imagem ao invés de renderizá-los na tela
Parâmetros:
largura - a largura da nova imagem
altura - a altura da nova imagem
restaurar_janela
funcao vazio restaurar_janela()
Restaura a janela do ambiente gráfico, como se o usuário tivesse clicado no ícone do programa na
barra de tarefas do Sistema Operacional
desenhar_linha
funcao vazio desenhar_linha(inteiro x1, inteiro y1, inteiro x2, inteiro
y2)
Desenha uma linha de um ponto 'A' (definido pelos parâmetros x1 e y1) até um ponto 'B' (definido
pelos parâmetros x2 e y2)
Parâmetros:
x1 - a coordenada (distância) do ponto 'A' no eixo horizontal, em relação ao lado esquerdo
da janela
y1 - a coordenada (distância) do ponto 'A' no eixo vertical, em relação ao topo da janela
x2 - a coordenada (distância) do ponto 'B' no eixo horizontal, em relação ao lado esquerdo
da janela
y2 - a coordenada (distância) do ponto 'B' no eixo vertical, em relação ao topo da janela
desenhar_retangulo
funcao vazio desenhar_retangulo(inteiro x, inteiro y, inteiro largura,
inteiro altura, logico arredondar_cantos, logico preencher)
Desenha um retângulo na posição definida pelos parâmetros x e y e com as dimensões

especificadas pelos parâmetros largura e altura.
O retângulo é desenhado na tela a partir do seu canto superior esquerdo
Parâmetros:
x - a posição (distância) do retângulo no eixo horizontal, em relação ao lado esquerdo da
janela
y - a posição (distância) do retângulo no eixo vertical, em relação ao topo da janela
largura - a largura do retângulo em pixels
altura - a altura do retângulo em pixels
arredondar_cantos - define se o retângulo deverá ter cantos arredondados
preencher - define se o retângulo será preenchido com a cor do ambiente gráfico. Se o valor
for verdadeiro, o retângulo será preenchido. Se o valor for falso, somente o contorno do
retângulo será desenhado
desenhar_elipse
funcao vazio desenhar_elipse(inteiro x, inteiro y, inteiro largura,
inteiro altura, logico preencher)
Desenha uma elipse na posição definida pelos parâmetros x e y e com as dimensões especificadas
pelos parâmetros largura e altura, .
A elipse é desenhada na tela a partir do seu canto superior esquerdo
Parâmetros:
x - a posição (distância) do círculo no eixo horizontal, em relação ao lado esquerdo da
janela
y - a posição (distância) do círculo no eixo vertical, em relação ao topo da janela
largura - a largura da elipse em pixels
altura - a altura da elipse em pixels
preencher - define se a elipse será preenchida com a cor do ambiente gráfico. Se o valor for
verdadeiro, a elipse será preenchida. Se o valor for falso, somente o contorno da elipse será
desenhado
transformar_imagem
funcao inteiro transformar_imagem(inteiro endereco, logico
Esta função permite transformar uma imagem previamente carregada no ambiente gráfico com a
função carregar_imagem(). As transformações possíveis são: espelhamento, rotação e remoção de
cor.
O espelhamento permite inverter a imagem tanto na direção horizontal quanto na direção vertical.
A rotação, permite girar e inclinar a imagem em um ângulo de 360 graus.
A remoção de cor, permite escolher uma cor da imagem e torná-la transparente.
Esta função cria uma cópia da imagem original antes de aplicar as transformações, portanto, a
imagem original não é perdida ao realizar a transformação e a nova imagem é alocada em outro
endereço de memória
Parâmetros:
espelhamento_horizontal - define se a imagem será invertida (espelhada) na direção
horizontal
espelhamento_vertical - define se a imagem será invertida (espelhada) na direção vertical
rotacao - define em quantos graus a imagem será rotacionada. Se o valor 0 for informado, a
imagem não será rotacionada. É importante notar que, ao rotacionar a imagem, as suas
dimensões (largura e altura) poderão se alterar
cor_transparente - define a cor que será removida da imagem, ou seja, que irá se tornar
transparente. Se o valor 0 for informado, nenhuma cor será removida
desenhar_poligono
funcao vazio desenhar_poligono(inteiro pontos[][], logico preencher)
Desenha poligono
Parâmetros:
pontos - a largura do retângulo em pixels
preencher - define se o retângulo será preenchido com a cor do ambiente gráfico. Se o valor
for verdadeiro, o retângulo será preenchido. Se o valor for falso, somente o contorno do
retângulo será desenhado
carregar_imagem
funcao inteiro carregar_imagem(cadeia caminho)
Carrega uma imagem na memória para ser utilizada mais tarde. Os formatos de imagem
suportados são: JPEG, PNG, BITMAP e GIF
Parâmetros:
caminho - o caminho do arquivo de imagem no computador
Retorna: o endereço de memória no qual a imagem foi carregada
proximo_frame_gif
funcao vazio proximo_frame_gif(inteiro endereco)
Define a imagem a ser desenhada do gif como o próximo frame
Parâmetros:
endereco - o endereço de memória no qual o gif foi carregado
desenhar_ponto
funcao vazio desenhar_ponto(inteiro x, inteiro y)
Desenha um ponto na posição definida pelos parâmetros x e y.
O ponto desenhado ocupa um único pixel na tela
Parâmetros:
x - a coordenada (distância) do ponto no eixo horizontal, em relação ao lado esquerdo da
janela
y - a coordenada (distância) do ponto no eixo vertical, em relação ao topo da janela
obter_cor_pixel
funcao inteiro obter_cor_pixel(inteiro endereco, inteiro x, inteiro y)
Esta função permite obter uma cor em um pixel expecifico de uma imagem previamente carregada
no ambiente gráfico com a função carregar_imagem().
Parâmetros:
x - coluna do pixel no bitmap
y - linha do pixel no bitmap
Retorna: cor RGB do pixel
obter_RGB
funcao inteiro obter_RGB(inteiro cor, inteiro canal)
Esta função permite obter um canal de uma cor.
Parâmetros:
cor - cor que será extraido o canal
canal - canal R, G ou B
Retorna: cor RGB do pixel
desenhar_imagem
funcao vazio desenhar_imagem(inteiro x, inteiro y, inteiro endereco)
Desenha uma imagem previamente carregada, na posição especificada pelos parâmetros x e y
Parâmetros:
janela
salvar_imagem
funcao vazio salvar_imagem(inteiro endereco, cadeia caminho)
Salva uma imagem
Parâmetros:
caminho - lugar onde a imagem deverá sre salva
definir_gradiente
funcao vazio definir_gradiente(inteiro tipo, inteiro cor1, inteiro
cor2)
Define a cor atual do ambiente gráfico como um gradiente de 2 cores. Esta cor será utilizada para
desenhar e preencher as primitivas gráficas (ponto, linha, retângulo, etc.) e, como cor de fundo ao
limpar o ambiente gráfico
Parâmetros:
tipo - o tipo de rotação de gradiente que será utilizado
cor1 - a primeira cor do novo gradiente do ambiente gráfico
cor2 - a segunda cor do novo gradiente do ambiente gráfico
definir_quadro_gif
funcao vazio definir_quadro_gif(inteiro endereco, inteiro quadro)
Define determinado quadro a um gif
Parâmetros:
quadro - o quadro que deseja ser definido
definir_cor
funcao vazio definir_cor(inteiro cor)
Define a cor atual do ambiente gráfico. Esta cor será utilizada para desenhar e preencher as
primitivas gráficas (ponto, linha, retângulo, etc.) e, como cor de fundo ao limpar o ambiente
gráfico ou desenhar um texto
Parâmetros:
cor - a nova cor do ambiente gráfico
largura_texto
funcao inteiro largura_texto(cadeia texto)
Obtém a largura em pixels que um texto ocupa para ser desenhado na tela
Parâmetros:
texto - o texto que será mensurado
Retorna: a largura do texto
obter_quadro_gif
funcao inteiro obter_quadro_gif(inteiro endereco, inteiro quadro)
Obtêm determinado quadro de um gif
Parâmetros:
quadro - o quadro que deseja obter
Retorna: imagem do quadro pedido por parâmetro
liberar_imagem
funcao vazio liberar_imagem(inteiro endereco)
Libera a memória utilizada por uma imagem que tenha sido previamente carregada
Parâmetros:
endereco - o endereço de memória da imagem
desenhar_texto
funcao vazio desenhar_texto(inteiro x, inteiro y, cadeia texto)
Desenha um texto (cadeia) na posição especificada pelos parâmetros x e y

Parâmetros:
x - a posição (distância) do texto no eixo horizontal, em relação ao lado esquerdo da janela
y - a posição (distância) do ponto no eixo vertical, em relação ao topo da janela
texto - o texto (cadeia) a ser desenhado
criar_cor
funcao inteiro criar_cor(inteiro vermelho, inteiro verde, inteiro azul)
cria uma nova cor a partir da combinação de tons de vermelho, verde e azul
Parâmetros:
vermelho - o tom de vermelho (0 a 255)
verde - o tom de verde (0 a 255)
azul - o tom de azul (0 a 255)
Retorna: a nova cor criada pela combinação dos tons de vermelho, verde e azul
http://pt.wikipedia.org/wiki/RGB
largura_janela
funcao inteiro largura_janela()
obtém a largura atual da janela do ambiente gráfico
largura_tela
funcao inteiro largura_tela()
obtém a largura da tela do computador
definir_opacidade
funcao vazio definir_opacidade(inteiro opacidade)
Esta função define o nível de opacidade dos desenhos no ambiente gráfico. Quanto menor for a
opacidade, mais transparente será o desenho e quanto maior for a opacidade mais opaco será o
desenho. Com esta função, é possível desenhar imagens, textos e primitivas gráficas semi-
transparentes, o que permite "enxergar" através dos desenhos.
É importante notar que, após ser chamada, esta função afeta todos os desenhos realizados. Isto
significa que se foram desenhados um retângulo e uma elipse após a chamada desta função, ambos
terão seu nível de opacidade alterados.
Caso fosse desejável modificar apenas a opacidade do retângulo, então seria necessário chamar
novamente esta função definido a opacidade para o valor máximo antes de desenhar a elipse
Parâmetros:
opacidade - o nível de opacidade dos desenhos. O valor deve estar entre 0 e 255, sendo que,
0 indica um desenho totalmente transparente e 255 indica um desenho totalmente opaco
carregar_fonte
funcao vazio carregar_fonte(cadeia caminho_fonte)
Carrega uma fonte no ambiente gráfico a partir de um arquivo de fonte presente no sistema de
arquivos
Parâmetros:
caminho_fonte - o caminho do arquivo de fonte no sistema de arquivos
altura_texto
funcao inteiro altura_texto(cadeia texto)
Obtém a altura em pixels que um texto ocupa para ser desenhado na tela
Parâmetros:
texto - o texto que será mensurado
Retorna: a altura do texto
altura_janela
funcao inteiro altura_janela()
obtém a altura atual da janela do ambiente gráfico
largura_imagem
funcao inteiro largura_imagem(inteiro endereco)
Obtém a altura de uma imagem previamente carregada no ambiente gráfico
Parâmetros:
endereco - o endereço da imagem para a qual se quer obter a largura
Retorna: a largura da imagem
altura_imagem
funcao inteiro altura_imagem(inteiro endereco)
Obtém a altura de uma imagem previamente carregada no ambiente gráfico
Parâmetros:
endereco - o endereço da imagem para a qual se quer obter a altura
Retorna: a altura da imagem
definir_rotacao
funcao vazio definir_rotacao(inteiro rotacao)
Esta função define o grau de rotação dos desenhos no ambiente gráfico. Com esta função, é
possível rotacionar imagens, textos e todas as primitivas gráficas, incluindo linhas, retângulos e
elipses.
A rotação é realizada sempre a partir do centro do desenho.
É importante notar que, após ser chamada, esta função afeta todos os desenhos realizados. Isto
significa que se foram desenhados um retângulo e uma elipse após a chamada desta função, ambos
serão rotacionados no mesmo grau de inclinação.
Caso fosse desejável rotacionar apenas o retângulo, então seria necessário chamar novamente esta
função definido a rotação para 0 antes de desenhar a elipse
Parâmetros:
rotacao - o grau de rotação dos desenhos. Pode ser qualquer valor real, incluindo 0,
positivos e negativos. Os valores múltiplos de 360.0 e o valor 0.0 indicam que não haverá
rotação. Valores positivos, indicam uma rotação no sentido horário enquanto que valores
negativos indicam uma rotação no sentido anti-horário
altura_tela
funcao inteiro altura_tela()
obtém a altura da tela do computador
Internet
Esta biblioteca contém diversas funções de conexão com a web
funcao vazio definir_tempo_limite(inteiro tempo)
funcao logico endereco_disponivel(cadeia endereço)
funcao cadeia baixar_imagem(cadeia endereço, cadeia caminho)
funcao cadeia obter_texto(cadeia caminho)

definir_tempo_limite
funcao vazio definir_tempo_limite(inteiro tempo)
Define um valor de tempo limite de espera
Parâmetros:
tempo - o tempo limite de espera
endereco_disponivel
funcao logico endereco_disponivel(cadeia endereço)
Verifica a disponibilidade atual de algum endereço
Parâmetros:
endereço - o endereço de onde o conteúdo deverá ser obtido
Retorna: verdadeiro se o endereço estiver disponível no momento falso se não
baixar_imagem
funcao cadeia baixar_imagem(cadeia endereço, cadeia caminho)
Obtém recursos de um página web
Parâmetros:
endereço - o endereço de onde o conteúdo deverá ser obtido
caminho - o caminho de onde o conteúdo deverá ser salvo
Retorna: O tipo da Imagem
obter_texto
funcao cadeia obter_texto(cadeia caminho)
Obtém o conteúdo de um página web
Parâmetros:
caminho - o caminho de onde o conteúdo deverá ser obtido
Retorna: O conteúdo de uma pagina web
Matematica
Esta biblioteca contém uma série das funções matemáticas mais comuns
Constantes:
real PI: Constante matemática que representa a relação entre o perímetro de uma circunferência
e seu diâmetro, em outras palavras: perimetro/diâmetro(http://pt.wikipedia.org/wiki/Pi)
funcao real potencia(real base, real expoente)
funcao real tangente(real angulo)
funcao real maior_numero(real numeroA, real numeroB)
funcao real arredondar(real numero, inteiro casas)
funcao real valor_absoluto(real numero)
funcao real cosseno(real angulo)
funcao real seno(real angulo)
funcao real raiz(real radicando, real indice)
funcao real logaritmo(real numero, real base)
funcao real menor_numero(real numeroA, real numeroB)
potencia
funcao real potencia(real base, real expoente)
Realiza uma exponenciação através da multiplicação da base por ela mesma tantas vezes quanto
indicar o expoente
Parâmetros:
base - o número que será multiplicado
expoente - o número de vezes que a base será multiplicada
Retorna: A exponenciação da base pelo expoente
http://pt.wikipedia.org/wiki/Exponencia%C3%A7%C3%A3o
tangente
funcao real tangente(real angulo)
Calcula a tangente do ângulo informado
Parâmetros:
angulo - o ângulo para o qual será calculada a tangente
Retorna: a tagente do ângulo informado
http://pt.wikipedia.org/wiki/Tangente
maior_numero
funcao real maior_numero(real numeroA, real numeroB)
Identifica o maior número entre os números informados
Parâmetros:
numeroA - um número qualquer
numeroB - um número qualquer
Retorna: o maior número
arredondar
funcao real arredondar(real numero, inteiro casas)
Arredonda um número real para o número de casas decimais informadas. Quando o último dígito
for maior ou igual a 5, o número será arredondado para cima, quando o último dígito for menor
que 5, o número será arredondado para baixo
Parâmetros:
numero - o número que será arredondado
casas - o número de casas decimais após o arredondamento
Retorna: o número arredondado
http://pt.wikipedia.org/wiki/Arredondamento
valor_absoluto
funcao real valor_absoluto(real numero)
Calcula o valor absoluto do número informado
Parâmetros:
numero - o número para o qual será calculado o valor absoluto
Retorna: o valor absoluto do número informado

http://pt.wikipedia.org/wiki/Fun%C3%A7%C3%A3o_modular
cosseno
funcao real cosseno(real angulo)
Calcula o cosseno do ângulo informado
Parâmetros:
angulo - o ângulo para o qual será calculado o cosseno
Retorna: o cosseno do ângulo informado
http://pt.wikipedia.org/wiki/Cosseno
seno
funcao real seno(real angulo)
Calcula o seno do ângulo informado
Parâmetros:
angulo - o ângulo para o qual será calculado o seno
Retorna: o seno do ângulo informado
http://pt.wikipedia.org/wiki/Seno
raiz
funcao real raiz(real radicando, real indice)
Realiza a radiciação (extrai a raíz) de um número por um determinado índice
Parâmetros:
radicando - o número do qual será extraída a raíz
indice - indica o grau da radiciação. Quando o indice é 2 a raíz é quadrada, quando o indice
é 3 a raíz é cúbica, e assim por diante
Retorna: a raíz do número informado
http://pt.wikipedia.org/wiki/Radicia%C3%A7%C3%A3o
logaritmo
funcao real logaritmo(real numero, real base)
Calcula o logaritmo de um número para uma determinada base

Parâmetros:
numero - o número resultante da exponenciação
base - a base da exponenciação
Retorna: o logaritmo
menor_numero
funcao real menor_numero(real numeroA, real numeroB)
Identifica o menor número entre os números informados
Parâmetros:
numeroA - um número qualquer
numeroB - um número qualquer
Retorna: o menor número
Mouse
Esta biblioteca contém um conjunto de funções para manipular a entrada de dados através do mouse
do computador
IMPORTANTE: Esta biblioteca não funciona no console de entrada e saída de dados
do Portugol Studio, ela só funciona com a biblioteca Graficos, se o modo gráfico estiver iniciado.
Constantes:
inteiro BOTAO_ESQUERDO: Código numérico do botão esquerdo do mouse
inteiro BOTAO_DIREITO: Código numérico do botão direito do mouse
inteiro BOTAO_MEIO: Código numérico do botão do meio do mouse
funcao logico algum_botao_pressionado()
funcao inteiro ler_botao()
funcao inteiro posicao_x()
funcao logico botao_pressionado(inteiro botao)
funcao inteiro posicao_y()

funcao vazio exibir_cursor()
funcao vazio ocultar_cursor()
algum_botao_pressionado
funcao logico algum_botao_pressionado()
Testa se existe algum botão do mouse pressionado neste instante
Retorna: o resultado do teste. Verdadeiro se houver um botão do mouse pressionado no momento

do teste. Caso contrário, retorna falso
ler_botao
funcao inteiro ler_botao()
Aguarda até que um botão seja clicado (isto é, foi pressionado e depois solto), e captura o seu
código
Retorna: o código do botão lido
posicao_x
funcao inteiro posicao_x()
Obtém a coordenada X do mouse neste instante
Retorna: a coordenada X do mouse neste instante
botao_pressionado
funcao logico botao_pressionado(inteiro botao)
Testa se um determinado botão do mouse está pressionado neste instante
Parâmetros:
botao - o código do botão que será testado
Retorna: o resultado do teste. Verdadeiro se o botão estiver pressionado no momento do teste.

Caso contrário, retorna falso
posicao_y
funcao inteiro posicao_y()
Obtém a coordenada Y do mouse neste instante
Retorna: a coordenada Y do mouse neste instante
exibir_cursor
funcao vazio exibir_cursor()
Exibe novamente o cursor do mouse caso ele esteja oculto
ocultar_cursor
funcao vazio ocultar_cursor()
Oculta o cursor do mouse
Objetos
Esta biblioteca contém uma série de funções para criar e trabalhar com objetos
Constantes:
inteiro TIPO_INTEIRO: Constante para definir o tipo inteiro
inteiro TIPO_CADEIA: Constante para definir o tipo cadeia
inteiro TIPO_CARACTER: Constante para definir o tipo caracter
inteiro TIPO_REAL: Constante para definir o tipo real
inteiro TIPO_LOGICO: Constante para definir o tipo logico
inteiro TIPO_OBJETO: Constante para definir o tipo objeto
inteiro TIPO_VETOR: Constante para definir o tipo vetor
funcao inteiro obter_propriedade_tipo_objeto_em_vetor(inteiro endereco,

cadeia propriedade, inteiro indice)
funcao real obter_propriedade_tipo_real_em_vetor(inteiro endereco,

funcao logico obter_propriedade_tipo_logico_em_vetor(inteiro endereco,
funcao caracter obter_propriedade_tipo_caracter_em_vetor(inteiro

endereco, cadeia propriedade, inteiro indice)
funcao inteiro obter_propriedade_tipo_inteiro_em_vetor(inteiro

funcao cadeia obter_propriedade_tipo_cadeia_em_vetor(inteiro endereco,

funcao cadeia obter_propriedade_tipo_cadeia(inteiro endereco, cadeia

propriedade)
funcao inteiro obter_tamanho_vetor_propriedade(inteiro endereco, cadeia

propriedade)
funcao caracter obter_propriedade_tipo_caracter(inteiro endereco,

cadeia propriedade)
funcao logico obter_propriedade_tipo_logico(inteiro endereco, cadeia

propriedade)
funcao inteiro obter_propriedade_tipo_inteiro(inteiro endereco, cadeia

propriedade)
funcao inteiro obter_propriedade_tipo_objeto(inteiro endereco, cadeia

propriedade)
funcao inteiro criar_objeto_via_json(cadeia json)
funcao real obter_propriedade_tipo_real(inteiro endereco, cadeia

propriedade)
funcao vazio atribuir_propriedade(inteiro endereco, cadeia propriedade,

vazio valor)
funcao inteiro criar_objeto_via_xml(cadeia xml)
funcao inteiro criar_objeto()
funcao cadeia obter_json(inteiro endereco)
funcao vazio liberar()
funcao inteiro tipo_propriedade(inteiro endereco, cadeia propriedade)
funcao vazio liberar_objeto(inteiro endereco)
funcao logico contem_propriedade(inteiro endereco, cadeia propriedade)

obter_propriedade_tipo_objeto_em_vetor
funcao inteiro obter_propriedade_tipo_objeto_em_vetor(inteiro endereco,
Obtém o valor de um vetor armazenado no objeto do endereço informado
Parâmetros:
endereco - o endereço onde o objeto foi armazenado
propriedade - a descrição da propriedade que terá o valor obtido
indice - o índice do elemento do vetor que será obtido
Retorna: o valor da propriedade informada
obter_propriedade_tipo_real_em_vetor
funcao real obter_propriedade_tipo_real_em_vetor(inteiro endereco,
Parâmetros:
obter_propriedade_tipo_logico_em_vetor
funcao logico obter_propriedade_tipo_logico_em_vetor(inteiro endereco,
Parâmetros:
obter_propriedade_tipo_caracter_em_vetor
funcao caracter obter_propriedade_tipo_caracter_em_vetor(inteiro
Parâmetros:
obter_propriedade_tipo_inteiro_em_vetor
funcao inteiro obter_propriedade_tipo_inteiro_em_vetor(inteiro
Parâmetros:
obter_propriedade_tipo_cadeia_em_vetor
funcao cadeia obter_propriedade_tipo_cadeia_em_vetor(inteiro endereco,
Parâmetros:
obter_propriedade_tipo_cadeia
funcao cadeia obter_propriedade_tipo_cadeia(inteiro endereco, cadeia
propriedade)
Obtém o valor de uma propriedade do tipo cadeia no objeto do endereço informado
Parâmetros:
obter_tamanho_vetor_propriedade
funcao inteiro obter_tamanho_vetor_propriedade(inteiro endereco, cadeia
propriedade)
Obtém o tamanho de um vetor armazenado no objeto do endereço informado
Parâmetros:
obter_propriedade_tipo_caracter
funcao caracter obter_propriedade_tipo_caracter(inteiro endereco,
cadeia propriedade)
Obtém o valor de uma propriedade do tipo caracter no objeto do endereço informado
Parâmetros:
obter_propriedade_tipo_logico
funcao logico obter_propriedade_tipo_logico(inteiro endereco, cadeia
propriedade)
Obtém o valor de uma propriedade do tipo logico no objeto do endereço informado
Parâmetros:
obter_propriedade_tipo_inteiro
funcao inteiro obter_propriedade_tipo_inteiro(inteiro endereco, cadeia
propriedade)
Obtém o valor de uma propriedade do tipo inteiro no objeto do endereço informado
Parâmetros:
obter_propriedade_tipo_objeto
funcao inteiro obter_propriedade_tipo_objeto(inteiro endereco, cadeia
propriedade)
Obtém o valor de uma propriedade do tipo objeto no objeto do endereço informado
Parâmetros:
criar_objeto_via_json
funcao inteiro criar_objeto_via_json(cadeia json)
Realiza a criação de um objeto a partir de uma cadeia no formato JSON (JavaScript Object
Notation)
Parâmetros:
json - texto no formato JSON para criar o objeto
Retorna: O endereço de memória no qual o objeto foi carregada
https://pt.wikipedia.org/wiki/JSON
obter_propriedade_tipo_real
funcao real obter_propriedade_tipo_real(inteiro endereco, cadeia
propriedade)
Obtém o valor de uma propriedade do tipo real no objeto do endereço informado
Parâmetros:
atribuir_propriedade
funcao vazio atribuir_propriedade(inteiro endereco, cadeia propriedade,
vazio valor)
Realiza a atribuição de uma propriedade do objeto no endereço informado
Parâmetros:
propriedade - a descrição da propriedade que terá o valor alterado
valor - o valor que será atribuido para a propriedade
criar_objeto_via_xml
funcao inteiro criar_objeto_via_xml(cadeia xml)
Realiza a criação de um objeto a partir de uma cadeia no formato XML (eXtensible Markup
Language)
Parâmetros:
xml - texto no formato XML para criar o objeto
https://pt.wikipedia.org/wiki/XML
criar_objeto
funcao inteiro criar_objeto()
Realiza a criação de um objeto vazio em memória
obter_json
funcao cadeia obter_json(inteiro endereco)
Obtém a cadeia que representa o objeto inteiro no formato JSON (JavaScript Object Notation)
Parâmetros:
https://pt.wikipedia.org/wiki/JSON
liberar
funcao vazio liberar()
Libera todos os objetos previamente armazenados na memória
tipo_propriedade
funcao inteiro tipo_propriedade(inteiro endereco, cadeia propriedade)
Identifica o tipo da propriedade informada
Parâmetros:
propriedade - propriedade utilizada para verificação
liberar_objeto
funcao vazio liberar_objeto(inteiro endereco)
Libera o objeto do endereço informado da memória
Parâmetros:
contem_propriedade
funcao logico contem_propriedade(inteiro endereco, cadeia propriedade)
Identifica se o objeto contém ou não a propriedade informada
Parâmetros:
propriedade - propriedade utilizada para verificação
ServicosWeb
Esta biblioteca contém uma série de funções para trabalhar com serviços web
Constantes:
inteiro OBTER: Constante para definir o método HTTP

GET(https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#GET)
inteiro PUBLICAR: Constante para definir o método HTTP

POST(https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#POST)
inteiro ATUALIZAR: Constante para definir o método HTTP
PUT(https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#PUT)
inteiro EXCLUIR: Constante para definir o método HTTP

DELETE(https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#DELETE)
funcao vazio adicionar_parametros(cadeia objeto)
funcao vazio adicionar_cabecalho(cadeia chave, cadeia valor)
funcao vazio abrir_conexao(cadeia endereco)
funcao cadeia obter_dados(cadeia endereco)
funcao cadeia atualizar_dados(cadeia endereco, cadeia objeto)
funcao cadeia publicar_dados(cadeia endereco, cadeia objeto)
funcao cadeia fazer_requisicao(inteiro metodoHttp)
funcao cadeia excluir_dados(cadeia endereco)
adicionar_parametros
funcao vazio adicionar_parametros(cadeia objeto)
Adiciona um objeto no formato JSON na conexão customizável, para utilizar esta função é
necessário abrir uma conexão antes. Esta função deve ser utilizada para informar os parâmetros
dos métodos HTTP POST e PUT.
Parâmetros:
objeto - objeto no formato JSON passado por parâmetro no corpo da requisição
https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol
adicionar_cabecalho
funcao vazio adicionar_cabecalho(cadeia chave, cadeia valor)
Adiciona um cabeçalho na conexão customizável, para utilizar esta função é necessário abrir uma
conexão antes.
Parâmetros:
chave - chave do cabeçalho que será incluído na conexão
valor - valor do cabeçalho que será incluído na conexão
https://pt.wikipedia.org/wiki/Lista_de_campos_de_cabe%C3%A7alho_HTTP
abrir_conexao
funcao vazio abrir_conexao(cadeia endereco)
Abre uma conexão customizável com o endereço especificado.
Parâmetros:
endereco - endereço para o qual a requisição será feita
obter_dados
funcao cadeia obter_dados(cadeia endereco)
Realiza uma chamada HTTP GET para o endereço especificado, retornando uma cadeia no
formato JSON como resposta
Parâmetros:
Retorna: a cadeia JSON contendo a resposta da requisição
https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#GET
atualizar_dados
funcao cadeia atualizar_dados(cadeia endereco, cadeia objeto)
Realiza uma chamada HTTP PUT para o endereço especificado, retornando uma cadeia no
Parâmetros:
https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#PUT
publicar_dados
funcao cadeia publicar_dados(cadeia endereco, cadeia objeto)
Realiza uma chamada HTTP POST para o endereço especificado, retornando uma cadeia no
Parâmetros:
https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#POST
fazer_requisicao
funcao cadeia fazer_requisicao(inteiro metodoHttp)
Realiza uma chamada HTTP através de uma conexão customizada, retornando uma cadeia no
Parâmetros:
metodoHttp - Método HTTP que será utilizado nesta execução (GET, POST, PUT ou
DELETE).
excluir_dados
funcao cadeia excluir_dados(cadeia endereco)
Realiza uma chamada HTTP DELETE para o endereço especificado, retornando uma cadeia no
Parâmetros:
https://pt.wikipedia.org/wiki/Hypertext_Transfer_Protocol#DELETE
Sons
Esta biblioteca contém funções que permitem reproduzir sons dentro de um programa. No momento,
somente o formato MP3 é suportado.
funcao inteiro obter_volume_reproducao(inteiro endereco)
funcao inteiro obter_posicao_atual_musica(inteiro endereco)

funcao inteiro obter_tamanho_musica(inteiro endereco)
funcao vazio definir_volume_reproducao(inteiro endereco, inteiro

volume)
funcao vazio definir_posicao_atual_musica(inteiro endereco, inteiro

milissegundos)
funcao inteiro obter_volume()
funcao vazio definir_volume(inteiro volume)
funcao vazio interromper_som(inteiro endereco)
funcao inteiro carregar_som(cadeia caminho_som)
funcao vazio liberar_som(inteiro endereco)
funcao inteiro reproduzir_som(inteiro endereco, logico repetir)
funcao vazio pausar_som(inteiro endereco)
obter_volume_reproducao
funcao inteiro obter_volume_reproducao(inteiro endereco)
Retornar o volume de uma reprodução de som
Parâmetros:
endereco - O endereço de memória da reprodução que se quer obter o volume
Retorna: Um valor do tipo inteiro entre 0 e 100 representando o volume atual da reprodução.
Caso a reprodução não exista ou já tenha sido finalizada o valor -1 será retornado
obter_posicao_atual_musica
funcao inteiro obter_posicao_atual_musica(inteiro endereco)
Obtêm a posição atual da música em milisegundos
Parâmetros:
endereco - o endereço de memória da reprodução que se quer alterar o volume
Retorna: o tempo atual em milissegundos do som
obter_tamanho_musica
funcao inteiro obter_tamanho_musica(inteiro endereco)
Obtêm o tamanho da música em milisegundos
Parâmetros:
Retorna: tempo total em milissegundos do som
definir_volume_reproducao
funcao vazio definir_volume_reproducao(inteiro endereco, inteiro
volume)
Define um novo volume para um som que já está sendo executado
Parâmetros:
volume - o novo volume entre 0 e 100
definir_posicao_atual_musica
funcao vazio definir_posicao_atual_musica(inteiro endereco, inteiro
milissegundos)
Define a posição atual da música em milisegundos
Parâmetros:
milissegundos - o tempo em milissegundos que deseja colocar a musica
obter_volume
funcao inteiro obter_volume()
Retorna o volume geral
Retorna: Um valor do tipo inteiro entre 0 e 100 representando o volume geral atual.
definir_volume
funcao vazio definir_volume(inteiro volume)
Define o volume geral
Parâmetros:
volume - O novo volume geral (entre 0 e 100)
interromper_som
funcao vazio interromper_som(inteiro endereco)
Interrompe uma reprodução específica de um som que está sendo executada no momento
Parâmetros:
endereco - o endereço de memória da reprodução que se quer interromper
carregar_som
funcao inteiro carregar_som(cadeia caminho_som)
Carrega um som na memória para ser reproduzido mais tarde
Parâmetros:
caminho_som - o caminho para o arquivo de som no sistema de arquivos
Retorna: o endereço de memória no qual o som foi carregado
liberar_som
funcao vazio liberar_som(inteiro endereco)
Libera a memória utilizada por um som que tenha sido previamente carregado. Se o som estiver
sendo reproduzido, todas as reproduções deste som serão interrompidas
Parâmetros:
endereco - o endereço de memória do som
reproduzir_som
funcao inteiro reproduzir_som(inteiro endereco, logico repetir)
Reproduz um som previamente carregado na memória. O som é reproduzido de forma assíncrona,

ou seja, o som ficará reproduzindo no fundo, enquanto o programa executa as próximas instruções
normalmente. Um mesmo som pode ser reproduzido várias vezes e pode se sobrepor a outros
sons.
Parâmetros:
endereco - o endereço de memória do som a ser reproduzido
repetir - determina se o som deve ficar repetindo até ser manualmente interrompido
Retorna: o endereço de memória da reprodução de som. Este endereço é utilizado quando se

deseja interromper esta reprodução de som especificamente.
pausar_som
funcao vazio pausar_som(inteiro endereco)
Pausa uma reprodução específica de um som que está sendo executada no momento
Parâmetros:
endereco - o endereço de memória da reprodução que se quer interromper
Teclado
Esta biblioteca contém um conjunto de funções para manipular a entrada de dados através do teclado
do computador
IMPORTANTE: Esta biblioteca não funciona no console de entrada e saída de dados
do Portugol Studio, ela só funciona com a biblioteca Graficos, se o modo gráfico estiver iniciado.
Constantes:
inteiro TECLA_ENTER: Código numérico da tecla ENTER no teclado
inteiro TECLA_BACKSPACE: Código numérico da tecla BACKSPACE no teclado
inteiro TECLA_TAB: Código numérico da tecla TAB no teclado
inteiro TECLA_CANCELAR: Código numérico da tecla CANCELAR no teclado
inteiro TECLA_LIMPAR: Código numérico da tecla LIMPAR no teclado
inteiro TECLA_SHIFT: Código numérico da tecla SHIFT no teclado
inteiro TECLA_CONTROL: Código numérico da tecla CONTROL no teclado
inteiro TECLA_ALT: Código numérico da tecla ALT no teclado
inteiro TECLA_PAUSE: Código numérico da tecla PAUSE/BREAK no teclado
inteiro TECLA_CAPS_LOCK: Código numérico da tecla CAPSLOCK no teclado
inteiro TECLA_ESC: Código numérico da tecla ESC no teclado
inteiro TECLA_ESPACO: Código numérico da tecla ESPAÇO no teclado
inteiro TECLA_PAGE_UP: Código numérico da tecla PAGE UP no teclado
inteiro TECLA_PAGE_DOWN: Código numérico da tecla PAGE DOWN no teclado
inteiro TECLA_END: Código numérico da tecla END no teclado
inteiro TECLA_HOME: Código numérico da tecla HOME no teclado
inteiro TECLA_SETA_ESQUERDA: Código numérico da tecla SETA ESQUERDA no teclado
inteiro TECLA_SETA_ACIMA: Código numérico da tecla SETA ACIMA no teclado
inteiro TECLA_SETA_DIREITA: Código numérico da tecla SETA DIREITA no teclado
inteiro TECLA_SETA_ABAIXO: Código numérico da tecla SETA ABAIXO no teclado

inteiro TECLA_VIRGULA: Código numérico da tecla ',' no teclado
inteiro TECLA_MENOS: Código numérico da tecla '-' no teclado
inteiro TECLA_PONTO_FINAL: Código numérico da tecla '.' no teclado
inteiro TECLA_BARRA: Código numérico da tecla '/' no teclado
inteiro TECLA_0: Código numérico da tecla '0' no teclado
inteiro TECLA_PONTO_VIRGULA: Código numérico da tecla ';' no teclado
inteiro TECLA_IGUAL: Código numérico da tecla '=' no teclado
inteiro TECLA_A: Código numérico da tecla 'A' no teclado
inteiro TECLA_B: Código numérico da tecla 'B' no teclado
inteiro TECLA_C: Código numérico da tecla 'C' no teclado
inteiro TECLA_D: Código numérico da tecla 'D' no teclado
inteiro TECLA_E: Código numérico da tecla 'E' no teclado
inteiro TECLA_F: Código numérico da tecla 'F' no teclado
inteiro TECLA_G: Código numérico da tecla 'G' no teclado
inteiro TECLA_H: Código numérico da tecla 'H' no teclado
inteiro TECLA_I: Código numérico da tecla 'I' no teclado
inteiro TECLA_J: Código numérico da tecla 'J' no teclado
inteiro TECLA_K: Código numérico da tecla 'K' no teclado

inteiro TECLA_L: Código numérico da tecla 'L' no teclado
inteiro TECLA_M: Código numérico da tecla 'M' no teclado
inteiro TECLA_N: Código numérico da tecla 'N' no teclado
inteiro TECLA_O: Código numérico da tecla 'O' no teclado
inteiro TECLA_P: Código numérico da tecla 'P' no teclado
inteiro TECLA_Q: Código numérico da tecla 'Q' no teclado
inteiro TECLA_R: Código numérico da tecla 'R' no teclado
inteiro TECLA_S: Código numérico da tecla 'S' no teclado
inteiro TECLA_T: Código numérico da tecla 'T' no teclado
inteiro TECLA_U: Código numérico da tecla 'U' no teclado
inteiro TECLA_V: Código numérico da tecla 'V' no teclado
inteiro TECLA_W: Código numérico da tecla 'W' no teclado
inteiro TECLA_X: Código numérico da tecla 'X' no teclado
inteiro TECLA_Y: Código numérico da tecla 'Y' no teclado
inteiro TECLA_Z: Código numérico da tecla 'Z' no teclado
inteiro TECLA_ABRE_COLCHETES: Código numérico da tecla '[' no teclado
inteiro TECLA_BARRA_INVERTIDA: Código numérico da tecla '\' no teclado
inteiro TECLA_FECHA_COLCHETES: Código numérico da tecla ']' no teclado
inteiro TECLA_0_NUM: Código numérico da tecla '0' no teclado numérico

inteiro TECLA_MULTIPLICACAO: Código numérico da tecla '*' no teclado numérico
inteiro TECLA_ADICAO: Código numérico da tecla '+' no teclado numérico
inteiro TECLA_NUM_SEPARADOR_DECIMAL: Código numérico da tecla de separador decimal

(',' ou '.') no teclado numérico
inteiro TECLA_SUBTRACAO: Código numérico da tecla '-' no teclado numérico
inteiro TECLA_DECIMAL: ???
inteiro TECLA_DIVISAO: Código numérico da tecla '/' no teclado numérico
inteiro TECLA_DELETAR: Código numérico da tecla DELETE no teclado numérico
inteiro TECLA_NUM_LOCK: Código numérico da tecla NUM LOCK no teclado numérico
inteiro TECLA_SCROLL_LOCK: Código numérico da tecla SCROLL LOCK no teclado
inteiro TECLA_F1: Código numérico da tecla 'F1' no teclado

inteiro TECLA_PRINTSCREEN: Código numérico da tecla PRINT SCREEN no teclado
inteiro TECLA_INSERT: Código numérico da tecla INSERT no teclado
inteiro TECLA_AJUDA: Código numérico da tecla AJUDA no teclado
inteiro TECLA_WINDOWS: Código numérico da tecla de acesso ao menu Iniciar no teclado
inteiro TECLA_MENU_CONTEXTO: Código numérico da tecla MENU DE CONTEXTO no

teclado
funcao logico alguma_tecla_pressionada()
funcao caracter caracter_tecla(inteiro tecla)
funcao logico tecla_pressionada(inteiro tecla)
funcao inteiro ler_tecla()
alguma_tecla_pressionada
funcao logico alguma_tecla_pressionada()
Testa se existe alguma tecla pressionada neste instante
Retorna: o resultado do teste. Verdadeiro se houver uma tecla pressionada no momento do teste.
caracter_tecla
funcao caracter caracter_tecla(inteiro tecla)
Obtém o caracter correspondente a uma determinada tecla
Parâmetros:
tecla - a tecla para a qual se quer obter o caracter
Retorna: o caracter correspondente à tecla
tecla_pressionada
funcao logico tecla_pressionada(inteiro tecla)
Testa se uma determinada tecla está pressionada neste instante
Parâmetros:
tecla - o código da tecla que será testada
Retorna: o resultado do teste. Verdadeiro se a tecla estiver pressionada no momento do teste.

ler_tecla
funcao inteiro ler_tecla()
Aguarda até que uma tecla seja digitada, isto é, foi pressionada e depois solta, e captura o seu
código
Retorna: o código da tecla lida
Texto
Esta biblioteca contém funções para manipulação de texto (dados do tipo cadeia)
funcao cadeia caixa_alta(cadeia cad)
funcao cadeia caixa_baixa(cadeia cad)
funcao cadeia preencher_a_esquerda(caracter car, inteiro tamanho,

cadeia cad)
funcao caracter obter_caracter(cadeia cad, inteiro indice)

funcao cadeia substituir(cadeia cad, cadeia texto_pesquisa, cadeia
texto_substituto)
funcao inteiro numero_caracteres(cadeia cadeia)
funcao cadeia extrair_subtexto(cadeia cad, inteiro posicao_inicial,

inteiro posicao_final)
funcao inteiro posicao_texto(cadeia texto, cadeia cad, inteiro

posicao_incial)
caixa_alta
funcao cadeia caixa_alta(cadeia cad)
Transforma os caracteres de uma cadeia em caracteres maiúsculos
Parâmetros:
cad - um valor qualquer do tipo cadeia
Retorna: a cadeia com os caracteres transformados
caixa_baixa
funcao cadeia caixa_baixa(cadeia cad)
Transforma os caracteres de uma cadeia em caracteres minúsculos
Parâmetros:
cad - um valor qualquer do tipo cadeia
Retorna: a cadeia com os caracteres transformados
preencher_a_esquerda
funcao cadeia preencher_a_esquerda(caracter car, inteiro tamanho,
cadeia cad)
Concatena o caracter informado, à esquerda da cadeia, até que a cadeia fique do tamanho
indicado.
Se o tamanho da cadeia for maior ou igual ao tamanho informado, nada é feito
Parâmetros:
car - o caracter que será concatenado á esquerda da cadeia
tamanho - o tamanho final da cadeia
cad - a cadeia que será transformada
Retorna: a cadeia transformada
obter_caracter
funcao caracter obter_caracter(cadeia cad, inteiro indice)
Obtém um caracter da cadeia a partir de seu índice.

O índice deve estar entre 0 e o número de
caracteres da cadeia
Parâmetros:
cad - a cadeia da qual será obtido o caracater
indice - o indice do caracter que se deseja obter
Retorna: o caracater no índice informado
substituir
funcao cadeia substituir(cadeia cad, cadeia texto_pesquisa, cadeia
texto_substituto)
Pesquisa por um determinado texto em uma cadeia e substitui todas as ocorrências por um texto
alternativo
Parâmetros:
cad - a cadeia que será pesquisada
texto_pesquisa - o texto que será pesquisado na cadeia
texto_substituto - o texto pelo qual as ocorrências serão substituídas
Retorna: a cadeia resultante da substituição
numero_caracteres
funcao inteiro numero_caracteres(cadeia cadeia)
Conta o número de caracteres existentes em uma cadeia
Parâmetros:
cadeia - um valor qualquer do tipo cadeia
Retorna: o número de caracteres na cadeia
extrair_subtexto
funcao cadeia extrair_subtexto(cadeia cad, inteiro posicao_inicial,
inteiro posicao_final)
Extrai uma parte da cadeia delimitada pela posição inicial e final. Exemplos:
extrair_subtexto("salgado", 0, 3) // resultado: "sal"
extrair_subtexto("salgado", 3, 7) // resultado: "gado"
extrair_subtexto("salgado", 1, 5) // resultado: "alga"
Parâmetros:
cad - a cadeia a partir da qual será extraído o subtexto
posicao_inicial - a posição dentro da cadeia onde começará o subtexto
posicao_final - a posição dentro da cadeia onde terminará o subtexto
Retorna: uma cadeia contendo o subtexto
posicao_texto
funcao inteiro posicao_texto(cadeia texto, cadeia cad, inteiro
posicao_incial)
Procura por um texto dentro de uma cadeia e, caso encontrado, retorna a posição da primeira
ocorrência
Parâmetros:
texto - o texto que será procurado na cadeia
cad - a cadeia dentro da qual o texto será procurado
posicao_incial - a posição inicial a partir da qual o texto será procurado. Para procurar a
partir do início da cadeia deve-se informar a posição 0
Retorna: a posição da primeira ocorrência do texto, caso ele seja encontrado. Caso o texto não
seja encontrado na cadeia o valor retornado é -1
Tipos
Esta biblioteca contém funções que permitem converter os tipos de dado do Portugol entre si
funcao inteiro caracter_para_inteiro(caracter valor)
funcao caracter logico_para_caracter(logico valor)
funcao caracter inteiro_para_caracter(inteiro valor)

funcao inteiro cadeia_para_inteiro(cadeia valor, inteiro base)
funcao logico caracter_para_logico(caracter valor)
funcao inteiro logico_para_inteiro(logico valor)
funcao logico inteiro_para_logico(inteiro valor)
funcao cadeia caracter_para_cadeia(caracter valor)
funcao cadeia inteiro_para_cadeia(inteiro valor, inteiro base)
funcao caracter cadeia_para_caracter(cadeia valor)
funcao logico cadeia_e_real(cadeia cad)
funcao logico cadeia_e_logico(cadeia cad)
funcao logico cadeia_e_inteiro(cadeia cad, inteiro base)
funcao logico cadeia_e_caracter(cadeia cad)
funcao real cadeia_para_real(cadeia valor)
funcao inteiro real_para_inteiro(real valor)
funcao logico caracter_e_logico(caracter car)
funcao real inteiro_para_real(inteiro valor)
funcao logico caracter_e_inteiro(caracter car)
funcao logico inteiro_e_caracter(inteiro int)
funcao cadeia real_para_cadeia(real valor)
funcao cadeia logico_para_cadeia(logico valor)
funcao logico cadeia_para_logico(cadeia valor)
caracter_para_inteiro
funcao inteiro caracter_para_inteiro(caracter valor)
Converte um valor do tipo caracter em um valor do tipo inteiro
Parâmetros:
valor - o valor a ser convertido
Retorna: um valor do tipo caracter

logico_para_caracter
funcao caracter logico_para_caracter(logico valor)
Converte um valor do tipo logico em um valor do tipo caracter
Parâmetros:
Retorna: 'S' se o valor passado por parâmetro for verdadeiro, 'N' se o valor passado por parâmetro
for falso
inteiro_para_caracter
funcao caracter inteiro_para_caracter(inteiro valor)
Converte um valor do tipo inteiro em um valor do tipo caracter
Parâmetros:
cadeia_para_inteiro
funcao inteiro cadeia_para_inteiro(cadeia valor, inteiro base)
Converte um valor do tipo cadeia em um valor do tipo inteiro utilizando a base informada
Parâmetros:
base - a notação em que o número inteiro está representado na cadeia. Os valores possíveis
são: 2, 10 e 16.
O valor 2 assume que a cadeia representa um número inteiro escrito em
notação binária.
Ex.: 0b1001; 01101001; 101; 0B1101.
O valor 10 assume que a cadeia
representa um número inteiro escrito em notação decimal.
Ex.: 52; -34; 0; 71.
O valor 16
assume que a cadeia representa um número inteiro escrito em notação hexadecimal.
Ex.:
0xFF5AC; 0XDf5Ac01B; A0B551ce; ff00ff.
Caso a base informada seja diferente de
qualquer um destes valores, será gerado um erro de execução.
Retorna: um valor do tipo inteiro
caracter_para_logico
funcao logico caracter_para_logico(caracter valor)
Converte um valor do tipo caracter em um valor do tipo logico
Parâmetros:
Retorna: verdadeiro se o caracter for um dos seguintes valores: 'S', 's'; falso se o caracter for um
dos seguintes valores: 'N', 'n'
logico_para_inteiro
funcao inteiro logico_para_inteiro(logico valor)
Converte um valor do tipo logico em um valor do tipo inteiro
Parâmetros:
Retorna: 1 se o valor passado por parâmetro for verdadeiro, 0 se o valor passado por parâmetro
for falso
inteiro_para_logico
funcao logico inteiro_para_logico(inteiro valor)
Converte um valor do tipo inteiro em um valor do tipo logico
Parâmetros:
Retorna: falso se o valor for menor ou igual a 0, verdadeiro se o valor for maior ou igual a 1
caracter_para_cadeia
funcao cadeia caracter_para_cadeia(caracter valor)
Converte um valor do tipo caracter em um valor do tipo cadeia
Parâmetros:
Retorna: um valor do tipo cadeia
inteiro_para_cadeia
funcao cadeia inteiro_para_cadeia(inteiro valor, inteiro base)
Converte um valor do tipo inteiro em um valor do tipo cadeia utilizando a base informada
Parâmetros:
base - a notação em que o número inteiro está representado na cadeia. Os valores possíveis
são: 2, 10 e 16.
O valor 2 assume que a cadeia representa um número inteiro escrito em
notação binária.
Ex.: 0b1001; 01101001; 101; 0B1101.
O valor 10 assume que a cadeia
representa um número inteiro escrito em notação decimal.
Ex.: 52; -34; 0; 71.
O valor 16
assume que a cadeia representa um número inteiro escrito em notação hexadecimal.
Ex.:
0xFF5AC; 0XDf5Ac01B; A0B551ce; ff00ff.
Caso a base informada seja diferente de
qualquer um destes valores, será gerado um erro de execução.
cadeia_para_caracter
funcao caracter cadeia_para_caracter(cadeia valor)
Converte um valor do tipo cadeia em um valor do tipo caracter
Parâmetros:
cadeia_e_real
funcao logico cadeia_e_real(cadeia cad)
Verifica se a cadeia passada por parâmetro representa um valor do tipo real
Parâmetros:
cad - a cadeia a ser verificada
Retorna: verdadeiro se a cadeia representar um valor do tipo real, caso contrário, retorna falso
cadeia_e_logico
funcao logico cadeia_e_logico(cadeia cad)
Verifica se a cadeia passada por parâmetro representa um valor do tipo logico
Parâmetros:
Retorna: verdadeiro se a cadeia representar um valor do tipo logico, caso contrário, retorna falso
cadeia_e_inteiro
funcao logico cadeia_e_inteiro(cadeia cad, inteiro base)
Verifica se a cadeia passada por parâmetro representa um valor do tipo inteiro escrito na notação
definida pelo parâmetro base
Parâmetros:
base - a base que deverá ser assumida ao realizar a verificação. Os valores possíveis são: 2,
10 e 16.
O valor 2 assume que a cadeia representa um número inteiro escrito em notação
binária.
Ex.: 0b1001; 01101001; 101; 0B1101.
O valor 10 assume que a cadeia representa
um número inteiro escrito em notação decimal.
Ex.: 52; -34; 0; 71.
O valor 16 assume que a
cadeia representa um número inteiro escrito em notação hexadecimal.
Ex.: 0xFF5AC;
0XDf5Ac01B; A0B551ce; ff00ff.
Caso a base informada seja diferente de qualquer um
destes valores, será gerado um erro de execução.
Retorna: verdadeiro se a cadeia representar um valor do tipo inteiro, caso contrário, retorna falso
cadeia_e_caracter
funcao logico cadeia_e_caracter(cadeia cad)
Verifica se a cadeia passada por parâmetro representa um valor do tipo caracter
Parâmetros:
Retorna: verdadeiro se a cadeia representar um valor do tipo caracter, caso contrário, retorna
falso
cadeia_para_real
funcao real cadeia_para_real(cadeia valor)
Converte um valor do tipo cadeia em um valor do tipo real
Parâmetros:
Retorna: um valor do tipo real
real_para_inteiro
funcao inteiro real_para_inteiro(real valor)
Converte um valor do tipo real em um valor do tipo inteiro. Se o valor real tiver uma porção
fracionária (Ex.: 9.56), o valor será truncado (Ex.: 9)
Parâmetros:
Retorna: um valor do tipo inteiro
caracter_e_logico
funcao logico caracter_e_logico(caracter car)
Verifica se o caracter passado por parâmetro representa um valor do tipo logico
Parâmetros:
car - o caracter a ser verificado
Retorna: verdadeiro se o caracter for um dos seguintes valores: 'S', 's', 'N' ou 'n'. Caso contrário,
retorna falso
inteiro_para_real
funcao real inteiro_para_real(inteiro valor)
Converte um valor do tipo inteiro em um valor do tipo real
Parâmetros:
Retorna: um valor do tipo real
caracter_e_inteiro
funcao logico caracter_e_inteiro(caracter car)
Verifica se o caracter passado por parâmetro representa um valor do tipo inteiro
Parâmetros:
car - o caracter a ser verificado
Retorna: verdadeiro se o caracter representar um valor do tipo inteiro, caso contrário, retorna
falso
inteiro_e_caracter
funcao logico inteiro_e_caracter(inteiro int)
Verifica se o inteiro passado por parâmetro representa um valor do tipo caracter
Parâmetros:
int - o inteiro a a ser verificado
Retorna: verdadeiro se o inteiro representar um valor do tipo caracter, caso contrário, retorna
falso
real_para_cadeia
funcao cadeia real_para_cadeia(real valor)
Converte um valor do tipo real em um valor do tipo cadeia
Parâmetros:
logico_para_cadeia
funcao cadeia logico_para_cadeia(logico valor)
Converte um valor do tipo logico em um valor do tipo cadeia
Parâmetros:
cadeia_para_logico
funcao logico cadeia_para_logico(cadeia valor)
Converte um valor do tipo cadeia em um valor do tipo logico
Parâmetros:
Retorna: um valor do tipo logico
Util
Esta biblioteca contém diversas funções utilitárias
funcao cadeia obter_diretorio_usuario()

funcao vazio aguarde(inteiro intervalo)
funcao inteiro tempo_decorrido()
funcao inteiro numero_linhas(qualquer matriz[][])
funcao inteiro numero_elementos(qualquer vetor[])
funcao inteiro numero_colunas(qualquer matriz[][])
funcao inteiro sorteia(inteiro minimo, inteiro maximo)
obter_diretorio_usuario
funcao cadeia obter_diretorio_usuario()
Obtém o caminho utilizado pelo Sistema Operacional como diretório do usuário atual
Retorna: O diretório do usuário
aguarde
funcao vazio aguarde(inteiro intervalo)
Pausa a execução do programa durante o intervalo de tempo especificado
Parâmetros:
intervalo - o intervalo de tempo (em milissegundos) durante o qual o programa ficará
pausado
tempo_decorrido
funcao inteiro tempo_decorrido()
Obtém o tempo decorrido (em milissegundos) desde que a biblioteca foi utilizada pela primeira
vez
numero_linhas
funcao inteiro numero_linhas(qualquer matriz[][])
Descobre o número de linhas existentes em uma matriz
Parâmetros:
matriz - a matriz em questão
Retorna: O número de linhas existentes na matriz

numero_elementos
funcao inteiro numero_elementos(qualquer vetor[])
Descobre o número de elementos existentes em um vetor
Parâmetros:
vetor - o vetor em questão
Retorna: O número de elementos existentes no vetor
numero_colunas
funcao inteiro numero_colunas(qualquer matriz[][])
Descobre o número de colunas existentes em uma matriz
Parâmetros:
matriz - a matriz em questão
Retorna: O número de colunas existentes na matriz
sorteia
funcao inteiro sorteia(inteiro minimo, inteiro maximo)
Sorteia um número aleatório entre os valores mínimo e máximo especificados
Parâmetros:
minimo - o menor número que pode ser sorteado
maximo - o maior número que pode ser sorteado
Retorna: O número sorteado

Portugol Bibliotecas

Enviado por

Direitos autorais:

Formatos disponíveis

Portugol Bibliotecas

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Portugol Bibliotecas

Enviado por

Direitos autorais:

Formatos disponíveis

Bibliotecas

Arquivos Esta biblioteca permite ler e escrever arquivos

Calendario Esta biblioteca é utilizada para retornar a data e(ou) hora do computador

Internet Esta biblioteca contém diversas funções de conexão com a web

Util Esta biblioteca contém diversas funções utilitárias

Esta biblioteca permite ler e escrever arquivos

funcao vazio listar_arquivos_por_tipo(cadeia caminho_pai, cadeia

funcao inteiro abrir_arquivo(cadeia caminho_arquivo, inteiro

funcao logico fim_arquivo(inteiro endereco)

funcao vazio substituir_texto(cadeia endereco, cadeia texto_pesquisa,

funcao vazio escrever_linha(cadeia linha, inteiro endereco)

funcao vazio fechar_arquivo(inteiro endereco)

funcao cadeia ler_linha(inteiro endereco)

funcao logico arquivo_existe(cadeia caminho_arquivo)

funcao cadeia selecionar_arquivo(cadeia formatos_suportados[], logico

funcao vazio listar_pastas(cadeia caminho_pai, cadeia vetor_pastas[])

funcao vazio apagar_arquivo(cadeia caminho_arquivo)

funcao vazio listar_arquivos(cadeia caminho_pai, cadeia

funcao vazio criar_pasta(cadeia caminho)

Detalhamento das Funções:

Altera um vetor para que ele represente os arquivos existentes em um diretório

IMPORTANTE: ao abrir o arquivo no modo de escrita, o conteúdo do arquivo é apagado para

Constantes aceitas: MODO_LEITURA | MODO_ESCRITA | MODO_ACRESCENTAR

Retorna: o endereço de memória onde o arquivo foi carregado

Fecha um arquivo aberto anteriormente

Retorna: Uma cadeia contendo o conteudo da linha lida.

Verifica se um determinado arquivo existe no sistema de arquivos

Retorna: verdadeiro se o arquivo existir

Retorna: O arquivo_selecionado ou uma string vazia caso o usuário tenha cancelado.

Altera um vetor para que ele represente as pastas existentes em um diretório

Remove um arquivo do sistema de arquivos

Altera um vetor para que ele represente os arquivos existentes em um diretório

Cria pastas no caminho informado caso elas não existam

Esta biblioteca é utilizada para retornar a data e(ou) hora do computador

inteiro DIA_DOMINGO: constante que representa o 'Domingo'

inteiro DIA_SEGUNDA_FEIRA: constante que representa a 'Segunda-Feira'

inteiro DIA_TERCA_FEIRA: constante que representa a 'Terça-Feira'

inteiro DIA_QUARTA_FEIRA: constante que representa a 'Quarta-Feira'

inteiro DIA_QUINTA_FEIRA: constante que representa a 'Quinta-Feira'

inteiro DIA_SEXTA_FEIRA: constante que representa a 'Sexta-Feira'

inteiro DIA_SABADO: constante que representa o 'Sábado'

inteiro MES_JANEIRO: constante que representa o mês de 'Janeiro'

inteiro MES_FEVEREIRO: constante que representa o mês de 'Fevereiro'

inteiro MES_MARCO: constante que representa o mês de 'Março'

inteiro MES_ABRIL: constante que representa o mês de 'Abril'

inteiro MES_MAIO: constante que representa o mês de 'Maio'

inteiro MES_JUNHO: constante que representa o mês de 'Junho'

inteiro MES_JULHO: constante que representa o mês de 'Julho'

inteiro MES_AGOSTO: constante que representa o mês de 'Agosto'

inteiro MES_SETEMBRO: constante que representa o mês de 'Setembro'

inteiro MES_OUTUBRO: constante que representa o mês de 'Outubro'

inteiro MES_NOVEMBRO: constante que representa o mês de 'Novembro'

inteiro MES_DEZEMBRO: constante que representa o mês de 'Dezembro'

Índice das Funções:

funcao cadeia dia_semana_completo(inteiro numero_dia, logico

funcao cadeia dia_semana_abreviado(inteiro numero_dia, logico

funcao inteiro mes_atual()

funcao inteiro dia_mes_atual()