Character.h

 
#ifndef MFRAME_5098703C_A1D7_4D60_9E2D_E5F648A0C629
#define MFRAME_5098703C_A1D7_4D60_9E2D_E5F648A0C629
 
/* ***************************************************************************************
 * Include
 */
 
//----------------------------------------------------------------------------------------
 
//----------------------------------------------------------------------------------------
#include "./../lang/Appendable.h"
#include "./../lang/NonInstantiable.h"
#include "./../lang/Strings.h"
 
/* ***************************************************************************************
 * Namespace
 */
namespace ufm::lang {
  class Character;
}  // namespace ufm::lang
 
/* ***************************************************************************************
 * Class/Interface/Struct/Enum
 */
 
class ufm::lang::Character final : public ufm::lang::NonInstantiable {
  /* *************************************************************************************
   * Class/Interface/Struct/Enum
   */
 public:
  enum struct LineEnding : uint8;
  /* *************************************************************************************
   * Variable
   */
 
  /* *************************************************************************************
   * Abstract Method
   */
 
  /* *************************************************************************************
   * Construct Method
   */
 protected:
  virtual ~Character(void) override = default;
 
  /* *************************************************************************************
   * Operator Method
   */
 
  /* *************************************************************************************
   * Override Method
   */
 
  /* *************************************************************************************
   * Public Method
   */
 
  /* *************************************************************************************
   * Protected Method
   */
 
  /* *************************************************************************************
   * Private Method
   */
 
  /* *************************************************************************************
   * Static Variable
   */
 public:
  // 控制字符(Control Characters)
  static constexpr char KEY_NUL       = 0x00; 
  static constexpr char KEY_SOH       = 0x01; 
  static constexpr char KEY_STX       = 0x02; 
  static constexpr char KEY_ETX       = 0x03; 
  static constexpr char KEY_EOT       = 0x04; 
  static constexpr char KEY_ENQ       = 0x05; 
  static constexpr char KEY_ACK       = 0x06; 
  static constexpr char KEY_BEL       = 0x07; 
  static constexpr char KEY_BS        = 0x08; 
  static constexpr char KEY_TAB       = 0x09; 
  static constexpr char KEY_LF        = 0x0A; 
  static constexpr char KEY_VT        = 0x0B; 
  static constexpr char KEY_FF        = 0x0C; 
  static constexpr char KEY_CR        = 0x0D; 
  static constexpr char KEY_SO        = 0x0E; 
  static constexpr char KEY_SI        = 0x0F; 
  static constexpr char KEY_DLE       = 0x10; 
  static constexpr char KEY_DC1       = 0x11; 
  static constexpr char KEY_DC2       = 0x12; 
  static constexpr char KEY_DC3       = 0x13; 
  static constexpr char KEY_DC4       = 0x14; 
  static constexpr char KEY_NAK       = 0x15; 
  static constexpr char KEY_SYN       = 0x16; 
  static constexpr char KEY_ETB       = 0x17; 
  static constexpr char KEY_CAN       = 0x18; 
  static constexpr char KEY_EM        = 0x19; 
  static constexpr char KEY_SUB       = 0x1A; 
  static constexpr char KEY_ESC       = 0x1B; 
  static constexpr char KEY_FS        = 0x1C; 
  static constexpr char KEY_GS        = 0x1D; 
  static constexpr char KEY_RS        = 0x1E; 
  static constexpr char KEY_US        = 0x1F; 
  static constexpr char KEY_BACKSPACE = 0x7F; 
  // 符號字符(Symbol Characters)
  static constexpr char KEY_SPACE         = 0x20; 
  static constexpr char KEY_EXCLAM        = 0x21; 
  static constexpr char KEY_QUOTE         = 0x22; 
  static constexpr char KEY_HASH          = 0x23; 
  static constexpr char KEY_DOLLAR        = 0x24; 
  static constexpr char KEY_PERCENT       = 0x25; 
  static constexpr char KEY_AMPERSAND     = 0x26; 
  static constexpr char KEY_APOSTROPHE    = 0x27; 
  static constexpr char KEY_LEFT_PAREN    = 0x28; 
  static constexpr char KEY_RIGHT_PAREN   = 0x29; 
  static constexpr char KEY_ASTERISK      = 0x2A; 
  static constexpr char KEY_PLUS          = 0x2B; 
  static constexpr char KEY_COMMA         = 0x2C; 
  static constexpr char KEY_MINUS         = 0x2D; 
  static constexpr char KEY_PERIOD        = 0x2E; 
  static constexpr char KEY_SLASH         = 0x2F; 
  static constexpr char KEY_COLON         = 0x3A; 
  static constexpr char KEY_SEMICOLON     = 0x3B; 
  static constexpr char KEY_LESS_THAN     = 0x3C; 
  static constexpr char KEY_EQUAL         = 0x3D; 
  static constexpr char KEY_GREATER_THAN  = 0x3E; 
  static constexpr char KEY_QUESTION      = 0x3F; 
  static constexpr char KEY_AT            = 0x40; 
  static constexpr char KEY_LEFT_BRACKET  = 0x5B; 
  static constexpr char KEY_BACKSLASH     = 0x5C; 
  static constexpr char KEY_RIGHT_BRACKET = 0x5D; 
  static constexpr char KEY_CARET         = 0x5E; 
  static constexpr char KEY_UNDERSCORE    = 0x5F; 
  static constexpr char KEY_GRAVE         = 0x60; 
  static constexpr char KEY_LEFT_CURLY    = 0x7B; 
  static constexpr char KEY_VERTICAL_BAR  = 0x7C; 
  static constexpr char KEY_RIGHT_CURLY   = 0x7D; 
  static constexpr char KEY_TILDE         = 0x7E; 
  /* *************************************************************************************
   * Static Method
   */
 public:
  static inline bool isTokenSymbol(char c) {
    return ((c == ' ') || (c == Character::KEY_TAB) || (c == Character::KEY_CR) ||
            (c == Character::KEY_LF) || (c == Character::KEY_NUL));
  }
 
