FileName.h

Go to the documentation of this file.

#ifndef FileName_h
#define FileName_h

#include <QSharedData>

class QDate;
class QDir;
class QString;

template<typename A, typename B> struct QPair;

namespace Isis {
  class FileName {
    public:
      FileName();
      FileName(const char *fileName);
      FileName(const QString &fileName);
      FileName(const FileName &other);
      ~FileName();

      QString originalPath() const;
      QString path() const;

      QString attributes() const;
      QString baseName() const;
      QString name() const;
      QString extension() const;

      QString expanded() const;
      QString original() const;

      FileName addExtension(const QString &extension) const;
      FileName removeExtension() const;
      FileName setExtension(const QString &extension) const;

      bool isVersioned() const;
      bool isNumericallyVersioned() const;
      bool isDateVersioned() const;

      FileName highestVersion() const;
      FileName newVersion() const;
      FileName version(long versionNumber) const;
      FileName version(QDate versionDate) const;

      // Return true if the file exists
      bool fileExists() const;

      // Create a directory
      QDir dir() const;

      static FileName createTempFile(FileName templateFileName = "$TEMPORARY/temp");

      QString toString() const;
      FileName &operator=(const FileName &rhs);
      bool operator==(const FileName &rhs);
      bool operator!=(const FileName &rhs);

    private:
      QDate highestVersionDate() const;
      long highestVersionNum() const;
      void validateVersioningState() const;

      QString fileNameQDatePattern() const;

      QPair<QString, QString> splitNameAroundVersionNum() const;

    private:
      class Data : public QSharedData {
        public:
          Data();
          Data(const Data &other);
          ~Data();

          QString original(bool includeAttributes) const;
          void setOriginal(const QString &);

          QString expanded(bool includeAttributes) const;

          // assignment operator is defined in QSharedData
          // Data &operator=(const Data &rhs);

        private:
          QString *m_originalFileNameString;
          QString *m_expandedFileNameString;
      };

      QSharedDataPointer<Data> m_d;
  };
};

#endif