utilities_api.h

Go to the documentation of this file.

// -------------------------------------------------------------------------------------------
// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
// This file is part of the AWS CDI-SDK, licensed under the BSD 2-Clause "Simplified" License.
// License details at: https://github.com/aws/aws-cdi-sdk/blob/mainline/LICENSE
// -------------------------------------------------------------------------------------------
 
#ifndef CDI_UTILITIES_H__
#define CDI_UTILITIES_H__
 
#include <stddef.h>
#include <stdint.h>
 
//*********************************************************************************************************************
//***************************************** START OF DEFINITIONS AND TYPES ********************************************
//*********************************************************************************************************************
 
#define CDI_NANOSECONDS_PER_SECOND   (1000000000UL)
 
#define CONTAINER_OF(ptr, type, member) \
                    (type*)( (char*)(ptr) - offsetof(type, member) )
 
#define CONTAINER_FROM(ptr, type, member_pointed_to, desired_member) \
                       (type*)( (char*)(ptr) + (offsetof(type, desired_member) - offsetof(type, member_pointed_to)) )
 
#define CDI_ARRAY_ELEMENT_COUNT(array) ((int)(sizeof(array) / sizeof(array[0])))
 
#define CDI_MIN(a, b) (((a) < (b)) ? (a) : (b))
 
#define CDI_MAX(a, b) (((a) > (b)) ? (a) : (b))
 
#define CDI_INVALID_ENUM_VALUE  (-1)
 
static inline const char* CdiGetEmptyStringIfNull(const char* source_str)
{
    static const char empty_str[] = "";
 
    if (NULL == source_str) {
        return empty_str;
    }
 
    return source_str;
}
 
//*********************************************************************************************************************
//******************************************* START OF PUBLIC FUNCTIONS ***********************************************
//*********************************************************************************************************************
 
#endif // CDI_UTILITIES_H__