FXDirVisitor.h

/********************************************************************************
*                                                                               *
*                     D i r e c t o r y   V i s i t o r                         *
*                                                                               *
*********************************************************************************
* Copyright (C) 2008,2024 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 FXDIRVISITOR_H
#define FXDIRVISITOR_H

namespace FX {


class FXAPI FXDirVisitor {
private:
  struct Seen;
private:
  Seen* current;
private:
  FXDirVisitor(const FXDirVisitor&);
  FXDirVisitor& operator=(const FXDirVisitor&);
public:

  FXDirVisitor():current(nullptr){}

  FXuint traverse(const FXString& path,FXint limit=1000);

  FXbool visiting() const { return current!=nullptr; }

  const FXStat& info() const;

  virtual FXuint enter(const FXString& path);

  virtual FXuint visit(const FXString& path);

  virtual FXuint leave(const FXString& path);

  virtual ~FXDirVisitor();
  };


class FXAPI FXGlobVisitor : public FXDirVisitor {
private:
  FXString wildcard;            // Match files against this wild card
  FXuint   options;             // Matching options
private:
  FXGlobVisitor(const FXGlobVisitor&);
  FXGlobVisitor& operator=(const FXGlobVisitor&);
public:

  FXGlobVisitor():options(0){}

  FXuint traverse(const FXString& path,const FXString& wild="*",FXuint opts=FXDir::MatchAll,FXint depth=1000);

  virtual FXuint enter(const FXString& path);

  virtual FXuint visit(const FXString& path);

  virtual FXuint leave(const FXString& path);

  virtual ~FXGlobVisitor();
  };


class FXAPI FXGlobCountVisitor : public FXGlobVisitor {
private:
  FXlong countFolders;          // Count of folders seen
  FXlong countFiles;            // Count of files seen
  FXlong countBytes;            // Total number of bytes in files
  FXlong maxDepth;              // Maximum depth
  FXlong depth;                 // Current depth during traversal
private:
  FXGlobCountVisitor(const FXGlobCountVisitor&);
  FXGlobCountVisitor& operator=(const FXGlobCountVisitor&);
public:

  FXGlobCountVisitor();

  FXuint traverse(const FXString& path,const FXString& wild="*",FXuint opts=FXDir::MatchAll,FXint limit=1000);

  FXlong getTotalFolders() const { return countFolders; }

  FXlong getTotalFiles() const { return countFiles; }

  FXlong getTotalBytes() const { return countBytes; }

  FXlong getMaximumDepth() const { return maxDepth; }

  virtual FXuint enter(const FXString& path);

  virtual FXuint visit(const FXString& path);

  virtual FXuint leave(const FXString& path);

  virtual ~FXGlobCountVisitor();
  };


}

#endif