MCGIDI::String Class Reference

#include <MCGIDI_string.hpp>

Public Types
typedef size_t	size_type

Public Member Functions
LUPI_HOST_DEVICE	String ()
LUPI_HOST_DEVICE	~String ()
LUPI_HOST_DEVICE	String (const String &)
LUPI_HOST_DEVICE	String (const char *)
LUPI_HOST_DEVICE String &	operator= (const char *)
LUPI_HOST_DEVICE String &	operator= (const String &)
LUPI_HOST_DEVICE String &	operator+= (const String &)
LUPI_HOST_DEVICE String &	operator+= (const char *)
LUPI_HOST_DEVICE String &	operator+= (char)
LUPI_HOST_DEVICE void	push_back (char)
LUPI_HOST_DEVICE bool	operator== (const char *) const
LUPI_HOST_DEVICE bool	operator== (const String &) const
LUPI_HOST_DEVICE void	clear ()
LUPI_HOST_DEVICE void	clearMemory ()
LUPI_HOST_DEVICE size_type	size () const
	size without terminating NUL
LUPI_HOST_DEVICE size_type	length () const
	as size()
LUPI_HOST_DEVICE size_type	capacity () const
LUPI_HOST_DEVICE size_t	internalSize () const
LUPI_HOST_DEVICE bool	empty () const
LUPI_HOST_DEVICE const char *	c_str () const
	raw data
LUPI_HOST_DEVICE void	reserve (size_type n, char **address=nullptr)
LUPI_HOST_DEVICE void	resize (size_type n, char **address=nullptr)
LUPI_HOST_DEVICE void	resize (size_type n, char c, char **address=nullptr)
LUPI_HOST_DEVICE void	swap (String &)
	swap contents
LUPI_HOST_DEVICE String	substr (const size_type pos, size_type length) const
LUPI_HOST_DEVICE char &	operator[] (const size_type i)
LUPI_HOST_DEVICE char	operator[] (const size_type i) const
LUPI_HOST_DEVICE char &	at (const size_type i)
LUPI_HOST_DEVICE char	at (const size_type i) const
LUPI_HOST_DEVICE String &	erase (size_type pos, size_type len)
	erase len characters at position pos
LUPI_HOST_DEVICE String &	append (const char *str, size_type n)
	Append n characters of a string.
LUPI_HOST_DEVICE int	compare (size_type pos, size_type len, const String &str) const
LUPI_HOST_DEVICE int	compare (size_type pos, size_type len, const char *str) const

Static Public Attributes
static const size_type	npos = static_cast<size_t>(-1)

Friends
String LUPI_HOST_DEVICE	operator+ (const String &lhs, const String &rhs)

Detailed Description

Definition at line 72 of file MCGIDI_string.hpp.

Member Typedef Documentation

size_type

typedef size_t MCGIDI::String::size_type

Definition at line 80 of file MCGIDI_string.hpp.

Constructor & Destructor Documentation

String() [1/3]

LUPI_HOST_DEVICE MCGIDI::String::String

(

)

Definition at line 69 of file MCGIDI_string.cc.

: p( nullptr ), allocated_(0), size_(0) { }

Referenced by append(), clearMemory(), compare(), erase(), operator+, operator+=(), operator+=(), operator+=(), operator=(), operator=(), operator==(), String(), substr(), and swap().

~String()

LUPI_HOST_DEVICE MCGIDI::String::~String

(

)

Definition at line 71 of file MCGIDI_string.cc.

  {
      free(p);
  }

String() [2/3]

LUPI_HOST_DEVICE MCGIDI::String::String

(

const String &

s

)

Definition at line 76 of file MCGIDI_string.cc.

    : p(nullptr)
  {
    p = malloc_never_null( s.size_ + 1 );  // copy only used part
    allocated_ = s.size_ + 1;
    size_      = s.size_;
    memcpy(p, s.p, size_ + 1);
  }

String() [3/3]

LUPI_HOST_DEVICE MCGIDI::String::String

(

const char *

s

)

Definition at line 85 of file MCGIDI_string.cc.

  : p(strdup_never_null(s))
  {
  }

Member Function Documentation

append()

