/*---------------------------------------------------------------------------*
  Project:  Horizon
  File:     nstd_Printf.h

  Copyright (C)2009 Nintendo Co., Ltd.  All rights reserved.

  These coded instructions, statements, and computer programs contain
  proprietary information of Nintendo of America Inc. and/or Nintendo
  Company Ltd., and are protected by Federal copyright law.  They may
  not be disclosed to third parties or copied or duplicated in any form,
  in whole or in part, without the prior written consent of Nintendo.

  $Rev: 21974 $
 *---------------------------------------------------------------------------*/

#ifndef NN_NSTD_PRINTF_H_
#define NN_NSTD_PRINTF_H_

#include <nn/types.h>

#ifdef __cplusplus

namespace nn { namespace nstd {

/*
    @brief 文字列を出力します。vsnprintf の省メモリ版です。
    @param[out]   dst     結果を格納するバッファを指定します。
    @param[in]    len     dst のバッファ長を指定します。
    @param[in]    fmt     一般的な printf のフォーマット文字列を指定します。ただし、浮動小数点系のもの(%%f など) は指定できません。
    @param[in]    vlist   パラメータを指定します。

    return 書式文字列を正しく出力した場合の文字数を返します。
*/
s32 TVSNPrintf(char *dst, size_t len, const char *fmt, va_list vlist);
s32 TVSNPrintf(wchar_t *dst, size_t len, const wchar_t *fmt, va_list vlist);

/*
    @brief 文字列を出力します。snprintf の省メモリ版です。
    @param[out]   dst     結果を格納するバッファを指定します。
    @param[in]    len     dst のバッファ長を指定します。
    @param[in]    fmt     一般的な printf のフォーマット文字列を指定します。ただし、浮動小数点系のもの(%%f など) は指定できません。
    @param[in]    ...     フォーマット文字列に対応する引数を指定します。

    return 書式文字列を正しく出力した場合の文字数を返します。
*/
s32 TSNPrintf(char *dst, size_t len, const char *fmt, ...);
s32 TSNPrintf(wchar_t *dst, size_t len, const wchar_t *fmt, ...);

/*
    @brief 文字列を出力します。sprintf の省メモリ版です。
    @param[out]   dst     結果を格納するバッファを指定します。
    @param[in]    fmt     一般的な printf のフォーマット文字列を指定します。ただし、浮動小数点系のもの(%%f など) は指定できません。
    @param[in]    ...     フォーマット文字列に対応する引数を指定します。

    return 書式文字列を正しく出力した場合の文字数を返します。
*/
s32 TSPrintf(char *dst, const char *fmt, ...);
s32 TSPrintf(wchar_t *dst, const wchar_t *fmt, ...);

}}

#endif

// 以下、C 用宣言

#include <nn/util/detail/util_CLibImpl.h>

NN_EXTERN_C s32 nnnstdTVSNPrintf(char *dst, size_t len, const char *fmt, va_list vlist);
NN_EXTERN_C s32 nnnstdTSNPrintf(char *dst, size_t len, const char *fmt, ...);
NN_EXTERN_C s32 nnnstdTSPrintf(char *dst, const char *fmt, ...);
NN_EXTERN_C s32 nnnstdTVSNWPrintf(wchar_t *dst, size_t len, const wchar_t *fmt, va_list vlist);
NN_EXTERN_C s32 nnnstdTSNWPrintf(wchar_t *dst, size_t len, const wchar_t *fmt, ...);
NN_EXTERN_C s32 nnnstdTSWPrintf(wchar_t *dst, const wchar_t *fmt, ...);

#endif /* NN_NSTD_PRINTF_H_ */