tigervnc/common/rfb/util.h

/* Copyright (C) 2002-2005 RealVNC Ltd.  All Rights Reserved.
 * Copyright 2011-2023 Pierre Ossman for Cendio AB
 * 
 * This 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 software 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 software; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
 * USA.
 */

//
// util.h - miscellaneous useful bits
//

#ifndef __RFB_UTIL_H__
#define __RFB_UTIL_H__

#include <limits.h>
#include <string.h>
#include <stdint.h>

#include <string>
#include <vector>

struct timeval;

namespace rfb {

  // -=- Class to handle cleanup of arrays of characters
  class CharArray {
  public:
    CharArray() : buf(0) {}
    CharArray(char* str) : buf(str) {} // note: assumes ownership
    CharArray(size_t len) {
      buf = new char[len]();
      memset(buf, 0, len);
    }
    ~CharArray() {
      delete [] buf;
    }
    void format(const char *fmt, ...)
      __attribute__((__format__ (__printf__, 2, 3)));
    // Get the buffer pointer & clear it (i.e. caller takes ownership)
    char* takeBuf() {char* tmp = buf; buf = 0; return tmp;}
    void replaceBuf(char* b) {delete [] buf; buf = b;}
    char* buf;
  private:
    CharArray(const CharArray&);
    CharArray& operator=(const CharArray&);
  };

  char* strDup(const char* s);
  void strFree(char* s);

  // Formats according to printf(), with a dynamic allocation
  std::string strFormat(const char *fmt, ...)
      __attribute__((__format__ (__printf__, 1, 2)));

  // Splits a string with the specified delimiter
  std::vector<std::string> strSplit(const char* src,
                                    const char delimiter);

  // Returns true if src contains c
  bool strContains(const char* src, char c);

  // Copies src to dest, up to specified length-1, and guarantees termination
  void strCopy(char* dest, const char* src, int destlen);

  // Conversion to and from a hex string

  void binToHex(const uint8_t* in, size_t inlen, char* out, size_t outlen);
  std::string binToHex(const uint8_t* in, size_t inlen);
  bool hexToBin(const char* in, size_t inlen, uint8_t* out, size_t outlen);
  std::vector<uint8_t> hexToBin(const char* in, size_t inlen);

  // Makes sure line endings are in a certain format

  std::string convertLF(const char* src, size_t bytes = (size_t)-1);
  std::string convertCRLF(const char* src, size_t bytes = (size_t)-1);

  // Convertions between various Unicode formats

  size_t ucs4ToUTF8(unsigned src, char dst[5]);
  size_t utf8ToUCS4(const char* src, size_t max, unsigned* dst);

  size_t ucs4ToUTF16(unsigned src, wchar_t dst[3]);
  size_t utf16ToUCS4(const wchar_t* src, size_t max, unsigned* dst);

  std::string latin1ToUTF8(const char* src, size_t bytes = (size_t)-1);
  std::string utf8ToLatin1(const char* src, size_t bytes = (size_t)-1);

  std::string utf16ToUTF8(const wchar_t* src, size_t units = (size_t)-1);
  std::wstring utf8ToUTF16(const char* src, size_t bytes = (size_t)-1);

  // HELPER functions for timeout handling

  // soonestTimeout() is a function to help work out the soonest of several
  //   timeouts.
  inline void soonestTimeout(int* timeout, int newTimeout) {
    if (newTimeout && (!*timeout || newTimeout < *timeout))
      *timeout = newTimeout;
  }

  // secsToMillis() turns seconds into milliseconds, capping the value so it
  //   can't wrap round and become -ve
  inline int secsToMillis(int secs) {
    return (secs < 0 || secs > (INT_MAX/1000) ? INT_MAX : secs * 1000);
  }

  // Returns time elapsed between two moments in milliseconds.
  unsigned msBetween(const struct timeval *first,
                     const struct timeval *second);

  // Returns time elapsed since given moment in milliseconds.
  unsigned msSince(const struct timeval *then);

  // Returns true if first happened before seconds
  bool isBefore(const struct timeval *first,
                const struct timeval *second);

  std::string siPrefix(long long value, const char *unit,
                       int precision=6);
  std::string iecPrefix(long long value, const char *unit,
                        int precision=6);
}

// Some platforms (e.g. Windows) include max() and min() macros in their
// standard headers, but they are also standard C++ template functions, so some
// C++ headers will undefine them.  So we steer clear of the names min and max
// and define __rfbmin and __rfbmax instead.

#ifndef __rfbmax
#define __rfbmax(a,b) (((a) > (b)) ? (a) : (b))
#endif
#ifndef __rfbmin
#define __rfbmin(a,b) (((a) < (b)) ? (a) : (b))
#endif

#endif