Files | |
file | deprecated.h |
NS_DEPRECATED macro definition. | |
Macros | |
#define | NS_DEPRECATED(msg) |
Mark a function as deprecated. | |
#define | NS_DEPRECATED_3_40(msg) |
Tag for things deprecated in version ns-3.40. | |
#define | NS_DEPRECATED_3_41(msg) |
Tag for things deprecated in version ns-3.41. | |
#define | NS_DEPRECATED_3_42(msg) |
Tag for things deprecated in version ns-3.42. | |
#define | NS_DEPRECATED_3_43(msg) |
Tag for things deprecated in version ns-3.43. | |
#define | NS_DEPRECATED_3_44(msg) |
Tag for things deprecated in version ns-3.44. | |
#define | NS_DEPRECATED_3_45(msg) |
Tag for things deprecated in version ns-3.45. | |
#define NS_DEPRECATED | ( | msg | ) |
Mark a function as deprecated.
Users should expect deprecated features to be removed eventually.
When deprecating a feature, please update the documentation with information for users on how to update their code.
The following snippet shows an example of how to deprecate the function SomethingUseful() in favor of the new function TheNewWay(). Note: in the following snippet, the Doxygen blocks are not following the ns-3 style. This allows the code to be safely embedded in the documentation.
Please follow these two guidelines to ease future maintenance (primarily the eventual removal of the deprecated code):
NS_DEPRECATED_3_XX
, not the generic NS_DEPRECATED
.Typically only the declaration needs to be deprecated,
but it's helpful to put the same macro as a comment at the site of the definition, to make it easier to find all the bits which eventually have to be removed:
msg | Optional message to add to the compiler warning. |
Definition at line 84 of file deprecated.h.
#define NS_DEPRECATED_3_40 | ( | msg | ) |
Tag for things deprecated in version ns-3.40.
Definition at line 126 of file deprecated.h.
#define NS_DEPRECATED_3_41 | ( | msg | ) |
Tag for things deprecated in version ns-3.41.
Definition at line 119 of file deprecated.h.
Referenced by ns3::Ipv4L3Protocol::::Ipv4L3ProtocolTestCase, and ns3::Ipv4::GetWeakEsModel().
#define NS_DEPRECATED_3_42 | ( | msg | ) |
Tag for things deprecated in version ns-3.42.
Definition at line 112 of file deprecated.h.
#define NS_DEPRECATED_3_43 | ( | msg | ) |
Tag for things deprecated in version ns-3.43.
Definition at line 105 of file deprecated.h.
#define NS_DEPRECATED_3_44 | ( | msg | ) |
Tag for things deprecated in version ns-3.44.
Definition at line 98 of file deprecated.h.
#define NS_DEPRECATED_3_45 | ( | msg | ) |
Tag for things deprecated in version ns-3.45.
Definition at line 91 of file deprecated.h.