read.fortran {utils} | R Documentation

## Read fixed-format data

### Description

Read fixed-format data files using Fortran-style format specifications.

### Usage

    read.fortran(file, format, ..., as.is = TRUE, colClasses = NA)

### Arguments

`file` | File or connection to read from
`format` | Character vector or list of vectors. See Details below.
`...` | Other arguments for `read.table`
`as.is` | Keep characters as characters?
`colClasses` | Variable classes to override defaults. See `read.table` for details.

### Details

The format for a field is of one of the following forms: `rFl.d`, `rDl.d`, `rXl`, `rAl`, `rIl`, where `l` is the number of columns, `d` is the number of decimal places, and `r` is the number of repeats. `F` and `D` are numeric formats, `A` is character, `I` is integer, and `X` indicates columns to be skipped. The repeat code `r` and decimal place code `d` are always optional. The length code `l` is required except for `X` formats when `r` is present.

For a single-line record, `format` should be a character vector. For a multiline record it should be a list with a character vector for each line.

Skipped (`X`) columns are not passed to `read.table`, so `colClasses`, `col.names`, and similar arguments passed to `read.table` should not reference these columns.

### Value

A data frame

### See Also

`read.fwf`, `read.csv`

### Examples

    ff <- tempfile()
    cat(file=ff, "123456", "987654", sep="\n")
    read.fortran(ff, c("F2.1","F2.0","I2"))
    read.fortran(ff, c("2F1.0","2X","2A1"))
    unlink(ff)
    cat(file=ff, "123456AB", "987654CD", sep="\n")
    read.fortran(ff, list(c("2F3.1","A2"), c("3I2","2X")))
    unlink(ff)

[Package utils version 2.3.1 Index]