gdal_openinfo.h

/******************************************************************************
 *
 * Name:     gdal_openinfo.h
 * Project:  GDAL Core
 * Purpose:  Declaration of GDALOpenInfo class
 * Author:   Frank Warmerdam, warmerdam@pobox.com
 *
 ******************************************************************************
 * Copyright (c) 1998, Frank Warmerdam
 * Copyright (c) 2007-2014, Even Rouault <even dot rouault at spatialys.com>
 *
 * SPDX-License-Identifier: MIT
 ****************************************************************************/
 
#ifndef GDALOPENINFO_H_INCLUDED
#define GDALOPENINFO_H_INCLUDED
 
#include "cpl_port.h"
 
#include "gdal.h"
 
struct VSIVirtualHandle;
 
/* ******************************************************************** */
/*                             GDALOpenInfo                             */
/* ******************************************************************** */

class CPL_DLL GDALOpenInfo
{
    bool bHasGotSiblingFiles = false;
    char **papszSiblingFiles = nullptr;
    int nHeaderBytesTried = 0;
 
    void Init(const char *const *papszSiblingFilesIn,
              std::unique_ptr<VSIVirtualHandle> poFile);
 
  public:
    GDALOpenInfo(const char *pszFile, int nOpenFlagsIn,
                 const char *const *papszSiblingFilesIn = nullptr);
    GDALOpenInfo(const char *pszFile, int nOpenFlagsIn,
                 std::unique_ptr<VSIVirtualHandle> poFile);
    ~GDALOpenInfo();

    char *pszFilename = nullptr;

    std::string osExtension{};

    char **papszOpenOptions = nullptr;

    GDALAccess eAccess = GA_ReadOnly;
    int nOpenFlags = 0;

    bool bStatOK = false;
    bool bIsDirectory = false;

    VSILFILE *fpL = nullptr;

    int nHeaderBytes = 0;
    GByte *pabyHeader = nullptr;

    const char *const *papszAllowedDrivers = nullptr;
 
    int TryToIngest(int nBytes);
    char **GetSiblingFiles();
    char **StealSiblingFiles();
    bool AreSiblingFilesLoaded() const;
 
    bool IsSingleAllowedDriver(const char *pszDriverName) const;

    inline bool IsExtensionEqualToCI(const char *pszExt) const
    {
        return EQUAL(osExtension.c_str(), pszExt);
    }
 
  private:
    CPL_DISALLOW_COPY_ASSIGN(GDALOpenInfo)
};
 
#endif