equat

equat é o package que contém as classes que implementam expressões matemáticas como grafos de árvores (conforme descrito aqui). Admito que a escolha do nome não parece apropriada, visto que esta versão do package não pode ser usada para resolver equações matemáticas, mas fica aberta a possibilidade para o futuro. As classes deste package são:


equation.class

Interface implementada por todos os nós da árvore. Consiste de dois métodos:

• eval(): avalia (evaluate) a expressão de cuja árvore este nó é raiz.
• prec(): retorna um número inteiro que mede a precedência da operação realizada por este nó. Por exemplo, a precedência da multiplicação é maior que a da soma, o que faz com que a multiplicação seja realizada primeiro na avaliação de uma expressão como 2+3*5. Apesar de ser o formato da árvore que determina qual a ordem com que as operações são feitas na avaliação da expressão, é importante poder saber a precedência das operações para realizar rotinas como parsing de expressões, por exemplo.

eqUnaria.class

Classe base de todas as operações matemáticas que possuem apenas um parâmetro. Implementa a interface equation. Cada nó deste tipo possui apenas um filho, representando o parâmetro da operação. As seguintes classes herdam esta classe:

Classe	Operação
eqCeil.class	Retorna o menor inteiro maior ou igual ao parâmetro
eqCos.class	Calcula o cosseno do parâmetro (em radianos)
eqExp.class	Calcula e (número de Euler = 2.71828...) elevado à potência do parâmetro, conforme as convenções do método Math.exp()
eqFabs.class	Calcula o módulo do parâmetro
eqFloor.class	Retorna o menor inteiro menor ou igual ao parâmetro
eqInv.class	Retorna o parâmetro com o sinal invertido
eqLog.class	Calcula o logaritmo natural do parâmetro, conforme as convenções do método Math.log()
eqNot.class	NOT lógico. Se o parâmetro for um número não-nulo, retorna zero. Caso contrário, retorna um número não-nulo
eqRand.class	Retorna um número aleatório uniformemente distribuído no intervalo [0, parâmetro[, gerado pelo método Rand.nextDouble()
eqRound.class	Retorna o número inteiro mais próximo do parâmetro
eqSin.class	Calcula o cosseno do parâmetro (em radianos)
eqSqrt.class	Calcula a raiz quadrada do parâmetro

eqBinaria.class

Classe base de todas as operações matemáticas que possuem dois parâmetros. Implementa a interface equation. Cada nó deste tipo possui dois filhos, representando os parâmetros da operação. As seguintes classes herdam esta classe:

Classe	Operação
eqAnd.class	AND lógico. Se os dois parâmetros forem números não-nulos, retorna um número não-nulo. Caso contrário, retorna zero
eqDiferente.class	Retorna um número não-nulo, se os dois parâmetros forem números diferentes, ou zero, em caso contrário
eqDiv.class	Calcula o resultado da divisão do primeiro parâmetro (filho da esquerda) pelo segundo parâmetro, seguindo as convenções de divisão do Java
eqIgual.class	Retorna um número não-nulo, se os dois parâmetros forem números iguais, ou zero, em caso contrário
eqMult.class	Calcula o resultado da multiplicação dos dois parâmetros
eqMaior.class	Retorna um número não-nulo, se o primeiro parâmetro (filho da esquerda) for estritamente maior que o segundo parâmetro, ou zero, em caso contrário
eqMaiorIgual.class	Retorna um número não-nulo, se o primeiro parâmetro (filho da esquerda) for maior ou igual que o segundo parâmetro, ou zero, em caso contrário
eqMenor.class	Retorna um número não-nulo, se o primeiro parâmetro (filho da esquerda) for estritamente menor que o segundo parâmetro, ou zero, em caso contrário
eqMenorIgual.class	Retorna um número não-nulo, se o primeiro parâmetro (filho da esquerda) for menor ou igual que o segundo parâmetro, ou zero, em caso contrário
eqMod.class	Calcula o resto da divisão do primeiro parâmetro (filho da esquerda) pelo segundo parâmetro, seguindo as convenções de divisão do Java
eqNrand.class	Retorna um número aleatório, cuja distribuição é uma Gaussiana de média igual ao primeiro parâmetro (filho da esquerda) e desvio-padrão igual so segundo parâmetro
eqOr.class	OR lógico. Se pelo menos um dos dois parâmetros for não-nulo, retorna um número não-nulo. Caso contrário, retorna zero
eqPow.class	Calcula o valor do primeiro argumento (filho da esquerda) elevado à potência do segundo argumento, de acordo com as convenções do método Math.pow()
eqSoma.class	Calcula a soma dos dois argumentos
eqSub.class	Calcula o resultado da subtração do primeiro argumento (filho da esquerda) pelo segundo argumento

eqTernaria.class

Classe base de todas as operações matemáticas que possuem apenas um parâmetro. Implementa a interface equation. Cada nó deste tipo possui três filho, representando os parâmetros da operação. Nesta versão do package, apenas uma classe herda esta classe:

Classe	Operação
eqIf.class	Operação lógica IF. Se o valor do primeiro parâmetro (filho da esquerda) for não-nulo, retorna o valor do segundo parâmetro (filho do meio). Caso contrário, retorna o valor do terceiro parâmetro

Folhas da árvore

As folhas das árvores de expressões, por não possuirem filhos, não realizam nenhuma operação matemática, e servem para armazenar valores numéricos. Estas classes implementam a interface equation.class.

Classe	Descrição
eqNum.class	Armazena um número. O resultado da avaliação deste nó é o próprio valor que armazena
eqVar.class	Representa uma variável de uma função ou uma literal. Herda a classe eqNum.java, ou seja, também armazena valores numéricos, mas também armazena uma String que identifica seu nome