| 500 * |
500 * |
| 501 * @attention |
501 * @attention |
| 502 * When @p size is larger than one and the contents of the buffer are not aligned |
502 * When @p size is larger than one and the contents of the buffer are not aligned |
| 503 * with @p size, flushing stops after all complete items have been flushed, leaving |
503 * with @p size, flushing stops after all complete items have been flushed, leaving |
| 504 * the mis-aligned part in the buffer. |
504 * the mis-aligned part in the buffer. |
| 505 * Afterward, this function refuses to write any data to the buffer, until the |
505 * Afterward, this function only writes as many items as possible to the buffer. |
| 506 * mis-alignment has been resolved (e.g. by manually flushing with cxBufferFlush()). |
|
| 507 * |
506 * |
| 508 * @note The signature is compatible with the fwrite() family of functions. |
507 * @note The signature is compatible with the fwrite() family of functions. |
| 509 * |
508 * |
| 510 * @param ptr a pointer to the memory area containing the bytes to be written |
509 * @param ptr a pointer to the memory area containing the bytes to be written |
| 511 * @param size the length of one element |
510 * @param size the length of one element |