LUPI_HOST_DEVICE String & MCGIDI::String::append	(	const char *	str,
		size_type	n )

Append n characters of a string.

Definition at line 251 of file MCGIDI_string.cc.

                                                                       {
    if (str && n > 0) {
      size_t lens = MCGIDI_strlen(str);
      if (n > lens)
        n = lens;
      size_t newlen = size_ + n;
      this->reserve( newlen );
      MCGIDI_memmove(p+size_, str, n); // p and s.p MAY overlap
      p[newlen] = 0; // add NUL termination
      size_ = newlen;
    }
    return *this;
  }

at() [1/2]

LUPI_HOST_DEVICE char & MCGIDI::String::at

(

const size_type

i

)

Definition at line 212 of file MCGIDI_string.cc.

  {
      if ( i > MCGIDI_strlen(p) )
        LUPI_THROW( "MCGIDI::String::at(): index out_of_range");
 
      return p[i];
  }

at() [2/2]

LUPI_HOST_DEVICE char MCGIDI::String::at

(

const size_type

i

)

const

Definition at line 219 of file MCGIDI_string.cc.

  {
      if ( i > MCGIDI_strlen(p) )
        LUPI_THROW("MCGIDI::String::at(): index out_of_range");
 
      return p[i];
  }

c_str()

LUPI_HOST_DEVICE const char * MCGIDI::String::c_str ( ) const

inline

raw data

Definition at line 121 of file MCGIDI_string.hpp.

Referenced by MCGIDI::Functions::Function1d_d1::evaluate(), MCGIDI::Functions::Function1d_d2::evaluate(), MCGIDI::operator<(), MCGIDI::serializeFunction1d(), MCGIDI::serializeFunction1d_d1(), and MCGIDI::serializeFunction1d_d2().

capacity()

LUPI_HOST_DEVICE size_type MCGIDI::String::capacity ( ) const

inline

Definition at line 109 of file MCGIDI_string.hpp.

{ return allocated_-1; }

clear()

LUPI_HOST_DEVICE void MCGIDI::String::clear

(

)

Definition at line 177 of file MCGIDI_string.cc.

  {
      size_ = 0;
      p[0]  = 0;
  }

clearMemory()

LUPI_HOST_DEVICE void MCGIDI::String::clearMemory

(

)

Definition at line 171 of file MCGIDI_string.cc.

  {
    String s;
    this->swap( s );
  }

compare() [1/2]

LUPI_HOST_DEVICE int MCGIDI::String::compare	(	size_type	pos,
		size_type	len,
		const char *	str ) const

Definition at line 280 of file MCGIDI_string.cc.

                                                                                            {
    if (pos > size_)
      LUPI_THROW("MCGIDI::String::compare: pos index out of range");
 
    if ( len > size_ - pos)
      len = size_ - pos; // limit len to available length
 
    const size_type osize = MCGIDI_strlen(str);
    const size_type len2   = MCGIDI_MIN(len, osize);
    int r = MCGIDI_strncmp( p + pos, str, len2);
    if (r==0) // equal so far, now compare sizes
        r = len < osize ? -1 : ( len == osize ? 0 : +1 );
    return r;
  }

compare() [2/2]

LUPI_HOST_DEVICE int MCGIDI::String::compare	(	size_type	pos,
		size_type	len,
		const String &	str ) const

Definition at line 265 of file MCGIDI_string.cc.

                                                                                              {
    if (pos > size_)
      LUPI_THROW("MCGIDI::String::compare: pos index out of range");
 
    if ( len > size_ - pos)
      len = size_ - pos; // limit len to available length
 
    const size_type osize = str.size();
    const size_type len2   = MCGIDI_MIN(len, osize);
    int r = MCGIDI_strncmp( p + pos, str.p, len2);
    if (r==0) // equal so far, now compare sizes
    r = len < osize ? -1 : ( len == osize ? 0 : +1 );
    return r;
  }

empty()

LUPI_HOST_DEVICE bool MCGIDI::String::empty ( ) const

inline

Definition at line 119 of file MCGIDI_string.hpp.

{ return size_ == 0; }

erase()

LUPI_HOST_DEVICE String & MCGIDI::String::erase	(	size_type	pos,
		size_type	len )

