summaryrefslogtreecommitdiff
path: root/ACE/ACEXML/common/Locator.h
blob: c6504b706a4f86ccc80f843f8d632c2acd5cc0ee (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
73
74
// -*- C++ -*-

//=============================================================================
/**
 *  @file    Locator.h
 *
 *  $Id$
 *
 *  @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 Locator.h "ACEXML/common/Locator.h"
 *
 * @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 (void);

  /*
   * Return the column number where the current document event ends.
   */
  virtual int getColumnNumber (void) const = 0;

  /*
   * Return the line number where the current document event ends.
   */
  virtual int getLineNumber (void) const = 0;

  /*
   * Return the public identifier for the current document event.
   */
  virtual const ACEXML_Char *getPublicId (void) const = 0;

  /*
   * Return the system identifier for the current document event.
   */
  virtual const ACEXML_Char *getSystemId (void) const = 0;
};


#include /**/ "ace/post.h"

#endif /* _ACEXML_LOCATOR_H_ */