VuoLog.h

Go to the documentation of this file.

 
// Don't use `#pragma once` here, since this header is included both from the source tree and from Vuo.framework.
#ifndef VUO_LOG
#define VUO_LOG
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdbool.h>
 
double VuoLogGetTime(void);
double VuoLogGetElapsedTime(void);
bool VuoIsDebugEnabled(void);
char *VuoLog_copyCFDescription(const void *variable);
 
void VuoLog_backtrace(void);
#ifdef __cplusplus
}
#include <vector>
std::vector<std::string> VuoLog_getBacktrace(void);
extern "C" {
#endif
 
 
#define VuoLog_status(format, ...) VuoLog_statusF(__FILE__, __LINE__, __func__, format, ##__VA_ARGS__)
 
#ifdef DOXYGEN
void VuoLog_statusF(const char *file, const unsigned int linenumber, const char *function, const char *format, ...);
#else
void VuoLog_statusF(const char *file, const unsigned int linenumber, const char *function, const char *format, ...) __attribute__((format(printf, 4, 5)));
#endif
 
#ifdef DOXYGEN
void VuoLog(const char *file, const unsigned int linenumber, const char *function, const char *format, ...);
#else
void VuoLog(const char *file, const unsigned int linenumber, const char *function, const char *format, ...) __attribute__((format(printf, 4, 5)));
#endif
 
#define VL() VuoLog(__FILE__, __LINE__, __func__, "")
 
#define VLog(format, ...) VuoLog(__FILE__, __LINE__, __func__, format, ##__VA_ARGS__)
 
#define VUserLog(format, ...) VuoLog(__FILE__, __LINE__, __func__, format, ##__VA_ARGS__)
 
#define VDebugLog(format, ...) do { if (VuoIsDebugEnabled()) VuoLog(__FILE__, __LINE__, __func__, format, ##__VA_ARGS__); } while(0)
 
#define VLogHeap(heapPointer) do { \
    char *description = VuoHeap_getDescription(heapPointer); \
    VLog("%s = %p (registered at %s)", #heapPointer, heapPointer, description); \
    free(description); \
    } while(0)
 
 
void VuoLog_recordTime(const char *name, double time);
 
#ifdef VUO_PROFILE
#define VUOLOG_PROFILE_BEGIN(object) double VuoLog_time_ ## object = VuoLogGetTime();
#define VUOLOG_PROFILE_END(object) VuoLog_recordTime(#object, VuoLogGetTime() - VuoLog_time_ ## object);
#else
 
#define VUOLOG_PROFILE_BEGIN(object)
 
#define VUOLOG_PROFILE_END(object)
#endif
 
#ifndef DOXYGEN
// Executes the block passed to it (an adapter in order to use `__attribute__((cleanup(…)))` with C Blocks).
static inline void VuoDeferCleanup(void (^*b)(void)) { if (*b) (*b)(); }
 
// Combines two strings into an identifier.
#define VuoDeferMerge(a,b) a##b
 
// Create the name of the defer scope variable.
#define VuoDeferVarName(a) VuoDeferMerge(VuoDeferScopeVar, a)
#endif
 
#define VuoDefer __attribute__((cleanup(VuoDeferCleanup),unused)) void (^VuoDeferVarName(__COUNTER__))(void) =
 
#ifdef __cplusplus
}
#endif
 
#endif