/src/capstonenext/SStream.c

Source
/* Capstone Disassembly Engine */
/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */

#include <stdarg.h>
#if defined(CAPSTONE_HAS_OSXKERNEL)
#include <Availability.h>
#include <libkern/libkern.h>
#include <i386/limits.h>
#else
#include <stdio.h>
#include <limits.h>
#endif
#include <string.h>

#include <capstone/platform.h>

#include "SStream.h"
#include "cs_priv.h"
#include "utils.h"

void SStream_Init(SStream *ss)
{
  assert(ss);
  ss->index = 0;
  memset(ss->buffer, 0, sizeof(ss->buffer));
  ss->is_closed = false;
  ss->markup_stream = false;
  ss->prefixed_by_markup = false;
  ss->unsigned_num = false;
}

void SStream_opt_unum(SStream *ss, bool print_unsigned_numbers)
{
  assert(ss);
  ss->unsigned_num = print_unsigned_numbers;
}

/// Returns the a pointer to the internal string buffer of the stream.
/// For reading only.
const char *SStream_rbuf(const SStream *ss)
{
  assert(ss);
  return ss->buffer;
}

/// Searches in the stream for the first (from the left) occurrence of @elem and replaces
/// it with @repl. It returns the pointer *after* the replaced character
/// or NULL if no character was replaced.
///
/// It will never replace the final \0 byte in the stream buffer.
const char *SStream_replc(const SStream *ss, char elem, char repl)
{
  assert(ss);
  char *found = strchr(ss->buffer, elem);
  if (!found || found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
    return NULL;
  }
  *found = repl;
  found++;
  return found;
}

/// Searches in the stream for the first (from the left) occurrence of @chr and replaces
/// it with @rstr.
void SStream_replc_str(SStream *ss, char chr, const char *rstr)
{
  assert(ss && rstr);
  char *found = strchr(ss->buffer, chr);
  if (!found || found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
    return;
  }
  size_t post_len = strlen(found + 1);
  size_t buf_str_len = strlen(ss->buffer);
  size_t repl_len = strlen(rstr);
  if (repl_len - 1 + buf_str_len >= SSTREAM_BUF_LEN) {
    return;
  }
  memmove(found + repl_len, found + 1, post_len);
  memcpy(found, rstr, repl_len);
  ss->index = strlen(ss->buffer);
}

/// Removes the space characters '\t' and ' ' from the beginning of the stream buffer.
void SStream_trimls(SStream *ss)
{
  assert(ss);
  size_t buf_off = 0;
  /// Remove leading spaces
  while (ss->buffer[buf_off] == ' ' || ss->buffer[buf_off] == '\t') {
    buf_off++;
  }
  if (buf_off > 0) {
    memmove(ss->buffer, ss->buffer + buf_off,
      SSTREAM_BUF_LEN - buf_off);
    ss->index -= buf_off;
  }
}

/// Extract the mnemonic to @mnem_buf and the operand string into @op_str_buf from the stream buffer.
/// The mnemonic is everything up until the first ' ' or '\t' character.
/// The operand string is everything after the first ' ' or '\t' sequence.
void SStream_extract_mnem_opstr(const SStream *ss, char *mnem_buf,
        size_t mnem_buf_size, char *op_str_buf,
        size_t op_str_buf_size)
{
  assert(ss && mnem_buf && mnem_buf_size > 0 && op_str_buf &&
         op_str_buf_size > 0);
  size_t off = 0;
  // Copy all non space chars to as mnemonic.
  while (ss->buffer[off] && ss->buffer[off] != ' ' &&
         ss->buffer[off] != '\t') {
    if (off < mnem_buf_size - 1) {
      // Only copy if there is space left.
      mnem_buf[off] = ss->buffer[off];
    }
    off++;
  }
  if (!ss->buffer[off]) {
    return;
  }

  // Iterate until next non space char.
  do {
    off++;
  } while (ss->buffer[off] &&
     (ss->buffer[off] == ' ' || ss->buffer[off] == '\t'));

  if (!ss->buffer[off]) {
    return;
  }

  // Copy all follow up characters as op_str
  const char *ss_op_str = ss->buffer + off;
  off = 0;
  while (ss_op_str[off] && off < op_str_buf_size - 1) {
    op_str_buf[off] = ss_op_str[off];
    off++;
  }
}

/// Empty the stream @ss to given @file (stdin/stderr).
/// @file can be NULL. Then the buffer content is not emitted.
void SStream_Flush(SStream *ss, FILE *file)
{
  assert(ss);
  if (file) {
    fprintf(file, "%s\n", ss->buffer);
  }
  SStream_Init(ss);
}

