roCreateFile

12 min

Este objeto puede utilizarse para escribir un archivo nuevo o sobrescribir un archivo existente.

Creación de objetos: Crear un objeto roCreateFile abre un archivo existente o crea un archivo nuevo. Si el archivo existe, se trunca a un tamaño de cero.

CreateObject("roCreateFile", filename As String)

ifReadStream

SetReceiveEol(eol_sequence As String) As Void

Establece la secuencia EOL al leer desde el flujo.

ReadByte() As Integer

Lee un solo byte del flujo, bloqueando si es necesario. Si se alcanza el EOF o hay una condición de error, se devuelve un valor menor que 0.

ReadByteIfAvailable() As Integer

Lee un solo byte del flujo si hay uno disponible. Si no hay bytes disponibles, regresa inmediatamente. Un valor de retorno menor que 0 indica que se alcanzó el EOF o que no hay ningún byte disponible.

ReadLine() As String

Lee hasta encontrar una secuencia completa de fin de línea. Si no logra encontrar la secuencia dentro de 4096 bytes, devuelve los 4096 bytes encontrados. En este caso, no se descarta ningún dato.

ReadBlock(size As Integer) As String

Lee la cantidad especificada de bytes. El número está limitado a 65536 bytes. En caso de EOF o error, se devolverán menos bytes de los solicitados. Cualquier byte nulo en el archivo ocultará cualquier byte posterior.

AtEof() As Boolean

Devuelve True si se ha intentado leer más allá del final del archivo. Si la posición actual está al final del archivo, pero no se ha intentado leer más allá de este, este método devolverá False.

ifStreamSend

SetSendEol(eol_sequence As String) As Void

Establece la secuencia EOL al escribir en el flujo. El valor predeterminado es CR+LF. Si necesita establecer este valor en un carácter no imprimible, use la chr() función globalfunción global.

SendByte(byte As Integer) As Void

Escribe el byte especificado en el flujo.

SendLine(string As String) As Void

Escribe los caracteres especificados en el flujo seguidos de la secuencia EOL actual.

SendBlock(a As Dynamic) As Void

Escribe los caracteres especificados en el flujo. Este método puede admitir una cadena o un roByteArray. Si el bloque es una cadena, cualquier byte nulo terminará el bloque.

Flush() As Void

Escribe el flujo en el archivo, bloqueando la ejecución hasta que todos los datos se escriban.

AsyncFlush() As Void

Escribe el flujo en el archivo en unos pocos segundos. El sistema no bloqueará la ejecución mientras escribe en el archivo.

El sistema realiza automáticamente un vaciado asíncrono cuando se destruye la instancia del objeto (por ejemplo, cuando se reasigna la variable que lo contiene). Primero se escribe el flujo en el kernel, que luego lo escribe en el sistema de archivos cuando hay recursos disponibles.

ifStreamSeek

SeekAbsolute(offset As Integer) As Void

Busca el desplazamiento especificado. Si el desplazamiento está más allá del final del archivo, el archivo se extenderá en la siguiente escritura y cualquier espacio previamente desocupado se llenará con bytes nulos.

SeekRelative(offset As Integer) As Void

Busca el desplazamiento especificado relativo a la posición actual. Si el desplazamiento final está más allá del final del archivo, el archivo se extenderá como se describe en SeekAbsolute().

SeekToEnd() As Void

Busca hasta el final del archivo.

CurrentPosition() As Integer

Recupera la posición actual dentro del archivo.