diff options
author | belugas <belugas@openttd.org> | 2007-04-04 01:35:16 +0000 |
---|---|---|
committer | belugas <belugas@openttd.org> | 2007-04-04 01:35:16 +0000 |
commit | 6a86e758708a92134a8734a80935ae5fa3807ae4 (patch) | |
tree | c8c468b064c05fa682d00013b36792570a637721 /src/string.h | |
parent | 9dd844def2fd298fb8878483d7c5e34dfb8d25b0 (diff) | |
download | openttd-6a86e758708a92134a8734a80935ae5fa3807ae4.tar.xz |
(svn r9556) -Documentation: doxygen and comment-style changes. 'R', 'S'.. The end of the preliminary work is near
Diffstat (limited to 'src/string.h')
-rw-r--r-- | src/string.h | 34 |
1 files changed, 19 insertions, 15 deletions
diff --git a/src/string.h b/src/string.h index 2170a30f9..478c533e7 100644 --- a/src/string.h +++ b/src/string.h @@ -1,26 +1,28 @@ /* $Id$ */ +/** @file string.h */ + #ifndef STRING_H #define STRING_H #include "macros.h" -/* - * dst: destination buffer - * src: string to copy/concatenate - * size: size of the destination buffer - * usage: ttd_strlcpy(dst, src, lengthof(dst)); +/** + * usage ttd_strlcpy(dst, src, lengthof(dst)); + * @param dst destination buffer + * @param src string to copy/concatenate + * @param size size of the destination buffer */ void ttd_strlcat(char *dst, const char *src, size_t size); void ttd_strlcpy(char *dst, const char *src, size_t size); -/* - * dst: destination buffer - * src: string to copy - * last: pointer to the last element in the dst array - * if NULL no boundary check is performed - * returns a pointer to the terminating \0 in the destination buffer +/** * usage: strecpy(dst, src, lastof(dst)); + * @param dst destination buffer + * @param src string to copy + * @param last pointer to the last element in the dst array + * if NULL no boundary check is performed + * @return a pointer to the terminating \0 in the destination buffer */ char* strecat(char* dst, const char* src, const char* last); char* strecpy(char* dst, const char* src, const char* last); @@ -38,9 +40,9 @@ void str_strip_colours(char *str); * Valid filter types for IsValidChar. */ enum CharSetFilter { - CS_ALPHANUMERAL, //! Both numeric and alphabetic and spaces and stuff - CS_NUMERAL, //! Only numeric ones - CS_ALPHA, //! Only alphabetic values + CS_ALPHANUMERAL, ///< Both numeric and alphabetic and spaces and stuff + CS_NUMERAL, ///< Only numeric ones + CS_ALPHA, ///< Only alphabetic values }; /** Convert the given string to lowercase, only works with ASCII! */ @@ -105,6 +107,8 @@ static inline size_t Utf8CharLen(WChar c) * Return the length of an UTF-8 encoded value based on a single char. This * char should be the first byte of the UTF-8 encoding. If not, or encoding * is invalid, return value is 0 + * @param c char to query length of + * @return requested size */ static inline size_t Utf8EncodedCharLen(char c) { @@ -127,7 +131,7 @@ static inline bool IsUtf8Part(char c) /** * Retrieve the previous UNICODE character in an UTF-8 encoded string. * @param s char pointer pointing to (the first char of) the next character - * @returns a pointer in 's' to the previous UNICODE character's first byte + * @return a pointer in 's' to the previous UNICODE character's first byte * @note The function should not be used to determine the length of the previous * encoded char because it might be an invalid/corrupt start-sequence */ |