uva.infor.soft

Class SimpleIO

java.lang.Object

uva.infor.soft.SimpleIO

public class SimpleIO
extends java.lang.Object

Clase estática cuyo objetivo es facilitar la enseñanza de Java en Fundamentos de Programación. Contenido:

Consola:

• Consola

• setUnicode(boolean flag)

Utilidades varias:

• toUpperCase(char letra)
• toLowerCase(char letra)
• toUpperCase(String cad)
• toLowerCase(String cad)
• cad2Int(String cad)
• cad2Double(String cad)
• int2Cad(int n)
• double2Cad(double v)
• strFmt(String cad, Object... args)
• aleatorio(int n)
• aleatorio()

Wrappers de arrays:

• #length(Class<?>[] vec)

Wrappers de string:

• length(String cad)
• charAt(String cad, int i)
• substring(String cad, int i0)
• substring(String cad, int i0, int n)
• compareStrings(String cad1, String cad2)
• strIndexOf(String cad, String subcad)
• strIndexOf(String cad, char ch)
• strIndexOf(String cad, int i0, String subcad)
• strIndexOf(String cad, int i0, char ch)

Mutabilidad de strings:

• setCharAt(String cad, int i, char ch)
• strInsert(String cad, int i0, String subcad)
• strInsert(String cad, int i0, char ch)
• strDelete(String cad, int i0, int n)

Wrappers de la Consola:

• readChar()
• skipChar()
• readInt()
• readDouble()
• readKeyword()
• readBoolean()
• readLine()
• skipLine()
• write(boolean val)
• writeln(boolean val)
• writeFmt(String fmt,Object... args)

Since:

25/04/2010

Author:

César Vaca Rodríguez

Field Summary

Fields

Modifier and Type	Field and Description
static TextFile	Consola Objeto estático de tipo fichero de texto que sirve para acceder a la consola (típicamente la pantalla y el teclado).
protected static int	MODO_CONSOLA Uso interno
static int	MODO_ESCRITURA Constante que indica que el fichero debe abrirse para escritura.
static int	MODO_LECTURA Constante que indica que el fichero debe abrirse para lectura.
protected static java.lang.String	msgErrC
protected static java.lang.String	msgErrCC
protected static java.lang.String	msgErrEL
protected static java.lang.String	msgErrEOF
protected static java.lang.String	msgErrEOFC
protected static java.lang.String	msgErrEOL
protected static java.lang.String	msgErrLE
protected static java.lang.String	msgErrOC
protected static java.lang.String	msgErrOCL
protected static java.lang.String	msgErrOPC
protected static java.lang.String[]	msgPredef

Method Summary

Methods

