1\name{genericSAXHandlers}
2\alias{genericSAXHandlers}
3\title{SAX generic callback handler list}
4\description{
5  This is a convenience function to get the collection
6  of generic functions that make up the callbacks
7  for the SAX parser.
8  The return value can be used directly
9  as the value of the \code{handlers}
10  argument in \code{\link{xmlEventParse}}.
11  One can easily specify a  subset
12  of the handlers by giving the names of
13  the elements to include or exclude.
14}
15\usage{
16genericSAXHandlers(include, exclude, useDotNames = FALSE)
17}
18%- maybe also `usage' for other objects documented here.
19\arguments{
20  \item{include}{if supplied, this gives the names of the subset of elements to
21    return.
22  }
23  \item{exclude}{if supplied (and \code{include} is not),
24    this gives the names of the elements to remove from the list of
25    functions.
26  }
27  \item{useDotNames}{ a logical value.
28    If this is \code{TRUE}, the names of the elements in the list of
29    handler functions are prefixed with '.'. This is the newer format
30   used to differentiate general element handlers and node-name-specific handlers.}
31}
32\value{
33  A list of functions.
34  By default, the elements are named
35  startElement, endElement, comment, text,
36  processingInstruction, entityDeclaration
37  and contain the corresponding
38  generic SAX callback function, i.e. given by
39  the element name with the .SAX suffix.
40
41  If \code{include} or \code{exclude} is specified,
42  a subset of this list is returned.
43}
44
45\references{\url{http://www.w3.org/XML}, \url{http://www.jclark.com/xml},
46\url{http://www.omegahat.net}  }
47\author{ Duncan Temple Lang }
48
49
50
51\seealso{
52   \code{\link{xmlEventParse}}
53   \code{\link{startElement.SAX}}
54   \code{\link{endElement.SAX}}
55   \code{\link{comment.SAX}}
56   \code{\link{processingInstruction.SAX}}
57   \code{\link{entityDeclaration.SAX}}
58   \code{\link{.InitSAXMethods}}
59}
60
61\examples{
62\testonly{
63# .InitSAXMethods()
64names(genericSAXHandlers())
65names(genericSAXHandlers(inc=c("startElement", "endElement", "text")))
66names(genericSAXHandlers(ex=c("startElement", "endElement", "text")))
67}
68}
69\keyword{file}
70
71