cmnTokenizer.h

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-    */
/* ex: set filetype=cpp softtabstop=4 shiftwidth=4 tabstop=4 cindent expandtab: */
 
/*
 
  Author(s):    Ofri Sadowsky
  Created on:   2003-06-09
 
  (C) Copyright 2003-2007 Johns Hopkins University (JHU), All Rights
  Reserved.
 
--- begin cisst license - do not edit ---
 
This software is provided "as is" under an open source license, with
no warranty.  The complete license can be found in license.txt and
http://www.cisst.org/cisst/license.txt.
 
--- end cisst license ---
 
*/
 

#pragma once
 
#ifndef _cmnTokenizer_h
#define _cmnTokenizer_h
 
 
#include <cisstCommon/cmnPortability.h>
#include <cisstCommon/cmnThrow.h>
 
#include <vector>
 
// Always the last cisst include
#include <cisstCommon/cmnExport.h>

class CISST_EXPORT cmnTokenizer
{
 public:
 
    typedef std::vector<const char *> TokensContainer;
    typedef TokensContainer::size_type size_type;
 
    cmnTokenizer();
 
    ~cmnTokenizer();
 
    inline void SetDelimiters(const char * delimiters)
    {
        Delimiters = delimiters;
    }
 
    inline void SetQuoteMarkers(const char * markers)
    {
        QuoteMarkers = markers;
    }
 
    inline void SetEscapeMarkers(const char * markers)
    {
        EscapeMarkers = markers;
    }
 
    inline const char * GetDelimiters(void) const
    {
        return Delimiters;
    }
 
    inline const char * GetQuoteMarkers(void) const
    {
        return QuoteMarkers;
    }
 
    inline const char * GetEscapeMarkers(void) const
    {
        return EscapeMarkers;
    }
 
    static const char * GetDefaultDelimiters(void)
    {
        return DefaultDelimiters;
    }
 
    static const char * GetDefaultQuoteMarkers(void)
    {
        return DefaultQuoteMarkers;
    }
 
    static const char * GetDefaultEscapeMarkers(void)
    {
        return DefaultEscapeMarkers;
    }

    void Parse(const char * string) CISST_THROW(std::runtime_error);
 
 
    inline void Parse(const std::string & string) CISST_THROW(std::runtime_error) {
        Parse(string.c_str());
    }
 

    size_type GetNumTokens(void) const {
        return Tokens.size();
    }

    const char * GetToken(size_type num) const;

    const char * const * GetTokensArray(void) const;

    void GetArgvTokens(std::vector<const char *> & argvTokens) const;
 
private:
    const char * Delimiters;
    const char * QuoteMarkers;
    const char * EscapeMarkers;
 
    static const char * const DefaultDelimiters;
    static const char * const DefaultQuoteMarkers;
    static const char * const DefaultEscapeMarkers;
 
    std::vector<char> StringBuffer;
    TokensContainer Tokens;
};
 
#endif  // _cmnTokenizer_h