Method VicinityToText

Source/script.cpp:11417–11466

char *Line::VicinityToText(char *aBuf, size_t aBufSize, int aMaxLines)
// Translates the current line and the lines above and below it into their text equivalent
// putting the result into aBuf and returning the position in aBuf of its new string terminator.
{
	if (!aBuf || aBufSize < 256) return NULL;

	char *aBuf_orig = aBuf;

	if (aMaxLines < 5)
		aMaxLines = 5;
	--aMaxLines; // -1 to leave room for the current line itself.

	int lines_following = (int)(aMaxLines / 2);
	int lines_preceding = aMaxLines - lines_following;

	// Determine the correct value for line_start and line_end:
	int i;
	Line *line_start, *line_end;
	for (i = 0, line_start = this
		; i < lines_preceding && line_start->mPrevLine != NULL
		; ++i, line_start = line_start->mPrevLine);

	for (i = 0, line_end = this
		; i < lines_following && line_end->mNextLine != NULL
		; ++i, line_end = line_end->mNextLine);

	// Now line_start and line_end are the first and last lines of the range
	// we want to convert to text, and they're non-NULL.
	snprintf(aBuf, BUF_SPACE_REMAINING, "\tLine#\n");
	aBuf += strlen(aBuf);

	size_t space_remaining;

	// Start at the oldest and continue up through the newest:
	for (Line *line = line_start;;)
	{
		if (line == this)
			strlcpy(aBuf, "--->\t", BUF_SPACE_REMAINING);
		else
			strlcpy(aBuf, "\t", BUF_SPACE_REMAINING);
		aBuf += strlen(aBuf);
		space_remaining = BUF_SPACE_REMAINING;  // Resolve macro only once for performance.
		// Truncate large lines so that the dialog is more readable:
		aBuf = line->ToText(aBuf, space_remaining < 500 ? space_remaining : 500, false);
		if (line == line_end)
			break;
		line = line->mNextLine;
	}
	return aBuf;
}