Method append

src/isql/Extender.cpp:61–78

Append to the string. Note second parameter is the size, not the length. This means that a null terminator is not added unless the input contains it. If there's already a null terminator, it's not discarded before appending! If there's space used, a newline is optionally used as separator between the existing content and the new input. The internal buffer is not grown; the input will be truncated.

// The internal buffer is not grown; the input will be truncated.
// The amount of written bytes (the ones that fit) is returned.
size_t Extender::append(const char* s, size_t s_size, bool newline)
{
	if (m_pos >= m_buf + m_size) // Full buffer?
		return 0;

	const size_t extra = m_buf < m_pos && newline ? 1 : 0;

	if (m_pos + s_size + extra > m_buf + m_size) // Adjust the argument, truncating it.
		s_size = m_buf + m_size - m_pos - extra;

	// Do not append newline if there's nothing before or the caller doesn't want it.
	if (extra)
		*m_pos++ = '\n';

	memcpy(m_pos, s, s_size);
	m_pos += s_size;
	return s_size + extra;
}

// Unlike alloc() and allocFill(), this is not a destructive operation.
// If the requested size is not bigger than the existing one, nothing happens and