az_log.h

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation. All rights reserved.
// SPDX-License-Identifier: MIT
 
#ifndef _az_LOG_H
#define _az_LOG_H
 
#include <azure/core/az_result.h>
#include <azure/core/az_span.h>
 
#include <stdint.h>
 
#include <azure/core/_az_cfg_prefix.h>
 
typedef int32_t az_log_classification;
 
// az_log_classification Bits:
//   - 31 Always 0.
//   - 16..30 Facility.
//   - 0..15 Code.
 
#define _az_LOG_MAKE_CLASSIFICATION(facility, code) \
  ((az_log_classification)(((uint32_t)(facility) << 16U) | (uint32_t)(code)))
 
enum az_log_classification_core
{
  AZ_LOG_HTTP_REQUEST
  = _az_LOG_MAKE_CLASSIFICATION(_az_FACILITY_CORE_HTTP, 1), 
 
  AZ_LOG_HTTP_RESPONSE
  = _az_LOG_MAKE_CLASSIFICATION(_az_FACILITY_CORE_HTTP, 2), 
 
  AZ_LOG_HTTP_RETRY = _az_LOG_MAKE_CLASSIFICATION(
      _az_FACILITY_CORE_HTTP,
      3), 
};
 
typedef void (*az_log_message_fn)(az_log_classification classification, az_span message);
 
typedef bool (*az_log_classification_filter_fn)(az_log_classification classification);
 
#ifndef AZ_NO_LOGGING
void az_log_set_message_callback(az_log_message_fn log_message_callback);
#else
AZ_INLINE void az_log_set_message_callback(az_log_message_fn log_message_callback)
{
  (void)log_message_callback;
}
#endif // AZ_NO_LOGGING
 
#ifndef AZ_NO_LOGGING
void az_log_set_classification_filter_callback(
    az_log_classification_filter_fn message_filter_callback);
#else
AZ_INLINE void az_log_set_classification_filter_callback(
    az_log_classification_filter_fn message_filter_callback)
{
  (void)message_filter_callback;
}
#endif // AZ_NO_LOGGING
 
#include <azure/core/_az_cfg_suffix.h>
 
#endif // _az_LOG_H