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.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Slack 3.0.5 - Collaborative communicatio...
Slack is a collaborative communication app that simplifies real-time messaging, archiving, and search for modern working teams. Version 3.0.5: Bug Fixes: An important security update. Security... Read more
VirtualBox 5.2.6 - x86 virtualization so...
VirtualBox is a family of powerful x86 virtualization products for enterprise as well as home use. Not only is VirtualBox an extremely feature rich, high performance product for enterprise customers... Read more
Espresso 5.1 - Powerful HTML, XML, CSS,...
Note from the developer: For the new Espresso, we changed our versioning and licensing approach with more consistent pricing and a simpler development timeline: "X+1". Each new update would increase... Read more
MacFamilyTree 8.2.7 - Create and explore...
MacFamilyTree gives genealogy a facelift: modern, interactive, convenient and fast. Explore your family tree and your family history in a way generations of chroniclers before you would have loved.... Read more
VueScan 9.6.04 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
WhatsApp 0.2.8000 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
Vivaldi 1.13.1008.40 - An advanced brows...
Vivaldi is a browser for our friends. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind... Read more
TotalFinder 1.10.7 - Adds tabs, hotkeys,...
TotalFinder is a universally acclaimed navigational companion for your Mac. Enhance your Mac's Finder with features so smart and convenient, you won't believe you ever lived without them. Features... Read more
Box Sync 4.0.7886 - Online synchronizati...
Box Sync gives you a hard-drive in the Cloud for online storage. Note: You must first sign up to use Box. What if the files you need are on your laptop -- but you're on the road with your iPhone? No... Read more
iExplorer 4.1.14 - View and transfer fil...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more

Latest Forum Discussions

See All

