Newer
Older
/*
* ADIOSFunctions.h Describe functions used by ADIOS class
*
* Created on: Oct 10, 2016
* Author: wfg
*/
#ifndef ADIOSFUNCTIONS_H_
#define ADIOSFUNCTIONS_H_
#include <string>
#include <vector>
#include <map>
#ifdef HAVE_MPI
#include <mpi.h> //Just for MPI_Comm argument in SetMembersMPI
#endif
#include "CGroup.h"
namespace adios
{
/**
* Opens and checks for file and dumps contents to a single string
* @param fileName file to be opened
* @param fileContents output contains the entire file
*/
void DumpFileToStream( const std::string fileName, std::string& fileContents );
/**
* Extracts a substring between two tags from content
* @param initialTag
* @param finalTag
* @param content full string
* @param subString if found return substring between initialTag and finalTag, otherwise returns empty
* @param currentPosition to start the search, moved forward to finalTag position
*/
void GetSubString ( const std::string initialTag, const std::string finalTag, const std::string content, std::string& subString,
std::string::size_type& currentPosition );
/**
* Extracts the value inside quotes in a string currentTag ( Example: currentTag --> field1="value1" field2="value2" )
* @param quote double " or single '
* @param quotePosition position of the opening quote in currentTag
* @param currentTag initial tag value, modified by cutting the first found " " portion, currentTag --> field2="value2"
* @param value value1 in the example above
*/
void GetQuotedValue( const char quote, const std::string::size_type& quotePosition,
std::string& currentTag, std::string& value );
/**
* Get attributes field1="value1" field2="value2" by looping through a single XML tag
* @param tag field0="value0" field1="value1" in a single string
* @param pairs pairs[0].first=field0 pairs[0].second=value0 pairs[1].first=field1 pairs[1].second=value1
*/
void GetPairs( const std::string tag, std::vector< std::pair<const std::string, const std::string> >& pairs ) noexcept;
/**
* Determine tag type and call GetPairs to populate pairs
* @param fileContent file Content in a single string
* @param tag field0="value0" field1="value1" in a single string
* @param pairs pairs[0].first=field0 pairs[0].second=value0 pairs[1].first=field1 pairs[1].second=value1
*/
void GetPairsFromTag( const std::string& fileContent, const std::string tag,
std::vector< std::pair<const std::string, const std::string> >& pairs );
* Set members m_Groups and m_HostLanguage from XML file content, called within Init functions
* @param fileContent file Content in a single string
* @param hostLanguage return the host language from fileContent
* @param groups passed returns the map of groups defined in fileContent
void SetMembers( const std::string& fileContent, std::string& hostLanguage, std::map< std::string, CGroup >& groups );
#ifdef HAVE_MPI
/**
* Set members m_Groups and m_HostLanguage from XML file content, called within Init functions
* @param fileContent file Content in a single string
* @param hostLanguage return the host language from fileContent
* @param groups passed returns the map of groups defined in fileContent
*/
void SetMembers( const std::string& fileContent, std::string& hostLanguage, std::map< std::string, CGroup >& groups,
const MPI_Comm mpiComm );
#endif
} //end namespace