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

Ember 1.8.3 - Versatile digital scrapboo...
Ember (formerly LittleSnapper) is your digital scrapbook of things that inspire you: websites, photos, apps or other things. Just drag in images that you want to keep, organize them into relevant... Read more
Apple iTunes 12.1 - Manage your music, m...
Apple iTunes lets you organize and play digital music and video on your computer. It can automatically download new music, app, and book purchases across all your devices and computers. And it's a... Read more
LibreOffice 4.4.3 - Free, open-source of...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
FoldersSynchronizer 4.2.1 - Synchronize...
FoldersSynchronizer is a popular and useful utility that synchronizes and backs-up files, folders, disks and boot disks. On each session you can apply special options like Timers, Multiple Folders,... Read more
Simon 4.0.2 - Monitor changes and crashe...
Simon monitors websites and alerts you of crashes and changes. Select pages to monitor, choose your alert options, and customize your settings. Simon does the rest. Keep a watchful eye on your... Read more
Cocktail 8.1.2 - General maintenance and...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Cyberduck 4.6.4 - FTP and SFTP browser....
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Herald 5.0.2 - Notification plugin for M...
Note: Versions 2.1.3 (for OS X 10.7), 3.0.6 (for OS X 10.8), and 4.0.8 (for OS X 10.9) are no longer supported by the developer. Herald is a notification plugin for Mail.app, Apple's Mac OS X email... Read more
DEVONthink Pro 2.8.3 - Knowledge base, i...
Save 10% with our exclusive coupon code: MACUPDATE10 DEVONthink Pro is your essential assistant for today's world, where almost everything is digital. From shopping receipts to important research... Read more
Boom 2 1.0.1 - System-wide pro audio app...
Boom 2 is a system-wide volume booster and equalizer app that is designed especially for OS X 10.10 Yosemite. It comes with a smart interface, self-calibrates itself according to your Mac, offers... Read more

Playworld Superheroes Review
Playworld Superheroes Review By Tre Lawrence on January 30th, 2015 Our Rating: :: HERO CRAFTINGUniversal App - Designed for iPhone and iPad It’s all about the imagination, fighting bad creatures — and looking good while doing so.   | Read more »
Join the SpongeBob Bubble Party in this...
Join the SpongeBob Bubble Party in this New Match 3 Bubble Poppin’ Frenzy Posted by Jessica Fisher on January 30th, 2015 [ permalink ] | Read more »
Handpick Review
Handpick Review By Jennifer Allen on January 30th, 2015 Our Rating: :: TANTALIZING SUGGESTIONSiPhone App - Designed for the iPhone, compatible with the iPad Handpick will make you hungry, as well as inspire you to cook something... | Read more »
Storm the Halls of Echo Base in First St...
Storm the Halls of Echo Base in First Star Wars: Galactic Defense Event Posted by Jessica Fisher on January 30th, 2015 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Contradiction Review
Contradiction Review By Tre Lawrence on January 30th, 2015 Our Rating: :: SPOT THE LIEiPad Only App - Designed for the iPad Contradiction is a live action point and click adventure that’s pretty engaging.   Developer: Tim Follin... | Read more »
Unlock Sunshine Girl in Ironkill with th...
Unlock Sunshine Girl in Ironkill with this special 148Apps code Posted by Rob Rich on January 29th, 2015 [ permalink ] Robo-fighter Ironkill has been out on iOS a | Read more »
Crossroad Zombies Review
Crossroad Zombies Review By Jordan Minor on January 29th, 2015 Our Rating: :: CROSSWALKING DEADiPad Only App - Designed for the iPad Crossroad Zombies is a rough draft of a cool genre mash-up.   | Read more »
Blood Brothers 2 – Tips, Cheats, and Str...
War is hell: Is it the kind of hell you want to check out? Read our Blood Brothers 2 review to find out! Blood Brothers 2, DeNA’s follow-up to the original Blood Brothers, is an intriguing card collecting / role-playing / strategy hybrid. There’s... | Read more »
Blood Brothers 2 Review
Blood Brothers 2 Review By Nadia Oxford on January 29th, 2015 Our Rating: :: AN AGGRAVATING RELATIVEUniversal App - Designed for iPhone and iPad Blood Brothers 2 is built on a simple, solid foundation, but its free-to-play system... | Read more »
I AM BREAD, the Toast of the Town, is Ro...
Have you ever dreamt of being deliciously gluten-y? Do you feel passionate about Rye and Wheat? The guys at Bossa Studios do and that is why they are bringing I AM BREAD to iOS soon. The loafy app will feature all the new content that is being... | Read more »

