\HeaderA{selectSome}{Extract elements of a vector for concise rendering}{selectSome}
\keyword{utilities}{selectSome}
\begin{Description}\relax
Extract the first and last several elements of a vector for concise
rendering; insert ellipses to indicate elided elements. This function
is primarily meant for developer rather than end-user use.
\end{Description}
\begin{Usage}
\begin{verbatim}
selectSome(obj, maxToShow=5)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{obj}] A vector.
\item[\code{maxToShow}] The number of elements (including "...") to render.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
This function can be used in 'show' methods to give users exemplars of
the tokens used in a vector.  For example, an
\code{\LinkA{ExpressionSet}{ExpressionSet}} built from a yeast experiment might have
features enumerated using systematic gene names (e.g., YPR181C) or
standard gene names (e.g., SEC23).  The \code{\LinkA{show}{show}} method for
\code{\LinkA{ExpressionSet}{ExpressionSet}} uses \code{selectSome} to alert the user to
the tokens used, and thereby to indicate what vocabulary must be
understood to work with the feature names.
\end{Details}
\begin{Value}
A string vector with at most \code{maxToShow} plus 1 elements,
where an ellipsis ("...") is included to indicate incompleteness
of the excerpt.
\end{Value}
\begin{Author}\relax
Martin Morgan <mtmorgan@fhcrc.org>
\end{Author}
\begin{Examples}
\begin{ExampleCode}
selectSome(1:20)
\end{ExampleCode}
\end{Examples}