Tako Bubble guide - Tips and Tricks to S...
Tako Bubble is a pretty simple and fun puzzler, but the game can get downright devious with its puzzle design. If you insist on not paying for the game and want to manage your lives appropriately, check out these tips so you can avoid getting... | Read more »
Everything about Hero Academy 2 - The co...
It's fair to say we've spent a good deal of time on Hero Academy 2. So much so, that we think we're probably in a really good place to give you some advice about how to get the most out of the game. And in this guide, that's exactly what you're... | Read more »
Everything about Hero Academy 2: Part 3...
In the third part of our Hero Academy 2 guide we're going to take a look at the different modes you can play in the game. We'll explain what you need to do in each of them, and tell you why it's important that you do. [Read more] | Read more »
Everything about Hero Academy 2: Part 2...
In this second part of our guide to Hero Academy 2, we're going to have a look at the different card types that you're going to be using in the game. We'll split them up into different sections too, to make sure you're getting the most information... | Read more »
Everything about Hero Academy 2: Part 1...
So you've started playing Hero Academy 2, and you're feeling a little bit lost. Don't worry, we've got your back. So we've come up with a series of guides that are going to help you get to grips with everything that's going on in the game. [Read... | Read more »
What mobile gaming can learn from the Ni...
While Nintendo might not have had things all its own way since it began developing for mobile, one thing it has got right is the release of the Switch. After the disappointment of the WiiU, which I still can't really explain, the Switch felt a... | Read more »
Programmer of Sonic The Hedgehog launche...
Japanese programmer Yuji Naka is best known for leading the team that created the original Sonic The Hedgehog. He’s moved on from the speedy blue hero since then, launching his own company based in Tokyo – Prope Games. Legend of Coin is the... | Read more »
Why doesn't mobile gaming have its...
The Overwatch League is a pretty big deal. It's an attempt to really push eSports into the mainstream, by turning them into, well, regular sports. But slightly less sweaty. It's a lavish affair with teams from all around the world, and more... | Read more »
Give Webzen’s new billiard game PoolTime...
Best known for producing hugely popular MMO titles, South Korean publisher Webzen is now taking aim at a different genre altogether. PoolTime is a realistic eight ball pool simulator, allowing you to compete in real-time matches against players... | Read more »
Let Them Come Guide - How to survive aga...
Let Them Come is all about making it as far as possible against overwhelming odds. Check out some of these tips to help you last a little longer in your unwinnable fight: [Read more] | Read more »

Price Scanner via MacPrices.net

9.7-inch 2017 WiFi iPads on sale starting at...
B&H Photo has 9.7″ 2017 WiFi #Apple #iPads on sale for $30 off MSRP for a limited time. Shipping is free, and pay sales tax in NY & NJ only: – 32GB iPad WiFi: $299, $30 off – 128GB iPad WiFi... Read more
Wednesday deal: 13″ MacBook Pros for $100-$15...
B&H Photo has 13″ #Apple #MacBook Pros on sale for up to $100-$150 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 13-inch 2.3GHz/128GB Space Gray... Read more
Apple now offering Certified Refurbished 2017...
Apple has Certified Refurbished 9.7″ WiFi iPads available for $50-$80 off the cost of new models. An Apple one-year warranty is included with each iPad, and shipping is free: – 9″ 32GB WiFi iPad: $... Read more
10″ iPad Pros on sale for $50-$75 off MSRP, n...
B&H Photo has 10″ and #Apple #iPad Pros on sale for up to $75 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only. Note that some sale prices are restricted to certain... Read more
Apple refurbished Mac minis available startin...
Apple has restocked Certified Refurbished Mac minis starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: – 1.4GHz Mac mini: $419 $80 off MSRP – 2.6GHz Mac... Read more
Amazon offers Silver 13″ Apple MacBook Pros f...
Amazon has new Silver 2017 13″ #Apple #MacBook Pros on sale today for up to $150 off MSRP, each including free shipping: – 13″ 2.3GHz/128GB Silver MacBook Pro (MPXR2LL/A): $1199.99 $100 off MSRP – 13... Read more
Sale: 12″ 1.3GHz MacBooks on sale for $1499,...
B&H Photo has Space Gray and Rose Gold 12″ 1.3GHz #Apple MacBooks on sale for $100 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 12″ 1.3GHz Space... Read more
Apple offers Certified Refurbished 2017 iMacs...
Apple has a full line of Certified Refurbished iMacs available for up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: – 27... Read more
13″ MacBook Airs on sale for $120-$100 off MS...
B&H Photo has 2017 13″ 128GB MacBook Airs on sale for $120 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 13″ 1.8GHz/128GB MacBook Air (MQD32LL/A): $... Read more
15″ Touch Bar MacBook Pros on sale for up to...
Adorama has Space Gray 15″ MacBook Pros on sale for $200 off MSRP. Shipping is free, and Adorama charges sales tax in NJ and NY only: – 15″ 2.8GHz MacBook Pro Space Gray (MPTR2LL/A): $2199, $200 off... Read more

Jobs Board

*Apple* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 113384559 Brandon, Florida, United States Posted: 10-Jan-2018 Weekly Hours: 40.00 **Job Summary** Are you passionate about Read more
Art Director, *Apple* Music + Beats1 Market...
# Art Director, Apple Music + Beats1 Marketing Design Job Number: 113258081 Santa Clara Valley, California, United States Posted: 05-Jan-2018 Weekly Hours: 40.00 Read more
*Apple* Pay & Wallet Engineering Manager...
# Apple Pay & Wallet Engineering Manager, Apple Watch Job Number: 83769531 Santa Clara Valley, California, United States Posted: 06-Nov-2017 Weekly Hours: 40.00 Read more
UI Tools and Automation Engineer, *Apple* M...
# UI Tools and Automation Engineer, Apple Media Products Job Number: 113136387 Santa Clara Valley, California, United States Posted: 11-Jan-2018 Weekly Hours: 40.00 Read more
Senior Product Architect, *Apple* Pay - App...
# Senior Product Architect, Apple Pay Job Number: 58046427 Santa Clara Valley, California, United States Posted: 04-Jan-2018 Weekly Hours: **Job Summary** Apple , Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.