Modifier and Type	Method and Description
static double	aleatorio() Generador de números aleatorios
static int	aleatorio(int n) Generador de números aleatorios
static double	cad2Double(java.lang.String cad) Conversión de cadena a número real
static int	cad2Int(java.lang.String cad) Conversión de cadena a entero
static char	charAt(java.lang.String cad, int i) Devuelve el caracter en posición i-ésima de la cadena
static int	compareStrings(java.lang.String cad1, java.lang.String cad2) Comparación lexicográfica entre dos string
static java.lang.String	double2Cad(double v) Conversión de número real a texto
static java.lang.String	int2Cad(int n) Conversión de número a texto
static int	length(boolean[] vec) Longitud de arrays
static int	length(char[] vec) Longitud de arrays
static int	length(java.lang.Class<?>[] vec) Longitud de arrays
static int	length(double[] vec) Longitud de arrays
static int	length(double[][] vec) Longitud de arrays
static int	length(int[] vec) Longitud de arrays
static int	length(int[][] vec) Longitud de arrays
static int	length(java.lang.String cad) Longitud de Strings
static boolean	readBoolean() Lee una valor booleano de la consola.
static char	readChar() Lee un carácter de la consola.
static double	readDouble() Lee un número real de la consola.
static int	readInt() Lee un entero de la consola.
static java.lang.String	readKeyword() Lee una palabra de la consola.
static java.lang.String	readLine() Lee el resto de la linea.
static java.lang.String	setCharAt(java.lang.String cad, int i, char ch) Devuelve la cadena en la que se ha cambiado el carácter i-ésimo.
void	setUnicode(boolean flag) Cambia el modo en que se interpretan caracteres especiales (acentos, etc.)
static void	skipChar() Pasa al siguiente carácter de la consola.
static void	skipLine() Avanza hasta el principio de la linea siguiente.
static java.lang.String	strDelete(java.lang.String cad, int i0, int n) Devuelve la cadena en la que se han borrado los n caracteres que siguen a la posición i0 (inclusive).
static java.lang.String	strFmt(java.lang.String cad, java.lang.Object... args) Igual que writeFmt(java.lang.String, java.lang.Object[]) pero con salida a una cadena en vez de a la consola.
static int	strIndexOf(java.lang.String cad, char ch) Búsqueda de la primera aparición de un carácter dentro de una cadena.
static int	strIndexOf(java.lang.String cad, int i0, char ch) Búsqueda de un carácter dentro de una cadena tras la posición i0.
static int	strIndexOf(java.lang.String cad, int i0, java.lang.String subcad) Búsqueda de una subcadena dentro de una cadena tras la posición i0.
static int	strIndexOf(java.lang.String cad, java.lang.String subcad) Búsqueda de la primera aparición de una subcadena dentro de una cadena.
static java.lang.String	strInsert(java.lang.String cad, int i0, char ch) Devuelve la cadena en la que se ha insertado el carácter ch entre los índices i0-1 e i0.
static java.lang.String	strInsert(java.lang.String cad, int i0, java.lang.String subcad) Devuelve la cadena en la que se ha insertado la subcadena subcad entre los índices i0-1 e i0.
static java.lang.String	substring(java.lang.String cad, int i0) Devuelve una subcadena formada por los caracteres que siguen a la posición i0 (inclusive) hasta el final de la cadena original.
static java.lang.String	substring(java.lang.String cad, int i0, int n) Devuelve una subcadena formada por los n caracteres que siguen a la posición i0 (inclusive).
static char	toLowerCase(char letra) Conversión de un carácter a minúsculas
static java.lang.String	toLowerCase(java.lang.String cad) Conversión de una cadena a minúsculas
static char	toUpperCase(char letra) Conversión de un carácter a mayúsculas
static java.lang.String	toUpperCase(java.lang.String cad) Conversión de una cadena a mayúsculas
static void	write(boolean val) Escribe la traducción a texto de val a la consola.
static void	write(char val) Escribe la traducción a texto de val a la consola.
static void	write(double val) Escribe la traducción a texto de val a la consola.
static void	write(int val) Escribe la traducción a texto de val a la consola.
static void	write(java.lang.String val) Escribe el string val a la consola.
static void	writeFmt(java.lang.String fmt, java.lang.Object... args) Escribe la cadena fmt formateada con los argumentos arg de la manera descrita en PrintWriter.format(String, Object...).
static void	writeln(boolean val) Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.
static void	writeln(char val) Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.
static void	writeln(double val) Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.
static void	writeln(int val) Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.
static void	writeln(java.lang.String val) Escribe el string val a la consola, pasando a la siguiente linea.

Methods inherited from class java.lang.Object

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

Field Detail

MODO_CONSOLA

protected static final int MODO_CONSOLA

Uso interno

See Also:

Constant Field Values

MODO_LECTURA

public static final int MODO_LECTURA

Constante que indica que el fichero debe abrirse para lectura.

Usado en #openTextFile(java.lang.String), #openGeneralFile(java.lang.String), TextFile.TextFile(java.lang.String, int), BinaryFile.BinaryFile(java.lang.String, int), GeneralFile.GeneralFile(java.lang.String, int).

See Also:

Constant Field Values

MODO_ESCRITURA

