/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef __FdPrintf_h__
#define __FdPrintf_h__

#include <cstdarg>

#ifdef _WIN32
typedef void* platform_handle_t;
#else
typedef int platform_handle_t;
#endif

/*
 * We can't use libc's (f)printf because it would reenter in replace_malloc,
 * So use a custom and simplified version.  Only %p, %zu, %s and %% are
 * supported, %zu, %s, support width specifiers.
 */
int VSNPrintf(char* aBuf, size_t aSize, const char* aFormat, va_list aArgs)
#ifdef __GNUC__
    __attribute__((format(printf, 3, 0)))
#endif
    ;

int SNPrintf(char* aBuf, size_t aSize, const char* aFormat, ...)
#ifdef __GNUC__
    __attribute__((format(printf, 3, 4)))
#endif
    ;

/*
 * /!\ These functions use a fixed-size internal buffer. The caller is
 * expected to not use a format string that may overflow.
 * The aFd argument is a file descriptor on UNIX and a native win32 file
 * handle on Windows (from CreateFile). We can't use the windows POSIX
 * APIs is that they don't support O_APPEND in a multi-process-safe way,
 * while CreateFile does.
 */
void VFdPrintf(platform_handle_t aFd, const char* aFormat, va_list aArgs)
#ifdef __GNUC__
    __attribute__((format(printf, 2, 0)))
#endif
    ;

void FdPrintf(platform_handle_t aFd, const char* aFormat, ...)
#ifdef __GNUC__
    __attribute__((format(printf, 2, 3)))
#endif
    ;

// Write buffer contents without formatting (eg for use with SNPrintf).
void FdPuts(platform_handle_t aFd, const char* aBuf, size_t aLen);

#endif /* __FdPrintf_h__ */