erase len characters at position pos

Definition at line 227 of file MCGIDI_string.cc.

  {
    if (len > 0) {
 
      if ( pos >= size_ ) // user must not remove trailing 0
        LUPI_THROW("MCGIDI::String::erase: pos index out_of_range");
 
      long s2 = (long) size_;
      long remain = s2 - (long) ( pos - len );
 
      if (remain > 0) {
        // erase by overwriting
        MCGIDI_memmove(p + pos, p + pos + len, (size_t) remain);
      }
 
      if ( remain < 0 ) remain = 0;
 
      // remove unused space
      this->resize( pos + (size_t) remain );
 
    }
    return *this;
  }

internalSize()

LUPI_HOST_DEVICE size_t MCGIDI::String::internalSize ( ) const

inline

Definition at line 112 of file MCGIDI_string.hpp.

                                                 {
        size_t delta = allocated_;
        size_t sub = delta % 8;
        if (sub != 0) delta += (8-sub);
        return delta * sizeof(char);
    }

length()

LUPI_HOST_DEVICE size_type MCGIDI::String::length ( ) const

inline

as size()

Definition at line 106 of file MCGIDI_string.hpp.

operator+=() [1/3]

LUPI_HOST_DEVICE String & MCGIDI::String::operator+=

(

char

c

)

Definition at line 141 of file MCGIDI_string.cc.

  {
      push_back(c);
      return *this;
  }

operator+=() [2/3]

LUPI_HOST_DEVICE String & MCGIDI::String::operator+=

(

const char *

s

)

Definition at line 122 of file MCGIDI_string.cc.

  {
      const size_type lens = MCGIDI_strlen(s);
      if (lens > 0){
        if (size_ + lens + 1 <= allocated_) {
          MCGIDI_memmove(p+size_, s, lens+1); // trailing 0
          size_ += lens;
        }
        else {
          String s2( *this );  // copy own data
          s2.reserve(size_ + lens);
          MCGIDI_memmove(s2.p+size_, s, lens+1); // trailing 0
          s2.size_ = size_ + lens;
          this->swap( s2 );
        }
      }
      return *this;
  }

operator+=() [3/3]

LUPI_HOST_DEVICE String & MCGIDI::String::operator+=

(

const String &

s

)

Definition at line 111 of file MCGIDI_string.cc.

  {
    if (s.size_ > 0){
      this->reserve(size_ + s.size_);
      MCGIDI_memmove(p+size_, s.p, s.size_+1); // trailing 0
      size_ += s.size_;
    }
    return *this;
  }

operator=() [1/2]

LUPI_HOST_DEVICE String & MCGIDI::String::operator=

(

const char *

s

)

Definition at line 90 of file MCGIDI_string.cc.

  {
      if ( p != s ) {
        // s could point into our own string, so we have to allocate a new string
        const size_t len = MCGIDI_strlen(s);
        char* copy = (char*) malloc( len + 1);
        MCGIDI_memmove(copy, s, len+1); // trailing 0
        free( p );
        p = copy;
        size_ = len;
        allocated_ = len+1;
      }
 
      return *this;
  }

Referenced by operator=().

operator=() [2/2]

LUPI_HOST_DEVICE String & MCGIDI::String::operator=

(

const String &

s

)

Definition at line 106 of file MCGIDI_string.cc.

  {
      return operator=(s.p);
  }

operator==() [1/2]

LUPI_HOST_DEVICE bool MCGIDI::String::operator==

(

const char *

s

)

const

Definition at line 161 of file MCGIDI_string.cc.

  {
      return !MCGIDI_strcmp(p, s);
  }

operator==() [2/2]

LUPI_HOST_DEVICE bool MCGIDI::String::operator==

(

const String &

s

)

const

Definition at line 166 of file MCGIDI_string.cc.

  {
      return !MCGIDI_strcmp(p, s.p);
  }

operator[]() [1/2]

LUPI_HOST_DEVICE char & MCGIDI::String::operator[] ( const size_type i )

inline

Definition at line 148 of file MCGIDI_string.hpp.

{ return p[i]; }

operator[]() [2/2]

