jme

Class Util

java.lang.Object

jme.Util

public final class Util
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Util.FilterToken Interfaz para mostrar una cadena a partir de token definida por usuario

Field Summary

Fields

Modifier and Type	Field and Description
static java.math.BigInteger	B2
static java.math.BigDecimal	D100
static java.math.BigDecimal	D2
static java.math.BigDecimal	D3
static java.lang.String	EOL_REGEX equivalente a \R en Java 8+
static Util.FilterToken	INPUT_FILTER Filtro para Token#entrada
static Util.FilterToken	OUTPUT_FILTER Filtro para Token#toString
static RealDoble	RINV_E
static RealDoble	RMINUS0
static RealDoble	RMINUS2
static RealDoble	RPI2
static double	SI_C vel. luz m/s
static double	SI_G constante de gravitación G en el SI
static double	SI_H constante de Planck en J·s
static double	SI_Ke Constante de Coulomb en el SI

Method Summary

Modifier and Type	Method and Description
static java.lang.String	cadenaCortada(java.lang.String s, int limite, java.lang.String sufijo) Recorta una cadena si excede el limite
static Token	cargarArchivoBin(java.lang.String filename) Carga token o terminal almacenado en archivo en forma binaria
static java.lang.String[]	cargarArchivoTexto(java.lang.String filename) Carga líneas de archivo de texto
static <T> T	cast(Vector v, int index, java.lang.Class<T> clase)
static java.lang.String	concatenar(java.lang.String conector, java.lang.String... cadenas) Concatena un array de cadenas mediante conector
static java.lang.String[]	convertir(Token[] array, Util.FilterToken filter) Convierte un array de tokens en array de String mediante un filtro
static java.lang.String[]	getIdentificadorArrayFromToken(Token maybeId)
static java.lang.String	getIdentificadorFromToken(Token maybeId)
static Vector	getVectorFromToken(Token maybeVector)
static JMEMath.TeoriaGrafos.Grafo	grafoDesdeDiccionario(Diccionario d)
static void	guardarArchivoBin(java.lang.String filename, Token data) Guarda un token o terminal en un archivo binario
static void	guardarArchivoTexto(java.lang.String filename, Terminal data, boolean append) Guarda un terminal en un archivo de texto nuevo o añade al final
static double[][]	matrizIniciada(int m, int n, double valor)
static Booleano	parametroBooleano(Funcion f, Vector v, int index) Leer parámetros Booleano de una función JME
static JMEContext	parametroContext(Funcion f, Vector v, int index) Leer contexto matemático de una función JME
static Diccionario	parametroDiccionario(Funcion f, Vector v, int index) Leer diccionario de una función JME
static Expresion	parametroExpresion(Funcion f, Vector v, int index) Leer parámetros Expresion de una función JME
static Numero	parametroNumero(Funcion f, Vector v, int index) Leer parámetros numéricos de una función JME
static Terminal	parametroTerminal(Funcion f, Vector v, int index) Leer parámetro general de una función JME
static Texto	parametroTexto(Funcion f, Vector v, int index) Leer parámetros Texto de una función JME
static VectorEvaluado	parametroVector(Funcion f, Vector v, int index) Leer parámetros VectorEvaluado de una función JME
static VectorEvaluado	parametroVector(Funcion f, Vector v, int index, int tama)
static Expresion[]	parametroVectorExpresiones(Funcion f, Vector v, int index) Leer una o varias expresiones de un único parámetro vectorial
static java.lang.String	printNanos(long nanos) Imprime nanosegundos en distintas unidades de tiempo más legibles Nota: no siempre se muestra el resultado con la máxima precisión por legibilidad
static <T> java.util.Collection<T>	putInto(java.util.Collection<T> col, T... values) Guarda valores en una colección a partir de un array
static <K,V> java.util.Map<K,V>	putIntoMap(java.util.Map<K,V> map, java.lang.Object... keyValuePairs) Store entries in a map from Object array
static int[]	rango(int a, int b, int p)
static <T> T	swap(T a, T b) "Intercambia" variables en JAVA usando asignación de parámetros en invocación.
static int	terminalAIndiceNodo(JMEMath.TeoriaGrafos.Grafo grafo, Terminal nodo)
static <T> T[]	toArray(java.lang.Class<T> clazz, java.util.Collection<T> col) Copia los elementos de una colección en un array de la case especificada
static boolean	todoNull(java.lang.Object... objetos)
static double[][]	toDoubleMatrix(VectorEvaluado matriz)
static int[]	toIntArray(java.lang.Integer[] array)
static int[]	toIntArray(VectorEvaluado vectorEntero)
static java.lang.Integer[]	toIntegerArray(int[] intArray)
static int[][]	toIntMatrix(VectorEvaluado matriz)
static java.lang.String[]	toStringArray(VectorEvaluado v)
static int[]	vectorAIndicesNodo(JMEMath.TeoriaGrafos.Grafo grafo, VectorEvaluado vnodos)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OUTPUT_FILTER

