TextFile

java.lang.Object
- uva.infor.soft.TextFile

```
public class TextFile
extends java.lang.Object
```
La clase TextFile representa a un fichero de texto abierto para lectura o para escritura, e implementa métodos para leer y escribir datos de tipo primitivo y detectar condiciones de fin de linea y fin de fichero asi como detectar errores en la última operación realizada.
La lectura de datos se ha implementado usando las facilidades de StreamTokenizer.
La consola (habitualmente el teclado y la pantalla) se representa por un objeto estático SimpleIO.Consola de este tipo, abierto simultaneamente para lectura y escritura.
Un fichero físico, sin embargo, sólo puede crearse en modo lectura o modo escritura. Las operaciones disponibles dependen del modo de apertura.
- MODO_LECTURA: No existe una operación de lectura general, sino una operación por cada tipo de dato primitivo y String.
  Existen dos funciones para descartar datos del fichero:
  - skipChar()
  - skipLine()
  Y una función para comprobar el fin de fichero:
  - isEndOfFile()
- MODO_ESCRITURA: Para escribir existen tres métodos:
  - write(tipo valor) sobrecargado para los tipos primitivos.
  - writeln(tipo valor) identico al anterior salvo que pasa a la siguiente linea.
  - writeFmt(String, Object...) para la escritura con formato.
Since:

10/01/2012

Author:

César Vaca Rodríguez

Constructor Summary

Constructors
Modifier	Constructor and Description
	`TextFile()` Constructor del fichero de texto asociado a la consola.
	`TextFile(boolean unicode)` Constructor del fichero de texto asociado a la consola.
`protected`	`TextFile(java.nio.charset.Charset cs)`
	`TextFile(java.lang.String nomFich, int modo)` Constructor de un fichero de texto y apertura del mismo.
	`TextFile(java.lang.String nomFich, int modo, boolean unicode)` Constructor de un fichero de texto y apertura del mismo.
`protected`	`TextFile(java.lang.String nomFich, int modo, java.nio.charset.Charset cs)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()` Cierra el fichero, permitiendo que otros programas puedan acceder a él.
`boolean`	`isEndOfFile()` Comprueba si quedan o no datos por leer en el fichero.
`boolean`	`readBoolean()` Lee una valor booleano del fichero (creado para lectura).
`char`	`readChar()` Lee un carácter del fichero (creado para lectura).
`double`	`readDouble()` Lee un número real del fichero (creado para lectura).
`int`	`readInt()` Lee un entero del fichero (creado para lectura).
`java.lang.String`	`readKeyword()` Lee una palabra del fichero (creado para lectura).
`java.lang.String`	`readLine()` Lee el resto de la linea.
`void`	`skipChar()` Pasa al siguiente carácter del fichero (creado para lectura).
`void`	`skipLine()` Avanza hasta el principio de la linea siguiente.
`void`	`write(boolean val)` Escribe la traducción a texto de `val` al fichero.
`void`	`write(char val)` Escribe la traducción a texto de `val` al fichero.
`void`	`write(double val)` Escribe la traducción a texto de `val` al fichero.
`void`	`write(int val)` Escribe la traducción a texto de `val` al fichero.
`void`	`write(java.lang.String val)` Escribe el string `val` al fichero.
`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...)`.
`void`	`writeln(boolean val)` Escribe la traducción a texto de `val` al fichero, pasando a la siguiente linea.
`void`	`writeln(char val)` Escribe la traducción a texto de `val` al fichero, pasando a la siguiente linea.
`void`	`writeln(double val)` Escribe la traducción a texto de `val` al fichero, pasando a la siguiente linea.
`void`	`writeln(int val)` Escribe la traducción a texto de `val` al fichero, pasando a la siguiente linea.
`void`	`writeln(java.lang.String val)` Escribe el string `val` al fichero, pasando a la siguiente linea.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TextFile
```
public TextFile()
```
    Constructor del fichero de texto asociado a la consola.
  - TextFile
```
public TextFile(boolean unicode)
```
    Constructor del fichero de texto asociado a la consola.
    
    Parameters:
    unicode - True si la entrada es Unicode, False si es ISO-8859-1
  - TextFile