  static inline bool isNextLineSymbol(char c) {
    return ((c == Character::KEY_CR) || (c == Character::KEY_LF) ||
            (c == Character::KEY_NUL));
  }
 
  static inline bool isHexChar(char c) {
    if ((c >= '0') && (c <= '9')) return true;
    if ((c >= 'a') && (c <= 'f')) return true;
    if ((c >= 'A') && (c <= 'F')) return true;
    return false;
  }
 
  static inline bool isNumberChar(char c) {
    return ((c >= '0') && (c <= '9'));
  }
 
  static inline bool isPrintable(char c) {
    return ((c >= ' ') && (c <= '~'));
  }
 
  static inline bool isControl(char c) {
    return (((c > Character::KEY_NUL) && (c <= Character::KEY_US)) ||
            (c == Character::KEY_BACKSPACE));
  }
 
  static inline char toUpperCase(char ch) {
    return (((ch >= 'a') && (ch <= 'z')) ? (ch - ('a' - 'A')) : ch);
  }
 
  static int toUpperCase(const char* src, char* dst);
 
  static int toUpperCase(const char* src, char* dst, int length);
 
  static inline char toLowerCase(char ch) {
    return (((ch >= 'A') && (ch <= 'Z')) ? (ch + ('a' - 'A')) : ch);
  }
 
  static int toLowerCase(const char* src, char* dst);
 
  static int toLowerCase(const char* src, char* dst, int length);
 
  static bool hexCharToChar(char& result, char highChar, char lowChar);
 
  static bool hexCharToChar(char& result, char source);
 
  static inline bool compare(char src1, char src2) {
    return (src1 == src2);
  }
 
  static bool compare(const char* str1, const char* str2, int length = -1);
 
  static inline bool compareIgnoreCast(char src1, char src2) {
    return (Character::toLowerCase(src1) == Character::toLowerCase(src2));
  }
 
  static bool compareIgnoreCast(const char* src1, const char* src2, int length = -1);
 
  static bool compareTokenIgnoreCast(const char* src1, const char* src2, int length = -1);
 
  static int length(const char* src);
 
  static int lengthToken(const char* src);
 
  static inline bool isHexString(const ufm::lang::Data& source);
 
  static bool parseHexString(ufm::lang::Data& result, const ufm::lang::Data& source);
};
 
enum struct ufm::lang::Character::LineEnding : uint8 {
  LF,  
  CR,  
  CRLF 
};
 
/* ***************************************************************************************
 * End of file
 */
 
#endif /* MFRAME_5098703C_A1D7_4D60_9E2D_E5F648A0C629 */