summaryrefslogtreecommitdiffhomepage
path: root/src/CompilerKit/StringKit.h
blob: 4f07a0786ece8e45e5bfeaa391d9328b5084e870 (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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*
 *	========================================================
 *
 *	CompilerKit
 * 	Copyright (C) 2024-2025 Amlal El Mahrouss, Licensed under the Apache 2.0 license.
 *
 * 	========================================================
 */

#ifndef __NECTI_STRINGKIT__
#define __NECTI_STRINGKIT__

#include <CompilerKit/Config.h>
#include <CompilerKit/ErrorOr.h>
#include <cstring>

/// =========================================================== ///
/// @file StringKit.h
/// @author Amlal El Mahrouss
/// @brief StringKit for CompilerKit.
/// =========================================================== ///

namespace CompilerKit {
class NEStringBuilder;
class NEString;

/**
 * @brief NEString class, contains a C string and manages it.
 * @note No need to manage it it's getting deleted by default.
 */

class NEString final {
 public:
  explicit NEString() = delete;

  explicit NEString(SizeType Sz) noexcept : m_Sz(Sz) {
    m_Data = new Char[Sz];
    assert(m_Data);
  }

  ~NEString() noexcept {
    if (m_Data) {
      memset(m_Data, 0, m_Sz);
      delete[] m_Data;

      m_Data = nullptr;
    }
  }

  NECTI_COPY_DEFAULT(NEString);

  Char*       Data();
  const Char* CData() const;
  SizeType    Length() const;

  bool operator==(const Char* rhs) const;
  bool operator!=(const Char* rhs) const;

  bool operator==(const NEString& rhs) const;
  bool operator!=(const NEString& rhs) const;

  NEString& operator+=(const Char* rhs);
  NEString& operator+=(const Char rhs);
  NEString& operator+=(const NEString& rhs);

  explicit operator bool() { return m_Data && m_Data[0] != 0; }

  bool operator!() { return !m_Data || m_Data[0] == 0; }

 private:
  Char*    m_Data{nullptr};
  SizeType m_Sz{0};
  SizeType m_Cur{0};

  friend class NEStringBuilder;
};

/**
 * @brief NEStringBuilder class
 * @note These results shall call be delete[] after they're used.
 */
struct NEStringBuilder final {
  static NEString Construct(const Char* data);
  static NEString FromInt(const char* fmt, int n);
  static NEString FromBool(const char* fmt, bool n);
  static NEString Format(const char* fmt, const char* from);
  static Bool     Equals(const char* lhs, const char* rhs);
};

using NEStringOr  = ErrorOr<NEString>;
using NEStringPtr = NEString*;
using NEStringRef = Ref<NEString>;
}  // namespace CompilerKit

#endif /* ifndef __NECTI_STRINGKIT__ */