filescamp.inl

Go to the documentation of this file.

//==================================================================================================
/// \file
/// This header-file is part of module \alib_files of the \aliblong.
///
/// \emoji :copyright: 2013-2025 A-Worx GmbH, Germany.
/// Published under #"mainpage_license".
//==================================================================================================
ALIB_EXPORT namespace alib {
 
//==================================================================================================
/// This is the reference documentation of module \alib_files_nl of the \aliblong.<br>
/// @see A user manual with tutorial-style sample code is found in the
///      #"alib_mod_files;Programmer's Manual" of this module.
//==================================================================================================
namespace files {
 
//todo: An symlink target knoten muss ein "scanparent" dran. Dieser zeigt auf den link.
//      Die AssemblePath muss es dann entweder mit einem Flag geben oder unter anderem Namen.
//      Auch eine alternative Parent() muss her, z.B. ScanParent() oder LinkParent(). Eines von
//      beiden Wörtern muss man nehmen. Bei den meisten wird dann ein nulled-String zurückgegeben.
//      Wenn ein zweiter scan einen Knoten erneut, aber dieses mal direkt findet, dann überschreibt
//      es den link-parent mit nulled! Zwar würde die Info damit verloren gegehen... aber deswegen
//      würde ich es ja ScanParent nennen. Das muss man dann so im manual dokumentieren:
//      Link-parent kann es ja grundsätzlich viele geben, die bedeutung hier its: Ist dieser Knoten
//      bisher ausschließlich über irgendeinen Symlink reingekommen? Dann zeige ihn so auch
//      dem Benutzer. Wenn er später direkt gefunden wurde, hat der benutzer diesen Real-pfad angegeben
//      und er bekommt dann diesen auch angezeigt! Das ist eigentlich recht leicht zu implementieren.
//==================================================================================================
/// This is a strict singleton class representing module \alib_files.
///
/// The only instance is found with the namespace variable #"alib::files".
//==================================================================================================
class FilesCamp : public camp::Camp
{
  public:
    /// Constructor.<br>
    /// While this is public, it must not be invoked as this is a strict singleton type.
    /// (See notes in #"alib_camp_camp").
    ALIB_DLL
    FilesCamp();
 
  protected:
    /// Initializes this camp.
    ALIB_DLL
    virtual void    Bootstrap()                                                            override;
 
    /// Terminates this camp. (Nothing to do.)
    virtual void    Shutdown( ShutdownPhases )                                           override {}
 
}; // class FilesCamp
 
} // namespace alib[::files]
 
/// The singleton instance of \alibcamp class #"FilesCamp".
extern ALIB_DLL files::FilesCamp FILES;
 
} // namespace [alib]