---

more/gen/string.h

Go to the documentation of this file.

//  more/gen/string.h -- Additional string functions
//  Copyright (C) 2001--2002  Petter Urkedal
//
//  This file is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation; either version 2 of the License, or
//  (at your option) any later version.
//
//  This file 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 General Public License for more details.
//
//  You should have received a copy of the GNU General Public License
//  along with this program; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
//  As a special exception, you may use this file as part of a free
//  software library without restriction.  Specifically, if other files
//  instantiate templates or use macros or inline functions from this
//  file, or you compile this file and link it with other files to
//  produce an executable, this file does not by itself cause the
//  resulting executable to be covered by the GNU General Public
//  License.  This exception does not however invalidate any other
//  reasons why the executable file might be covered by the GNU General
//  Public License.
//
//  $Id: string.h,v 1.2 2002/08/24 13:56:26 petter_urkedal Exp $

#ifndef MORE_GEN_STRING_H
#define MORE_GEN_STRING_H

#include <more/bits/config.h>
#include <cstring>

namespace more {
namespace gen {

  /** Returns a unique pointer for all lexically equal strings.  The
      string argument must have static lifetime. */
  char const* struniq_static(char const*);

  /** Returns a unique pointer for all lexically equal strings. */
  char const* struniq_copy(char const*);

  /** Returns a unique pointer for all lexically equal strings.  The
      string argument must have static lifetime. */
  wchar_t const* struniq_static(wchar_t const*);

  /** Returns a unique pointer for all lexically equal strings. */
  wchar_t const* struniq_copy(wchar_t const*);

  /** Returns a unique string pointer for each argument.  The string
      is a valid C identifier.  The global time and space complexty
      scales lineary with the maximum absolute value of the argument,
      in addition to amortized constant time and zero space for each
      call.  */
  char const* struniq_dense(int);

  /** Returns a unique string pointer for each argument.  The string
      is a valid C identifier.  The time complexity is logarithmic in
      the number of distinct uniqstr_* pointers returned. */
  char const* struniq_sparse(int);

  /** Returns a copy of str allocated by new. */
  inline char*
  strcpy_new(char const* str)
  {
      char* s = new char[strlen(str) + 1];
      std::strcpy(s, str);
      return s;
  }

#ifdef HAVE_BDWGC
  /** A version of wcstombs which stores its result in garbage
   ** collected memory. */
  char* wcstombs_gc(wchar_t const* ws);

  /** A version of mbstowcs which stores its result in collected
   ** memory. */
  wchar_t* mbstowcs_gc(char const* str);
#endif

}}

#endif

---