Public API Reference

csutil/util.h

Go to the documentation of this file.

/*
    Copyright (C) 1998 by Jorrit Tyberghein

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_UTIL_H__
#define __CS_UTIL_H__

#include <stdio.h>
#include "csextern.h"
#include "csutil/csunicode.h"

CS_CRYSTALSPACE_EXPORT char *csStrNew (const char *s);
CS_CRYSTALSPACE_EXPORT char *csStrNew (const wchar_t *s);
CS_CRYSTALSPACE_EXPORT wchar_t* csStrNewW (const wchar_t *s);
CS_CRYSTALSPACE_EXPORT wchar_t* csStrNewW (const char *s);

CS_CRYSTALSPACE_EXPORT int csStrCaseCmp(char const* str1, char const* str2);

CS_CRYSTALSPACE_EXPORT int csStrNCaseCmp(char const* str1, char const* str2,
  size_t n);

struct csWtoC
{
private:
  char* s;
public:
  csWtoC (const wchar_t* ws)
  { s = csStrNew (ws); }
  ~csWtoC ()
  { delete[] s; }
  operator const char* () const
  { return s; }
};

struct csCtoW
{
private:
  wchar_t* ws;
public:
  csCtoW (const char* s)
  { ws = csStrNewW (s); }
  ~csCtoW ()
  { delete[] ws; }
  operator const wchar_t* () const
  { return ws; }
};

CS_CRYSTALSPACE_EXPORT char *csExpandName (const char *iName);

CS_CRYSTALSPACE_EXPORT void csSplitPath (const char *iPathName, char *oPath,
  size_t iPathSize, char *oName, size_t iNameSize);

CS_CRYSTALSPACE_EXPORT bool csGlobMatches (const char *fName,
        const char *fMask);

CS_CRYSTALSPACE_EXPORT int csFindNearestPowerOf2 (int n);

CS_CRYSTALSPACE_EXPORT bool csIsPowerOf2 (int n);

static inline int csLog2 (int n)
{
  const unsigned int b[] = {0x2, 0xC, 0xF0, 0xFF00, 0xFFFF0000};
  const unsigned int S[] = {1, 2, 4, 8, 16};
  int i;

  register unsigned int c = 0; // result of log2(v) will go here
  for (i = 4; i >= 0; i--) // unroll for speed...
  {
    if (n & b[i])
    {
      n >>= S[i];
      c |= S[i];
    } 
  }
  return c;
}

CS_CRYSTALSPACE_EXPORT void csReplaceAll (char *dest, const char *src,
  const char *search, const char *replace, int max);

CS_DEPRECATED_METHOD_MSG("Use csReplaceAll() instead.")
inline void csFindReplace (char *dest, const char *src,
  const char *search, const char *replace, int max)
{ csReplaceAll(dest, src, search, replace, max); }

#endif // __CS_UTIL_H__

---