Click here to Skip to main content
15,867,453 members
Articles / Programming Languages / C++
Article

A TCHAR style header file for STL strings and streams

Rate me:
Please Sign up or sign in to vote.
4.90/5 (18 votes)
11 Feb 2006CPOL1 min read 103.2K   502   35   24
Presents a header file that allows a single source file that uses STL to be built in either ANSI or Unicode, without any changes or lots of #ifdefs.

Introduction

I had asked on the Visual C++ forum if there was a standard header file that would provide a way of declaring std::strings so that a single code source could be compiled in either ANSI or UNICODE builds without any changes, much in the same way tchar.h is used. The response I got back is that there is no standard way of doing this so I decided to write my own header file to accomplish this task.

The TSTL.H header file

The header file is a simple one that uses a series of typedefs to define new synonyms for some of the commonly used STL classes that use chars and wchar_ts. The idea being that you can now use new names wherever you would have previously had to use either one or the other of the standard names. For example, a piece of code may have been written:

#ifdef _UNICODE
   std::wostringstream stream;
   stream.setf(std::wios::fixed);
#else
   std::ostringstream stream;
   stream.setf(std::ios::fixed);
#endif

and can now be written:

std::tostringstream stream;
stream.setf(std::tios::fixed);

and it will compile in either ANSI or Unicode builds. The file is probably not complete as there may be other STL classes that I do not know about or did not think of that should be included in this file. If there are, let me know which ones and I can include them and update the file.

To use the file, simply include it in your precompiled header file (stdafx.h) or include it in any file that uses any of the STL string or stream classes. The file is listed here and it can be downloaded from the download link at the top of this article.

// tstl.h - header file for TCHAR equivalents of STL
//          string and stream classes
//
// Copyright (c) 2006 PJ Arends
//
// This file is provided "AS-IS". Use and/or abuse it
// in any way you feel fit.
// 
 
#pragma once

#include <string>
 
namespace std
{
#if defined UNICODE || defined _UNICODE
 
    typedef wstring         tstring;
 
    typedef wstringbuf      tstringbuf;
    typedef wstringstream   tstringstream;
    typedef wostringstream  tostringstream;
    typedef wistringstream  tistringstream;
 
    typedef wstreambuf      tstreambuf;
 
    typedef wistream        tistream;
    typedef wiostream       tiostream;
 
    typedef wostream        tostream;
 
    typedef wfilebuf        tfilebuf;
    typedef wfstream        tfstream;
    typedef wifstream       tifstream;
    typedef wofstream       tofstream;
 
    typedef wios            tios;
 
#   define tcerr            wcerr
#   define tcin             wcin
#   define tclog            wclog
#   define tcout            wcout
 
#else // defined UNICODE || defined _UNICODE
 
    typedef string          tstring;
 
    typedef stringbuf       tstringbuf;
    typedef stringstream    tstringstream;
    typedef ostringstream   tostringstream;
    typedef istringstream   tistringstream;
 
    typedef streambuf       tstreambuf;
 
    typedef istream         tistream;
    typedef iostream        tiostream;
 
    typedef ostream         tostream;
 
    typedef filebuf         tfilebuf;
    typedef fstream         tfstream;
    typedef ifstream        tifstream;
    typedef ofstream        tofstream;
 
    typedef ios             tios;
 
#   define tcerr            cerr
#   define tcin             cin
#   define tclog            clog
#   define tcout            cout
 
#endif // defined UNICODE || defined _UNICODE
} // namespace std

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
President
Canada Canada
Father of two, brother of two, child of two.
Spouse to one, uncle to many, friend to lots.
Farmer, carpenter, mechanic, electrician, but definitely not a plumber.
Likes walks with the wife, board games, card games, travel, and camping in the summer.
High school graduate, college drop-out.
Hobby programmer who knows C++ with MFC and the STL.
Has dabbled with BASIC, Pascal, Fortran, COBOL, C#, SQL, ASM, and HTML.
Realized long ago that programming is fun when there is nobody pressuring you with schedules and timelines.

Comments and Discussions

 
GeneralRe: typedef vs #define Pin
PJ Arends12-Feb-06 6:11
professionalPJ Arends12-Feb-06 6:11 
GeneralRe: typedef vs #define Pin
Nish Nishant12-Feb-06 8:14
sitebuilderNish Nishant12-Feb-06 8:14 
GeneralRe: typedef vs #define Pin
Rama Krishna Vavilala12-Feb-06 6:12
Rama Krishna Vavilala12-Feb-06 6:12 
GeneralRe: typedef vs #define Pin
Anders Dalvander12-Feb-06 21:18
Anders Dalvander12-Feb-06 21:18 
Why not use references?
#if defined UNICODE || defined _UNICODE
wostream& tcout = wcout;
wostream& tcerr = wcerr;
wostream& tclog = wclog;
wistream& tcin = wcin;
#else
ostream& tcout = cout;
ostream& tcerr = cerr;
ostream& tclog = clog;
istream& tcin = cin;
#endif


// Dalle
GeneralRe: typedef vs #define Pin
toxcct13-Feb-06 0:29
toxcct13-Feb-06 0:29 
GeneralRe: typedef vs #define Pin
Anders Dalvander13-Feb-06 0:35
Anders Dalvander13-Feb-06 0:35 
GeneralRe: typedef vs #define Pin
toxcct13-Feb-06 0:38
toxcct13-Feb-06 0:38 
GeneralRe: typedef vs #define Pin
PJ Arends13-Feb-06 6:43
professionalPJ Arends13-Feb-06 6:43 
GeneralRe: typedef vs #define Pin
HasAName28-Feb-07 0:25
HasAName28-Feb-07 0:25 
GeneralSome Remarks Pin
Roland Pibinger12-Feb-06 0:59
Roland Pibinger12-Feb-06 0:59 
GeneralRe: Some Remarks Pin
PJ Arends12-Feb-06 6:33
professionalPJ Arends12-Feb-06 6:33 

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

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