Method parse_string_to_multiple

crawl-ref/source/format.cc:99–139

Parses a formatted string in much the same way as parse_string, but handles \n by creating a new formatted_string.

// Parses a formatted string in much the same way as parse_string, but
// handles \n by creating a new formatted_string.
void formatted_string::parse_string_to_multiple(const string &s,
                                                vector<formatted_string> &out,
                                                int wrap_col)
{
    vector<int> colour_stack(1, LIGHTGREY);
    vector<int> bg_stack(1, BLACK);

    vector<string> lines = split_string("\n", s, false, true);
    if (wrap_col > 0)
    {
        vector<string> pre_split = std::move(lines);
        for (string &line : pre_split)
        {
            do
            {
                lines.push_back(wordwrap_line(line, wrap_col, true, true));
            }
            while (!line.empty());
        }
    }

    for (const string &line : lines)
    {
        out.emplace_back();
        formatted_string& fs = out.back();
        // apply initial colors or the colors leftover on the stack from
        // previous lines. Only apply background in case there was an explicit
        // bg tag from previous lines.
        fs.textcolour(colour_stack.back());
        if (bg_stack.size() > 1)
            fs.textbackground(bg_stack.back());
        parse_string1(line, fs, colour_stack, bg_stack);
        // if the colour strings are unbalanced at this point, reset the
        // colors at the end of the line, and then re-apply them to the next
        // line (if there is one) on the next cycle of this loop
        if (colour_stack.back() != colour_stack.front())
            fs.textcolour(colour_stack.front()); // XXX: this does nothing
        if (bg_stack.back() != bg_stack.front())
            fs.textbackground(bg_stack.front());
    }
}

// Helper for the other parse_ methods.
void formatted_string::parse_string1(const string &s, formatted_string &fs,