| CRM64Pro GDK v0.19.0 A free cross-platform game development kit built on top of SDL 3.0

Loading...
Searching...
No Matches
CRM64Pro::XMLMgrfinal
Core modules » XML

XML Manager class. More...

## Detailed Description

XML Manager class.

## Public Member Functions
bool | info (Sint32 iMode=0) override
| Request XML Manager information.
Sint32 | create (const string &sMainNode, Uint32 iReserved=0) override
| Create a new XML.
Sint32 | close (Sint32 idXML) override
| Close and destroy an XML object.
Sint32 | getCount () const override
| Get number of loaded objects.
Sint32 | setName (Sint32 idXML, const string &sName) override
| Change the object name.
XML * | get (Sint32 idXML)
| Get a pointer to the XML using its handle.
Sint32 | loadFromFile (const string &sFile, const string &sName="")
| Load an XML object from an external file.
Sint32 | loadFromBuffer (const void *pBuffer, Sint32 iSize, const string &sName)
| Load an XML object from a buffer.
Sint32 | load (const string &sCDCFile, const string &sName)
| Load an XML file stored in a CDC file.
Sint32 | load (Sint32 idCDC, const string &sName)
| Load an XML file stored in a CDC file.
Sint32 | remove (Sint32 idCDC, const string &sName)
| Remove an XML file stored in a CDC file.
bool | exists (Sint32 idCDC, const string &sName) const
| Check if an XML is stored in a CDC file.
bool | exists (const string &sCDCFile, const string &sName) const
| Check if an XML is stored in a CDC file.

## Member Function Documentation

## ◆ info()

bool CRM64Pro::XMLMgr::info | ( | Sint32 | iMode = 0 | ) |
| override

Request XML Manager information.

Writes manager information to the default log.

Parameters

  iMode | -1 to display only manager information. 0 (default) to display manager and all objects. A specific object ID displays manager information and only that object.

Returns
  true on success, or false on failure.

## ◆ create()

Sint32 CRM64Pro::XMLMgr::create | ( | const string & | sMainNode,
|  | Uint32 | iReserved = 0 )
| override

Create a new XML.

Parameters

  sMainNode | The name for the main node (e.g. 'rootNode'). Also used as the XML object name. Must be unique and shorter than 64 characters.
  iReserved | Reserved for future use. Pass 0.

Returns
  Greater than 0 on success (the XML id), or a negative error code on failure.

## ◆ close()

Sint32 CRM64Pro::XMLMgr::close | ( | Sint32 | idXML | ) |
| override

Close and destroy an XML object.

Parameters

  idXML | 0 for closing all XML objects, or a specific XML id.

Returns
  0 on success, or a negative error code on failure.

Note
  If you forget to close an XML object, it will be automatically closed once the GDK is terminated.

## ◆ getCount()

Sint32 CRM64Pro::XMLMgr::getCount | ( |  | ) | const
| override

Get number of loaded objects.

Returns
  the number of XML objects.

## ◆ setName()

Sint32 CRM64Pro::XMLMgr::setName | ( | Sint32 | idXML,
|  | const string & | sName )
| override

Change the object name.

Parameters

  idXML | XML id.
  sName | The name for the XML object (e.g. 'demoXML'). Must be unique and shorter than 64 characters.

Returns
  0 on success, or a negative error code on failure.

## ◆ get()

XML * CRM64Pro::XMLMgr::get | ( | Sint32 | idXML | ) |

Get a pointer to the XML using its handle.

Parameters

  idXML | XML id. Passing 0 returns the first loaded XML.

Returns
  Borrowed pointer to the XML object, or nullptr if not found.

Note
  The returned pointer must not be deleted. It remains valid until the XML object is closed or XMLMgr is reset or terminated.

## ◆ loadFromFile()

Sint32 CRM64Pro::XMLMgr::loadFromFile | ( | const string & | sFile,
|  | const string & | sName = "" )

Load an XML object from an external file.

Parameters

  sFile | string containing [directory]+filename+[extension]. Directory separators '\' and '/' are supported.
  sName | the XML object name. If empty (default), uses the filename without extension. Must be unique and shorter than 64 characters.

Returns
  Greater than 0 on success (the XML id), or a negative error code on failure.

## ◆ loadFromBuffer()

Sint32 CRM64Pro::XMLMgr::loadFromBuffer | ( | const void * | pBuffer,
|  | Sint32 | iSize,
|  | const string & | sName )

Load an XML object from a buffer.

Parameters

  pBuffer | pointer to buffer data containing the XML to be loaded.
  iSize | size in bytes of the buffer data.
  sName | the XML object name. Must be unique and shorter than 64 characters.

Returns
  Greater than 0 on success (the XML id), or a negative error code on failure.

## ◆ load() [1/2]

Sint32 CRM64Pro::XMLMgr::load | ( | const string & | sCDCFile,
|  | const string & | sName )

Load an XML file stored in a CDC file.

Parameters

  sCDCFile | string containing [directory]+filename+[extension]. Directory separators '\' and '/' are supported.
  sName | string containing the XML object name. Must be unique and shorter than 64 characters.

Returns
  Greater than 0 on success (the XML id), or a negative error code on failure.

Note
  If the CDC file is secured, this call will fail. Load the CDC first using ArchiveMgr::load() and use XMLMgr::load() with the CDC id instead.

## ◆ load() [2/2]

Sint32 CRM64Pro::XMLMgr::load | ( | Sint32 | idCDC,
|  | const string & | sName )

Load an XML file stored in a CDC file.

Parameters

  idCDC | CDC id.
  sName | string containing the XML object name. Must be unique and shorter than 64 characters.

Returns
  Greater than 0 on success (the XML id), or a negative error code on failure.

## ◆ remove()

Sint32 CRM64Pro::XMLMgr::remove | ( | Sint32 | idCDC,
|  | const string & | sName )

Remove an XML file stored in a CDC file.

Parameters

  idCDC | CDC id.
  sName | string containing the XML object name (shorter than 64 characters).

Returns
  0 on success, or a negative error code on failure.

Note
  The XML object must be closed before trying to remove it from the CDC.

## ◆ exists() [1/2]

bool CRM64Pro::XMLMgr::exists | ( | Sint32 | idCDC,
|  | const string & | sName ) const

Check if an XML is stored in a CDC file.

Parameters

  idCDC | CDC id.
  sName | string with the XML name (shorter than 64 characters).

Returns
  true if the resource is stored in the CDC file, or false otherwise. No error is reported.

## ◆ exists() [2/2]

bool CRM64Pro::XMLMgr::exists | ( | const string & | sCDCFile,
|  | const string & | sName ) const

Check if an XML is stored in a CDC file.

Parameters

  sCDCFile | Path to the CDC archive file.
  sName | string with the XML name (shorter than 64 characters).

Returns
  true if the resource is stored in the CDC file, or false otherwise. No error is reported.