mirror of https://gerrit.osmocom.org/libosmocore
doc: clarify osmo_strlcpy() doc
Stating that it 'truncates src' is misleading. Also clarify whether siz includes the space needed for the terminating NUL. Change-Id: I01c1a94408b471f7f54576178a60938bf9ee3261
This commit is contained in:
parent
449324b264
commit
df83eced68
10
src/utils.c
10
src/utils.c
|
@ -343,12 +343,12 @@ uint8_t *osmo_encode_big_endian(uint64_t value, size_t data_len)
|
|||
/*! \brief Copy a C-string into a sized buffer
|
||||
* \param[in] src source string
|
||||
* \param[out] dst destination string
|
||||
* \param[in] siz size of the \a dst string
|
||||
* \returns length of source string
|
||||
* \param[in] siz size of the \a dst buffer
|
||||
* \returns length of \a src
|
||||
*
|
||||
* Copies up to \a siz characters from \a src to \a dst, but ensures
|
||||
* that the last character of \a dst is always a NUL character. May
|
||||
* truncate \a src to do achieve this.
|
||||
* Copy at most \a siz bytes from \a src to \a dst, ensuring that the result is
|
||||
* NUL terminated. The NUL character is included in \a siz, i.e. passing the
|
||||
* actual sizeof(*dst) is correct.
|
||||
*/
|
||||
size_t osmo_strlcpy(char *dst, const char *src, size_t siz)
|
||||
{
|
||||
|
|
Loading…
Reference in New Issue