Price Scanner via MacPrices.net

Apple Becomes World’s Largest Smartphone Vend...
According to the latest research data from Strategy Analytics, as global smartphone shipments grew 31 percent annually to reach a record 380 million units in the fourth quarter of 2014. Apple became... Read more
Cut the Cord: OtterBox Resurgence Power Case...
Dead batteries and broken phones are two of the biggest issues for smartphone users today. Otterbox addresses both with the new Resurgence Power Case for Apple iPhone 6, promising to make those panic... Read more
13-inch Retina MacBook Pros on sale for up to...
B&H Photo has 13″ Retina MacBook Pros on sale for $200 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.6GHz/128GB Retina MacBook Pro: $1199.99 save $100 - 13″ 2.6GHz/... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
 B&H Photo has the 15″ 2.5GHz Retina MacBook Pro on sale for $2319.99 including free shipping plus NY sales tax only. Their price is $180 off MSRP, and it’s the lowest price available for this... Read more
Back in stock: Refurbished iPod nanos for $99...
The Apple Store has Apple Certified Refurbished 16GB iPod nanos available for $99 including free shipping and Apple’s standard one-year warranty. That’s $50 off the cost of new nanos. Most colors are... Read more
Apple lowers price on refurbished 256GB MacBo...
The Apple Store has lowered prices on Apple Certified Refurbished 2014 MacBook Airs with 256GB SSDs, now available for up to $200 off the cost of new models. An Apple one-year warranty is included... Read more
New Good Management Suite Simplifies Enterpri...
Good Technology has announced the availability of the Good Management Suite, a comprehensive cross-platform solution for organizations getting started with mobile business initiatives. Built on the... Read more
15-inch 2.0GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished previous-generation 15″ 2.0GHz Retina MacBook Pros available for $1489 including free shipping plus Apple’s standard one-year warranty. Their price is... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
Amazon has the 15″ 2.5GHz Retina MacBook Pro on sale for $2319.99 including free shipping. Their price is $180 off MSRP, and it’s the lowest price available for this model from any reseller. Read more
iPad Turns Five – The ”Book Mystique
Five years ago this week, the late Steve Jobs took the stage at an Apple special press event to unveil the first Apple iPad — a slab-shaped, hand-holdable device that was to shake the personal... Read more

Jobs Board

At-Home Chat Specialist- *Apple* Online Stor...
**Job Summary** At Apple , we believe in hard work, a fun environment, and the kind of creativity and innovation that only comes about when talented people from diverse Read more
SW QA Engineer - *Apple* TV - Apple (United...
**Job Summary** The Apple TV team is looking for experienced Quality Assurance Engineers with a passion for delivering first in class home entertainment solutions. **Key Read more
*Apple* Retail - Multiple Positions(US) - Ap...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you re also the Read more
*Apple* Systems Engineer - Pre Sales, Educat...
…is responsible for proactively providing technical expertise to drive sales of Apple solutions into assigned accounts. The SE architects, validates, and assists in Read more
*Apple* Solutions Consultant - Retail Sales...
As an ambassador of the Apple brand, the ASC is accountable for driving sales performance by: Connecting with customers. Discovering customers' needs and values. Showing Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.