GDALSubdatasetInfo Struct Reference

The GDALSubdatasetInfo abstract class provides methods to extract and manipulate subdataset information from a file name that contains subdataset information. More...

#include <gdalsubdatasetinfo.h>

Public Member Functions
	GDALSubdatasetInfo (const std::string &fileName)
	Construct a GDALSubdatasetInfo object from a subdataset file descriptor.
std::string	GetPathComponent () const
	Returns the unquoted and unescaped path component of the complete file descriptor stripping any subdataset, prefix and additional information.
std::string	ModifyPathComponent (const std::string &newPathName) const
	Replaces the path component of the complete file descriptor by keeping the subdataset and any other component unaltered.
std::string	GetSubdatasetComponent () const
	Returns the subdataset component of the file name.

Detailed Description

The GDALSubdatasetInfo abstract class provides methods to extract and manipulate subdataset information from a file name that contains subdataset information.

Drivers offering this functionality must override the parseFileName() method.

Constructor & Destructor Documentation

GDALSubdatasetInfo()

GDALSubdatasetInfo::GDALSubdatasetInfo

(

const std::string &

fileName

)

Construct a GDALSubdatasetInfo object from a subdataset file descriptor.

Parameters

fileName

The subdataset file name descriptor.

Member Function Documentation

GetPathComponent()

std::string GDALSubdatasetInfo::GetPathComponent

(

)

const

Returns the unquoted and unescaped path component of the complete file descriptor stripping any subdataset, prefix and additional information.

Returns

The path to the file

Since

GDAL 3.8

GetSubdatasetComponent()

std::string GDALSubdatasetInfo::GetSubdatasetComponent

(

)

const

Returns the subdataset component of the file name.

Returns

The subdataset name

Since

GDAL 3.8

ModifyPathComponent()

std::string GDALSubdatasetInfo::ModifyPathComponent

(

const std::string &

newPathName

)

const

Replaces the path component of the complete file descriptor by keeping the subdataset and any other component unaltered.

The returned string must be freed with CPLFree()

Parameters

newPathName

New path name with no subdataset information.

Note

This method does not check if the subdataset actually exists.

Returns

The original file name with the old path component replaced by newPathName.

Since

GDAL 3.8

---

The documentation for this struct was generated from the following files:

• gdalsubdatasetinfo.h
• gdalsubdatasetinfo.cpp