dvander@7: /* ======== SourceMM ======== dvander@282: * Copyright (C) 2004-2007 Metamod:Source Development Team dvander@282: * No warranties of any kind dvander@282: * dvander@282: * License: zlib/libpng dvander@282: * dvander@282: * Author(s): David "BAILOPAN" Anderson dvander@282: * ============================ dvander@282: */ dvander@7: dvander@7: #ifndef _INCLUDE_UTIL_H dvander@7: #define _INCLUDE_UTIL_H dvander@7: ds@296: #include ds@296: dvander@7: /** ds@296: * @brief Utility functions dvander@7: * @file util.h dvander@7: */ dvander@7: ds@296: /** ds@296: * @brief Returns a pointer to the extension in a file name. ds@296: */ dvander@7: const char *UTIL_GetExtension(const char *file); ds@296: ds@296: /** ds@296: * @brief Removes C-style comments from string. ds@296: */ dvander@122: void UTIL_TrimComments(char *buffer); ds@296: ds@296: /** ds@296: * @brief Removes whitespace characters from left side of string. ds@296: */ ds@84: void UTIL_TrimLeft(char *buffer); ds@296: ds@296: /** ds@296: * @brief Removes whitespace characters from right side of string. ds@296: */ ds@84: void UTIL_TrimRight(char *buffer); ds@296: ds@296: /** ds@296: * @brief Breaks a string at the first space until it reaches a non-space. ds@296: */ dvander@122: void UTIL_KeySplit(const char *str, char *buf1, size_t len1, char *buf2, size_t len2); ds@296: ds@296: /** ds@296: * @brief Compares two file paths. ds@296: */ dvander@122: bool UTIL_PathCmp(const char *path1, const char *path2); dvander@7: ds@296: /** ds@296: * @brief Same as snprintf except that it ensures the string buffer is null terminated. ds@296: */ ds@296: size_t UTIL_Format(char *buffer, size_t maxlength, const char *fmt, ...); ds@296: ds@296: /** ds@296: * @brief Same as vsnprintf except that it ensures the string buffer is null terminated. ds@296: */ ds@296: inline size_t UTIL_FormatArgs(char *buffer, size_t maxlength, const char *fmt, va_list params) ds@296: { ds@296: size_t len = vsnprintf(buffer, maxlength, fmt, params); ds@296: ds@296: if (len >= maxlength) ds@296: { ds@296: len = maxlength - 1; ds@296: buffer[len] = '\0'; ds@296: } ds@296: ds@296: return len; ds@296: } ds@296: dvander@7: #endif //_INCLUDE_UTIL_H