\HeaderA{linkedmultiget}{A function to look for values across linked environments}{linkedmultiget}
\keyword{manip}{linkedmultiget}
\begin{Description}\relax
A function to look for values across linked environments.
\end{Description}
\begin{Usage}
\begin{verbatim}
linkedmultiget(x, envir.list = list(), unique = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] The keys in the first environment in the list.
\item[\code{envir.list}] A list of environments.
\item[\code{unique}] Simplify the list returned by ensuring that the values
for each key are unique.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Environments can be considered as hashtables. The keys are obviously
strings, but in some cases the associated values are also
strings. This is the case for annotation environments (as built with
the package \code{AnnBuilder}). This function helps to look for values
across several environments: the keys have associated values in a
first environment, these values are used as keys in the second
environments, etc...
\end{Details}
\begin{Value}
A list of length the length of \code{x}.
\end{Value}
\begin{Author}\relax
Laurent Gautier
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{mget}{mget}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(ecoligenomeBNUM)
data(ecoligenomeBNUM2MULTIFUN)
data(multiFun)

## get 5 Affymetrix IDs
set.seed(456)
my.affyids <- sample(ls(ecoligenomeBNUM), 5)

## get the MULTIFUN annotations for them
r <- linkedmultiget(my.affyids, list(ecoligenomeBNUM,
                    ecoligenomeBNUM2MULTIFUN, multiFun))

print(r)
\end{ExampleCode}
\end{Examples}

