/** @file * IPRT - Message Formatting. */ /* * Copyright (C) 2009-2011 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. * * The contents of this file may alternatively be used under the terms * of the Common Development and Distribution License Version 1.0 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the * VirtualBox OSE distribution, in which case the provisions of the * CDDL are applicable instead of those of the GPL. * * You may elect to license modified versions of this file under the * terms and conditions of either the GPL or the CDDL or both. */ #ifndef ___iprt_msg_h #define ___iprt_msg_h #include #include #include RT_C_DECLS_BEGIN /** @defgroup grp_rt_msg RTMsg - Message Formatting * @ingroup grp_rt * @{ */ /** * Sets the program name to use. * * @returns IPRT status code. * @param pszFormat The program name format string. * @param ... Format arguments. */ RTDECL(int) RTMsgSetProgName(const char *pszFormat, ...); /** * Print error message to standard error. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "error: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param ... Format arguments. */ RTDECL(int) RTMsgError(const char *pszFormat, ...); /** * Print error message to standard error. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "error: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param va Format arguments. */ RTDECL(int) RTMsgErrorV(const char *pszFormat, va_list va); /** * Same as RTMsgError() except for the return value. * * @returns @a enmExitCode * @param enmExitCode What to exit code to return. This is mainly for * saving some vertical space in the source file. * @param pszFormat The message format string. * @param ... Format arguments. */ RTDECL(RTEXITCODE) RTMsgErrorExit(RTEXITCODE enmExitcode, const char *pszFormat, ...); /** * Same as RTMsgErrorV() except for the return value. * * @returns @a enmExitCode * @param enmExitCode What to exit code to return. This is mainly for * saving some vertical space in the source file. * @param pszFormat The message format string. * @param va Format arguments. */ RTDECL(RTEXITCODE) RTMsgErrorExitV(RTEXITCODE enmExitCode, const char *pszFormat, va_list va); /** * Same as RTMsgError() except for the return value. * * @returns @a rcRet * @param rcRet What IPRT status to return. This is mainly for * saving some vertical space in the source file. * @param pszFormat The message format string. * @param ... Format arguments. */ RTDECL(int) RTMsgErrorRc(int rc, const char *pszFormat, ...); /** * Same as RTMsgErrorV() except for the return value. * * @returns @a rcRet * @param rcRet What IPRT status to return. This is mainly for * saving some vertical space in the source file. * @param pszFormat The message format string. * @param va Format arguments. */ RTDECL(int) RTMsgErrorRcV(int rc, const char *pszFormat, va_list va); /** * Print an error message for a RTR3Init failure and suggest an exit code. * * @code * * int rc = RTR3Init(); * if (RT_FAILURE(rc)) * return RTMsgInitFailure(rc); * * @endcode * * @returns Appropriate exit code. * @param rcRTR3Init The status code returned by RTR3Init. */ RTDECL(RTEXITCODE) RTMsgInitFailure(int rcRTR3Init); /** * Print informational message to standard error. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "warning: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param ... Format arguments. */ RTDECL(int) RTMsgWarning(const char *pszFormat, ...); /** * Print informational message to standard error. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "warning: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param va Format arguments. */ RTDECL(int) RTMsgWarningV(const char *pszFormat, va_list va); /** * Print informational message to standard output. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "info: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param ... Format arguments. */ RTDECL(int) RTMsgInfo(const char *pszFormat, ...); /** * Print informational message to standard output. * * The message will be prefixed with the file name part of process image name * (i.e. no path) and "info: ". If the message doesn't end with a new line, * one will be added. The caller should call this with an empty string if * unsure whether the cursor is currently position at the start of a new line. * * @returns IPRT status code. * @param pszFormat The message format string. * @param va Format arguments. */ RTDECL(int) RTMsgInfoV(const char *pszFormat, va_list va); /** @} */ RT_C_DECLS_END #endif