aboutsummaryrefslogtreecommitdiff
path: root/tools/lldb-mi/MIUtilString.h
blob: 3b077722f9a9c62a492b89b513aa786fc964ef3c (plain) (blame)
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
//===-- MIUtilString.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 <cinttypes>
#include <cstdarg>
#include <string>
#include <vector>

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

//++
//============================================================================
// Details: MI common code utility class. Used to help handle text.
//          Derived from std::string
//--
class CMIUtilString : public std::string {
  // Typedefs:
public:
  typedef std::vector<CMIUtilString> VecString_t;

  // Static method:
public:
  static CMIUtilString Format(const CMIUtilString vFormating, ...);
  static CMIUtilString FormatBinary(const MIuint64 vnDecimal);
  static CMIUtilString FormatValist(const CMIUtilString &vrFormating,
                                    va_list vArgs);
  static bool IsAllValidAlphaAndNumeric(const char *vpText);
  static bool Compare(const CMIUtilString &vrLhs, const CMIUtilString &vrRhs);
  static CMIUtilString ConvertToPrintableASCII(const char vChar,
                                               bool bEscapeQuotes = false);
  static CMIUtilString ConvertToPrintableASCII(const char16_t vChar16,
                                               bool bEscapeQuotes = false);
  static CMIUtilString ConvertToPrintableASCII(const char32_t vChar32,
                                               bool bEscapeQuotes = false);

  // Methods:
public:
  /* ctor */ CMIUtilString();
  /* ctor */ CMIUtilString(const char *vpData);
  /* ctor */ CMIUtilString(const std::string &vrStr);
  //
  bool ExtractNumber(MIint64 &vwrNumber) const;
  CMIUtilString FindAndReplace(const CMIUtilString &vFind,
                               const CMIUtilString &vReplaceWith) const;
  bool IsNumber() const;
  bool IsHexadecimalNumber() const;
  bool IsQuoted() const;
  CMIUtilString RemoveRepeatedCharacters(const char vChar);
  size_t Split(const CMIUtilString &vDelimiter, VecString_t &vwVecSplits) const;
  size_t SplitConsiderQuotes(const CMIUtilString &vDelimiter,
                             VecString_t &vwVecSplits) const;
  size_t SplitLines(VecString_t &vwVecSplits) const;
  CMIUtilString StripCREndOfLine() const;
  CMIUtilString StripCRAll() const;
  CMIUtilString Trim() const;
  CMIUtilString Trim(const char vChar) const;
  size_t FindFirst(const CMIUtilString &vrPattern, size_t vnPos = 0) const;
  size_t FindFirst(const CMIUtilString &vrPattern, bool vbSkipQuotedText,
                   bool &vrwbNotFoundClosedQuote, size_t vnPos = 0) const;
  size_t FindFirstNot(const CMIUtilString &vrPattern, size_t vnPos = 0) const;
  CMIUtilString Escape(bool vbEscapeQuotes = false) const;
  CMIUtilString AddSlashes() const;
  CMIUtilString StripSlashes() const;
  //
  CMIUtilString &operator=(const char *vpRhs);
  CMIUtilString &operator=(const std::string &vrRhs);

  // Overrideable:
public:
  /* dtor */ virtual ~CMIUtilString();

  // Static method:
private:
  static CMIUtilString FormatPriv(const CMIUtilString &vrFormat, va_list vArgs);
  static CMIUtilString ConvertCharValueToPrintableASCII(char vChar,
                                                        bool bEscapeQuotes);

  // Methods:
private:
  bool ExtractNumberFromHexadecimal(MIint64 &vwrNumber) const;
  CMIUtilString RemoveRepeatedCharacters(size_t vnPos, const char vChar);
  size_t FindFirstQuote(size_t vnPos) const;
};