add onoff support for "inset-modify changetype xxx" in include inset

[lyx.git] / src / support / FileName.h

diff --git a/src/support/FileName.h b/src/support/FileName.h
index c293f66021fada455cd4ad35df7cabf2aba3d827..0a433d278fe811dba290fb0db45f44496f6b0490 100644 (file)
--- a/src/support/FileName.h
+++ b/src/support/FileName.h
@@ -43,6 +43,9 @@ public:
        /// copy constructor.
        FileName(FileName const &);
 
+       /// constructor with base name and suffix.
+       FileName(FileName const & fn, std::string const & suffix);
+
        ///
        FileName & operator=(FileName const &);
 
@@ -52,11 +55,21 @@ public:
         * Encoding is always UTF-8.
         */
        virtual void set(std::string const & filename);
+       virtual void set(FileName const & fn, std::string const & suffix);
        virtual void erase();
        /// Is this filename empty?
        bool empty() const;
+       /// Is the filename absolute?
+       static bool isAbsolute(std::string const & name);
+
        /// get the absolute file name in UTF-8 encoding
        std::string absFilename() const;
+
+       /** returns an absolute pathname (whose resolution does not involve
+         * '.', '..', or symbolic links) in UTF-8 encoding
+         */
+       std::string realPath() const;
+
        /**
         * Get the file name in the encoding used by the file system.
         * Only use this for accessing the file, e.g. with an fstream.
@@ -72,15 +85,15 @@ public:
        /// returns time of last write access
        std::time_t lastModified() const;
        /// generates a checksum of a file
-       unsigned long checksum() const;
-       /// return true when file is readable but not writabel
+       virtual unsigned long checksum() const;
+       /// return true when file is readable but not writable
        bool isReadOnly() const;
        /// return true when it names a directory
        bool isDirectory() const;
-       /// return true when file/directory is readable
+       /// return true when directory is readable
        bool isReadableDirectory() const;
        /// return true when it is a file and readable
-       bool isReadableFile() const;
+       virtual bool isReadableFile() const;
        /// return true when file/directory is writable
        bool isWritable() const;
        /// return true when file/directory is writable (write test file)
@@ -90,18 +103,39 @@ public:
        
        /// copy a file
        /// \return true when file/directory is writable (write test file)
-       /// \param overwrite: set to true if we should erase the \c target 
-       /// file if it exists,
-       bool copyTo(FileName const & target, bool overwrite = false) const;
+       /// \warning This methods has different semantics when system level
+       /// copy command, it will overwrite the \c target file if it exists,
+       bool copyTo(FileName const & target) const;
 
        /// remove pointed file.
-       /// \retrun true on success.
+       /// \return true on success.
        bool removeFile() const;
 
-       /// remove directory and all contents, returns true on success
+       /// rename pointed file.
+       /// \return false if the operation fails or if the \param target file
+       /// already exists.
+       /// \return true on success.
+       bool renameTo(FileName const & target) const;
+
+       /// move pointed file to \param target.
+       /// \return true on success.
+       bool moveTo(FileName const & target) const;
+
+       /// change mode of pointed file.
+       /// This methods does nothing and return true on platforms that does not
+       /// support this.
+       /// \return true on success.
+       bool changePermission(unsigned long int mode) const;
+
+       /// remove pointed directory and all contents.
+       /// \return true on success.
        bool destroyDirectory() const;
-       /// Creates directory. Returns true on success
+       /// Creates pointed directory.
+       /// \return true on success.
        bool createDirectory(int permissions) const;
+       /// Creates pointed path.
+       /// \return true on success.
+       bool createPath() const;
 
        /// Get the contents of a file as a huge docstring.
        /// \param encoding defines the encoding of the file contents.
@@ -127,13 +161,28 @@ public:
        bool isZippedFile() const;
 
        static FileName fromFilesystemEncoding(std::string const & name);
-       /// (securely) create a temporary file in the given dir with the given mask
-       /// \p mask must be in filesystem encoding
-       static FileName tempName(FileName const & dir = FileName(),
-                                               std::string const & mask = empty_string());
+       /// (securely) create a temporary file with the given mask.
+       /// \p mask must be in filesystem encoding, if it contains a
+       /// relative path, the template file will be created in the global
+       /// temporary directory as given by 'package().temp_dir()'.
+       static FileName tempName(std::string const & mask = empty_string());
+       static FileName tempName(FileName const & temp_dir,
+               std::string const & mask);
+
+       /// get the current working directory
+       static FileName getcwd();
+
+       static FileName tempPath();
 
        /// filename without path
        std::string onlyFileName() const;
+       /// filename without path and without extension
+       std::string onlyFileNameWithoutExt() const;
+       /// only extension after the last dot.
+       std::string extension() const;
+       /** checks if the file has the given extension
+               on Windows and Mac it compares case insensitive */
+       bool hasExtension(const std::string & ext);
        /// path without file name
        FileName onlyPath() const;
        /// used for display in the Gui
@@ -148,12 +197,14 @@ public:
        docstring const absoluteFilePath() const;
 
 private:
+       friend bool equivalent(FileName const &, FileName const &);
        ///
        struct Private;
        Private * const d;
 };
 
 
+bool equivalent(FileName const &, FileName const &);
 bool operator==(FileName const &, FileName const &);
 bool operator!=(FileName const &, FileName const &);
 bool operator<(FileName const &, FileName const &);
@@ -181,7 +232,7 @@ public:
         *  \param buffer_path if \c filename has a relative path, generate
         *  the absolute path using this.
         */
-       void set(std::string const & filename, std::string const & buffer_path);
+       virtual void set(std::string const & filename, std::string const & buffer_path);
 
        void erase();