GUACAMOLE-637: Document failsafe behavior of guac_strlcat() in the event the destination buffer is not terminated as required.
This commit is contained in:
parent
ba8fd17394
commit
350d8e5995
@ -84,6 +84,12 @@ size_t guac_strlcpy(char* restrict dest, const char* restrict src, size_t n);
|
|||||||
* string. This buffer MUST already be null-terminated and will always be
|
* string. This buffer MUST already be null-terminated and will always be
|
||||||
* null-terminated unless zero bytes are available within the buffer.
|
* null-terminated unless zero bytes are available within the buffer.
|
||||||
*
|
*
|
||||||
|
* As a safeguard against incorrectly-written code, in the event that the
|
||||||
|
* destination buffer is not null-terminated, this function will still stop
|
||||||
|
* before overrunning the buffer, instead behaving as if the length of the
|
||||||
|
* string in the buffer is exactly the size of the buffer. The destination
|
||||||
|
* buffer will remain untouched (and unterminated) in this case.
|
||||||
|
*
|
||||||
* @param src
|
* @param src
|
||||||
* The source string to append to the the destination buffer. This string
|
* The source string to append to the the destination buffer. This string
|
||||||
* MUST be null-terminated.
|
* MUST be null-terminated.
|
||||||
|
Loading…
Reference in New Issue
Block a user