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 |