dvander@2226: #ifndef _INCLUDE_KNIGHT_KE_COMMON_UTILS_H_
dvander@2226: #define _INCLUDE_KNIGHT_KE_COMMON_UTILS_H_
dvander@2226: 
dvander@2226: #include <stddef.h>
dvander@2226: #include <stdarg.h>
dvander@2226: 
dvander@2226: namespace Knight
dvander@2226: {
dvander@2226: 	/**
dvander@2226: 	 * @brief Formats a buffer with C platform rules.
dvander@2226: 	 *
dvander@2226: 	 * Unlink platform snprintf, this will never return nonsense values like -1.
dvander@2226: 	 *
dvander@2226: 	 * @param buffer			Buffer to store to.
dvander@2226: 	 * @param maxlength			Maximum length of buffer (including null terminator).
dvander@2226: 	 * @param fmt				printf() format string.
dvander@2226: 	 * @param ...				Formatting arguments.
dvander@2226: 	 * @return					Number of characters written.
dvander@2226: 	 */
dvander@2226: 	extern size_t KE_PFormat(char *buffer, size_t maxlength, const char *fmt, ...);
dvander@2226: 
dvander@2226: 	/**
dvander@2226: 	 * @brief Formats a buffer with C platform rules.
dvander@2226: 	 *
dvander@2226: 	 * Unlink platform snprintf, this will never return nonsense values like -1.
dvander@2226: 	 *
dvander@2226: 	 * @param buffer			Buffer to store to.
dvander@2226: 	 * @param maxlength			Maximum length of buffer (including null terminator).
dvander@2226: 	 * @param fmt				printf() format string.
dvander@2226: 	 * @param args				Formatting arguments.
dvander@2226: 	 * @return					Number of characters written.
dvander@2226: 	 */
dvander@2226: 	extern size_t KE_PFormatArgs(char *buffer, size_t maxlength, const char *fmt, va_list args);
dvander@2226: }
dvander@2226: 
dvander@2226: #endif //_INCLUDE_KNIGHT_KE_COMMON_UTILS_H_