/************************************************************************* * * $RCSfile: simstr.hxx,v $ * * $Revision: 1.1 $ * * last change: $Author: np $ $Date: 2001-06-11 16:05:17 $ * * The Contents of this file are made available subject to the terms of * either of the following licenses * * - GNU Lesser General Public License Version 2.1 * - Sun Industry Standards Source License Version 1.1 * * Sun Microsystems Inc., October, 2000 * * GNU Lesser General Public License Version 2.1 * ============================================= * Copyright 2000 by Sun Microsystems, Inc. * 901 San Antonio Road, Palo Alto, CA 94303, USA * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License version 2.1, as published by the Free Software Foundation. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * * * Sun Industry Standards Source License Version 1.1 * ================================================= * The contents of this file are subject to the Sun Industry Standards * Source License Version 1.1 (the "License"); You may not use this file * except in compliance with the License. You may obtain a copy of the * License at http://www.openoffice.org/license.html. * * Software provided under this License is provided on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, * WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, * MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. * See the License for the specific provisions governing your rights and * obligations concerning the Software. * * The Initial Developer of the Original Code is: Sun Microsystems, Inc. * * Copyright: 2000 by Sun Microsystems, Inc. * * All Rights Reserved. * * Contributor(s): _______________________________________ * * ************************************************************************/ #ifndef SOLTOOLS_SIMSTR_HXX #define SOLTOOLS_SIMSTR_HXX class Simstr /// Simple string class. { // INTERFACE public: // LIFECYCLE Simstr( const char * str = 0); Simstr( /** Creates Simstr out of a copy of the first 'nrOfBytes' bytes of 'anyBytes'. Adds a '\0' at the end. */ const char * anybytes, int nrOfBytes); Simstr( /** Creates Simstr out of a copy of the described bytes within 'anyBytes'. Adds a '\0' at the end. */ const char * anybytes, int firstBytesPos, int nrOfBytes ); Simstr( /// Creates Simstr of 'anzahl' times 'c'. char c, int anzahl); Simstr( const Simstr & S); ~Simstr(); // OPERATORS operator const char*() const; Simstr & operator=( const Simstr & S ); Simstr operator+( const Simstr & S ) const; Simstr & operator+=( const Simstr & S ); Simstr & operator+=( const char * s ); bool operator==( const Simstr & S ) const; bool operator!=( const Simstr & S ) const; bool operator<( const Simstr & S ) const; bool operator>( const Simstr & S ) const; bool operator<=( const Simstr & S ) const; bool operator>=( const Simstr & S ) const; // INFO static const Simstr & null_(); const char * str() const; int l() const; // Length of string without '\0' at end. char * s(); // ATTENTION !!! // Only to be used, when a function needs a 'char*' but // nevertheless THAT WILL BE NOT CHANGED! // Typecasts to 'const char*' are performed automatically. char get( int n) const; char get_front() const; char get_back() const; Simstr get( int startPos, int anzahl ) const; Simstr get_front( int anzahl ) const; Simstr get_back( int anzahl ) const; int pos_first( char c ) const; int pos_first_after( char c, int startSearchPos ) const; int pos_last( char c ) const; int pos_first( const Simstr & S ) const; int pos_last( const Simstr & S ) const; int count( char c ) const; bool is_empty() const; // Only true if object == "". bool is_no_text() const; // String may contain spaces or tabs. Simstr get_first_token( char c ) const; Simstr get_last_token( char c ) const; // ACCESS char & ch( /** Reference to sz[n]. Allows change of this char. !!! No safety, if n is out of the allowed range! */ int n ); // OPERATIONS void insert( int pos, char c ); void push_front( char c ); void push_back( char c ); void insert( int pos, const Simstr & S ); void push_front( const Simstr & S ); void push_back( const Simstr & S ); void remove( int pos, int anzahl = 1 ); void remove_trailing_blanks(); void pop_front( int anzahl = 1 ); void pop_back( int anzahl = 1 ); void rem_back_from( int removeStartPos ); void remove_all( char c ); void remove_all( // Starts search left. const Simstr & S ); void strip( char c ); // Removes all characters == c from front and back. // c == ' ' removes also TABs !!! void empty(); // Changes object to the value "". void replace( int pos, char c ); void replace( int startPos, int anzahl, const Simstr & S ); void replace_all( char oldCh, char newCh ); void replace_all( const Simstr & oldS, const Simstr & newS ); void to_lower(); Simstr take_first_token( /// Token is removed from the Simstr. char c ); Simstr take_last_token( /// Token is removed from the Simstr. char c ); private: // DATA char * sz; int len; }; // Simstr - char* / char - concatenations Simstr operator+(const char * str, const Simstr & S); Simstr operator+(const Simstr & S, const char * str); Simstr operator+(char c, const Simstr & S); Simstr operator+(const Simstr & S, char c); // Simstr - char* - comparison operators bool operator==(const Simstr & S, const char * str); bool operator!=(const Simstr & S, const char * str); bool operator<(const Simstr & S, const char * str); bool operator>(const Simstr & S, const char * str); bool operator<=(const Simstr & S, const char * str); bool operator>=(const Simstr & S, const char * str); bool operator==(const char * str, const Simstr & S); bool operator!=(const char * str, const Simstr & S); bool operator<(const char * str, const Simstr & S); bool operator>(const char * str, const Simstr & S); bool operator<=(const char * str, const Simstr & S); bool operator>=(const char * str, const Simstr & S); inline const char * Simstr::str() const { return sz; } inline char * Simstr::s() { return sz; } inline int Simstr::l() const { return len; } inline Simstr::operator const char*() const { return sz; } inline bool Simstr::is_empty() const { return len == 0; } #endif