LUPI_HOST_DEVICE char MCGIDI::String::operator[] ( const size_type i ) const

inline

Definition at line 149 of file MCGIDI_string.hpp.

{ return p[i]; }

push_back()

LUPI_HOST_DEVICE void MCGIDI::String::push_back

(

char

c

)

Definition at line 148 of file MCGIDI_string.cc.

                                                      {
 
    if (size_ == allocated_ - 1) {
      size_t more =  (allocated_* 3) / 2; // factor 1.5
      if ( more < 4 ) more = 4;
      reserve( size_ + more );
    }
 
    p[size_] = c;
    size_++;
    p[size_] = 0;
  }

Referenced by operator+=().

reserve()

LUPI_HOST_DEVICE void MCGIDI::String::reserve	(	size_type	n,
		char **	address = nullptr )

Reserve internal string memory so that n characters can be put into the string (plus 1 for the NUL char). If there is already enough memory, nothing happens, if not, the memory will be realloated to exactly this amount.

Definition at line 317 of file MCGIDI_string.cc.

                                                                           {
    if (n >= allocated_ ) {
      this->my_realloc(n + 1, address);
      allocated_ = n + 1;
    }
  }

Referenced by append(), operator+=(), operator+=(), push_back(), and resize().

resize() [1/2]

LUPI_HOST_DEVICE void MCGIDI::String::resize	(	size_type	n,
		char **	address = nullptr )

Resize string. If n is less than the current size, the string will be truncated. If n is larger, then the memory will be reallocated to exactly this amount, and the additional characters will be NUL characters.

Definition at line 324 of file MCGIDI_string.cc.

                                                                          {
    this->resize( n, 0, address );
  }

Referenced by erase(), and resize().

resize() [2/2]

LUPI_HOST_DEVICE void MCGIDI::String::resize	(	size_type	n,
		char	c,
		char **	address = nullptr )

Resize string. If n is less than the current size, the string will be truncated. If n is larger, then the memory will be reallocated to exactly this amount, and the additional characters will be c characters.

Definition at line 328 of file MCGIDI_string.cc.

                                                                                        {
    if (n < allocated_ ) {
      p[n] = 0;
      size_ = n;
    }
    else if (n >= allocated_ ) {
      this->reserve( n, address );
      for (size_type i=size_; i < n; ++i )
        p[i] = c;
      p[n] = 0;
      size_ = n;
    }
  }

size()

LUPI_HOST_DEVICE size_type MCGIDI::String::size ( ) const

inline

size without terminating NUL

Definition at line 105 of file MCGIDI_string.hpp.

Referenced by compare().

substr()

LUPI_HOST_DEVICE String MCGIDI::String::substr	(	const size_type	pos,
		size_type	length ) const

Definition at line 188 of file MCGIDI_string.cc.

  {
      String s;
      const size_type len = size_;
 
      if ( pos > len )
        LUPI_THROW("MCGIDI::String::substr: pos index out of range");
 
      size_type remain = len - pos;
 
      if ( in_length > remain )
          in_length = remain;
 
      s.reserve( in_length );
 
      memcpy(s.p, p + pos, in_length);
      s.p[in_length] = '\0';
      s.size_ = in_length;
 
      return s;
  }

swap()

LUPI_HOST_DEVICE void MCGIDI::String::swap

(

String &

s

)

swap contents

Definition at line 342 of file MCGIDI_string.cc.

                                                {
    MCGIDI_SWAP( allocated_, s.allocated_, size_t );
    MCGIDI_SWAP( size_,      s.size_,      size_t );
    MCGIDI_SWAP( p,          s.p,          char * );
  }

Referenced by clearMemory(), and operator+=().

Friends And Related Symbol Documentation

operator+

String LUPI_HOST_DEVICE operator+ ( const String & lhs, const String & rhs )

friend

Definition at line 183 of file MCGIDI_string.cc.

  {
      return String(lhs) += rhs;
  }

Member Data Documentation

npos

const String::size_type MCGIDI::String::npos = static_cast<size_t>(-1)

static

Definition at line 81 of file MCGIDI_string.hpp.

---

The documentation for this class was generated from the following files:

• MCGIDI_string.hpp
• MCGIDI_string.cc