blob: 14f27aefb999af1559e73e67edb9c53da2d5046d (
plain)
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
// -*- C++ -*-
//=============================================================================
/**
* @file Locator.h
*
* @author Nanbor Wang <nanbor@cs.wustl.edu>
*/
//=============================================================================
#ifndef _ACEXML_LOCATOR_H_
#define _ACEXML_LOCATOR_H_
#include /**/ "ace/pre.h"
#include "ACEXML/common/ACEXML_Export.h"
#include "ACEXML/common/XML_Types.h"
/**
* @class ACEXML_Locator
*
* @brief ACEXML_Locator defines operations that an XML locator should support.
*
* If a SAX parser provides location information to the SAX
* application, it does so by implementing this interface and then
* passing an instance to the application using the content handler's
* setDocumentLocator method. The application can use the object to
* obtain the location of any other content handler event in the XML
* source document.
*
* Note that the results returned by the object will be valid only
* during the scope of each content handler method: the application
* will receive unpredictable results if it attempts to use the
* locator at any other time.
*
* SAX parsers are not required to supply a locator, but they are very
* strongly encouraged to do so. If the parser supplies a locator, it
* must do so before reporting any other document events. If no
* locator has been set by the time the application receives the
* startDocument event, the application should assume that a locator
* is not available.
*/
class ACEXML_Export ACEXML_Locator
{
public:
virtual ~ACEXML_Locator ();
/*
* Return the column number where the current document event ends.
*/
virtual int getColumnNumber () const = 0;
/*
* Return the line number where the current document event ends.
*/
virtual int getLineNumber () const = 0;
/*
* Return the public identifier for the current document event.
*/
virtual const ACEXML_Char *getPublicId () const = 0;
/*
* Return the system identifier for the current document event.
*/
virtual const ACEXML_Char *getSystemId () const = 0;
};
#include /**/ "ace/post.h"
#endif /* _ACEXML_LOCATOR_H_ */
|