/**
 * Open the output stream. Every write attempt is accepted again.
 */
void SStream_Open(SStream *ss)
{
  assert(ss);
  ss->is_closed = false;
}

/**
 * Closes the output stream. Every write attempt is ignored.
 */
void SStream_Close(SStream *ss)
{
  assert(ss);
  ss->is_closed = true;
}

/**
 * Copy the string \p s to the buffer of \p ss and terminate it with a '\\0' byte.
 */
void SStream_concat0(SStream *ss, const char *s)
{
#ifndef CAPSTONE_DIET
  assert(ss && s);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (s[0] == '\0')
    return;
  unsigned int len = (unsigned int)strlen(s);

  SSTREAM_OVERFLOW_CHECK(ss, len);

  memcpy(ss->buffer + ss->index, s, len);
  ss->index += len;
  ss->buffer[ss->index] = '\0';
  if (ss->markup_stream && ss->prefixed_by_markup) {
    SSTREAM_OVERFLOW_CHECK(ss, 1);
    ss->buffer[ss->index] = '>';
    ss->index += 1;
    ss->buffer[ss->index] = '\0';
  }
#else
  ss->buffer[ss->index] = '\0';
#endif
}

/**
 * Copy the single char \p c to the buffer of \p ss.
 */
void SStream_concat1(SStream *ss, const char c)
{
#ifndef CAPSTONE_DIET
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (c == '\0')
    return;

  SSTREAM_OVERFLOW_CHECK(ss, 1);

  ss->buffer[ss->index] = c;
  ss->index++;
  ss->buffer[ss->index] = '\0';
  if (ss->markup_stream && ss->prefixed_by_markup) {
    SSTREAM_OVERFLOW_CHECK(ss, 1);
    ss->buffer[ss->index] = '>';
    ss->index++;
  }
#else
  ss->buffer[ss->index] = '\0';
#endif
}

/**
 * Copy all strings given to the buffer of \p ss according to formatting \p fmt.
 */
void SStream_concat(SStream *ss, const char *fmt, ...)
{
#ifndef CAPSTONE_DIET
  assert(ss && fmt);
  SSTREAM_RETURN_IF_CLOSED(ss);
  va_list ap;
  int ret;

  va_start(ap, fmt);
  ret = cs_vsnprintf(ss->buffer + ss->index,
         sizeof(ss->buffer) - (ss->index + 1), fmt, ap);
  va_end(ap);
  if (ret < 0) {
    return;
  }
  SSTREAM_OVERFLOW_CHECK(ss, ret);
  ss->index += ret;
  if (ss->markup_stream && ss->prefixed_by_markup) {
    SSTREAM_OVERFLOW_CHECK(ss, 1);
    ss->buffer[ss->index] = '>';
    ss->index += 1;
  }
#else
  ss->buffer[ss->index] = '\0';
#endif
}

// print number with prefix #
void printInt64Bang(SStream *ss, int64_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt64Bang(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat1(ss, '#');
  printInt64(ss, val);
}

void printUInt64Bang(SStream *ss, uint64_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat1(ss, '#');
  printUInt64(ss, val);
}

// print number
void printInt64(SStream *ss, int64_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt64(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    if (val > HEX_THRESHOLD)
      SStream_concat(ss, "0x%" PRIx64, val);
    else
      SStream_concat(ss, "%" PRIu64, val);
  } else {
    if (val < -HEX_THRESHOLD) {
      if (val == INT64_MIN)
        SStream_concat(ss, "-0x%" PRIx64,
                 (uint64_t)INT64_MAX + 1);
      else
        SStream_concat(ss, "-0x%" PRIx64,
                 (uint64_t)-val);
    } else
      SStream_concat(ss, "-%" PRIu64, -val);
  }
}

void printUInt64(SStream *ss, uint64_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val > HEX_THRESHOLD)
    SStream_concat(ss, "0x%" PRIx64, val);
  else
    SStream_concat(ss, "%" PRIu64, val);
}

// print number in decimal mode
void printInt32BangDec(SStream *ss, int32_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0)
    SStream_concat(ss, "#%" PRIu32, val);
  else {
    if (val == INT32_MIN)
      SStream_concat(ss, "#-%" PRIu32, val);
    else
      SStream_concat(ss, "#-%" PRIu32, (uint32_t)-val);
  }
}

