672 ); |
672 ); |
673 |
673 |
674 /** |
674 /** |
675 * Writes a terminating zero to a buffer at the current position. |
675 * Writes a terminating zero to a buffer at the current position. |
676 * |
676 * |
677 * On successful write, @em neither the position @em nor the size of the buffer is |
677 * If successful, sets the size to the current position and advances the position by one. |
678 * increased. |
|
679 * |
678 * |
680 * The purpose of this function is to have the written data ready to be used as |
679 * The purpose of this function is to have the written data ready to be used as |
681 * a C string. |
680 * a C string with the buffer's size being the length of that string. |
682 * |
681 * |
683 * @param buffer the buffer to write to |
682 * @param buffer the buffer to write to |
684 * @return zero, if the terminator could be written, non-zero otherwise |
683 * @return zero, if the terminator could be written, non-zero otherwise |
685 */ |
684 */ |
686 cx_attr_nonnull |
685 cx_attr_nonnull |