File: readTableIndex.Rd

package info (click to toggle)
r-cran-r.utils 2.13.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,864 kB
  • sloc: sh: 18; makefile: 6
file content (57 lines) | stat: -rw-r--r-- 1,544 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Do not modify this file since it was automatically generated from:
% 
%  readTableIndex.R
% 
% by the Rdoc compiler part of the R.oo package.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\name{readTableIndex}
\alias{readTableIndex.default}
\alias{readTableIndex}

\title{Reads a single column from file in table format}

\usage{
\method{readTableIndex}{default}(..., indexColumn=1, colClass="character", verbose=FALSE)
}

\description{
 Reads a single column from file in table format, which can then be used as a index-to-row (look-up) map
 for fast access to a subset of rows using \code{\link{readTable}}().
}

\arguments{
  \item{indexColumn}{An single \code{\link[base]{integer}} of the index column.}
  \item{colClass}{A single \code{\link[base]{character}} specifying the class of the
    index column.}
  \item{...}{Arguments passed to \code{\link{readTable}}() used internally.}
  \item{verbose}{A \code{\link[base]{logical}} or a \code{\link{Verbose}} object.}
}

\value{
  Returns a \code{\link[base]{vector}}.
}

\examples{\dontrun{
   # File containing data table to be access many times
   filename <- "somefile.txt"

   # Create a look-up index
   index <- readTableIndex(filename)

   # Keys of interest
   keys <- c("foo", "bar", "wah")

   # Read only those keys and do it fast
   df <- readTable(filename, rows=match(keys, index))
}}

\author{Henrik Bengtsson}

\seealso{
 \code{\link{readTable}}().
}


\keyword{IO}