X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFBaseLog.h;h=fbbb6d9edea59627291018df9a6b57beb4592426;hb=376b1791f5888970901326fa60f67431fa701a4d;hp=11f67115748496062469ccce558b0fc2d55937dc;hpb=1863c30d6f14733b76565358071507cc83dec8a3;p=platform%2Fframework%2Fnative%2Fappfw.git
diff --git a/inc/FBaseLog.h b/inc/FBaseLog.h
index 11f6711..fbbb6d9 100644
--- a/inc/FBaseLog.h
+++ b/inc/FBaseLog.h
@@ -1,5 +1,4 @@
//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
@@ -35,7 +34,7 @@ extern "C" {
/**
* @defgroup GroupMacros Debugging Macros
*
- * This page describes Tizen debugging macros.
+ * This page describes the Tizen debugging macros.
*
* @since 2.0
*/
@@ -71,13 +70,13 @@ extern "C" {
else {;}
#define AppAssert(condition) \
- if (!(condition)) { \
+ if (!(condition)) { \
AppassertInternal(__PRETTY_FUNCTION__, __LINE__); \
} \
else {;}
#define AppAssertf(condition, ...) \
- if (!(condition)) { \
+ if (!(condition)) { \
AppassertfInternal(# condition, __PRETTY_FUNCTION__, __LINE__, __VA_ARGS__); \
} \
else {;}
@@ -89,7 +88,7 @@ extern "C" {
* @{
*/
/**
- * This macro allows display of arbitrary messages for future examination.
+ * This macro allows the display of arbitrary messages for future examination.
*
* @since 2.0
*
@@ -188,7 +187,7 @@ extern "C" {
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to print, if the assertion fails
+ * @param[in] ... The message to print, if the assertion fails
*
* @image html debugging_appassert.png
*
@@ -220,7 +219,7 @@ extern "C" {
* @since 2.0
*
* @param[in] expression The expression to evaluate
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the AppLogIf macro.
*
@@ -244,7 +243,7 @@ extern "C" {
* @since 2.0
*
* @param[in] expression The expression to evaluate
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the AppLogDebugIf macro.
*
@@ -268,7 +267,7 @@ extern "C" {
* @since 2.0
*
* @param[in] expression The expression to evaluate
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the AppLogExceptionIf macro.
*
@@ -389,8 +388,8 @@ extern "C" {
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the Try macro.
*
@@ -419,7 +418,7 @@ extern "C" {
* @hideinitializer
*/
#define TryCatch(condition, expr, ...) \
- if (!(condition)) { \
+ if (!(condition)) { \
AppLogException(__VA_ARGS__); \
expr; \
goto CATCH; \
@@ -433,9 +432,9 @@ extern "C" {
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryCatchResult(condition, expr, r, ...) \
@@ -449,15 +448,15 @@ extern "C" {
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
-* @param[in] expr Expressions that are evaluated before going to catchLabel
-* @param[in] catchLabel The label for goto operation
-* @param[in] r The last result to set
-* @param[in] ... The message to display
+* @param[in] expr Expressions that are evaluated before going to the CATCH label
+* @param[in] catchLabel The label for the goto operation
+* @param[in] r The last result to set
+* @param[in] ... The message to display
* @hideinitializer
*/
#define TryCatchLabelResult(condition, expr, catchLabel, r, ...) \
@@ -470,13 +469,13 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed and a value is returned.
+ * If the condition is @c false, a message is printed and a value is returned.
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturn(condition, returnValue, ...) \
@@ -487,14 +486,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and a value is returned.
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnResult(condition, returnValue, r, ...) \
@@ -506,11 +505,11 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
*
* @since 2.0
*
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
@@ -524,12 +523,12 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed and no value is returned.
+ * If the condition is @c false, a message is printed and no value is returned.
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnVoid(condition, ...) \
@@ -540,12 +539,12 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed.
+ * If the condition is @c false, a message is printed.
*
* @since 2.0
*
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryLog(condition, ...) \
@@ -555,13 +554,13 @@ extern "C" {
else {;}
/**
-* If the condition is @c false, the informative log message is printed and a value is returned.
+* If the condition is @c false, an informative log message is printed and a value is returned.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
-* @param[in] ... The message to display
+* @param[in] ... The message to display
* @hideinitializer
*/
#define TryLogReturn(condition, returnValue, ...) \
@@ -579,10 +578,10 @@ extern "C" {
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryCatchTag(tag, condition, expr, ...) \
@@ -599,11 +598,11 @@ extern "C" {
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryCatchResultTag(tag, condition, expr, r, ...) \
@@ -617,16 +616,16 @@ extern "C" {
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
-* and goes to label.
+* and goes to the catch label.
*
* @since 2.1
*
-* @param[in] tag Used to identify the source of a log message
+* @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
-* @param[in] expr Expressions that are evaluated before going to catchLabel
-* @param[in] catchLabel The label for goto operation
-* @param[in] r The last result to set
-* @param[in] ... The message to display
+* @param[in] expr Expressions that are evaluated before going to the CATCH label
+* @param[in] catchLabel The label for the goto operation
+* @param[in] r The last result to set
+* @param[in] ... The message to display
* @hideinitializer
*/
#define TryCatchLabelResultTag(tag, condition, expr, catchLabel, r, ...) \
@@ -639,14 +638,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnTag(tag, condition, returnValue, ...) \
@@ -657,15 +656,15 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and returns a value.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnResultTag(tag, condition, returnValue, r, ...) \
@@ -677,14 +676,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
+ * If the condition is @c false, it prints a message with a tag, sets the last result and does not return any value.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnVoidResultTag(tag, condition, r, ...) \
@@ -696,13 +695,13 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define TryReturnVoidTag(tag, condition, ...) \
@@ -713,12 +712,12 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag.
+ * If the condition is @c false, a message is printed with a tag.
*
* @since 2.0
*
- * @param[in] tag Used to identify the source of a log message
- * @param[in] condition The condition that is expected to be true
+ * @param[in] tag Used to identify the source of the log message
+ * @param[in] condition The condition that is expected to be true
* @param[in] ... The message to display
* @hideinitializer
*/
@@ -729,14 +728,14 @@ extern "C" {
else {;}
/**
-* If the condition is @c false, the informative log message is printed with a tag and a value is returned.
+* If the condition is @c false, an informative log message is printed with a tag and a value is returned.
*
* @since 2.1
*
-* @param[in] tag Used to identify the source of a log message
+* @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
-* @param[in] ... The message to display
+* @param[in] ... The message to display
* @hideinitializer
*/
#define TryLogReturnTag(tag, condition, returnValue, ...) \
@@ -758,19 +757,19 @@ extern "C" {
#if (defined(_APP_LOG) || defined(_OSP_DEBUG_) || defined(_DEBUG)) && defined(_SECURE_LOG)
-#define AppSecureLog(...) AppLogInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
+#define AppSecureLog(...) AppLogInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
#define AppSecureLogDebug(...) AppLogDebugInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
#define AppSecureLogException(...) AppLogExceptionInternal(__PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
-#define AppSecureLogTag(tag, ...) AppLogTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
+#define AppSecureLogTag(tag, ...) AppLogTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
#define AppSecureLogDebugTag(tag, ...) AppLogDebugTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
#define AppSecureLogExceptionTag(tag, ...) AppLogExceptionTagInternal(tag, __PRETTY_FUNCTION__, __LINE__, "[SECURE_LOG] "__VA_ARGS__)
#else
/**
- * This macro is to protect informative log messages which needs to keep security.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
@@ -792,9 +791,9 @@ extern "C" {
#define AppSecureLog(...)
/**
- * This macro is to protect debug log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
@@ -823,13 +822,13 @@ extern "C" {
#define AppSecureLogDebug(...)
/**
- * This macro is to protect exception log messages which needs to keep security.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the AppSecureLogException macro.
*
@@ -854,9 +853,9 @@ extern "C" {
#define AppSecureLogException(...)
/**
- * This macro is to protect informative log messages which needs to keep security, with a tag.
- * It allows display of informative log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect informative log messages which need security, with a tag.
+ * It allows the display of informative log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
@@ -879,9 +878,9 @@ extern "C" {
#define AppSecureLogTag(tag, ...)
/**
- * This macro is to protect debug log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect debug log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
@@ -894,7 +893,7 @@ extern "C" {
* bool
* MyEngine::Init(int value)
* {
- * AppSecureLogExceptionTag("MyTag", "User ID : 'JoneDoe' mismatch.");
+ * AppSecureLogDebugTag("MyTag", "User ID : 'JoneDoe' mismatch.");
*
* return true;
* }
@@ -904,9 +903,9 @@ extern "C" {
#define AppSecureLogDebugTag(tag, ...)
/**
- * This macro is to protect exception log messages which needs to keep security, with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, it will be removed in the compile time.
+ * This macro is used to protect exception log messages which need security, with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, it is removed in the compile time.
*
* @since 2.1
*
@@ -919,7 +918,7 @@ extern "C" {
* bool
* MyEngine::Init(int value)
* {
- * AppSecureLogDebugTag("MyTag", "User ID : 'JoneDoe' mismatch.");
+ * AppSecureLogExceptionTag("MyTag", "User ID : 'JoneDoe' mismatch.");
*
* return true;
* }
@@ -933,14 +932,14 @@ extern "C" {
/**
* If the condition is @c false, it prints a message, evaluates a cleanup expression,
* and goes to CATCH.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] ... The message to display
*
* The following example demonstrates how to use the SecureTry macro.
*
@@ -980,15 +979,15 @@ extern "C" {
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
* and goes to CATCH.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryCatchResult(condition, expr, r, ...) \
@@ -1002,16 +1001,16 @@ extern "C" {
/**
* If the condition is @c false, it prints a message, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel
- * @param[in] catchLabel The label for goto operation
- * @param[in] r The last result to set
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
+ * @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
*/
@@ -1025,15 +1024,15 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturn(condition, returnValue, ...) \
@@ -1044,16 +1043,16 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, it prints a message, sets the last result and returns a value.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnResult(condition, returnValue, r, ...) \
@@ -1065,15 +1064,15 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnVoidResult(condition, r, ...) \
@@ -1085,14 +1084,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnVoid(condition, ...) \
@@ -1103,14 +1102,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryLog(condition, ...) \
@@ -1120,15 +1119,15 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the informative log message is printed and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] condition The condition that is expected to be true
+ * @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryLogReturn(condition, returnValue, ...) \
@@ -1143,15 +1142,15 @@ extern "C" {
/**
* If the condition is @c false, it prints a message with a tag, evaluates a cleanup expression
* and goes to CATCH.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryCatchTag(tag, condition, expr, ...) \
@@ -1165,16 +1164,16 @@ extern "C" {
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression,
* and goes to CATCH.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to CATCH label
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryCatchResultTag(tag, condition, expr, r, ...) \
@@ -1188,17 +1187,17 @@ extern "C" {
/**
* If the condition is @c false, it prints a message with a tag, sets the last result, evaluates a cleanup expression
- * and goes to label.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * and goes to the catch label.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] expr Expressions that are evaluated before going to catchLabel
- * @param[in] catchLabel The label for goto operation
- * @param[in] r The last result to set
+ * @param[in] expr Expressions that are evaluated before going to the CATCH label
+ * @param[in] catchLabel The label for the goto operation
+ * @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
*/
@@ -1212,16 +1211,16 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnTag(tag, condition, returnValue, ...) \
@@ -1232,17 +1231,17 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] r The last result to set
- * @param[in] ... The message to display
+ * @param[in] r The last result to set
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnResultTag(tag, condition, returnValue, r, ...) \
@@ -1254,14 +1253,14 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag, sets the last result and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag, the last result is set and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
- * @param[in] condition The condition that is expected to be true
+ * @param[in] tag Used to identify the source of the log message
+ * @param[in] condition The condition that is expected to be true
* @param[in] r The last result to set
* @param[in] ... The message to display
* @hideinitializer
@@ -1275,15 +1274,15 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag and no value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag and no value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryReturnVoidTag(tag, condition, ...) \
@@ -1294,34 +1293,34 @@ extern "C" {
else {;}
/**
- * If the condition is @c false, the message is printed with a tag.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, a message is printed with a tag.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
+ * @param[in] tag Used to identify the source of the log message
* @param[in] condition The condition that is expected to be true
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryLogTag(tag, condition, ...) \
- if (!(condition)) { \
+ if (!(condition)) { \
AppSecureLogTag(tag, __VA_ARGS__); \
} \
else {;}
/**
- * If the condition is @c false, the informative log message is printed with a tag and a value is returned.
- * It allows display of exception log messages if compiled with "_SECURE_LOG" definition.
- * Otherwise, log printing functionality will be removed in the compile time.
+ * If the condition is @c false, an informative log message is printed with a tag and a value is returned.
+ * It allows the display of exception log messages if compiled with the "_SECURE_LOG" definition.
+ * Otherwise, the log printing functionality is removed in the compile time.
*
* @since 2.1
*
- * @param[in] tag Used to identify the source of a log message
- * @param[in] condition The condition that is expected to be true
+ * @param[in] tag Used to identify the source of the log message
+ * @param[in] condition The condition that is expected to be true
* @param[in] returnValue The value to return when the condition is @c false
- * @param[in] ... The message to display
+ * @param[in] ... The message to display
* @hideinitializer
*/
#define SecureTryLogReturnTag(tag, condition, returnValue, ...) \