@designliquido/delegua
Version:
Linguagem de programação simples e moderna usando português estruturado.
327 lines • 16.3 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
const informacao_variavel_ou_constante_1 = require("../informacao-variavel-ou-constante");
exports.default = {
adicionar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('elemento', 'qualquer', true, [], 'Os elementos a serem adicionados ao vetor.')
],
implementacao: (interpretador, vetor, elemento) => {
vetor.push(elemento);
return Promise.resolve(vetor);
},
assinaturaFormato: 'vetor.adicionar(...elemento: qualquer)',
documentacao: '# `vetor.adicionar(elemento)` \n \n' +
'Adiciona um ou mais elementos em um vetor.' +
'\n\n ## Exemplo de Código\n' +
'```delegua\nv.adicionar(7)\n' +
'v.adicionar(5)\n' +
'v.adicionar(3)\n' +
'escreva(v) // [7, 5, 3]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.adicionar(elemento)'
},
concatenar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('outroVetor', 'qualquer[]', true, [], 'O outro vetorm ou outros vetores, a serem concatenados a este vetor.')
],
implementacao: (interpretador, vetor, outroVetor) => {
return Promise.resolve(vetor.concat(outroVetor));
},
assinaturaFormato: 'vetor.concatenar(...outroVetor: qualquer[])',
documentacao: '# `vetor.concatenar(outroVetor)` \n \n' +
'Adiciona ao conteúdo do vetor um ou mais elementos' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [7, 5, 3]\n' +
'escreva(v.concatenar([1, 2, 4])) // [7, 5, 3, 1, 2, 4]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.concatenar(...argumentos)'
},
empilhar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('elemento', 'qualquer', true, [], '')
],
implementacao: (interpretador, vetor, elemento) => {
vetor.push(elemento);
return Promise.resolve(vetor);
},
assinaturaFormato: 'vetor.empilhar(elemento: qualquer)',
documentacao: '# `vetor.empilhar(elemento)` \n \n' +
'Adiciona um elemento ao final do vetor, como se o vetor fosse uma pilha na vertical.' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = []\n' +
'v.empilhar(7)\n' +
'v.empilhar(5)\n' +
'v.empilhar(3)\n' +
'escreva(v) // [7, 5, 3]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.empilhar(elemento)'
},
encaixar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('inicio', 'inteiro'),
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('excluirQuantidade', 'número'),
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('itens', 'qualquer[]'),
],
implementacao: (interpretador, vetor, inicio, excluirQuantidade, ...itens) => {
let elementos = [];
if (excluirQuantidade || excluirQuantidade === 0) {
elementos = !itens.length
? vetor.splice(inicio, excluirQuantidade)
: vetor.splice(inicio, excluirQuantidade, ...itens);
}
else {
elementos = !itens.length ? vetor.splice(inicio) : vetor.splice(inicio, ...itens);
}
return Promise.resolve(elementos);
},
},
fatiar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('inicio', 'número', false, [], 'A posição de início do vetor a ser fatiado. Se não fornecido, retorna o vetor inteiro.'),
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('fim', 'número', false, [], 'A posição de fim do vetor a ser fatiado.'),
],
implementacao: (interpretador, vetor, inicio, fim) => Promise.resolve(vetor.slice(inicio, fim)),
assinaturaFormato: 'vetor.fatiar(inicio?: número, fim?: número)',
documentacao: '# `vetor.fatiar(inicio, fim)` \n \n' +
'Extrai uma fatia do vetor, dadas posições de início e fim. \n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3, 4, 5]\n' +
'escreva(v.fatiar()) // "[1, 2, 3, 4, 5]", ou seja, não faz coisa alguma.\n' +
'escreva(v.fatiar(2, 4)) // "[3, 4]"\n' +
'escreva(v.fatiar(2)) // "[3, 4, 5]", ou seja, seleciona tudo da posição 3 até o final do vetor.\n```' +
'\n\n ### Formas de uso \n' +
'Fatiar suporta sobrecarga do método.\n\n',
exemploCodigo: 'vetor.fatiar(<a partir desta posição>)\n' +
'vetor.fatiar(<a partir desta posição>, <até esta posição>)'
},
filtrarPor: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('funcao', 'função', true, [], 'A função de filtragem.')
],
implementacao: async (interpretador, vetor, funcao) => {
if (funcao === undefined || funcao === null) {
return Promise.reject("É necessário passar uma função para o método 'filtrarPor'");
}
const retorno = [];
for (let elemento of vetor) {
if (await funcao.chamar(interpretador, [elemento])) {
retorno.push(elemento);
}
}
return retorno;
},
assinaturaFormato: 'vetor.filtrarPor(funcao: função)',
documentacao: '# `vetor.filtrarPor(funcao)` \n \n' +
'Dada uma função passada como parâmetro, executa essa função para cada elemento do vetor. \n' +
'Elementos cujo retorno da função é `falso` são excluídos. \n' +
'\n\n ### Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3, 4, 5]\n' +
'var funcaoNumerosImpares = funcao (n) { retorna n % 2 > 0 }\n' +
'escreva(v.filtrarPor(funcaoNumerosImpares)) // "[1, 3, 5]"\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.filtrarPor(funcao (argumento) { <corpo da função com retorna> })'
},
inclui: {
tipoRetorno: 'lógico',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('elemento', 'qualquer', true, [], 'O elemento a ser verificado se está presente no vetor.')
],
implementacao: (interpretador, vetor, elemento) => Promise.resolve(vetor.includes(elemento)),
assinaturaFormato: 'vetor.inclui(elemento: qualquer)',
documentacao: '# `vetor.inclui(elemento)` \n \n' +
'Verifica se o elemento existe no vetor. Devolve `verdadeiro` se existe, e `falso` em caso contrário.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3]\n' +
'escreva(v.inclui(2)) // verdadeiro\n' +
'escreva(v.inclui(4)) // falso\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.inclui(elemento)'
},
inverter: {
tipoRetorno: 'qualquer[]',
argumentos: [],
implementacao: (interpretador, vetor) => Promise.resolve(vetor.reverse()),
assinaturaFormato: 'vetor.inverter()',
documentacao: '# `vetor.inverter()` \n \n' +
'Inverte a ordem dos elementos de um vetor.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3]\n' +
'escreva(v.inverter()) // [3, 2, 1]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.inverter()'
},
juntar: {
tipoRetorno: 'texto',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('separador', 'texto', true, [], 'O separador entre elementos do vetor para o texto.')
],
implementacao: (interpretador, vetor, separador) => Promise.resolve(vetor.join(separador)),
assinaturaFormato: 'vetor.juntar(separador: texto)',
documentacao: '# `vetor.juntar(separador)` \n \n' +
'Junta todos os elementos de um vetor em um texto, separando cada elemento pelo separador passado como parâmetro.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3]\n' +
'escreva(v.juntar(":")) // "1:2:3"\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.juntar()'
},
mapear: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('funcao', 'função', true, [], 'A função que transforma cada elemento de um vetor em outro elemento a ser retornado em um novo vetor.')
],
implementacao: async (interpretador, vetor, funcao) => {
if (funcao === undefined || funcao === null) {
return Promise.reject("É necessário passar uma função para o método 'mapear'");
}
const retorno = [];
for (let elemento of vetor) {
let resultado = await funcao.chamar(interpretador, [elemento]);
retorno.push(resultado);
}
return retorno;
},
assinaturaFormato: 'vetor.mapear(funcao: função)',
documentacao: '# `vetor.mapear(funcao)` \n \n' +
'Dada uma função passada como parâmetro, executa essa função para cada elemento do vetor. \n' +
'Cada elemento retornado por esta função é adicionado ao vetor resultante. \n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar v = [1, 2, 3, 4, 5]\n' +
'var funcaoPotenciasDeDois = funcao (n) { retorna n ** 2 }\n' +
'escreva(v.mapear(funcaoPotenciasDeDois)) // [1, 4, 9, 16, 25]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.mapear(funcao (argumento) { <corpo da função com retorna> })'
},
ordenar: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('funcaoOrdenacao', 'função', false, [], '(Opcional) Função para guiar a ordenação.')
],
implementacao: async (interpretador, vetor, funcaoOrdenacao) => {
if (funcaoOrdenacao !== undefined && funcaoOrdenacao !== null) {
for (let i = 0; i < vetor.length - 1; i++) {
for (let j = 1; j < vetor.length; j++) {
if ((await funcaoOrdenacao.chamar(interpretador, [
vetor[j - 1],
vetor[j],
])) > 0) {
const aux = vetor[j];
vetor[j] = vetor[j - 1];
vetor[j - 1] = aux;
}
}
}
return vetor;
}
if (!vetor.every((v) => typeof v === 'number')) {
return vetor.sort();
}
return vetor.sort((a, b) => a - b);
},
assinaturaFormato: 'vetor.ordenar()',
documentacao: '# `vetor.ordenar()` \n \n' +
'Ordena valores de um vetor em ordem crescente.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\n// A ordenação padrão é ascendente, ou seja, para o caso de números, a ordem fica do menor para o maior.\n' +
'var v = [4, 2, 12, 5]\n' +
'escreva(v.ordenar()) // [2, 4, 5, 12]\n' +
'// Para o caso de textos, a ordenação é feita em ordem alfabética, caractere a caractere.\n' +
'var v = ["aaa", "a", "aba", "abb", "abc"]\n' +
'escreva(v.ordenar()) // ["a", "aaa", "aba", "abb", "abc"]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.ordenar()'
},
remover: {
tipoRetorno: 'qualquer[]',
argumentos: [
new informacao_variavel_ou_constante_1.InformacaoVariavelOuConstante('elemento', 'qualquer', true, [], 'O elemento a ser removido do vetor.')
],
implementacao: (interpretador, vetor, elemento) => {
const index = vetor.indexOf(elemento);
if (index !== -1)
vetor.splice(index, 1);
return Promise.resolve(vetor);
},
assinaturaFormato: 'vetor.remover(elemento: qualquer)',
documentacao: '# `vetor.remover(elemento)` \n \n' +
'Remove um elemento do vetor caso o elemento exista no vetor.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar vetor = [1, 2, 3]\n' +
'vetor.remover(2)\n' +
'escreva(vetor) // [1, 3]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.remover(elemento)'
},
removerPrimeiro: {
tipoRetorno: 'qualquer',
argumentos: [],
implementacao: (interpretador, vetor) => {
let elemento = vetor.shift();
return Promise.resolve(elemento);
},
assinaturaFormato: 'vetor.removerPrimeiro()',
documentacao: '# `vetor.removerPrimeiro()` \n \n' +
'Remove o primeiro elemento do vetor caso o elemento exista no vetor.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar vetor = [1, 2, 3]\n' +
'var primeiroElemento = vetor.removerPrimeiro()\n' +
'escreva(primeiroElemento) // 1\n' +
'escreva(vetor) // [2, 3]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.removerPrimeiro()'
},
removerUltimo: {
tipoRetorno: 'qualquer',
argumentos: [],
implementacao: (interpretador, vetor) => {
let elemento = vetor.pop();
return Promise.resolve(elemento);
},
assinaturaFormato: 'vetor.removerUltimo()',
documentacao: '# `vetor.removerUltimo()` \n \n' +
'Remove o último elemento do vetor caso o elemento exista no vetor.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar vetor = [1, 2, 3]\n' +
'var ultimoElemento = vetor.removerUltimo()\n' +
'escreva(ultimoElemento) // 3\n' +
'escreva(vetor) // [1, 2]\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.removerUltimo()'
},
somar: {
tipoRetorno: 'qualquer',
argumentos: [],
implementacao: (interpretador, vetor) => {
return Promise.resolve(vetor.reduce((acc, item) => acc + (typeof item === 'number' ? item : item.valor), 0));
},
assinaturaFormato: 'vetor.somar()',
documentacao: '# `vetor.somar()` \n \n' +
'Soma ou concatena todos os elementos do vetor (de acordo com o tipo de dados desses elementos) e retorna o resultado.\n' +
'\n\n ### Exemplo de Código\n' +
'\n\n```delegua\nvar vetor = [1, 2, 3, 4, 5]\n' +
'escreva(vetor.somar()) // 15\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.somar()'
},
tamanho: {
tipoRetorno: 'número',
argumentos: [],
implementacao: (interpretador, vetor) => Promise.resolve(vetor.length),
assinaturaFormato: 'vetor.tamanho()',
documentacao: '# `vetor.tamanho()` \n \n' +
'Retorna o número de elementos que compõem o vetor.\n' +
'\n\n ## Exemplo de Código\n' +
'\n\n```delegua\nvar vetor = [0, 1, 2, 3, 4]\n' +
'escreva(vetor.tamanho()) // 5\n```' +
'\n\n ### Formas de uso \n',
exemploCodigo: 'vetor.tamanho()'
},
};
//# sourceMappingURL=primitivas-vetor.js.map