lldb/tools/lldb-mi/MIUtilParse.h

//===-- MIUtilParse.h ------------------------------------------*- C++ -*-===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

#pragma once

// Third party headers:
#include "../lib/Support/regex_impl.h"

// In-house headers:
#include "MIUtilString.h"

namespace MIUtilParse {

//++
//============================================================================
// Details: MI common code utility class. Used to parse the output
//          returned from lldb commands using regex.
//--
class CRegexParser {
public:
  // Helper class for keeping track of regex matches.
  class Match {
    friend CRegexParser;

  public:
    /* ctor */ explicit Match(size_t nmatches)
        : m_matchStrs(nmatches), m_maxMatches(nmatches) {}
    size_t GetMatchCount() const { return m_matchStrs.size(); }
    CMIUtilString GetMatchAtIndex(size_t i) const {
      if (m_matchStrs.size() > i)
        return m_matchStrs[i];
      return CMIUtilString();
    }

  private:
    CMIUtilString::VecString_t m_matchStrs;
    const size_t m_maxMatches;
  };

  // Methods:
  // Compile the regular expression.
  /* ctor */ explicit CRegexParser(const char *regexStr);

  // Free the memory used by the regular expression.
  /* dtor */ ~CRegexParser();

  // No copies
  CRegexParser(const CRegexParser &) = delete;
  void operator=(CRegexParser &) = delete;

  // Return the match at the index.
  int GetMatchCount(const Match &match) const {
    if (m_isValid)
      return match.GetMatchCount();
    return 0;
  }

  bool IsValid() const { return m_isValid; }

  // Match the input against the regular expression.  Return an error
  // if the number of matches is less than minMatches.  If the default
  // minMatches value of 0 is passed, an error will be returned if
  // the number of matches is less than the maxMatches value used to
  // initialize Match.
  bool Execute(const char *input, Match &match, size_t minMatches = 0);

private:
  llvm_regex_t m_emma;
  const bool m_isValid;
};
}