public static final int MODO_ESCRITURA

Constante que indica que el fichero debe abrirse para escritura.

Usado en #openTextFile(java.lang.String), #openGeneralFile(java.lang.String), TextFile.TextFile(java.lang.String, int), BinaryFile.BinaryFile(java.lang.String, int), GeneralFile.GeneralFile(java.lang.String, int).

See Also:

Constant Field Values

msgPredef

protected static final java.lang.String[] msgPredef

msgErrLE

protected static final java.lang.String msgErrLE

See Also:

Constant Field Values

msgErrEL

protected static final java.lang.String msgErrEL

See Also:

Constant Field Values

msgErrC

protected static final java.lang.String msgErrC

See Also:

Constant Field Values

msgErrEOL

protected static final java.lang.String msgErrEOL

See Also:

Constant Field Values

msgErrEOF

protected static final java.lang.String msgErrEOF

See Also:

Constant Field Values

msgErrEOFC

protected static final java.lang.String msgErrEOFC

See Also:

Constant Field Values

msgErrOC

protected static final java.lang.String msgErrOC

See Also:

Constant Field Values

msgErrCC

protected static final java.lang.String msgErrCC

See Also:

Constant Field Values

msgErrOCL

protected static final java.lang.String msgErrOCL

See Also:

Constant Field Values

msgErrOPC

protected static final java.lang.String msgErrOPC

See Also:

Constant Field Values

Consola

public static TextFile Consola

Objeto estático de tipo fichero de texto que sirve para acceder a la consola (típicamente la pantalla y el teclado). A diferencia de los ficheros de texto normales esta abierto simultaneamente para lectura y escritura, y no se puede cerrar.

Method Detail

setUnicode

public void setUnicode(boolean flag)

Cambia el modo en que se interpretan caracteres especiales (acentos, etc.)

Parameters:

flag - Use True para entrada Unicode, False para entrada ISO-8859-1

toUpperCase

public static char toUpperCase(char letra)

Conversión de un carácter a mayúsculas

Parameters:

letra -

Returns:

el carácter en mayúsculas

toLowerCase

public static char toLowerCase(char letra)

Conversión de un carácter a minúsculas

Parameters:

letra -

Returns:

el carácter en minúsculas

toUpperCase

public static java.lang.String toUpperCase(java.lang.String cad)

Conversión de una cadena a mayúsculas

Parameters:

cad -

Returns:

Un nuevo String con la cadena original en mayúsculas

toLowerCase

public static java.lang.String toLowerCase(java.lang.String cad)

Conversión de una cadena a minúsculas

Parameters:

cad -

Returns:

Un nuevo String con la cadena original en minúsculas

cad2Int

public static int cad2Int(java.lang.String cad)

Conversión de cadena a entero

Parameters:

cad -

Returns:

El valor entero correspondiente a la traducción de cad

cad2Double

public static double cad2Double(java.lang.String cad)

Conversión de cadena a número real

Parameters:

cad -

Returns:

El valor real correspondiente a la traducción de cad

int2Cad

public static java.lang.String int2Cad(int n)

Conversión de número a texto

Parameters:

n -

Returns:

La cadena de texto que representa el valor n

double2Cad

public static java.lang.String double2Cad(double v)

Conversión de número real a texto

Parameters:

v -

Returns:

La cadena de texto que representa el valor v

aleatorio

public static int aleatorio(int n)

Generador de números aleatorios

Parameters:

n - límite

Returns:

un entero al azar entre 0 y n-1

aleatorio

public static double aleatorio()

Generador de números aleatorios

Returns:

un número real entre 0 y 1 (exclusive)

length

