mirror of
https://github.com/stefanocasazza/ULib.git
synced 2025-09-28 19:05:55 +08:00
73 lines
2.1 KiB
C
73 lines
2.1 KiB
C
// ============================================================================
|
|
//
|
|
// = LIBRARY
|
|
// ULib - c++ library
|
|
//
|
|
// = FILENAME
|
|
// escape.h
|
|
//
|
|
// = AUTHOR
|
|
// Stefano Casazza
|
|
//
|
|
// ============================================================================
|
|
|
|
#ifndef ULIB_ESCAPE_H
|
|
#define ULIB_ESCAPE_H 1
|
|
|
|
#include <ulib/base/coder/escape.h>
|
|
|
|
#include <ulib/string.h>
|
|
|
|
/**
|
|
* Encode-Decode escape sequences into a buffer, the following are recognized:
|
|
* ---------------------------------------------------------------------------
|
|
* \a BEL (\007 7 7)
|
|
* \b BS backspace (\010 8 8)
|
|
* \t HT horizontal tab (\011 9 9)
|
|
* \n LF newline (\012 10 A)
|
|
* \v VT vertical tab (\013 11 B)
|
|
* \f FF formfeed (\014 12 C)
|
|
* \r CR carriage return (\015 13 D)
|
|
* \e ESC character (\033 27 1B)
|
|
*
|
|
* \u four-hex-digits (unicode char)
|
|
* \^C C = any letter (Control code)
|
|
* \xDD number formed of 1-2 hex digits
|
|
* \DDD number formed of 1-3 octal digits
|
|
* ---------------------------------------------------------------------------
|
|
*/
|
|
|
|
struct U_EXPORT UEscape {
|
|
|
|
static void encode(const char* s, uint32_t n, UString& buffer)
|
|
{
|
|
U_TRACE(0, "UEscape::encode(%.*S,%u,%p)", n, s, n, &buffer)
|
|
|
|
U_ASSERT(buffer.uniq())
|
|
U_ASSERT(buffer.capacity() >= n)
|
|
|
|
uint32_t sz = buffer.size();
|
|
|
|
buffer.rep->_length = sz + u_escape_encode((const unsigned char*)s, n, buffer.c_pointer(sz), buffer.space());
|
|
|
|
U_INTERNAL_DUMP("buffer(%u) = %#V", buffer.size(), buffer.rep)
|
|
}
|
|
|
|
static void encode(const UString& s, UString& buffer) { encode(U_STRING_TO_PARAM(s), buffer); }
|
|
|
|
static void decode(const char* s, uint32_t n, UString& buffer)
|
|
{
|
|
U_TRACE(0, "UEscape::decode(%.*S,%u,%V)", n, s, n, buffer.rep)
|
|
|
|
U_ASSERT(buffer.uniq())
|
|
|
|
buffer.rep->_length = u_escape_decode(s, n, (unsigned char*)buffer.data());
|
|
|
|
U_INTERNAL_DUMP("buffer(%u) = %#V", buffer.size(), buffer.rep)
|
|
}
|
|
|
|
static void decode(const UString& s, UString& buffer) { decode(U_STRING_TO_PARAM(s), buffer); }
|
|
};
|
|
|
|
#endif
|