---

string.h

Go to the documentation of this file.

/*
 * Copyright (c) 2001 The AUTHORS 
 *   Romeu Andre' Pieritz, Ph.D.        - romeu_pieritz@hotmail.com
 *   Rafael Mendes, Eng.                – mendes_rafael@yahoo.com
 *   Rodrigo Ferraz de Andrade, Eng.    – rferraz@iname.com 
 * All rights reserved.
 *
 * Permission to use, copy and distribute this software and its
 * documentation for educational and personal use, without fee is hereby granted, 
 * provided that the above copyright notice and the following
 * two paragraphs appear in all copies of this software.
 *
 * IN NO EVENT SHALL THE AUTHORS BE LIABLE TO ANY PARTY FOR
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
 * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE AUTHORS
 * HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * THE AUTHORS SPECIFICALLY DISCLAIMS ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HERE UNDER IS
 * ON AN "AS IS" BASIS, AND THE AUTHORS HAVE NO OBLIGATION TO
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 *
 * SINMEC Lab. - CFD Sinflow Project - http://www.sinmec.ufsc.br/cfd
 */


// File Define
#ifndef __CSFL_SYS_CORE_STRING_H__
#define __CSFL_SYS_CORE_STRING_H__


// Include 
#include <csfl/sys/core/types.h>


// Namespace
namespace csfl { 

        
typedef unsigned short int Dimension;
typedef ptrdiff_t          Subscript;  // Signed, machine-dependent int; from <stddef.h>


class IString 

{
public:
        static const IString empty;

    // Constructors
    IString();                           // Null IString
    IString(const char*);                // From built-in IString
    IString(const char*, Subscript n);   // ... for at most n characters
    IString(char);                       // From single character
    IString(const IString&);             // From another IString

    // Assignment
    IString& operator=(const IString&);  // Assign from IString
    IString& operator=(const char*);     // ... from built-in IString
    IString& operator=(char);            // ... from single character


    // Destructor
    ~IString();

    // Indexing
    char  operator[](Subscript i) const;
    char& operator[](Subscript i);
    char  operator()(Subscript i) const;
    char& operator()(Subscript i);


    // Concatenation
    IString& operator+=(const IString& rhs);
    friend IString operator+(const IString& lhs, const IString& rhs);


    // Comparisons
    friend bool operator==(const IString&, const IString&);
    friend bool operator!=(const IString&, const IString&);
    friend bool operator< (const IString&, const IString&);
    friend bool operator<=(const IString&, const IString&);
    friend bool operator> (const IString&, const IString&);
    friend bool operator>=(const IString&, const IString&);


    // Searches
    const char* find(const IString& s)   const;  // First occurence of s
    const char* find(char c)             const;  // First occurence of c
    const char* findlast(char c)         const;  // Last occurence of c
    const char* brk(const IString& s)    const;  // First occurence of any character in s
    Subscript           span(const IString& s)   const;  // Size of initial span of characters in s
    Subscript           cspan(const IString& s)  const;  // Size of initial span of characters not in s

    // Sub-IStrings
    IString subString(Subscript start             ) const;  // From start 
    IString subString(Subscript start, Subscript n) const;  // ... for n characters


    // Miscellaneous
    Subscript   strlen() const;  // Length of IString (not including null)
    const char* c_str()  const;  // Pointer to underlying built-in IString
    char*       c_str();         // Pointer to underlying built-in IString


    // Conversion into numbers
    double        strtod()  const;    // Conversion to double
    long          strtol()  const;    // Conversion to long
    unsigned long strtoul() const;    // Conversion to unsigned long


    // I/O
    friend ostream& operator<<(ostream& s, const IString& cs);
    friend istream& operator>>(istream& s, IString& cs);


    // Iterators
    class Iterator; // Forward declaration

    class Browser {
    public:
        Browser(const IString& s);


        bool more() const;
        void    advance();
        char    current() const;


        Browser(const Iterator&);
    private:
        const char* cur;
        const char* endp;
    };

    class Iterator {
    public:
        Iterator(IString& s);


        bool more() const;
        void    advance();
        char&   current() const;

    private:
        friend Browser::Browser(const Iterator&);
        char* cur;
        const char* endp;
    };

private:
    char* data; // Pointer to built-in character IString

    IString(const IString&, const IString&);
};

// Inline 

inline const char* IString::c_str() const { 
    return data; 
}
inline char* IString::c_str() {
    return data;
}


inline char IString::operator[](Subscript i) const { return data[i]; }
inline char& IString::operator[](Subscript i) { return data[i]; }
inline char IString::operator()(Subscript i) const { return data[i]; }
inline char& IString::operator()(Subscript i) { return data[i]; }

inline Subscript IString::strlen() const { return ::strlen(data); }


inline IString::Browser::Browser(const IString& s) : cur(s.c_str()), endp(cur + s.strlen()) {}
inline bool IString::Browser::more() const { return cur < endp; }
inline void    IString::Browser::advance()    { ++cur; }
inline char    IString::Browser::current() const { return *cur; }

inline IString::Iterator::Iterator(IString& s) : cur(s.c_str()), endp(cur + s.strlen()) {}
inline bool IString::Iterator::more() const { return cur < endp; }
inline void    IString::Iterator::advance()    { ++cur; }
inline char& IString::Iterator::current() const { return *cur; }

inline IString::Browser::Browser(const IString::Iterator& iter) : cur(iter.cur), endp(iter.endp) {}


} // csfl namespace

#endif// _SFL20_SYS_CORE_STRING_H

 

CFD Project | Documents | Downloads | Contact us | Use Terms
© SINMEC/EMC/UFSC, 2001.	All rights reserved.	Last Update: Jan. 18, 2002	Webmaster