public static int length(java.lang.Class<?>[] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(boolean[] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(char[] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(int[] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(double[] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(int[][] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(double[][] vec)

Longitud de arrays

Parameters:

vec -

Returns:

la longitud del array vec

length

public static int length(java.lang.String cad)

Longitud de Strings

Parameters:

cad -

Returns:

charAt

public static char charAt(java.lang.String cad,
          int i)

Devuelve el caracter en posición i-ésima de la cadena

Parameters:

cad -

i - índice del carácter (0 based)

Returns:

carácter en posición i

substring

public static java.lang.String substring(java.lang.String cad,
                         int i0,
                         int n)

Devuelve una subcadena formada por los n caracteres que siguen a la posición i0 (inclusive).

Parameters:

cad - la cadena original

i0 - índice del primer carácter de la subcadena

n - longitud de la subcadena

Returns:

substring

public static java.lang.String substring(java.lang.String cad,
                         int i0)

Devuelve una subcadena formada por los caracteres que siguen a la posición i0 (inclusive) hasta el final de la cadena original.

Parameters:

cad - la cadena original

i0 - índice del primer carácter de la subcadena

Returns:

compareStrings

public static int compareStrings(java.lang.String cad1,
                 java.lang.String cad2)

Comparación lexicográfica entre dos string

Parameters:

cad1 -

cad2 -

Returns:

0 si ambos son iguales, un entero negativo si cad1 es menor que cad2 y un entero positivo en caso contrario.

setCharAt

public static java.lang.String setCharAt(java.lang.String cad,
                         int i,
                         char ch)

Devuelve la cadena en la que se ha cambiado el carácter i-ésimo.

Nota: Para cambios sobre la propia cadena se debe usar una expresión del tipo cad = setCharAt(cad,i,ch);

Parameters:

cad - la cadena original

i - índice del caracter que se va a sustituir (0 based)

ch - nuevo carácter

Returns:

Una nueva cadena con el carácter sustituido

strInsert

public static java.lang.String strInsert(java.lang.String cad,
                         int i0,
                         java.lang.String subcad)

Devuelve la cadena en la que se ha insertado la subcadena subcad entre los índices i0-1 e i0.

Nota: Para cambios sobre la propia cadena se debe usar una expresión del tipo cad = strInsert(cad,i,subcad);

Parameters:

cad - la cadena original

i0 - la posición de inserción (el caracter originalmente en la posición i0 pasa a estar al final de la subcadena insertada.

subcad - la subcadena que se inserta

Returns:

una nueva cadena con la subcadena insertada

strInsert

public static java.lang.String strInsert(java.lang.String cad,
                         int i0,
                         char ch)

Devuelve la cadena en la que se ha insertado el carácter ch entre los índices i0-1 e i0.

Nota: Para cambios sobre la propia cadena se debe usar una expresión del tipo cad = strInsert(cad,i,ch);

Parameters:

cad - la cadena original

i0 - la posición de inserción (el caracter originalmente en la posición i0 pasa a estar despues del carácter insertado.

ch - el carácter que se inserta

Returns:

una nueva cadena con el carácter insertado

strDelete

public static java.lang.String strDelete(java.lang.String cad,
                         int i0,
                         int n)

Devuelve la cadena en la que se han borrado los n caracteres que siguen a la posición i0 (inclusive).

Nota: Para cambios sobre la propia cadena se debe usar una expresión del tipo cad = strDelete(cad,i,n);

Parameters:

cad - La cadena original

i0 - Indice inicial

n - Número de caracteres a borrar

Returns:

Una nueva cadena con la zona borrada

strIndexOf

public static int strIndexOf(java.lang.String cad,
             java.lang.String subcad)

Búsqueda de la primera aparición de una subcadena dentro de una cadena.

Parameters:

cad - la cadena sobre la que se busca

subcad - la subcadena buscada

Returns:

el índice (0-based) de la primera aparición de la subcadena, o -1 si no existe

strIndexOf

public static int strIndexOf(java.lang.String cad,
             char ch)

Búsqueda de la primera aparición de un carácter dentro de una cadena.

Parameters:

cad - la cadena sobre la que se busca

ch - el carácter buscado

Returns:

el índice (0-based) de la primera aparición del carácter, o -1 si no existe

strIndexOf

public static int strIndexOf(java.lang.String cad,
             int i0,
             java.lang.String subcad)

Búsqueda de una subcadena dentro de una cadena tras la posición i0.

Parameters:

cad - la cadena sobre la que se busca

i0 - la posición (inclusive) a partir de la que se busca

subcad - la subcadena buscada

Returns:

el índice (>= i0) de la primera aparición de la subcadena, o -1 si no existe

strIndexOf

public static int strIndexOf(java.lang.String cad,
             int i0,
             char ch)

Búsqueda de un carácter dentro de una cadena tras la posición i0.

Parameters:

cad - la cadena sobre la que se busca

i0 - la posición (inclusive) a partir de la que se busca

ch - el carácter buscado

Returns:

el índice (>= i0) de la primera aparición del carácter, o -1 si no existe

strFmt

public static java.lang.String strFmt(java.lang.String cad,
                      java.lang.Object... args)

Igual que writeFmt(java.lang.String, java.lang.Object[]) pero con salida a una cadena en vez de a la consola.

Parameters:

cad -

args -

Returns:

readChar

public static char readChar()

Lee un carácter de la consola. Los finales de línea no tienen un tratamiento especial, se leen como caracteres.

Returns:

El carácter leido

skipChar

public static void skipChar()

Pasa al siguiente carácter de la consola. El fin de linea se trata como un carácter normal.

readInt

public static int readInt()

Lee un entero de la consola. No se bloquea en el fin de linea.

Al número entero le debe seguir un espacio en blanco o un fin de linea, en caso contrario se genera un error.

Returns:

El entero leido.

readDouble

public static double readDouble()

Lee un número real de la consola. No se bloquea en el fin de linea.

Al número real le debe seguir un espacio en blanco o un final de linea, en caso contrario se genera un error. Atención: El separador decimal depende del ordenador en que se ejecute, si el formato no concuerda se genera un error.

Returns:

El número real leido.

readKeyword

public static java.lang.String readKeyword()

Lee una palabra de la consola. Una palabra se define como una serie de caracteres contiguos terminada por un espacio o fin de linea.

Returns:

La palabra leída.

readBoolean

public static boolean readBoolean()

Lee una valor booleano de la consola. Las palabras true, yes, si, ok (o sus abreviaturas) generan el resultado true, y el resto de entradas genera el resultado false.

Returns:

El valor booleano leído.

readLine

public static java.lang.String readLine()

Lee el resto de la linea. Procesa el fin de linea de forma que la siguiente lectura sea en la linea siguiente.

Returns:

Un String conteniendo el resto de la linea.

skipLine

public static void skipLine()

Avanza hasta el principio de la linea siguiente.

write

public static void write(boolean val)

Escribe la traducción a texto de val a la consola.

Parameters:

val -

write

public static void write(char val)

Escribe la traducción a texto de val a la consola.

Parameters:

val -

write

public static void write(int val)

Escribe la traducción a texto de val a la consola.

Parameters:

val -

write

public static void write(double val)

Escribe la traducción a texto de val a la consola.

Parameters:

val -

write

public static void write(java.lang.String val)

Escribe el string val a la consola.

Parameters:

val -

writeln

public static void writeln(boolean val)

Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.

Parameters:

val -

writeln

public static void writeln(char val)

Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.

Parameters:

val -

writeln

public static void writeln(int val)

Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.

Parameters:

val -

writeln

public static void writeln(double val)

Escribe la traducción a texto de val a la consola, pasando a la siguiente linea.

Parameters:

val -

writeln

public static void writeln(java.lang.String val)

Escribe el string val a la consola, pasando a la siguiente linea.

Parameters:

val -

writeFmt

public static void writeFmt(java.lang.String fmt,
            java.lang.Object... args)

Escribe la cadena fmt formateada con los argumentos arg de la manera descrita en PrintWriter.format(String, Object...).

Parameters:

fmt -

args -