void printInt32Bang(SStream *ss, int32_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt32Bang(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat1(ss, '#');
  printInt32(ss, val);
}

void printUInt8(SStream *ss, uint8_t val)
{
  assert(ss);
  if (val > HEX_THRESHOLD)
    SStream_concat(ss, "0x%" PRIx8, val);
  else
    SStream_concat(ss, "%" PRIu8, val);
}

void printUInt16(SStream *ss, uint16_t val)
{
  assert(ss);
  if (val > HEX_THRESHOLD)
    SStream_concat(ss, "0x%" PRIx16, val);
  else
    SStream_concat(ss, "%" PRIu16, val);
}

void printInt8(SStream *ss, int8_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt8(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    if (val > HEX_THRESHOLD)
      SStream_concat(ss, "0x%" PRIx8, val);
    else
      SStream_concat(ss, "%" PRId8, val);
  } else {
    if (val < -HEX_THRESHOLD) {
      if (val == INT8_MIN)
        SStream_concat(ss, "-0x%" PRIx8,
                 (uint8_t)INT8_MAX + 1);
      else
        SStream_concat(ss, "-0x%" PRIx8, (int8_t)-val);
    } else
      SStream_concat(ss, "-%" PRIu8, -val);
  }
}

void printInt16(SStream *ss, int16_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt16(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    if (val > HEX_THRESHOLD)
      SStream_concat(ss, "0x%" PRIx16, val);
    else
      SStream_concat(ss, "%" PRId16, val);
  } else {
    if (val < -HEX_THRESHOLD) {
      if (val == INT16_MIN)
        SStream_concat(ss, "-0x%" PRIx16,
                 (uint16_t)INT16_MAX + 1);
      else
        SStream_concat(ss, "-0x%" PRIx16,
                 (int16_t)-val);
    } else
      SStream_concat(ss, "-%" PRIu16, -val);
  }
}

void printInt16HexOffset(SStream *ss, int16_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt16(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    SStream_concat(ss, "+0x%" PRIx16, val);
  } else {
    if (val == INT16_MIN)
      SStream_concat(ss, "-0x%" PRIx16,
               (uint16_t)INT16_MAX + 1);
    else
      SStream_concat(ss, "-0x%" PRIx16, (int16_t)-val);
  }
}

void printInt32(SStream *ss, int32_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt32(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    if (val > HEX_THRESHOLD)
      SStream_concat(ss, "0x%" PRIx32, val);
    else
      SStream_concat(ss, "%" PRId32, val);
  } else {
    if (val < -HEX_THRESHOLD) {
      if (val == INT32_MIN)
        SStream_concat(ss, "-0x%" PRIx32,
                 (uint32_t)INT32_MAX + 1);
      else
        SStream_concat(ss, "-0x%" PRIx32,
                 (int32_t)-val);
    } else {
      SStream_concat(ss, "-%" PRIu32, (uint32_t)-val);
    }
  }
}

void printInt32HexOffset(SStream *ss, int32_t val)
{
  assert(ss);
  if (ss->unsigned_num) {
    printUInt32(ss, val);
    return;
  }
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    SStream_concat(ss, "+0x%" PRIx32, val);
  } else {
    if (val == INT32_MIN)
      SStream_concat(ss, "-0x%" PRIx32,
               (uint32_t)INT32_MAX + 1);
    else
      SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
  }
}

void printInt32Hex(SStream *ss, int32_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val >= 0) {
    SStream_concat(ss, "0x%" PRIx32, val);
  } else {
    if (val == INT32_MIN)
      SStream_concat(ss, "-0x%" PRIx32,
               (uint32_t)INT32_MAX + 1);
    else
      SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
  }
}

void printUInt32Bang(SStream *ss, uint32_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat1(ss, '#');
  printUInt32(ss, val);
}

void printUInt32(SStream *ss, uint32_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  if (val > HEX_THRESHOLD)
    SStream_concat(ss, "0x%x", val);
  else
    SStream_concat(ss, "%u", val);
}

void printFloat(SStream *ss, float val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat(ss, "%e", val);
}

void printfFloat(SStream *ss, const char *fmt, float val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat(ss, fmt, val);
}

void printFloatBang(SStream *ss, float val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat(ss, "#%e", val);
}

void printExpr(SStream *ss, uint64_t val)
{
  assert(ss);
  SSTREAM_RETURN_IF_CLOSED(ss);
  SStream_concat(ss, "%" PRIu64, val);
}

SStream *markup_OS(SStream *OS, SStreamMarkup style)
{
  assert(OS);

  if (OS->is_closed || !OS->markup_stream) {
    return OS;
  }
  OS->markup_stream = false; // Disable temporarily.
  switch (style) {
  default:
    SStream_concat0(OS, "<UNKNOWN:");
    return OS;
  case Markup_Immediate:
    SStream_concat0(OS, "<imm:");
    break;
  case Markup_Register:
    SStream_concat0(OS, "<reg:");
    break;
  case Markup_Target:
    SStream_concat0(OS, "<tar:");
    break;
  case Markup_Memory:
    SStream_concat0(OS, "<mem:");
    break;
  }
  OS->markup_stream = true;
  OS->prefixed_by_markup = true;
  return OS;
}

