Mercurial > pidgin.yaz
comparison src/util.h @ 7123:d40966338ea6
[gaim-migrate @ 7690]
Fixed the @see stuff in util.h.
committer: Tailor Script <tailor@pidgin.im>
author | Christian Hammond <chipx86@chipx86.com> |
---|---|
date | Thu, 02 Oct 2003 04:16:50 +0000 |
parents | 6faeeecab0dc |
children | 67f9b43c402a |
comparison
equal
deleted
inserted
replaced
7122:b90c94620d1c | 7123:d40966338ea6 |
---|---|
45 * @param str The string to convert. | 45 * @param str The string to convert. |
46 * @param len The length of the string. | 46 * @param len The length of the string. |
47 * | 47 * |
48 * @return The base-16 string. | 48 * @return The base-16 string. |
49 * | 49 * |
50 * @see frombase16() | 50 * @see gaim_base16_decode() |
51 */ | 51 */ |
52 unsigned char *gaim_base16_encode(const unsigned char *str, int len); | 52 unsigned char *gaim_base16_encode(const unsigned char *str, int len); |
53 | 53 |
54 /** | 54 /** |
55 * Converts a string back from its base-16 equivalent. | 55 * Converts a string back from its base-16 equivalent. |
57 * @param str The string to convert back. | 57 * @param str The string to convert back. |
58 * @param ret_str The returned, non-base-16 string. | 58 * @param ret_str The returned, non-base-16 string. |
59 * | 59 * |
60 * @return The length of the returned string. | 60 * @return The length of the returned string. |
61 * | 61 * |
62 * @see tobase16() | 62 * @see gaim_base16_encode() |
63 */ | 63 */ |
64 int gaim_base16_decode(const char *str, unsigned char **ret_str); | 64 int gaim_base16_decode(const char *str, unsigned char **ret_str); |
65 | 65 |
66 /*@}*/ | 66 /*@}*/ |
67 | 67 |
77 * @param buf The data to convert. | 77 * @param buf The data to convert. |
78 * @param len The length of the data. | 78 * @param len The length of the data. |
79 * | 79 * |
80 * @return The base-64 version of @a str. | 80 * @return The base-64 version of @a str. |
81 * | 81 * |
82 * @see frombase64() | 82 * @see gaim_base64_decode() |
83 */ | 83 */ |
84 unsigned char *gaim_base64_encode(const unsigned char *buf, size_t len); | 84 unsigned char *gaim_base64_encode(const unsigned char *buf, size_t len); |
85 | 85 |
86 /** | 86 /** |
87 * Converts a string back from its base-64 equivalent. | 87 * Converts a string back from its base-64 equivalent. |
88 * | 88 * |
89 * @param str The string to convert back. | 89 * @param str The string to convert back. |
90 * @param ret_str The returned, non-base-64 string. | 90 * @param ret_str The returned, non-base-64 string. |
91 * @param ret_len The returned string length. | 91 * @param ret_len The returned string length. |
92 * | 92 * |
93 * @see tobase64() | 93 * @see gaim_base64_encode() |
94 */ | 94 */ |
95 void gaim_base64_decode(const char *str, char **ret_str, int *ret_len); | 95 void gaim_base64_decode(const char *str, char **ret_str, int *ret_len); |
96 | 96 |
97 /*@}*/ | 97 /*@}*/ |
98 | 98 |
108 * The returned string is stored in a static buffer, so the result | 108 * The returned string is stored in a static buffer, so the result |
109 * should be g_strdup()'d if it's intended to be used for long. | 109 * should be g_strdup()'d if it's intended to be used for long. |
110 * | 110 * |
111 * @return The current local time. | 111 * @return The current local time. |
112 * | 112 * |
113 * @see full_date() | 113 * @see gaim_date_full() |
114 */ | 114 */ |
115 char *gaim_date(void); | 115 char *gaim_date(void); |
116 | 116 |
117 /** | 117 /** |
118 * Returns the date and time in human-readable form. | 118 * Returns the date and time in human-readable form. |
120 * The returned string is stored in a static buffer, so the result | 120 * The returned string is stored in a static buffer, so the result |
121 * should be g_strdup()'d if it's intended to be used for long. | 121 * should be g_strdup()'d if it's intended to be used for long. |
122 * | 122 * |
123 * @return The date and time in human-readable form. | 123 * @return The date and time in human-readable form. |
124 * | 124 * |
125 * @see date() | 125 * @see gaim_date() |
126 */ | 126 */ |
127 char *gaim_date_full(void); | 127 char *gaim_date_full(void); |
128 | 128 |
129 /** | 129 /** |
130 * Builds a time_t from the supplied information. | 130 * Builds a time_t from the supplied information. |