tcpflow  1.6.1
About: tcpflow is a TCP/IP packet demultiplexer that captures data transmitted as part of TCP connections (flows), and stores the data in a way that is convenient for protocol analysis and debugging.
  Fossies Dox: tcpflow-1.6.1.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

checked.h
Go to the documentation of this file.
1 // Copyright 2006 Nemanja Trifunovic
2 
3 /*
4 Permission is hereby granted, free of charge, to any person or organization
5 obtaining a copy of the software and accompanying documentation covered by
6 this license (the "Software") to use, reproduce, display, distribute,
7 execute, and transmit the Software, and to prepare derivative works of the
8 Software, and to permit third-parties to whom the Software is furnished to
9 do so, all subject to the following:
10 
11 The copyright notices in the Software and this entire statement, including
12 the above license grant, this restriction and the following disclaimer,
13 must be included in all copies of the Software, in whole or in part, and
14 all derivative works of the Software, unless such copies or derivative
15 works are solely in the form of machine-executable object code generated by
16 a source language processor.
17 
18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
21 SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
22 FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
23 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24 DEALINGS IN THE SOFTWARE.
25 */
26 
27 
28 #ifndef UTF8_FOR_CPP_CHECKED_H_2675DCD0_9480_4c0c_B92A_CC14C027B731
29 #define UTF8_FOR_CPP_CHECKED_H_2675DCD0_9480_4c0c_B92A_CC14C027B731
30 
31 #include "core.h"
32 #include <stdexcept>
33 
34 namespace utf8
35 {
36  // Base for the exceptions that may be thrown from the library
37  class exception : public std::exception {
38  };
39 
40  // Exceptions that may be thrown from the library functions.
41  class invalid_code_point : public exception {
43  public:
45  virtual const char* what() const throw() { return "Invalid code point"; }
46  uint32_t code_point() const {return cp;}
47  };
48 
49  class invalid_utf8 : public exception {
51  public:
52  invalid_utf8 (uint8_t u) : u8(u) {}
53  virtual const char* what() const throw() { return "Invalid UTF-8"; }
54  uint8_t utf8_octet() const {return u8;}
55  };
56 
57  class invalid_utf16 : public exception {
59  public:
61  virtual const char* what() const throw() { return "Invalid UTF-16"; }
62  uint16_t utf16_word() const {return u16;}
63  };
64 
65  class not_enough_room : public exception {
66  public:
67  virtual const char* what() const throw() { return "Not enough space"; }
68  };
69 
70  /// The library API - functions intended to be called by the users
71 
72  template <typename octet_iterator, typename output_iterator>
73  output_iterator replace_invalid(octet_iterator start, octet_iterator end, output_iterator out, uint32_t replacement)
74  {
75  while (start != end) {
76  octet_iterator sequence_start = start;
77  internal::utf_error err_code = internal::validate_next(start, end);
78  switch (err_code) {
79  case internal::UTF8_OK :
80  for (octet_iterator it = sequence_start; it != start; ++it)
81  *out++ = *it;
82  break;
84  throw not_enough_room();
86  append (replacement, out);
87  ++start;
88  break;
92  append (replacement, out);
93  ++start;
94  // just one replacement mark for the sequence
95  while (internal::is_trail(*start) && start != end)
96  ++start;
97  break;
98  }
99  }
100  return out;
101  }
102 
103  template <typename octet_iterator, typename output_iterator>
104  inline output_iterator replace_invalid(octet_iterator start, octet_iterator end, output_iterator out)
105  {
106  static const uint32_t replacement_marker = internal::mask16(0xfffd);
107  return replace_invalid(start, end, out, replacement_marker);
108  }
109 
110  template <typename octet_iterator>
111  octet_iterator append(uint32_t cp, octet_iterator result)
112  {
114  throw invalid_code_point(cp);
115 
116  if (cp < 0x80) // one octet
117  *(result++) = static_cast<uint8_t>(cp);
118  else if (cp < 0x800) { // two octets
119  *(result++) = static_cast<uint8_t>((cp >> 6) | 0xc0);
120  *(result++) = static_cast<uint8_t>((cp & 0x3f) | 0x80);
121  }
122  else if (cp < 0x10000) { // three octets
123  *(result++) = static_cast<uint8_t>((cp >> 12) | 0xe0);
124  *(result++) = static_cast<uint8_t>(((cp >> 6) & 0x3f) | 0x80);
125  *(result++) = static_cast<uint8_t>((cp & 0x3f) | 0x80);
126  }
127  else { // four octets
128  *(result++) = static_cast<uint8_t>((cp >> 18) | 0xf0);
129  *(result++) = static_cast<uint8_t>(((cp >> 12) & 0x3f) | 0x80);
130  *(result++) = static_cast<uint8_t>(((cp >> 6) & 0x3f) | 0x80);
131  *(result++) = static_cast<uint8_t>((cp & 0x3f) | 0x80);
132  }
133  return result;
134  }
135 
136  template <typename octet_iterator>
137  uint32_t next(octet_iterator& it, octet_iterator end)
138  {
139  uint32_t cp = 0;
140  internal::utf_error err_code = internal::validate_next(it, end, &cp);
141  switch (err_code) {
142  case internal::UTF8_OK :
143  break;
145  throw not_enough_room();
149  throw invalid_utf8(*it);
151  throw invalid_code_point(cp);
152  }
153  return cp;
154  }
155 
156  template <typename octet_iterator>
157  uint32_t peek_next(octet_iterator it, octet_iterator end)
158  {
159  return next(it, end);
160  }
161 
162  template <typename octet_iterator>
163  uint32_t prior(octet_iterator& it, octet_iterator start)
164  {
165  // can't do much if it == start
166  if (it == start)
167  throw not_enough_room();
168 
169  octet_iterator end = it;
170  // Go back until we hit either a lead octet or start
171  while (internal::is_trail(*(--it)))
172  if (it == start)
173  throw invalid_utf8(*it); // error - no lead byte in the sequence
174  return peek_next(it, end);
175  }
176 
177  /// Deprecated in versions that include "prior"
178  template <typename octet_iterator>
179  uint32_t previous(octet_iterator& it, octet_iterator pass_start)
180  {
181  octet_iterator end = it;
182  while (internal::is_trail(*(--it)))
183  if (it == pass_start)
184  throw invalid_utf8(*it); // error - no lead byte in the sequence
185  octet_iterator temp = it;
186  return next(temp, end);
187  }
188 
189  template <typename octet_iterator, typename distance_type>
190  void advance (octet_iterator& it, distance_type n, octet_iterator end)
191  {
192  for (distance_type i = 0; i < n; ++i)
193  next(it, end);
194  }
195 
196  template <typename octet_iterator>
197  typename std::iterator_traits<octet_iterator>::difference_type
198  distance (octet_iterator first, octet_iterator last)
199  {
200  typename std::iterator_traits<octet_iterator>::difference_type dist;
201  for (dist = 0; first < last; ++dist)
202  next(first, last);
203  return dist;
204  }
205 
206  template <typename u16bit_iterator, typename octet_iterator>
207  octet_iterator utf16to8 (u16bit_iterator start, u16bit_iterator end, octet_iterator result)
208  {
209  while (start != end) {
210  uint32_t cp = internal::mask16(*start++);
211  // Take care of surrogate pairs first
212  if (internal::is_lead_surrogate(cp)) {
213  if (start != end) {
214  uint32_t trail_surrogate = internal::mask16(*start++);
215  if (internal::is_trail_surrogate(trail_surrogate))
216  cp = (cp << 10) + trail_surrogate + internal::SURROGATE_OFFSET;
217  else
218  throw invalid_utf16(static_cast<uint16_t>(trail_surrogate));
219  }
220  else
221  throw invalid_utf16(static_cast<uint16_t>(cp));
222 
223  }
224  // Lone trail surrogate
225  else if (internal::is_trail_surrogate(cp))
226  throw invalid_utf16(static_cast<uint16_t>(cp));
227 
228  result = append(cp, result);
229  }
230  return result;
231  }
232 
233  template <typename u16bit_iterator, typename octet_iterator>
234  u16bit_iterator utf8to16 (octet_iterator start, octet_iterator end, u16bit_iterator result)
235  {
236  while (start != end) {
237  uint32_t cp = next(start, end);
238  if (cp > 0xffff) { //make a surrogate pair
239  *result++ = static_cast<uint16_t>((cp >> 10) + internal::LEAD_OFFSET);
240  *result++ = static_cast<uint16_t>((cp & 0x3ff) + internal::TRAIL_SURROGATE_MIN);
241  }
242  else
243  *result++ = static_cast<uint16_t>(cp);
244  }
245  return result;
246  }
247 
248  template <typename octet_iterator, typename u32bit_iterator>
249  octet_iterator utf32to8 (u32bit_iterator start, u32bit_iterator end, octet_iterator result)
250  {
251  while (start != end)
252  result = append(*(start++), result);
253 
254  return result;
255  }
256 
257  template <typename octet_iterator, typename u32bit_iterator>
258  u32bit_iterator utf8to32 (octet_iterator start, octet_iterator end, u32bit_iterator result)
259  {
260  while (start != end)
261  (*result++) = next(start, end);
262 
263  return result;
264  }
265 
266  // The iterator class
267  template <typename octet_iterator>
268  class iterator : public std::iterator <std::bidirectional_iterator_tag, uint32_t> {
269  octet_iterator it;
270  octet_iterator range_start;
271  octet_iterator range_end;
272  public:
273  iterator () {};
274  explicit iterator (const octet_iterator& octet_it,
275  const octet_iterator& range_start_,
276  const octet_iterator& range_end_) :
277  it(octet_it), range_start(range_start_), range_end(range_end_)
278  {
279  if (it < range_start || it > range_end)
280  throw std::out_of_range("Invalid utf-8 iterator position");
281  }
282  // the default "big three" are OK
283  octet_iterator base () const { return it; }
285  {
286  octet_iterator temp = it;
287  return next(temp, range_end);
288  }
289  bool operator == (const iterator& rhs) const
290  {
291  if (range_start != rhs.range_start || range_end != rhs.range_end)
292  throw std::logic_error("Comparing utf-8 iterators defined with different ranges");
293  return (it == rhs.it);
294  }
295  bool operator != (const iterator& rhs) const
296  {
297  return !(operator == (rhs));
298  }
300  {
301  next(it, range_end);
302  return *this;
303  }
305  {
306  iterator temp = *this;
307  next(it, range_end);
308  return temp;
309  }
311  {
312  prior(it, range_start);
313  return *this;
314  }
316  {
317  iterator temp = *this;
318  prior(it, range_start);
319  return temp;
320  }
321  }; // class iterator
322 
323 } // namespace utf8
324 
325 #endif //header guard
326 
327 
uint32_t code_point() const
Definition: checked.h:46
invalid_code_point(uint32_t cp_)
Definition: checked.h:44
virtual const char * what() const
Definition: checked.h:45
virtual const char * what() const
Definition: checked.h:61
uint16_t utf16_word() const
Definition: checked.h:62
invalid_utf16(uint16_t u)
Definition: checked.h:60
uint16_t u16
Definition: checked.h:58
invalid_utf8(uint8_t u)
Definition: checked.h:52
virtual const char * what() const
Definition: checked.h:53
uint8_t utf8_octet() const
Definition: checked.h:54
octet_iterator range_start
Definition: checked.h:270
uint32_t operator*() const
Definition: checked.h:284
bool operator==(const iterator &rhs) const
Definition: checked.h:289
octet_iterator base() const
Definition: checked.h:283
iterator & operator--()
Definition: checked.h:310
iterator & operator++()
Definition: checked.h:299
octet_iterator range_end
Definition: checked.h:271
octet_iterator it
Definition: checked.h:269
bool operator!=(const iterator &rhs) const
Definition: checked.h:295
iterator(const octet_iterator &octet_it, const octet_iterator &range_start_, const octet_iterator &range_end_)
Definition: checked.h:274
virtual const char * what() const
Definition: checked.h:67
bool is_lead_surrogate(u16 cp)
Definition: core.h:75
bool is_trail_surrogate(u16 cp)
Definition: core.h:81
const uint32_t SURROGATE_OFFSET
Definition: core.h:53
const uint16_t LEAD_OFFSET
Definition: core.h:52
const uint16_t TRAIL_SURROGATE_MIN
Definition: core.h:50
bool is_code_point_valid(u32 cp)
Definition: core.h:93
@ INCOMPLETE_SEQUENCE
Definition: core.h:134
@ INVALID_LEAD
Definition: core.h:134
@ OVERLONG_SEQUENCE
Definition: core.h:134
@ INVALID_CODE_POINT
Definition: core.h:134
@ NOT_ENOUGH_ROOM
Definition: core.h:134
uint16_t mask16(u16_type oc)
Definition: core.h:64
bool is_trail(octet_type oc)
Definition: core.h:69
utf_error validate_next(octet_iterator &it, octet_iterator end, uint32_t *code_point)
Definition: core.h:252
Definition: checked.h:35
output_iterator replace_invalid(octet_iterator start, octet_iterator end, output_iterator out, uint32_t replacement)
The library API - functions intended to be called by the users.
Definition: checked.h:73
octet_iterator append(uint32_t cp, octet_iterator result)
Definition: checked.h:111
void advance(octet_iterator &it, distance_type n, octet_iterator end)
Definition: checked.h:190
uint32_t peek_next(octet_iterator it, octet_iterator end)
Definition: checked.h:157
octet_iterator utf32to8(u32bit_iterator start, u32bit_iterator end, octet_iterator result)
Definition: checked.h:249
u16bit_iterator utf8to16(octet_iterator start, octet_iterator end, u16bit_iterator result)
Definition: checked.h:234
std::iterator_traits< octet_iterator >::difference_type distance(octet_iterator first, octet_iterator last)
Definition: checked.h:198
u32bit_iterator utf8to32(octet_iterator start, octet_iterator end, u32bit_iterator result)
Definition: checked.h:258
unsigned int uint32_t
Definition: core.h:40
uint32_t prior(octet_iterator &it, octet_iterator start)
Definition: checked.h:163
unsigned char uint8_t
Definition: core.h:38
unsigned short uint16_t
Definition: core.h:39
octet_iterator utf16to8(u16bit_iterator start, u16bit_iterator end, octet_iterator result)
Definition: checked.h:207
uint32_t previous(octet_iterator &it, octet_iterator pass_start)
Deprecated in versions that include "prior".
Definition: checked.h:179
uint32_t next(octet_iterator &it, octet_iterator end)
Definition: checked.h:137