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) throw(std::runtime_error);


    inline void Parse(const std::string & string) 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