{"id":1071,"date":"2014-11-30T13:06:03","date_gmt":"2014-11-30T13:06:03","guid":{"rendered":"http:\/\/www.codergears.com\/Blog\/?p=1071"},"modified":"2014-11-30T13:56:55","modified_gmt":"2014-11-30T13:56:55","slug":"common-reasons-of-using-namespaces-in-c-projects","status":"publish","type":"post","link":"https:\/\/codergears.com\/Blog\/?p=1071","title":{"rendered":"Common reasons of using namespaces in C++ projects"},"content":{"rendered":"

Namespaces were introduced to the C++ Standard in 1995\u00a0and usually they are defined like this:<\/span><\/p>\n

A namespace defines a new scope. They provide a way to avoid name collisions.<\/p><\/blockquote>\n

Namespaces in C++ are most often used to avoid\u00a0<\/span>naming collisions. Although namespaces are used extensively in recent C++ code, most older code does not use this facility.\u00a0<\/span><\/p>\n

After exploring the source code of many C++ projects, here are some common reasons of using the namespaces in these projects.<\/p>\n

1- Avoid\u00a0name collisions.<\/strong><\/p>\n

As speicified before it’s the common reason, in this case their use are\u00a0just useful for the compiler, no added value for the developer to make the code more readable and maintanable.<\/p>\n

2- Modularize the application<\/strong><\/p>\n

Modern C++ librarires use extensively the namespaces to modalirize their code base, and they use the \u00a0“Namespace-by-feature” approach.\u00a0Namespace-by-feature uses namespaces\u00a0to reflect the feature set. It places all items related to a single feature (and only that feature) into a single namespace. This results in namespaces\u00a0with high cohesion and high modularity, and with minimal coupling between namespaces. Items that work closely together are placed next to each other.<\/p>\n

Boost is the best example of grouping by feature, it contains thousands of namespaces, each one is used to group a specific feature.<\/p>\n

3- Anonymous namespace.<\/strong><\/p>\n

Namespace with no name avoids making global static variable. The \u201canonymous\u201d namespace you have created will only be accessible within the file you created it in.<\/span><\/p>\n

4- workarround of the enum issue.<\/strong><\/p>\n

\u201cTraditional\u201d enums in C++ export their enumerators in the surrounding scope ,which can lead to name collisions, if two different enums in the same have scope define enumerators with the same name,<\/span><\/p>\n

In a large project, you would not be guaranteed that two distinct enums don\u2019t both called with the same name. This issue was resolved in C++11, using\u00a0\u00a0<\/span>enum class<\/strong>\u00a0which will implicitly scope the enum values within the enum\u2019s name.\u00a0<\/span><\/p>\n

Many years ago the trick of declaring an enum inside a namespace is used, for example instead of declaring an enum like this<\/p>\n

enum<\/span> status<\/span>{<\/span>\r\n  status_ok<\/span>,<\/span>\r\n  status_error\r\n<\/span>};<\/span><\/code><\/pre>\n
it’s declared inside an namespace:<\/p>\n
namespace<\/span> status<\/span>{\r\n<\/span>       enum<\/span> status<\/span>{<\/span>\r\n         ok<\/span>,<\/span>\r\n          error\r\n  <\/span>};\r\n<\/span>}<\/span><\/code><\/pre>\n
Many C++ projects use this trick, for example the Unreal Engine source code use widely this technique.<\/p>\n
5- Hiding details by convention<\/strong><\/p>\n
For templated libraries where the code is implemented in header files, it’s\u00a0interesting to find a way to inform the library user that he dont need to use directly some specific types because they concern only the implementation.\u00a0In\u00a0C# the \u201cinternal\u201d keyword did the job, but in C++ there\u2019s no way to hide public types to the library user.<\/span><\/p>\n
A common idiom in modern C++, pioneered by the developers of the Boost libraries, is to separate symbols that form part of the implementation of your module (that is, don\u2019t form part of the public API) but that have to be publicly available into a separate sub-namespace, by convention named detail.<\/p>\n
For example in the boost::math documentation, it’s specified that:<\/p>\n
Functions not intended for use by applications are in\u00a0<\/span>boost<\/span>::<\/span>math<\/span>::<\/span>detail<\/span><\/code>.<\/span><\/p><\/blockquote>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Namespaces were introduced to the C++ Standard in 1995\u00a0and usually they are defined like this: A namespace defines a new scope. They provide a way to avoid name collisions. Namespaces in C++ are most often used to avoid\u00a0naming collisions. Although namespaces are used extensively in recent C++ code, most older code does not use this … Continue reading “Common reasons of using  namespaces in C++ projects”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-1071","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/posts\/1071","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1071"}],"version-history":[{"count":14,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/posts\/1071\/revisions"}],"predecessor-version":[{"id":1086,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=\/wp\/v2\/posts\/1071\/revisions\/1086"}],"wp:attachment":[{"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1071"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1071"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codergears.com\/Blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1071"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}