1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
/* 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 <stdint.h>
#include <string>
#include <vector>
struct timeval;
namespace rfb {
// Formats according to printf(), with a dynamic allocation
std::string format(const char *fmt, ...)
__attribute__((__format__ (__printf__, 1, 2)));
// Splits a string with the specified delimiter
std::vector<std::string> split(const char* src,
const char delimiter);
// 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
|
