File indexing completed on 2024-05-05 05:48:32

 /*
     CT Unit of Time Interval Header
     --------------------------------------------------------------------
     SPDX-FileCopyrightText: 1999 Gary Meyer <gary@meyer.net>
     --------------------------------------------------------------------
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include <QList>
 #include <QString>
 
 /**
  * A cron table unit parser and tokenizer.
  * Parses/tokenizes unit such as "0-3,5,6,10-30/5"
  * Also provides default natural language description.
  */
 class CTUnit
 {
 protected:
     CTUnit(int min, int max, const QString &tokStr = QLatin1String(""));
 
     /**
      * Get default natural language description.
      */
     virtual QString genericDescribe(const QList<QString> &label) const;
 
 public:
     /**
      * Base initial image as empty and copy enabled intervals.
      */
     CTUnit(const CTUnit &source);
 
     /**
      * Destructor.
      */
     virtual ~CTUnit();
 
     /**
      * Copy enabled intervals.
      */
     CTUnit &operator=(const CTUnit &unit);
 
     /**
      * Tokenizes unit into string such as
      * "0,1,2,3,5,6,10,15,20,25,30".
      */
     virtual QString exportUnit() const;
 
     /**
      * Parses unit such as "0-3,5,6,10-30/5".
      * And initialize array of enabled intervals.
      */
     void initialize(const QString &tokStr = QLatin1String(""));
 
     /**
      * Lower bound.
      */
     int minimum() const;
 
     /**
      * Upper bound.
      */
     int maximum() const;
 
     /**
      * Accessor.
      */
     bool isEnabled(int pos) const;
 
     bool isAllEnabled() const;
 
     void setEnabled(int pos, bool value);
 
     /**
      * Indicates whether enabled intervals have been modified.
      */
     bool isDirty() const;
 
     /**
      * Total count of enabled intervals.
      */
     int enabledCount() const;
 
     /**
      * Mark changes as applied.
      */
     void apply();
 
     /**
      * Mark cancel changes and revert to initial or last applied
      * image.
      */
     void cancel();
 
     /**
      * Find a period in enabled values
      * If no period has been found, return 0
      */
     int findPeriod(const QList<int> &periods) const;
 
 protected:
     /**
      * Parses unit such as "0-3,5,6,10-30/5".
      * Does not initialize array of enabled intervals.
      */
     void parse(const QString &tokenString = QLatin1String(""));
 
 private:
     int mMin;
     int mMax;
 
     int fieldToValue(const QString &entry) const;
     bool mDirty;
 
     QList<bool> mEnabled;
     QList<bool> mInitialEnabled;
 
     QString mInitialTokStr;
 
 public:
     /**
      * Constant indicating short format.
      */
     static const bool shortFormat = false;
 
     /**
      * Constant indicating long format.
      */
     static const bool longFormat = true;
 };