TweetFollow Us on Twitter

Jul 98 Factory Floor

Volume Number: 14 (1998)
Issue Number: 7
Column Tag: From The Factory Floor

The New C++ Standard: Namespaces

by by Andreas Hommel, Howard Hinnant, and Dave Mark, ©1998 by Metrowerks, Inc., all rights reserved.

By the time you read this, the Final Draft International Standard for C++ should be finalized, approved, and made available for purchase (see last month's interview with Ron Liechty for specifics on where to go to get your copy). In this month's column, our old friend Andreas Hommel, along with new friend Howard Hinnant will tackle an important part of the new standard: C++ namespaces.

Andreas Hommel is currently the C/C++ front-end and 68K back-end architect at Metrowerks. After finishing his Master's degree in Computer Science, Andreas did some contract programming in the desktop publishing area and also published several games on the Macintosh and Amiga. He has been with Metrowerks for five years.

Andreas lives in a small country village about 20 kilometers north of Hamburg, with his wife, two Australian Shepherd dogs, two Arabian horses and one Quarter horse. When he is not coding, riding horses or walking his dogs, Andreas likes running, traveling, playing a good video game, and driving really fast on the Autobahn. He also likes cooking and fine red wines (California cabernets, in particular).

Howard Hinnant is a software engineer on the MSL team at Metrowerks, and is responsible for the C++ and EC++ libraries. Howard is a refugee from the aerospace industry where FORTRAN still rules. He has extensive experience in scientific computing including C++ implementations of linear algebra, finite difference and finite element solvers.

Dave: What are C++ namespaces?

Andreas: Namespaces are one of the newer ANSI C++ features. They allow a programmer to define new named or unnamed declarative regions. The original C++ (and ANSI C) only had one global namespace, but now it is possible to have many user defined namespaces.

For example:

namespace metro {
 int foo();
 int bar;
}

defines a namespace 'metro' and declares the namespace member function 'foo' and defines a namespace member variable 'bar'. You can define anything inside a namespace that can be defined in the global C++ namespace, even other nested namespaces. All these namespace members can then be used using qualified-ids.

For example:

int i = metro::foo() + metro::bar;

would call metro's member 'foo()'. So this is very similar to a C++ class definition. In fact we could have created something very similar using static class members:

class metro_class {
public:
 static int foo();
 static int bar;
};

int j = metro_class::foo() + metro_class::bar;

However, there are differences between a class and a namespace. You cannot create any instances of a namespace (ie a namespace variable or a pointer to a namespace) and all data and function namespace members behave like static class members (non-static namespace members wouldn't make any sense when you cannot have a namespace instance). So namespaces have more restrictions than classes. However, they have the advantage that you can split the definition of a namespace over several parts of one or more translation units (ie source and header files). So you can add new definitions later on.

For example

namespace metro {
 int baz();
}

adds the function 'baz' to our 'metro' namespace and this could be done in the same or any other source or header file.

Dave: So you have to use qualified-ids to access namespace members. Are there any mechanisms in C++ to simplify this?

Andreas: Yes, First, you don't have to use qualified-ids if you are accessing namespace members within the same or nested namespace. So you can do something like this:

namespace metro {
  int k = bar;  // no qualification necessary, uses metro::bar
}

or even:

int metro::baz()  // define metro::baz outside of namespace
{
  return foo();  // no qualification necessary, uses metro::foo
}

But, there are also language extensions that simplify the use of namespace members outside of the namespace. One is a 'using-declaration' that can be useful if you are using a particular namespace member over and over again. For example:

using metro::bar;  // using declaration
int m = bar;  // no qualification necessary, uses metro::bar

introduces metro's member bar to the current namespace which enables you to use metro::bar without any qualification.

The other major extension is called a 'using-directive' which will introduce all names defined in a namespace. For example:

using namespace metro;  // using-directive
int n = foo() + baz();  // no qualification necessary, uses 
                        // metro::foo and metro::baz

Dave: What is an unnamed namespace?

Andreas: An unnamed namespace like:

namespace { int o; }

behaves as if was replaced by:

namespace <unique> { }
using namespace <unique>;
namespace <unique> { int o; }

where <unique> is replaced with a translation unit specific identifier that is different from all other identifiers in a program. So it will be possible to access 'o' without any qualifications in the same translation unit:

void f() { o++; } // uses <unique>::o

but, not from any other translation unit. So this is very similar to:

static int o;
void f() { o++; }

The use of the 'static' keyword in namespace scope is actually deprecated in the current C++ draft.

Dave: Why would you want to use namespaces?

Andreas: Namespaces are very useful for libraries because they can be used to avoid name collisions. If you have a program that has a function 'foo' and you want to use a third party library that has a different function with the same name you would have to change your on program or the library to be able to use this library. If this library would have used its own namespace (e.g., 'metro' from the example above) you wouldn't have this problem. A good example for this is the std:: namespace that is used to implement the standard C++ library.

Dave: What did it take to get the libraries under namespace std?

Howard: Putting MSL (Metrowerks Standard Libraries) under namespace std took a lot more work than we had originally envisioned. There were many issues which needed sorting out, prioritizing, and dealing with within the time allowed. Without the aid of the entire MSL Team (headed by Vicki Scott) we would never have pulled it off so quickly. But it was more than just team work within the MSL Team that counted. Tight and rapid response between the MSL Team and the Compiler Team was crucial. There were many very subtle effects and interactions between the compiler's implementation of namespaces, and the library's use of namespaces. Andreas is great at getting to the heart of a problem, and providing a solution in an amazingly short amount of time.

Dave: What effect will namespaces have on legacy code?

Howard: Standard namespaces have quite a bit of backward compatibility built into them to ease the porting of namespace-ignorant code. We have implemented all of this compatibility, and where we thought was important, added even more backward compatibility.

Standard header names have become very particular, and very important. In previous releases, <iostream> and <iostream.h> were interchangeable. So were <cstdio> and <stdio.h>. This is no longer the case. As a general rule of thumb, namespace-ignorant code should use headers that end with the .h extension. If you use the extension-less headers, then your code should be "namespace std aware".

For example, the following HelloWorld will compile and run correctly:

#include <iostream.h>

int main()
{
 cout << "Hi\n";
}

But this will fail with a compiler error:

#include <iostream>

int main()
{
 cout << "Hi\n";
}

You can make the above HelloWorld work in one of two ways: You can provide a using declaration:

#include <iostream>

int main()
{
 using namespace std;
 cout << "Hi\n";
}

Or you can provide the full name of objects in the standard library:

#include <iostream>

int main()
{
 std::cout << "Hi\n";
}

The purpose of namespace std is to keep library names from conflicting with your own. With a name like cout, a conflict doesn't seem likely. But, consider the name vector or stack. Many users might want to use such names. Such users may even be unaware of their existence in the library. Now that these names are under a namespace, such conflicts are less likely.

Dave: Does namespace affect the C library?

Howard: The "C" library is also under namespace std when used from a C++ program. That is, printf's new name is std::printf. Remember, this is only when using the C++ compiler. C programs will continue to use just plain printf. Also note that if a C++ program includes <stdio.h> instead of <cstdio>, then printf is promoted to the global namespace. So again, just plain printf can be used.

 
AAPL
$531.70
Apple Inc.
+0.53
MSFT
$39.99
Microsoft Corpora
+0.05
GOOG
$534.81
Google Inc.
+6.19

MacTech Search:
Community Search:

Software Updates via MacUpdate

Viber 4.1.0 - Send messages and make cal...
Viber lets you send free messages and make free calls to other Viber users, on any device and network, in any country! Viber syncs your contacts, messages and call history with your mobile device,... Read more
Apple iOS 7.1.1 - The latest version of...
The latest version of iOS can be downloaded through iTunes. Apple iOS 7 brings an all-new design and all-new features. Simplicity Simplicity is often equated with minimalism. Yet true simplicity is... Read more
1Password 4.3 - Powerful password manage...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
Lens Blur 1.3.0 - True out-of-focus boke...
Let Lens Blur transform your existing photo into true SLR-quality out-of-focus bokeh effect! Everyone needs a gorgeous personalized background for a social profile, blog, Web/UI design, presentation... Read more
VMware Fusion 6.0.3 - Run Windows apps a...
VMware Fusion allows you to create a Virtual Machine on your Mac and run Windows (including Windows 8.1) and Windows software on your Mac. Run your favorite Windows applications alongside Mac... Read more
Tweetbot 1.5.1 - Popular iOS twitter cli...
Tweetbot is a full-featured OS X Twitter client with a lot of personality. Whether it's the meticulously-crafted interface, sounds and animation, or features like multiple timelines and column views... Read more
Mac DVDRipper Pro 4.1.7 - Copy, backup,...
Mac DVDRipper Pro is the DVD backup solution that lets you protect your DVDs from scratches, save your batteries by reading your movies from your hard disk, manage your collection with just a few... Read more
PDFpenPro 6.2 - Advanced PDF toolkit for...
PDFpenPro allows users to edit PDF's easily. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Create... Read more
PDFpen 6.2 - Edit and annotate PDFs with...
PDFpen allows users to easily edit PDF's. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Features... Read more
Monolingual 1.5.9 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. It requires a 64-bit capable Intel-based Mac and at least... Read more

Latest Forum Discussions

See All

Zeebox is Now Beamly TV – Still Offers t...
Zeebox is Now Beamly TV – Still Offers the Same Social Networking TV Fun, Plus a New Look Posted by Rob Rich on April 22nd, 2014 [ permalink ] | Read more »
Bandai Namco Unveils Upcoming Slate of M...
At their recent Global Gamers’ Day event, Bandai Namco was largely focused on their console and PC offerings for the upcoming year. However mobile still had a small presence, with some upcoming titles revealed by the company – though few were in a... | Read more »
The Story Behind Grammar Girl’s Grammar...
Learning is so much more rewarding when it’s also fun. That’s part of the reason why recent educational app, Grammar Pop HD, garnered such a positive review from us last week. The brainchild of Mignon Fogarty, otherwise known as Grammar Girl, we... | Read more »
Pinnacle Studio for iPhone Review
Pinnacle Studio for iPhone Review By Jennifer Allen on April 22nd, 2014 Our Rating: :: SIMPLY POWERFULiPhone App - Designed for the iPhone, compatible with the iPad Video editing while on the move has never been so convenient.   | Read more »
Taste Savant Review
Taste Savant Review By Jennifer Allen on April 22nd, 2014 Our Rating: :: TASTY RECOMMENDATIONSiPhone App - Designed for the iPhone, compatible with the iPad In need of some new restaurant recommendations? This app will be ideal,... | Read more »
Where’s My Water? Featuring XYY Adds Mor...
Where’s My Water? Featuring XYY Adds More Than Just Sheep to the Liquid Physics Puzzler Posted by Rob Rich on April 22nd, 2014 [ permalink ] | Read more »
FarmVille 2: Country Escape Review
FarmVille 2: Country Escape Review By Jennifer Allen on April 22nd, 2014 Our Rating: :: STEADY FARMINGUniversal App - Designed for iPhone and iPad FarmVille is bigger and brighter than ever before, but don’t expect it to sway you... | Read more »
Doctor Who: Legacy receives big update,...
Doctor Who: Legacy receives big update, adds Perk System and more Posted by Tre Lawrence on April 22nd, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Strongarm Universal Mount Hardware Revie...
Made by: Viatek Price: $14.99 for 2 Hardware/iOS Integration Rating: 3.5 out of 5 stars Usability Rating: 4 out of 5 stars Reuse Value Rating: 3.75 out of 5 stars Build Quality Rating: 3.5 out of 5 stars Overall Rating: 3.69 out of 5 stars | Read more »
Boxer Review
Boxer Review By Campbell Bird on April 21st, 2014 Our Rating: :: KO YOUR INBOXUniversal App - Designed for iPhone and iPad Turn your inbox into a task list or tune it to your own needs with this highly customizable, user friendly... | Read more »

Price Scanner via MacPrices.net

Everything You Wanted To Know And Probably Mo...
Macworld UK’s Lou Hattersley takes a look inside Apple’s A7 System On Chip (SoC) , noting that its processor module is much more powerful than other smartphone chipsets. He notes that the A7 was a... Read more
2.5GHz Mac mini, Apple refurbished, available...
The Apple Store has Apple Certified Refurbished 2.5GHz Mac minis available for $509, $90 off MSRP. Apple’s one-year warranty is included, and shipping is free. Read more
13-inch MacBook Pro, Apple refurbished, avail...
The Apple Store continues to offer Apple Certified Refurbished 13″ 2.5GHz MacBook Pros (4GB RAM/500GB HD) for $999 which is $200 off MSRP. Apple’s one-year warranty is included, and shipping is free. Read more
15-inch MacBook Pros (refurbished) available...
The Apple Store has Apple Certified Refurbished October 2013 15″ Retina MacBook Pros available starting at $1699, with models up to $400 off MSRP. Apple’s one-year warranty is standard, and shipping... Read more
$100 off cellular iPad minis plus free $20 gi...
Best Buy is discounting cellular iPad minis with Retina Displays by $100 on their online store for a limited time. They’ll also throw in a free $20 Best Buy gift card. Choose free shipping or free... Read more
Updated Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
Apple refurbished MacBook Airs available for...
The Apple Store has Apple Certified Refurbished 2013 MacBook Airs available for up to $200 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is free... Read more
Android Leads in Operating System Share Andro...
Consumer Intelligence Research Partners, LLC (CIRP) has released its latest results of its research on mobile phone operating systems for the calendar quarter that ended March 31, 2014. This analysis... Read more
Pelican Products, Inc. Introduces New Lineup...
Pelican Products, Inc., the global leader in the design and manufacture of high-performance protective cases, today announced the launch of a new line of rugged phone cases for both the Apple iPhone... Read more
SaveDrives – Car Dashboard Video Camera &...
Drivers who want to help reduce potential damage to their health and finances in the event of an accident can download the innovative new no-cost app SaveDrives – Car Dashboard Video Camera &... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Position Opening at *Apple* - Apple (United...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Inc. Research Data Specialist - Appl...
…of Worldwide Market Research & Intelligence. The team is responsible for conducting Apple branded consumer market research. It is also responsible for analyzing data Read more
*Apple* Automotive Parts Department position...
Apple Automotive is one of the fastest growing dealer…and it shows. Consider making the switch to the Apple Automotive Group today! At Apple Automotive, we Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.