# Microsoft Azure IoT SDKs - macro utils for C This repository contains the following: * **a generation tool for macro_utils.h** to regenerate the file macro_utils.h. Pressing F5 after opening .sln file will regenerate macro_utils.h * **macro_utils.h** a C header file that contains a multitude of very useful C macros ## How to clone the repository ``` git clone https://github.com/Azure/azure-macro-utils-c.git ``` ## How to use the Azure IoT SDKs - macro utils for C In a C source file: `#include "azure_macro_utils/macro_utils.h"` ### Installation To install the Azure IoT SDKs - macro utils for C on your machine, we recommend you use cmake 3.0.0 or higher. - Create a "build" directory and run `cmake ..` from that directory to generate the cmake files. - Run `cmake --build . --target install` to install on your machine #### CMake 3.0.0+ In your project, simply: - `find_package(azure_macro_utils_c REQUIRED CONFIG)` - `target_link_libraries( azure_macro_utils_c)` #### CMake 2.\*.\* In your project, simply: - `target_include_directories( PUBLIC ${MACRO_UTILS_INC_FOLDER})` ## Supported compilers The following compilers are supported: gcc 4.4 (and onwards), Visual Studio 2015 and others. ## CMake integration The project will export a global variable MACRO_UTILS_INC_FOLDER that points to the folder needed to be included so that `#include "azure_macro_utils/macro_utils.h"` resolves properly.