Click here to Skip to main content
Click here to Skip to main content

Text Formatter

, 19 Sep 2005
Rate this:
Please Sign up or sign in to vote.
A class to block the size of a given text.

Introduction

I wrote this code back in times where most of the user interfaces were text based. But some years ago, I again had to use this code for formatting emails which were automatically generated and sent to our customers. So I grabbed the change, and rewrote the whole thing in C++. The outcome of this refactoring process is an easy to use class called TextFormatter which provides row justification with a modifiable block size. It also has a special table formatting feature which avoids using tabs between its columns, thus providing a character based column size control and alignment.

How does it work?

The idea behind the row justification is, to automatically wrap the words if the length of one row is greater than the given block size. The diagram below shows the technique of wrapping the line into parts where each part's length is less than the block size. This job is done in makeRowsUnderBlockMax().

Once each row isn't greater than block size anymore, spaces are inserted between words by calculating the amount of characters needed to let the row fit exactly into the block size.

Using the class

The constructor of TextFormatter expects an output stream and a block size for row justifying. You can use either output streams. After an instance of this class is created you can call print(const char *text) as often as you want. This operation will print the given text to the output stream while row justifying it. By calling createTable(), you initiate table formatting. Before you can print the rows of the table, you have to define the column size and alignment. Please refer to the example below. You are also able to print text while you are printing tables. Just modify the code below and try it out. Hope you find this class useful.

void CTextformatterDialogDlg::OnButTesttable() 
{
    std::stringstream out;
    TF::TextFormatter tf(out, m_ColumnWidthControl.GetPos());
    tf.print(standard_text);

    tf.newLines(3);

    tf.createTable();
    tf.addColumn("Name", 10); tf.addColumn("First Name", 14); 
    tf.addColumn("Age", 6);
    tf.setColumnAlignment(2, TF::TextFormatter::right);
    tf.printHeader(true);

    tf.printRow(3, "Kandinsky", "Wassily", "139");
    tf.printRow(3, "Marc", "Franz", "125");
    tf.printRow(3, "Mueller", "Otto", "1131");
    tf.printRow(3, "Dali", "Salvador", "101");
    tf.printRowLine();
    tf.print("Mr.Mueller's age was slightly modified.");

    tf.newLines(5);

    tf.setBlockMax(m_ColumnWidthControl.GetPos()*2);
    tf.print(standard_text);

    m_Output = out.str().c_str();

    this->UpdateData(FALSE);
}

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Doga Arinir
Chief Technology Officer W3L
Germany Germany
-Since 1th August 2007: Chief Technology Officer of W3L
-2002/08/01-2007/07/31: PhD student
-1997/10/15-2002/07/31: Studied Electrical Engineering and Computer Science

Comments and Discussions

 
QuestionGreat ,Did u wrote it in c#??? Pinmemberqueen_Of_Hearts21-Feb-06 9:06 
GeneralStandalone method PinmemberRavi Bhavnani19-Sep-05 14:30 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.141022.2 | Last Updated 19 Sep 2005
Article Copyright 2005 by Doga Arinir
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid