Global.h

///////////////////////////////////////////////////////////////////////////////
//                                                                           //
// Global.h                                                                  //
// Copyright (C) Microsoft Corporation. All rights reserved.                 //
// This file is distributed under the University of Illinois Open Source     //
// License. See LICENSE.TXT for details.                                     //
//                                                                           //
// Provides important declarations global to all DX Compiler code.           //
//                                                                           //
///////////////////////////////////////////////////////////////////////////////

#pragma once

#ifdef _WIN32
// Redeclare some macros to not depend on winerror.h
#define DXC_FAILED(hr) (((HRESULT)(hr)) < 0)
#ifndef _HRESULT_DEFINED
#define _HRESULT_DEFINED
#ifndef _Return_type_success_
typedef long HRESULT;
#else
typedef _Return_type_success_(return >= 0) long HRESULT;
#endif // _Return_type_success_
#endif // !_HRESULT_DEFINED
#endif // _WIN32

#include "dxc/Support/exception.h"
#include "dxc/WinAdapter.h"
#include <stdarg.h>
#include <system_error>

///////////////////////////////////////////////////////////////////////////////
// Memory allocation support.
//
// This mechanism ties into the C++ new and delete operators.
//
// Other allocators may be used in specific situations, eg sub-allocators or
// the COM allocator for interop. This is the preferred allocator in general,
// however, as it eventually allows the library user to specify their own.
//

struct IMalloc;

// Used by DllMain to set up and tear down per-thread tracking.
HRESULT DxcInitThreadMalloc() throw();
void DxcCleanupThreadMalloc() throw();

// Used by APIs entry points to set up per-thread/invocation allocator.
// Setting the IMalloc on the thread increases the reference count,
// clearing it decreases it.
void DxcSetThreadMallocToDefault() throw();
void DxcClearThreadMalloc() throw();

// Used to retrieve the current invocation's allocator or perform an
// alloc/free/realloc.
IMalloc *DxcGetThreadMallocNoRef() throw();

// Common implementation of operators new and delete
void *DxcNew(std::size_t size) throw();
void DxcDelete(void *ptr) throw();

class DxcThreadMalloc {
public:
  explicit DxcThreadMalloc(IMalloc *pMallocOrNull) throw();
  ~DxcThreadMalloc();

  IMalloc *GetInstalledAllocator() const { return p; }

private:
  // Copy constructor and assignment are dangerous and should always be
  // deleted...
  DxcThreadMalloc(const DxcThreadMalloc &) = delete;
  DxcThreadMalloc &operator=(const DxcThreadMalloc &) = delete;
  // Move constructor and assignment should be OK to be added if needed.
  DxcThreadMalloc(DxcThreadMalloc &&) = delete;
  DxcThreadMalloc &operator=(DxcThreadMalloc &&) = delete;

  IMalloc *p;
  IMalloc *pPrior;
};

///////////////////////////////////////////////////////////////////////////////
// Error handling support.
void CheckLLVMErrorCode(const std::error_code &ec);

/******************************************************************************
                          Project-wide macros
******************************************************************************/
#define SAFE_RELEASE(p)                                                        \
  {                                                                            \
    if (p) {                                                                   \
      (p)->Release();                                                          \
      (p) = nullptr;                                                           \
    }                                                                          \
  }
#define SAFE_ADDREF(p)                                                         \
  {                                                                            \
    if (p) {                                                                   \
      (p)->AddRef();                                                           \
    }                                                                          \
  }

#define SAFE_DELETE_ARRAY(p)                                                   \
  {                                                                            \
    delete[](p);                                                               \
    p = nullptr;                                                               \
  }
#define SAFE_DELETE(p)                                                         \
  {                                                                            \
    delete (p);                                                                \
    p = nullptr;                                                               \
  }

// VH is used in other DXC projects, but it's also a typedef in llvm.
// Use the IFC (IfFailedCleanup) set of conventions.
#define IFC(x)                                                                 \
  {                                                                            \
    hr = (x);                                                                  \
    if (DXC_FAILED(hr))                                                        \
      goto Cleanup;                                                            \
  }
#define IFR(x)                                                                 \
  {                                                                            \
    HRESULT __hr = (x);                                                        \
    if (DXC_FAILED(__hr))                                                      \
      return __hr;                                                             \
  }
#define IFRBOOL(x, y)                                                          \
  {                                                                            \
    if (!(x))                                                                  \
      return (y);                                                              \
  }
#define IFCBOOL(x, y)                                                          \
  {                                                                            \
    if (!(x)) {                                                                \
      hr = (y);                                                                \
      goto Cleanup;                                                            \
    }                                                                          \
  }
#define IFCOOM(x)                                                              \
  {                                                                            \
    if (nullptr == (x)) {                                                      \
      hr = E_OUTOFMEMORY;                                                      \
      goto Cleanup;                                                            \
    }                                                                          \
  }
#define IFROOM(x)                                                              \
  {                                                                            \
    if (nullptr == (x)) {                                                      \
      return E_OUTOFMEMORY;                                                    \
    }                                                                          \
  }
#define IFCPTR(x)                                                              \
  {                                                                            \
    if (nullptr == (x)) {                                                      \
      hr = E_POINTER;                                                          \
      goto Cleanup;                                                            \
    }                                                                          \
  }
#define IFT(x)                                                                 \
  {                                                                            \
    HRESULT __hr = (x);                                                        \
    if (DXC_FAILED(__hr))                                                      \
      throw ::hlsl::Exception(__hr);                                           \
  }
#define IFTBOOL(x, y)                                                          \
  {                                                                            \
    if (!(x))                                                                  \
      throw ::hlsl::Exception(y);                                              \
  }
#define IFTOOM(x)                                                              \
  {                                                                            \
    if (nullptr == (x)) {                                                      \
      throw ::hlsl::Exception(E_OUTOFMEMORY);                                  \
    }                                                                          \
  }
#define IFTPTR(x)                                                              \
  {                                                                            \
    if (nullptr == (x)) {                                                      \
      throw ::hlsl::Exception(E_POINTER);                                      \
    }                                                                          \
  }
#define IFTARG(x)                                                              \
  {                                                                            \
    if (!(x)) {                                                                \
      throw ::hlsl::Exception(E_INVALIDARG);                                   \
    }                                                                          \
  }
#define IFTLLVM(x)                                                             \
  { CheckLLVMErrorCode(x); }
#define IFTMSG(x, msg)                                                         \
  {                                                                            \
    HRESULT __hr = (x);                                                        \
    if (DXC_FAILED(__hr))                                                      \
      throw ::hlsl::Exception(__hr, msg);                                      \
  }
#define IFTBOOLMSG(x, y, msg)                                                  \
  {                                                                            \
    if (!(x))                                                                  \
      throw ::hlsl::Exception(y, msg);                                         \
  }

// Propagate an C++ exception into an HRESULT.
#define CATCH_CPP_ASSIGN_HRESULT()                                             \
  catch (std::bad_alloc &) {                                                   \
    hr = E_OUTOFMEMORY;                                                        \
  }                                                                            \
  catch (hlsl::Exception & _hlsl_exception_) {                                 \
    hr = _hlsl_exception_.hr;                                                  \
  }                                                                            \
  catch (...) {                                                                \
    hr = E_FAIL;                                                               \
  }
#define CATCH_CPP_RETURN_HRESULT()                                             \
  catch (std::bad_alloc &) {                                                   \
    return E_OUTOFMEMORY;                                                      \
  }                                                                            \
  catch (hlsl::Exception & _hlsl_exception_) {                                 \
    return _hlsl_exception_.hr;                                                \
  }                                                                            \
  catch (...) {                                                                \
    return E_FAIL;                                                             \
  }

template <typename T> T *VerifyNullAndThrow(T *p) {
  if (p == nullptr)
    throw std::bad_alloc();
  return p;
}
#define VNT(__p) VerifyNullAndThrow(__p)

#ifdef _WIN32

extern "C" __declspec(dllimport) void __stdcall OutputDebugStringA(
    const char *msg);

inline void OutputDebugBytes(const void *ptr, size_t len) {
  const char digits[] = "0123456789abcdef";
  const unsigned char *pBytes = (const unsigned char *)ptr;
  constexpr size_t bytesPerLine = 16;
  constexpr size_t bufferSize = bytesPerLine * 3 + 2 + 1;
  char buffer[bufferSize];
  buffer[bufferSize - 3] = '\r';
  buffer[bufferSize - 2] = '\n';
  buffer[bufferSize - 1] = '\0';

  char *pWrite = buffer;
  char *pEnd = buffer + bufferSize - 3;
  while (len) {
    *pWrite++ = digits[(*pBytes & 0xF0) >> 4];
    *pWrite++ = digits[*pBytes & 0x0f];
    *pWrite++ = ' ';
    if (pWrite == pEnd) {
      OutputDebugStringA(buffer);
      pWrite = buffer;
    }
    --len;
    ++pBytes;
  }
  if (pWrite != buffer) {
    *pWrite = '\0';
    OutputDebugStringA(buffer);
    OutputDebugStringA("\r\n");
  }
}

inline void OutputDebugFormatA(const char *pszFormat, ...) {
  constexpr size_t bufferSize = 1024;
  char buffer[bufferSize];

  va_list argList;
  va_start(argList, pszFormat);
  int count = vsnprintf_s(buffer, bufferSize, bufferSize, pszFormat, argList);
  va_end(argList);

  OutputDebugStringA(buffer);
  if (count < 0) {
    OutputDebugStringA("...\n");
  }
}

#endif // _WIN32

#ifndef NDEBUG

#ifdef _WIN32

// DXASSERT is used to debug break when 'exp' evaluates to false and is only
//     intended for internal developer use. It is compiled out in free
//     builds.  This means that code that should be in the final exe should
//     NOT be inside of of an DXASSERT test.
//
// 'fmt' is a printf-like format string; positional arguments aren't
//  supported.
//
// Example: DXASSERT(i > 10, "Hello %s", "World");
// This prints 'Hello World (i > 10)' and breaks in the debugger if the
// assertion doesn't hold.
//
#define DXASSERT_ARGS(exp, fmt, ...)                                           \
  do {                                                                         \
    if (!(exp)) {                                                              \
      OutputDebugFormatA(                                                      \
          "Error: \t%s\nFile:\n%s(%d)\nFunc:\t%s.\n\t" fmt "\n",               \
          "!(" #exp ")", __FILE__, __LINE__, __FUNCTION__, ##__VA_ARGS__);     \
      __debugbreak();                                                          \
    }                                                                          \
  } while (0)
#define DXASSERT(exp, msg) DXASSERT_ARGS(exp, msg)

#define DXASSERT_LOCALVAR(local, exp, msg) DXASSERT(exp, msg)

#define DXASSERT_LOCALVAR_NOMSG(local, exp) DXASSERT_LOCALVAR(local, exp, "")

#define DXASSERT_NOMSG(exp) DXASSERT(exp, "")

#define DXVERIFY_NOMSG(exp) DXASSERT(exp, "")

#else // _WIN32
#include <cassert>

#define DXASSERT_NOMSG assert

#define DXASSERT_LOCALVAR(local, exp, msg) DXASSERT(exp, msg)

#define DXASSERT_LOCALVAR_NOMSG(local, exp) DXASSERT_LOCALVAR(local, exp, "")

#define DXVERIFY_NOMSG assert

#define DXASSERT_ARGS(expr, fmt, ...)                                          \
  do {                                                                         \
    if (!(expr)) {                                                             \
      fprintf(stderr, fmt, __VA_ARGS__);                                       \
      assert(false);                                                           \
    }                                                                          \
  } while (0)

#define DXASSERT(expr, msg)                                                    \
  do {                                                                         \
    if (!(expr)) {                                                             \
      fprintf(stderr, msg);                                                    \
      assert(false && msg);                                                    \
    }                                                                          \
  } while (0)

#endif // _WIN32

#else // NDEBUG

// DXASSERT_ARGS is disabled in free builds.
#define DXASSERT_ARGS(exp, s, ...)                                             \
  do {                                                                         \
  } while (0)

// DXASSERT is disabled in free builds.
#define DXASSERT(exp, msg)                                                     \
  do {                                                                         \
  } while (0)

// DXASSERT_LOCALVAR is disabled in free builds, but we keep the local
// referenced to avoid a warning.
#define DXASSERT_LOCALVAR(local, exp, msg)                                     \
  do {                                                                         \
    (void)(local);                                                             \
  } while (0)
#define DXASSERT_LOCALVAR_NOMSG(local, exp) DXASSERT_LOCALVAR(local, exp, "")

// DXASSERT_NOMSG is disabled in free builds.
#define DXASSERT_NOMSG(exp)                                                    \
  do {                                                                         \
  } while (0)

// DXVERIFY is patterned after NT_VERIFY and will evaluate the expression
#define DXVERIFY_NOMSG(exp)                                                    \
  do {                                                                         \
    (void)(exp);                                                               \
  } while (0)

#endif // NDEBUG