XPathProcessor.h

// Copyright (c) 2022 - 2025 Saxonica Limited.
// This Source Code Form is subject to the terms of the Mozilla Public License,
// v. 2.0. If a copy of the MPL was not distributed with this file, You can
// obtain one at http://mozilla.org/MPL/2.0/. This Source Code Form is
// "Incompatible With Secondary Licenses", as defined by the Mozilla Public
// License, v. 2.0.
 
#ifndef SAXON_XPATH_H
#define SAXON_XPATH_H
 
#include "saxonc_export.h"
#include "saxonc/SaxonProcessor.h"
//#include "XdmValue.h"
//#include "XdmItem.h"
 
#include <string>
 
class SaxonProcessor;
class SaxonApiException;
class XdmValue;
class XdmItem;
 
enum class SAXONC_EXPORT UnprefixedElementMatchingPolicy {

  DEFAULT_NAMESPACE = 0,
  ANY_NAMESPACE = 1,
  DEFAULT_NAMESPACE_OR_NONE = 2
};

class SAXONC_EXPORT XPathProcessor {
public:
  XPathProcessor();
 
  ~XPathProcessor();

  XPathProcessor(SaxonProcessor *proc, std::string cwd = "");

  XPathProcessor(const XPathProcessor &other);

  void setBaseURI(const char *uriStr);

  const char *getBaseURI();

  XdmValue *evaluate(const char *xpathStr, const char *encoding = nullptr);

  XdmItem *evaluateSingle(const char *xpathStr, const char *encoding = nullptr);

  void setContextItem(XdmItem *item);

  void setcwd(const char *cwd);

 const char * getcwd();

  void setContextFile(const char *filename);

  bool effectiveBooleanValue(const char *xpathStr,
                             const char *encoding = nullptr);

 
  void setParameter(const char *name, XdmValue *value, bool withParam=true);

  bool removeParameter(const char *name);

  void setProperty(const char *name, const char *value);

 const char * getProperty(const char *name);

  void declareNamespace(const char *prefix, const char *uri);

  void declareVariable(const char *name);

  void setLanguageVersion(const char *version);

  void setBackwardsCompatible(bool option);

 
  void setCaching(bool caching);

  void
  setUnprefixedElementMatchingPolicy(UnprefixedElementMatchingPolicy policy);

  UnprefixedElementMatchingPolicy convertEnumPolicy(int n) {
    return static_cast<UnprefixedElementMatchingPolicy>(n);
  }

  UnprefixedElementMatchingPolicy getUnprefixedElementMatchingPolicy();

  void importSchemaNamespace(const char *uri);

  XdmValue *getParameter(const char *name, bool withParam=true);

  std::map<std::string, XdmValue *> &getParameters();

  std::map<std::string, std::string> &getProperties();

  void clearParameters(bool deleteValues = false);

  void clearProperties();
 

  bool exceptionOccurred();

  void exceptionClear();

  const char *getErrorMessage();

  const char *getErrorCode();

  SaxonApiException *getException();

  SaxonProcessor* getSaxonProcessor() { return proc; }
 
private:
  void createException(const char *message = nullptr);
 
 
  SaxonProcessor *proc; 
  std::string cwdXP;    
  char *xp_baseURI;
  // jclass  cppClass; /*!< Reference to the XPathProcessor Java class under JNI
  // */
  int64_t cppXP; 
  std::map<std::string, XdmValue *>
      parameters; 
  std::map<std::string, std::string>
      properties; 
  SaxonApiException
      *exception; 
  UnprefixedElementMatchingPolicy unprefixedElementPolicy;
};
 
#endif /* SAXON_XPATH_H */