FreeAndNullMessageOnError macro

Frees a given message buffer if a given `Error` indicates an error and sets the `aMessage` to `nullptr`.

Syntax

Show:

Summary

Declaration

from message.hpp:131

#define FreeAndNullMessageOnError(aMessage, aError) \ do \ { \ if (((aError) != kErrorNone) && ((aMessage) != nullptr)) \ { \ (aMessage)->Free(); \ (aMessage) = nullptr; \ } \ } while (false)

Arguments

Argument

Description

aMessage

A pointer to a `Message` to free (can be `nullptr`).

aError

The `Error` to check.

References

Code

Location

#define FreeAndNullMessageOnError(aMessage, aError) \

message.hpp:131

FreeAndNullMessageOnError(aMessage, error);

coap.cpp:149

FreeAndNullMessageOnError(aMessage, error);

coap.cpp:163

FreeAndNullMessageOnError(messageCopy, error);

coap.cpp:557

FreeAndNullMessageOnError(response, error);

dataset_manager.cpp:610

FreeAndNullMessageOnError(aQuery, error);

dns_client.cpp:1052

FreeAndNullMessageOnError(message, error);

joiner_router.cpp:305

FreeAndNullMessageOnError(messageCopy, error);

message.cpp:795

FreeAndNullMessageOnError(message, error);

mle.cpp:4454

FreeAndNullMessageOnError(response, error);

network_data_leader.cpp:611

FreeAndNullMessageOnError macro

Syntax

Arguments

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle