FXRex.h

/********************************************************************************
*                                                                               *
*                 R e g u l a r   E x p r e s s i o n   C l a s s               *
*                                                                               *
*********************************************************************************
* Copyright (C) 1999,2026 by Jeroen van der Zijp.   All Rights Reserved.        *
*********************************************************************************
* This library is free software; you can redistribute it and/or modify          *
* it under the terms of the GNU Lesser General Public License as published by   *
* the Free Software Foundation; either version 3 of the License, or             *
* (at your option) any later version.                                           *
*                                                                               *
* This library is distributed in the hope that it will be useful,               *
* but WITHOUT ANY WARRANTY; without even the implied warranty of                *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                 *
* GNU Lesser General Public License for more details.                           *
*                                                                               *
* You should have received a copy of the GNU Lesser General Public License      *
* along with this program.  If not, see <http://www.gnu.org/licenses/>          *
********************************************************************************/
#ifndef FXREX_H
#define FXREX_H

namespace FX {


class FXAPI FXRex {
private:
  FXString code;
private:
  static const FXchar *const errors[];
public:

  enum {

    Normal     = 0,     
    Unicode    = 1,     

    Syntax     = 2,     
    Verbatim   = 4,     
    Capture    = 8,     
    IgnoreCase = 16,    
    Newline    = 32,    
    Exact      = 64,    
    NotEmpty   = 128,   
    Reverse    = 256,   
    WordBeg    = 512,   
    WordEnd    = 1024,  
    Words      = 1536,  

    NotBol     = 2048,  
    NotEol     = 4096   
    };

  enum Error {
    ErrOK      = 0,     
    ErrEmpty   = 1,     
    ErrMore    = 2,     
    ErrParent  = 3,     
    ErrBracket = 4,     
    ErrBrace   = 5,     
    ErrRange   = 6,     
    ErrEscape  = 7,     
    ErrCount   = 8,     
    ErrNoAtom  = 9,     
    ErrRepeat  = 10,    
    ErrBackRef = 11,    
    ErrClass   = 12,    
    ErrComplex = 13,    
    ErrMemory  = 14,    
    ErrToken   = 15,    
    ErrLong    = 16,    
    ErrSupport = 17     
    };

public:

  FXRex();

  FXRex(const FXRex& orig);

  FXRex(const FXchar* pattern,FXint mode=Normal,Error* error=nullptr);

  FXRex(const FXString& pattern,FXint mode=Normal,Error* error=nullptr);

  FXbool empty() const { return code.empty(); }

  Error parse(const FXchar* pattern,FXint mode=Normal);
  Error parse(const FXString& pattern,FXint mode=Normal);

  FXbool amatch(const FXchar* string,FXint len,FXint pos=0,FXint mode=Normal,FXint* beg=nullptr,FXint* end=nullptr,FXint npar=0) const;
  FXbool amatch(const FXString& string,FXint pos=0,FXint mode=Normal,FXint* beg=nullptr,FXint* end=nullptr,FXint npar=0) const;


  FXint search(const FXchar* string,FXint len,FXint fm,FXint to,FXint mode=Normal,FXint* beg=nullptr,FXint* end=nullptr,FXint npar=0) const;
  FXint search(const FXString& string,FXint fm,FXint to,FXint mode=Normal,FXint* beg=nullptr,FXint* end=nullptr,FXint npar=0) const;

  static FXString substitute(const FXchar* string,FXint len,FXint* beg,FXint* end,const FXchar* replace,FXint npar=1);
  static FXString substitute(const FXchar* string,FXint len,FXint* beg,FXint* end,const FXString& replace,FXint npar=1);
  static FXString substitute(const FXString& string,FXint* beg,FXint* end,const FXchar* replace,FXint npar=1);
  static FXString substitute(const FXString& string,FXint* beg,FXint* end,const FXString& replace,FXint npar=1);

  static const FXchar* getError(Error err){ return errors[err]; }

  FXRex& operator=(const FXRex& orig);

  FXbool operator==(const FXRex& rex) const;
  FXbool operator!=(const FXRex& rex) const;

  static FXString escape(const FXString& str);

  friend FXAPI FXStream& operator<<(FXStream& store,const FXRex& s);
  friend FXAPI FXStream& operator>>(FXStream& store,FXRex& s);

  void clear();

 ~FXRex();
  };


// Serialization
extern FXAPI FXStream& operator<<(FXStream& store,const FXRex& s);
extern FXAPI FXStream& operator>>(FXStream& store,FXRex& s);

}

#endif