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 |