AVR Z-LINK®

ParameterParser Class Reference

---

Detailed Description

Class to parse and store command line parameters for this application.

Definition at line 56 of file createhex.cpp.

Public Member Functions
const std::string &	GetFilename () const
const std::vector< byte > &	GetMACAddress () const
std::string	GetMACAddressString () const
	ParameterParser (size_t argc, const char **argv)
	~ParameterParser ()
Private Member Functions
std::string	CreateHexString (const std::vector< byte > &byteVector) const
std::vector< byte >	ParseHexString (const std::string &hexString) const
Private Attributes
std::string	m_filename
std::vector< byte >	m_MACAddress

---

Constructor & Destructor Documentation

ParameterParser::ParameterParser	(	size_t	argc,
		const char **	argv
	)

Ctor taking the argc and argv parameters typically given to any main() function.

Definition at line 128 of file createhex.cpp.

References m_filename, m_MACAddress, and ParseHexString().

{
        // Check that argument count is valid.
        if( argc != 3 ) {
                std::cout << "Parameters:\n"
                        "  filename     - Filename for resulting Intel HEX file\n"
                        "  macaddress   - Hex representation of the MAC address (32 hex digits)\n"
                        << std::endl;
                throw std::runtime_error( "Not exactly 2 parameters" );
        }

        //
        // Create strings or string streams from argument character arrays.
        // 
        std::string arg1( argv[1] ); // Filename
        std::string arg2( argv[2] ); // MAC Address

        //
        // Copy string arguments and parse non-string arguments.
        // 
        m_filename = arg1;
        
        m_MACAddress = ParseHexString( arg2 );
        
        //
        // Check argument validity.
        // 
        if( m_MACAddress.size() != 16 ) {
                throw std::runtime_error( "MAC address has invalid length" );
        }
}

Here is the call graph for this function:

ParameterParser::~ParameterParser

(

)

[inline]

Definition at line 70 of file createhex.cpp.

{}

---

Member Function Documentation

std::string ParameterParser::CreateHexString

(

const std::vector< byte > &

byteVector

)

const [private]

Creates an HEX string from a vector of data bytes. Space between every two digits, ie. byte.

Definition at line 108 of file createhex.cpp.

Referenced by GetMACAddressString().

{
        std::ostringstream oss;
        oss << std::setfill('0') << std::hex;

        // Add all byte last byte with spaces in between.
        for( size_t idx = 0; idx < byteVector.size() - 1; ++idx ) {
                oss << std::setw(2) << byteVector.at( idx ) << ' ';
        }

        // Add last byte.
        if( byteVector.size() > 0 ) {
                oss << std::setw(2) << byteVector.at( byteVector.size()-1 );
        }

        return oss.str();
}

const std::string& ParameterParser::GetFilename

(

)

const [inline]

Definition at line 75 of file createhex.cpp.

References m_filename.

Referenced by CreateHEXFile(), and main().

{ return m_filename; }

const std::vector< byte >& ParameterParser::GetMACAddress

(

)

const [inline]

Definition at line 76 of file createhex.cpp.

References m_MACAddress.

Referenced by CreateHEXFile(), and GetMACAddressString().

{ return m_MACAddress; }

std::string ParameterParser::GetMACAddressString

(

)

const [inline]

Definition at line 78 of file createhex.cpp.

References CreateHexString(), and GetMACAddress().

Referenced by main().

{ return CreateHexString( GetMACAddress() ); }

Here is the call graph for this function:

std::vector< byte > ParameterParser::ParseHexString

(

const std::string &

hexString

)

const [private]

Parses an unformatted HEX number string. Must be pairs of HEX digits, ie. bytes.

Definition at line 83 of file createhex.cpp.

Referenced by ParameterParser().

{
        // String must be even number of hex digits.
        if( hexString.size() % 2 != 0 ) {
                throw std::runtime_error( "Hex string does not have even character count" );
        }

        //
        // Parse hex digit pairs and insert into byte vector.
        // 
        std::vector< byte > bytes;
        for( size_t idx = 0; idx < hexString.size(); idx += 2 ) {
                std::istringstream iss( hexString.substr( idx, 2 ) );
                byte data;
                iss >> std::hex >> data;
                if( !iss ) {
                        throw std::runtime_error( "Error parsing hex string \"" + hexString + "\"" );
                }
                bytes.push_back( data );
        }
        return bytes;
}

---

Field Documentation

std::string ParameterParser::m_filename [private]

Stores filename parameter.

Definition at line 59 of file createhex.cpp.

Referenced by GetFilename(), and ParameterParser().

std::vector< byte > ParameterParser::m_MACAddress [private]

Stores MAC address.

Definition at line 60 of file createhex.cpp.

Referenced by GetMACAddress(), and ParameterParser().