public static final Util.FilterToken OUTPUT_FILTER

Filtro para Token#toString

INPUT_FILTER

public static final Util.FilterToken INPUT_FILTER

Filtro para Token#entrada

D2

public static final java.math.BigDecimal D2

D3

public static final java.math.BigDecimal D3

D100

public static final java.math.BigDecimal D100

B2

public static final java.math.BigInteger B2

RMINUS0

public static final RealDoble RMINUS0

RMINUS2

public static final RealDoble RMINUS2

RPI2

public static final RealDoble RPI2

RINV_E

public static final RealDoble RINV_E

EOL_REGEX

public static final java.lang.String EOL_REGEX

equivalente a \R en Java 8+

See Also:

Constant Field Values

SI_C

public static final double SI_C

vel. luz m/s

See Also:

Constant Field Values

SI_H

public static final double SI_H

constante de Planck en J·s

See Also:

Constant Field Values

SI_G

public static final double SI_G

constante de gravitación G en el SI

See Also:

Constant Field Values

SI_Ke

public static final double SI_Ke

Constante de Coulomb en el SI

See Also:

Constant Field Values

Method Detail

swap

public static <T> T swap(T a,
                         T b)

"Intercambia" variables en JAVA usando asignación de parámetros en invocación.
Es una función K-combinator.
Uso: y=swap(x,x=y)

·Ejemplo; intercambio mutuo de variables:
 int x=3,y=10;
 y=swap(x,x=y);
  x←10, y←3

·Ejemplo; intercambio de una variable y asignación a la otra:
 int x,y=10;
 y=swap(3,x=y);
  x←10, y←3

·Ejemplo; asignación de máximo y mínimo de dos variables a las propias variables:
 int a=10,b=3;
 a=swap(Math.min(a,b),b=Math.max(a,b));
  a←3, b←10
también
 b=swap(Math.max(a,b),a=Math.min(a,b));

Parameters:

a - primer valor a intercambiar

b - segundo valor asignándolo a la primera variable

Returns:

a

Since:

0.6.2.0

getVectorFromToken

public static Vector getVectorFromToken(Token maybeVector)

getIdentificadorFromToken

public static java.lang.String getIdentificadorFromToken(Token maybeId)

getIdentificadorArrayFromToken

public static java.lang.String[] getIdentificadorArrayFromToken(Token maybeId)

cast

public static <T> T cast(Vector v,
                         int index,
                         java.lang.Class<T> clase)
                  throws ConversionException

Throws:

ConversionException

parametroTerminal

public static Terminal parametroTerminal(Funcion f,
                                         Vector v,
                                         int index)
                                  throws ExpresionException

Leer parámetro general de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

parámetro después de evaluar

Throws:

ExpresionException - error al evaluar

parametroNumero

public static Numero parametroNumero(Funcion f,
                                     Vector v,
                                     int index)
                              throws ExpresionException

Leer parámetros numéricos de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor como 'Numero' del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroContext

public static JMEContext parametroContext(Funcion f,
                                          Vector v,
                                          int index)
                                   throws ExpresionException

Leer contexto matemático de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor como 'JMEContext' del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroDiccionario

public static Diccionario parametroDiccionario(Funcion f,
                                               Vector v,
                                               int index)
                                        throws ExpresionException

Leer diccionario de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor como Diccionario del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroVector

public static VectorEvaluado parametroVector(Funcion f,
                                             Vector v,
                                             int index)
                                      throws ExpresionException

Leer parámetros VectorEvaluado de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor VectorEvaluado del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroVector

public static VectorEvaluado parametroVector(Funcion f,
                                             Vector v,
                                             int index,
                                             int tama)
                                      throws ExpresionException

Throws:

ExpresionException

parametroBooleano

public static Booleano parametroBooleano(Funcion f,
                                         Vector v,
                                         int index)
                                  throws ExpresionException

Leer parámetros Booleano de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor 'Booleano' del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroTexto

public static Texto parametroTexto(Funcion f,
                                   Vector v,
                                   int index)
                            throws ExpresionException

Leer parámetros Texto de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor 'Texto' del parámetro si no hay excepción

Throws:

ExpresionException - error al evaluar o parámetro de tipo érroneo

parametroExpresion

public static Expresion parametroExpresion(Funcion f,
                                           Vector v,
                                           int index)
                                    throws ConversionException

Leer parámetros Expresion de una función JME

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

valor 'Expresion' del parámetro si no hay excepción

Throws:

ExpresionException - parámetro de tipo érroneo

ConversionException

parametroVectorExpresiones

public static Expresion[] parametroVectorExpresiones(Funcion f,
                                                     Vector v,
                                                     int index)
                                              throws ConversionException

Leer una o varias expresiones de un único parámetro vectorial

Parameters:

f - función

v - vector de parámetros

index - índice del parámetro

Returns:

array de expresiones extraídas del parámetro

Throws:

ConversionException - parámetro de tipo erróneo

Since:

0.4.10

printNanos

public static java.lang.String printNanos(long nanos)

Imprime nanosegundos en distintas unidades de tiempo más legibles Nota: no siempre se muestra el resultado con la máxima precisión por legibilidad

Parameters:

nanos - nanosegundos

Returns:

"tiempo+unidad", dependiendo del valor

concatenar

public static java.lang.String concatenar(java.lang.String conector,
                                          java.lang.String... cadenas)

Concatena un array de cadenas mediante conector

Parameters:

conector - cadena o carácter conector

cadenas - array de cadenas

Returns:

Las cadenas concatenadas. null si cadenas==null y "" si cadenas.length==0

Since:

0.5.0

convertir

public static java.lang.String[] convertir(Token[] array,
                                           Util.FilterToken filter)

Convierte un array de tokens en array de String mediante un filtro

Parameters:

array - array de tokens a convertir en String

filter - filtro que mapea cada token en String

Returns:

array de tokens mapeados

Since:

0.5.0

cargarArchivoTexto

public static java.lang.String[] cargarArchivoTexto(java.lang.String filename)
                                             throws java.io.IOException

Carga líneas de archivo de texto

Parameters:

filename - nombre y ruta del archivo

Returns:

array de líneas del archivo

Throws:

java.io.IOException - error al acceder a archivo, leer o cerrar

Since:

0.5.0

guardarArchivoTexto

public static void guardarArchivoTexto(java.lang.String filename,
                                       Terminal data,
                                       boolean append)
                                throws java.io.IOException

Guarda un terminal en un archivo de texto nuevo o añade al final

Parameters:

filename - nombre y ruta del archivo

data - terminal a guardar (con formato de salida), las cadenas de texto se guardan sin delimitador

append - true para 'append'

Throws:

java.io.IOException - error en la operación de grabado

Since:

0.6.2.0

cargarArchivoBin

public static Token cargarArchivoBin(java.lang.String filename)
                              throws java.io.IOException,
                                     java.lang.ClassNotFoundException

Carga token o terminal almacenado en archivo en forma binaria

Parameters:

filename - nombre y ruta del archivo

Returns:

dato almacenado como Token

Throws:

java.io.IOException - error al acceder a archivo, leer o cerrar