```
protected TextFile(java.nio.charset.Charset cs)
```
  - TextFile
```
public TextFile(java.lang.String nomFich,
        int modo)
```
    Constructor de un fichero de texto y apertura del mismo.
    Parameters:
    nomFich - Ruta y nombre del fichero
    modo - Modo de apertura:
    
    MODO_LECTURA: Abre un fichero existente para lectura de datos.
    
    MODO_ESCRITURA: Crea un nuevo fichero vacío (si ya existe se borra el anterior) y permite escribir datos en el.
    
    Genera una excepción si el fichero no existe o no es accesible.
  - TextFile
```
public TextFile(java.lang.String nomFich,
        int modo,
        boolean unicode)
```
    Constructor de un fichero de texto y apertura del mismo.
    Parameters:
    nomFich - Ruta y nombre del fichero
    modo - Modo de apertura:
    
    SimpleIO.MODO_LECTURA: Abre un fichero existente para lectura de datos.
    
    SimpleIO.MODO_ESCRITURA: Crea un nuevo fichero vacío (si ya existe se borra el anterior) y permite escribir datos en el.
    unicode - True si la entrada es Unicode, False si es ISO-8859-1
    Genera una excepción si el fichero no existe o no es accesible.
  - TextFile
```
protected TextFile(java.lang.String nomFich,
        int modo,
        java.nio.charset.Charset cs)
```
- Method Detail
  - close
```
public void close()
```
    Cierra el fichero, permitiendo que otros programas puedan acceder a él.
  - isEndOfFile
```
public boolean isEndOfFile()
```
    Comprueba si quedan o no datos por leer en el fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado, o se intenta realizar esta comprobación sobre la consola.
    
    Returns:
    true si se ha alcanzado el final del fichero, false si quedan datos por leer.
  - readChar
```
public char readChar()
```
    Lee un carácter del fichero (creado para lectura). Los finales de línea no tienen un tratamiento especial.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado, o si se intenta leer tras el final de fichero.
    
    Returns:
    El carácter leido
  - skipChar
```
public void skipChar()
```
    Pasa al siguiente carácter del fichero (creado para lectura). El fin de linea se trata como un carácter normal.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado, o si se intenta leer tras el final de linea o de fichero.
  - readInt
```
public int readInt()
```
    Lee un entero del fichero (creado para lectura). 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 double readDouble()
```
    Lee un número real del fichero (creado para lectura). No se bloquea en el final 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 java.lang.String readKeyword()
```
    Lee una palabra del fichero (creado para lectura). 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 boolean readBoolean()
```
    Lee una valor booleano del fichero (creado para lectura). 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 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 void skipLine()
```
    Avanza hasta el principio de la linea siguiente.
  - write
```
public void write(boolean val)
```
    Escribe la traducción a texto de val al fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - write
```
public void write(char val)
```
    Escribe la traducción a texto de val al fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - write
```
public void write(int val)
```
    Escribe la traducción a texto de val al fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - write
```
public void write(double val)
```
    Escribe la traducción a texto de val al fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - write
```
public void write(java.lang.String val)
```
    Escribe el string val al fichero.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeln
```
public void writeln(boolean val)
```
    Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeln
```
public void writeln(char val)
```
    Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeln
```
public void writeln(int val)
```
    Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeln
```
public void writeln(double val)
```
    Escribe la traducción a texto de val al fichero, pasando a la siguiente linea.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeln
```
public void writeln(java.lang.String val)
```
    Escribe el string val al fichero, pasando a la siguiente linea.
    Genera excepciones si el fichero se ha abierto para escritura o ya ha sido cerrado.
    
    Parameters:
    val -
  - writeFmt
```
public 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 -

Class TextFile

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TextFile

TextFile

TextFile

TextFile

TextFile

TextFile

Method Detail

close

isEndOfFile

readChar

skipChar

readInt

readDouble

readKeyword

readBoolean

readLine

skipLine

write

write

write

write

write

writeln

writeln

writeln

writeln

writeln

writeFmt