149 * @param buffer the buffer to initialize |
149 * @param buffer the buffer to initialize |
150 * @param space pointer to the memory area, or \c NULL to allocate |
150 * @param space pointer to the memory area, or \c NULL to allocate |
151 * new memory |
151 * new memory |
152 * @param capacity the capacity of the buffer |
152 * @param capacity the capacity of the buffer |
153 * @param allocator the allocator this buffer shall use for automatic |
153 * @param allocator the allocator this buffer shall use for automatic |
154 * memory management. If \c NULL, the default heap allocator will be used. |
154 * memory management |
|
155 * (if \c NULL, a default stdlib allocator will be used) |
155 * @param flags buffer features (see cx_buffer_s.flags) |
156 * @param flags buffer features (see cx_buffer_s.flags) |
156 * @return zero on success, non-zero if a required allocation failed |
157 * @return zero on success, non-zero if a required allocation failed |
157 */ |
158 */ |
158 cx_attr_nonnull_arg(1) |
159 cx_attr_nonnull_arg(1) |
159 int cxBufferInit( |
160 int cxBufferInit( |
199 * |
200 * |
200 * @param space pointer to the memory area, or \c NULL to allocate |
201 * @param space pointer to the memory area, or \c NULL to allocate |
201 * new memory |
202 * new memory |
202 * @param capacity the capacity of the buffer |
203 * @param capacity the capacity of the buffer |
203 * @param allocator the allocator to use for allocating the structure and the automatic |
204 * @param allocator the allocator to use for allocating the structure and the automatic |
204 * memory management within the buffer. If \c NULL, the default heap allocator will be used. |
205 * memory management within the buffer |
|
206 * (if \c NULL, a default stdlib allocator will be used) |
205 * @param flags buffer features (see cx_buffer_s.flags) |
207 * @param flags buffer features (see cx_buffer_s.flags) |
206 * @return a pointer to the buffer on success, \c NULL if a required allocation failed |
208 * @return a pointer to the buffer on success, \c NULL if a required allocation failed |
207 */ |
209 */ |
208 cx_attr_malloc |
210 cx_attr_malloc |
209 cx_attr_dealloc(cxBufferFree, 1) |
211 cx_attr_dealloc(cxBufferFree, 1) |