java.lang.ClassNotFoundException

Since:

0.6.2.0

guardarArchivoBin

public static void guardarArchivoBin(java.lang.String filename,
                                     Token data)
                              throws java.io.IOException

Guarda un token o terminal en un archivo binario

Parameters:

filename - nombre y ruta del archivo

data - dato a almacenar

Throws:

java.io.IOException - error en la operación de grabado

Since:

0.6.2.0

cadenaCortada

public static java.lang.String cadenaCortada(java.lang.String s,
                                             int limite,
                                             java.lang.String sufijo)

Recorta una cadena si excede el limite

Parameters:

s - cadena a recortar si es más larga que 'limite'

limite - >0, máximo de caracteres

sufijo - cadena a añadir al final si se recorta, como puntos suspensivos. Puede ser vacía o null

Returns:

la propia cadena o la cadena recortada

Since:

0.6.0

todoNull

public static boolean todoNull(java.lang.Object... objetos)

toIntArray

public static int[] toIntArray(VectorEvaluado vectorEntero)
                        throws ConversionException

Throws:

ConversionException

toIntArray

public static int[] toIntArray(java.lang.Integer[] array)

toIntegerArray

public static java.lang.Integer[] toIntegerArray(int[] intArray)

toDoubleMatrix

public static double[][] toDoubleMatrix(VectorEvaluado matriz)
                                 throws java.lang.IllegalArgumentException,
                                        java.lang.ClassCastException

Throws:

java.lang.IllegalArgumentException

java.lang.ClassCastException

toIntMatrix

public static int[][] toIntMatrix(VectorEvaluado matriz)
                           throws java.lang.IllegalArgumentException,
                                  java.lang.ClassCastException

Throws:

java.lang.IllegalArgumentException

java.lang.ClassCastException

toStringArray

public static java.lang.String[] toStringArray(VectorEvaluado v)

grafoDesdeDiccionario

public static JMEMath.TeoriaGrafos.Grafo grafoDesdeDiccionario(Diccionario d)
                                                        throws ExpresionException,
                                                               java.lang.ClassCastException

Throws:

ExpresionException

java.lang.ClassCastException

terminalAIndiceNodo

public static int terminalAIndiceNodo(JMEMath.TeoriaGrafos.Grafo grafo,
                                      Terminal nodo)

vectorAIndicesNodo

public static int[] vectorAIndicesNodo(JMEMath.TeoriaGrafos.Grafo grafo,
                                       VectorEvaluado vnodos)

matrizIniciada

public static double[][] matrizIniciada(int m,
                                        int n,
                                        double valor)

rango

public static int[] rango(int a,
                          int b,
                          int p)

putIntoMap

public static <K,V> java.util.Map<K,V> putIntoMap(java.util.Map<K,V> map,
                                                  java.lang.Object... keyValuePairs)

Store entries in a map from Object array

Type Parameters:

K - key type

V - value type

Parameters:

map - map to store entries

keyValuePairs - array of key/value pairs in the form {key1,value1,key2,value2,...}. This array must have an even number of elements

Returns:

the own map

Throws:

java.lang.IllegalArgumentException - the number of items in keyValuesPairs is odd or chaining from Map.put(Object, Object)

java.lang.UnsupportedOperationException - Map.put(Object, Object)

java.lang.ClassCastException - Map.put(Object, Object)

java.lang.NullPointerException - Map.put(Object, Object)

Since:

0.6.2.0

putInto

public static <T> java.util.Collection<T> putInto(java.util.Collection<T> col,
                                                  T... values)

Guarda valores en una colección a partir de un array

Parameters:

col - colección

values - array de valores como parámetros variables

Returns:

la colección ampliada

Since:

0.6.2.0

toArray

public static <T> T[] toArray(java.lang.Class<T> clazz,
                              java.util.Collection<T> col)

Copia los elementos de una colección en un array de la case especificada

Parameters:

clazz - clase coincidente con la de la colección

col - colección

Returns:

el array con los elementos y tipo de la colección

Since:

0.6.2.0