| 167 } |
167 } |
| 168 |
168 |
| 169 /** |
169 /** |
| 170 * Helper function to avoid code duplication. |
170 * Helper function to avoid code duplication. |
| 171 * |
171 * |
| 172 * If \p remove is true, and \p targetbuf is \c NULL, the element |
172 * If @p remove is true, and @p targetbuf is @c NULL, the element |
| 173 * will be destroyed when found. |
173 * will be destroyed when found. |
| 174 * |
174 * |
| 175 * If \p remove is true, and \p targetbuf is set, the element will |
175 * If @p remove is true, and @p targetbuf is set, the element will |
| 176 * be copied to that buffer and no destructor function is called. |
176 * be copied to that buffer and no destructor function is called. |
| 177 * |
177 * |
| 178 * If \p remove is false, \p targetbuf must not be non-null and |
178 * If @p remove is false, @p targetbuf must not be non-null and |
| 179 * either the pointer, when the map is storing pointers, is copied |
179 * either the pointer, when the map is storing pointers, is copied |
| 180 * to the target buffer, or a pointer to the stored object will |
180 * to the target buffer, or a pointer to the stored object will |
| 181 * be copied to the target buffer. |
181 * be copied to the target buffer. |
| 182 * |
182 * |
| 183 * @param map the map |
183 * @param map the map |