Coverage Report

Created: 2026-02-26 07:11

Line	Count	Source
1		/* Capstone Disassembly Engine */
2		/* By Nguyen Anh Quynh <aquynh@gmail.com>, 2013-2019 */
3
4		#include <stdarg.h>
5		#if defined(CAPSTONE_HAS_OSXKERNEL)
6		#include <Availability.h>
7		#include <libkern/libkern.h>
8		#include <i386/limits.h>
9		#else
10		#include <stdio.h>
11		#include <limits.h>
12		#endif
13		#include <string.h>
14
15		#include <capstone/platform.h>
16
17		#include "SStream.h"
18		#include "cs_priv.h"
19		#include "utils.h"
20
21		void SStream_Init(SStream *ss)
22	3.56M	{
23	3.56M	assert(ss);
24	3.56M	ss->index = 0;
25	3.56M	memset(ss->buffer, 0, sizeof(ss->buffer));
26	3.56M	ss->is_closed = false;
27	3.56M	ss->markup_stream = false;
28	3.56M	ss->prefixed_by_markup = false;
29	3.56M	ss->unsigned_num = false;
30	3.56M	}
31
32		void SStream_opt_unum(SStream *ss, bool print_unsigned_numbers)
33	3.43M	{
34	3.43M	assert(ss);
35	3.43M	ss->unsigned_num = print_unsigned_numbers;
36	3.43M	}
37
38		/// Returns the a pointer to the internal string buffer of the stream.
39		/// For reading only.
40		const char SStream_rbuf(const SStream ss)
41	175k	{
42	175k	assert(ss);
43	175k	return ss->buffer;
44	175k	}
45
46		/// Searches in the stream for the first (from the left) occurrence of @elem and replaces
47		/// it with @repl. It returns the pointer after the replaced character
48		/// or NULL if no character was replaced.
49		///
50		/// It will never replace the final \0 byte in the stream buffer.
51		const char SStream_replc(const SStream ss, char elem, char repl)
52	121k	{
53	121k	assert(ss);
54	121k	char *found = strchr(ss->buffer, elem);
55	121k	if (!found \|\| found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
56	121k	return NULL;
57	121k	}
58	0	*found = repl;
59	0	found++;
60	0	return found;
61	121k	}
62
63		/// Searches in the stream for the first (from the left) occurrence of @chr and replaces
64		/// it with @rstr.
65		void SStream_replc_str(SStream ss, char chr, const char rstr)
66	42.9k	{
67	42.9k	assert(ss && rstr);
68	42.9k	char *found = strchr(ss->buffer, chr);
69	42.9k	if (!found \|\| found == ss->buffer + (SSTREAM_BUF_LEN - 1)) {
70	0	return;
71	0	}
72	42.9k	size_t post_len = strlen(found + 1);
73	42.9k	size_t buf_str_len = strlen(ss->buffer);
74	42.9k	size_t repl_len = strlen(rstr);
75	42.9k	if (repl_len - 1 + buf_str_len >= SSTREAM_BUF_LEN) {
76	0	return;
77	0	}
78	42.9k	memmove(found + repl_len, found + 1, post_len);
79	42.9k	memcpy(found, rstr, repl_len);
80	42.9k	ss->index = strlen(ss->buffer);
81	42.9k	}
82
83		/// Removes the space characters '\t' and ' ' from the beginning of the stream buffer.
84		void SStream_trimls(SStream *ss)
85	3.55M	{
86	3.55M	assert(ss);
87	3.55M	size_t buf_off = 0;
88		/// Remove leading spaces
89	3.62M	while (ss->buffer[buf_off] == ' ' \|\| ss->buffer[buf_off] == '\t') {
90	67.3k	buf_off++;
91	67.3k	}
92	3.55M	if (buf_off > 0) {
93	67.3k	memmove(ss->buffer, ss->buffer + buf_off,
94	67.3k	SSTREAM_BUF_LEN - buf_off);
95	67.3k	ss->index -= buf_off;
96	67.3k	}
97	3.55M	}
98
99		/// Extract the mnemonic to @mnem_buf and the operand string into @op_str_buf from the stream buffer.
100		/// The mnemonic is everything up until the first ' ' or '\t' character.
101		/// The operand string is everything after the first ' ' or '\t' sequence.
102		void SStream_extract_mnem_opstr(const SStream ss, char mnem_buf,
103		size_t mnem_buf_size, char *op_str_buf,
104		size_t op_str_buf_size)
105	3.43M	{
106	3.43M	assert(ss && mnem_buf && mnem_buf_size > 0 && op_str_buf &&
107	3.43M	op_str_buf_size > 0);
108	3.43M	size_t off = 0;
109		// Copy all non space chars to as mnemonic.
110	19.8M	while (ss->buffer[off] && ss->buffer[off] != ' ' &&
111	18.9M	ss->buffer[off] != '\t') {
112	16.3M	if (off < mnem_buf_size - 1) {
113		// Only copy if there is space left.
114	16.3M	mnem_buf[off] = ss->buffer[off];
115	16.3M	}
116	16.3M	off++;
117	16.3M	}
118	3.43M	if (!ss->buffer[off]) {
119	167k	return;
120	167k	}
121
122		// Iterate until next non space char.
123	3.28M	do {
124	3.28M	off++;
125	3.28M	} while (ss->buffer[off] &&
126	3.23M	(ss->buffer[off] == ' ' \|\| ss->buffer[off] == '\t'));
127
128	3.26M	if (!ss->buffer[off]) {
129	48.3k	return;
130	48.3k	}
131
132		// Copy all follow up characters as op_str
133	3.21M	const char *ss_op_str = ss->buffer + off;
134	3.21M	off = 0;
135	46.4M	while (ss_op_str[off] && off < op_str_buf_size - 1) {
136	43.2M	op_str_buf[off] = ss_op_str[off];
137	43.2M	off++;
138	43.2M	}
139	3.21M	}
140
141		/// Empty the stream @ss to given @file (stdin/stderr).
142		/// @file can be NULL. Then the buffer content is not emitted.
143		void SStream_Flush(SStream ss, FILE file)
144	44.1k	{
145	44.1k	assert(ss);
146	44.1k	if (file) {
147	0	fprintf(file, "%s\n", ss->buffer);
148	0	}
149	44.1k	SStream_Init(ss);
150	44.1k	}
151
152		/**
153		* Open the output stream. Every write attempt is accepted again.
154		*/
155		void SStream_Open(SStream *ss)
156	0	{
157	0	assert(ss);
158	0	ss->is_closed = false;
159	0	}
160
161		/**
162		* Closes the output stream. Every write attempt is ignored.
163		*/
164		void SStream_Close(SStream *ss)
165	0	{
166	0	assert(ss);
167	0	ss->is_closed = true;
168	0	}
169
170		/**
171		* Copy the string \p s to the buffer of \p ss and terminate it with a '\\0' byte.
172		*/
173		void SStream_concat0(SStream ss, const char s)
174	19.8M	{
175	19.8M	#ifndef CAPSTONE_DIET
176	19.8M	assert(ss && s);
177	19.8M	SSTREAM_RETURN_IF_CLOSED(ss);
178	19.8M	if (s[0] == '\0')
179	6.03M	return;
180	13.8M	unsigned int len = (unsigned int)strlen(s);
181
182	13.8M	SSTREAM_OVERFLOW_CHECK(ss, len);
183
184	13.8M	memcpy(ss->buffer + ss->index, s, len);
185	13.8M	ss->index += len;
186	13.8M	ss->buffer[ss->index] = '\0';
187	13.8M	if (ss->markup_stream && ss->prefixed_by_markup) {
188	0	SSTREAM_OVERFLOW_CHECK(ss, 1);
189	0	ss->buffer[ss->index] = '>';
190	0	ss->index += 1;
191	0	ss->buffer[ss->index] = '\0';
192	0	}
193		#else
194		ss->buffer[ss->index] = '\0';
195		#endif
196	13.8M	}
197
198		/**
199		* Copy the single char \p c to the buffer of \p ss.
200		*/
201		void SStream_concat1(SStream *ss, const char c)
202	2.30M	{
203	2.30M	#ifndef CAPSTONE_DIET
204	2.30M	assert(ss);
205	2.30M	SSTREAM_RETURN_IF_CLOSED(ss);
206	2.30M	if (c == '\0')
207	29.0k	return;
208
209	2.27M	SSTREAM_OVERFLOW_CHECK(ss, 1);
210
211	2.27M	ss->buffer[ss->index] = c;
212	2.27M	ss->index++;
213	2.27M	ss->buffer[ss->index] = '\0';
214	2.27M	if (ss->markup_stream && ss->prefixed_by_markup) {
215	0	SSTREAM_OVERFLOW_CHECK(ss, 1);
216	0	ss->buffer[ss->index] = '>';
217	0	ss->index++;
218	0	}
219		#else
220		ss->buffer[ss->index] = '\0';
221		#endif
222	2.27M	}
223
224		/**
225		* Copy all strings given to the buffer of \p ss according to formatting \p fmt.
226		*/
227		void SStream_concat(SStream ss, const char fmt, ...)
228	8.90M	{
229	8.90M	#ifndef CAPSTONE_DIET
230	8.90M	assert(ss && fmt);
231	8.90M	SSTREAM_RETURN_IF_CLOSED(ss);
232	8.90M	va_list ap;
233	8.90M	int ret;
234
235	8.90M	va_start(ap, fmt);
236	8.90M	ret = cs_vsnprintf(ss->buffer + ss->index,
237	8.90M	sizeof(ss->buffer) - (ss->index + 1), fmt, ap);
238	8.90M	va_end(ap);
239	8.90M	if (ret < 0) {
240	0	return;
241	0	}
242	8.90M	SSTREAM_OVERFLOW_CHECK(ss, ret);
243	8.90M	ss->index += ret;
244	8.90M	if (ss->markup_stream && ss->prefixed_by_markup) {
245	0	SSTREAM_OVERFLOW_CHECK(ss, 1);
246	0	ss->buffer[ss->index] = '>';
247	0	ss->index += 1;
248	0	}
249		#else
250		ss->buffer[ss->index] = '\0';
251		#endif
252	8.90M	}
253
254		// print number with prefix #
255		void printInt64Bang(SStream *ss, int64_t val)
256	87.7k	{
257	87.7k	assert(ss);
258	87.7k	if (ss->unsigned_num) {
259	0	printUInt64Bang(ss, val);
260	0	return;
261	0	}
262	87.7k	SSTREAM_RETURN_IF_CLOSED(ss);
263	87.7k	SStream_concat1(ss, '#');
264	87.7k	printInt64(ss, val);
265	87.7k	}
266
267		void printUInt64Bang(SStream *ss, uint64_t val)
268	11.9k	{
269	11.9k	assert(ss);
270	11.9k	SSTREAM_RETURN_IF_CLOSED(ss);
271	11.9k	SStream_concat1(ss, '#');
272	11.9k	printUInt64(ss, val);
273	11.9k	}
274
275		// print number
276		void printInt64(SStream *ss, int64_t val)
277	806k	{
278	806k	assert(ss);
279	806k	if (ss->unsigned_num) {
280	0	printUInt64(ss, val);
281	0	return;
282	0	}
283	806k	SSTREAM_RETURN_IF_CLOSED(ss);
284	806k	if (val >= 0) {
285	725k	if (val > HEX_THRESHOLD)
286	459k	SStream_concat(ss, "0x%" PRIx64, val);
287	265k	else
288	265k	SStream_concat(ss, "%" PRIu64, val);
289	725k	} else {
290	81.5k	if (val < -HEX_THRESHOLD) {
291	72.5k	if (val == INT64_MIN)
292	25	SStream_concat(ss, "-0x%" PRIx64,
293	25	(uint64_t)INT64_MAX + 1);
294	72.5k	else
295	72.5k	SStream_concat(ss, "-0x%" PRIx64,
296	72.5k	(uint64_t)-val);
297	72.5k	} else
298	8.96k	SStream_concat(ss, "-%" PRIu64, -val);
299	81.5k	}
300	806k	}
301
302		void printUInt64(SStream *ss, uint64_t val)
303	209k	{
304	209k	assert(ss);
305	209k	SSTREAM_RETURN_IF_CLOSED(ss);
306	209k	if (val > HEX_THRESHOLD)
307	137k	SStream_concat(ss, "0x%" PRIx64, val);
308	71.4k	else
309	71.4k	SStream_concat(ss, "%" PRIu64, val);
310	209k	}
311
312		// print number in decimal mode
313		void printInt32BangDec(SStream *ss, int32_t val)
314	0	{
315	0	assert(ss);
316	0	SSTREAM_RETURN_IF_CLOSED(ss);
317	0	if (val >= 0)
318	0	SStream_concat(ss, "#%" PRIu32, val);
319	0	else {
320	0	if (val == INT32_MIN)
321	0	SStream_concat(ss, "#-%" PRIu32, val);
322	0	else
323	0	SStream_concat(ss, "#-%" PRIu32, (uint32_t)-val);
324	0	}
325	0	}
326
327		void printInt32Bang(SStream *ss, int32_t val)
328	214k	{
329	214k	assert(ss);
330	214k	if (ss->unsigned_num) {
331	0	printUInt32Bang(ss, val);
332	0	return;
333	0	}
334	214k	SSTREAM_RETURN_IF_CLOSED(ss);
335	214k	SStream_concat1(ss, '#');
336	214k	printInt32(ss, val);
337	214k	}
338
339		void printUInt8(SStream *ss, uint8_t val)
340	0	{
341	0	assert(ss);
342	0	if (val > HEX_THRESHOLD)
343	0	SStream_concat(ss, "0x%" PRIx8, val);
344	0	else
345	0	SStream_concat(ss, "%" PRIu8, val);
346	0	}
347
348		void printUInt16(SStream *ss, uint16_t val)
349	0	{
350	0	assert(ss);
351	0	if (val > HEX_THRESHOLD)
352	0	SStream_concat(ss, "0x%" PRIx16, val);
353	0	else
354	0	SStream_concat(ss, "%" PRIu16, val);
355	0	}
356
357		void printInt8(SStream *ss, int8_t val)
358	1.98k	{
359	1.98k	assert(ss);
360	1.98k	if (ss->unsigned_num) {
361	0	printUInt8(ss, val);
362	0	return;
363	0	}
364	1.98k	SSTREAM_RETURN_IF_CLOSED(ss);
365	1.98k	if (val >= 0) {
366	1.08k	if (val > HEX_THRESHOLD)
367	844	SStream_concat(ss, "0x%" PRIx8, val);
368	241	else
369	241	SStream_concat(ss, "%" PRId8, val);
370	1.08k	} else {
371	902	if (val < -HEX_THRESHOLD) {
372	639	if (val == INT8_MIN)
373	235	SStream_concat(ss, "-0x%" PRIx8,
374	235	(uint8_t)INT8_MAX + 1);
375	404	else
376	404	SStream_concat(ss, "-0x%" PRIx8, (int8_t)-val);
377	639	} else
378	263	SStream_concat(ss, "-%" PRIu8, -val);
379	902	}
380	1.98k	}
381
382		void printInt16(SStream *ss, int16_t val)
383	2.42k	{
384	2.42k	assert(ss);
385	2.42k	if (ss->unsigned_num) {
386	0	printUInt16(ss, val);
387	0	return;
388	0	}
389	2.42k	SSTREAM_RETURN_IF_CLOSED(ss);
390	2.42k	if (val >= 0) {
391	1.66k	if (val > HEX_THRESHOLD)
392	1.42k	SStream_concat(ss, "0x%" PRIx16, val);
393	236	else
394	236	SStream_concat(ss, "%" PRId16, val);
395	1.66k	} else {
396	761	if (val < -HEX_THRESHOLD) {
397	714	if (val == INT16_MIN)
398	57	SStream_concat(ss, "-0x%" PRIx16,
399	57	(uint16_t)INT16_MAX + 1);
400	657	else
401	657	SStream_concat(ss, "-0x%" PRIx16,
402	657	(int16_t)-val);
403	714	} else
404	47	SStream_concat(ss, "-%" PRIu16, -val);
405	761	}
406	2.42k	}
407
408		void printInt16HexOffset(SStream *ss, int16_t val)
409	8.34k	{
410	8.34k	assert(ss);
411	8.34k	if (ss->unsigned_num) {
412	0	printUInt16(ss, val);
413	0	return;
414	0	}
415	8.34k	SSTREAM_RETURN_IF_CLOSED(ss);
416	8.34k	if (val >= 0) {
417	5.16k	SStream_concat(ss, "+0x%" PRIx16, val);
418	5.16k	} else {
419	3.18k	if (val == INT16_MIN)
420	46	SStream_concat(ss, "-0x%" PRIx16,
421	46	(uint16_t)INT16_MAX + 1);
422	3.13k	else
423	3.13k	SStream_concat(ss, "-0x%" PRIx16, (int16_t)-val);
424	3.18k	}
425	8.34k	}
426
427		void printInt32(SStream *ss, int32_t val)
428	288k	{
429	288k	assert(ss);
430	288k	if (ss->unsigned_num) {
431	0	printUInt32(ss, val);
432	0	return;
433	0	}
434	288k	SSTREAM_RETURN_IF_CLOSED(ss);
435	288k	if (val >= 0) {
436	214k	if (val > HEX_THRESHOLD)
437	124k	SStream_concat(ss, "0x%" PRIx32, val);
438	89.9k	else
439	89.9k	SStream_concat(ss, "%" PRId32, val);
440	214k	} else {
441	74.5k	if (val < -HEX_THRESHOLD) {
442	68.9k	if (val == INT32_MIN)
443	86	SStream_concat(ss, "-0x%" PRIx32,
444	86	(uint32_t)INT32_MAX + 1);
445	68.8k	else
446	68.8k	SStream_concat(ss, "-0x%" PRIx32,
447	68.8k	(int32_t)-val);
448	68.9k	} else {
449	5.60k	SStream_concat(ss, "-%" PRIu32, (uint32_t)-val);
450	5.60k	}
451	74.5k	}
452	288k	}
453
454		void printInt32HexOffset(SStream *ss, int32_t val)
455	1.48k	{
456	1.48k	assert(ss);
457	1.48k	if (ss->unsigned_num) {
458	0	printUInt32(ss, val);
459	0	return;
460	0	}
461	1.48k	SSTREAM_RETURN_IF_CLOSED(ss);
462	1.48k	if (val >= 0) {
463	1.34k	SStream_concat(ss, "+0x%" PRIx32, val);
464	1.34k	} else {
465	133	if (val == INT32_MIN)
466	40	SStream_concat(ss, "-0x%" PRIx32,
467	40	(uint32_t)INT32_MAX + 1);
468	93	else
469	93	SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
470	133	}
471	1.48k	}
472
473		void printInt32Hex(SStream *ss, int32_t val)
474	5.49k	{
475	5.49k	assert(ss);
476	5.49k	SSTREAM_RETURN_IF_CLOSED(ss);
477	5.49k	if (val >= 0) {
478	2.34k	SStream_concat(ss, "0x%" PRIx32, val);
479	3.15k	} else {
480	3.15k	if (val == INT32_MIN)
481	53	SStream_concat(ss, "-0x%" PRIx32,
482	53	(uint32_t)INT32_MAX + 1);
483	3.09k	else
484	3.09k	SStream_concat(ss, "-0x%" PRIx32, (int32_t)-val);
485	3.15k	}
486	5.49k	}
487
488		void printUInt32Bang(SStream *ss, uint32_t val)
489	211k	{
490	211k	assert(ss);
491	211k	SSTREAM_RETURN_IF_CLOSED(ss);
492	211k	SStream_concat1(ss, '#');
493	211k	printUInt32(ss, val);
494	211k	}
495
496		void printUInt32(SStream *ss, uint32_t val)
497	320k	{
498	320k	assert(ss);
499	320k	SSTREAM_RETURN_IF_CLOSED(ss);
500	320k	if (val > HEX_THRESHOLD)
501	242k	SStream_concat(ss, "0x%x", val);
502	77.5k	else
503	77.5k	SStream_concat(ss, "%u", val);
504	320k	}
505
506		void printFloat(SStream *ss, float val)
507	0	{
508	0	assert(ss);
509	0	SSTREAM_RETURN_IF_CLOSED(ss);
510	0	SStream_concat(ss, "%e", val);
511	0	}
512
513		void printfFloat(SStream ss, const char fmt, float val)
514	74	{
515	74	assert(ss);
516	74	SSTREAM_RETURN_IF_CLOSED(ss);
517	74	SStream_concat(ss, fmt, val);
518	74	}
519
520		void printFloatBang(SStream *ss, float val)
521	705	{
522	705	assert(ss);
523	705	SSTREAM_RETURN_IF_CLOSED(ss);
524	705	SStream_concat(ss, "#%e", val);
525	705	}
526
527		void printExpr(SStream *ss, uint64_t val)
528	0	{
529	0	assert(ss);
530	0	SSTREAM_RETURN_IF_CLOSED(ss);
531	0	SStream_concat(ss, "%" PRIu64, val);
532	0	}
533
534		SStream markup_OS(SStream OS, SStreamMarkup style)
535	799k	{
536	799k	assert(OS);
537
538	799k	if (OS->is_closed \|\| !OS->markup_stream) {
539	799k	return OS;
540	799k	}
541	0	OS->markup_stream = false; // Disable temporarily.
542	0	switch (style) {
543	0	default:
544	0	SStream_concat0(OS, "<UNKNOWN:");
545	0	return OS;
546	0	case Markup_Immediate:
547	0	SStream_concat0(OS, "<imm:");
548	0	break;
549	0	case Markup_Register:
550	0	SStream_concat0(OS, "<reg:");
551	0	break;
552	0	case Markup_Target:
553	0	SStream_concat0(OS, "<tar:");
554	0	break;
555	0	case Markup_Memory:
556	0	SStream_concat0(OS, "<mem:");
557	0	break;
558	0	}
559	0	OS->markup_stream = true;
560		OS->prefixed_by_markup = true;
561	0	return OS;
562	0	}