xref: /third_party/bounds_checking_function/include/securec.h

129  * Parameter: destMax - The maximum length of destination buffer
134 SECUREC_API errno_t memset_s(void *dest, size_t destMax, int c, size_t count);
148  * Parameter: destMax - The maximum length of destination buffer
153 SECUREC_API errno_t memmove_s(void *dest, size_t destMax, const void *src, size_t count);
161  * Parameter: destMax - The maximum length of destination buffer
166 SECUREC_API errno_t memcpy_s(void *dest, size_t destMax, const void *src, size_t count);
174  * Parameter: destMax - The maximum length of destination buffer(including the terminating null character)
178 SECUREC_API errno_t strcpy_s(char *strDest, size_t destMax, const char *strSrc);
186  * Parameter: destMax - The maximum length of destination buffer(including the terminating null character)
191 SECUREC_API errno_t strncpy_s(char *strDest, size_t destMax, const char *strSrc, size_t count);
199  * Parameter: destMax - The maximum length of destination buffer(including the terminating null wide character)
203 SECUREC_API errno_t strcat_s(char *strDest, size_t destMax, const char *strSrc);
212  * Parameter: destMax - The maximum length of destination buffer(including the terminating null character)
217 SECUREC_API errno_t strncat_s(char *strDest, size_t destMax, const char *strSrc, size_t count);
222  * Description: The vsprintf_s function is equivalent to the vsprintf function except for the parameter destMax
225  * Parameter: destMax - The maximum length of destination buffer(including the terminating null wide character)
231 SECUREC_API int vsprintf_s(char *strDest, size_t destMax, const char *format,
237  * Description: The sprintf_s function is equivalent to the sprintf function except for the parameter destMax
240  * Parameter: destMax - The maximum length of destination buffer(including the terminating null byte '\0')
245 SECUREC_API int sprintf_s(char *strDest, size_t destMax, const char *format, ...) SECUREC_ATTRIBUTE(3, 4);
251  * the parameter destMax/count and the explicit runtime-constraints violation
253  * Parameter: destMax - The maximum length of destination buffer(including the terminating null  byte '\0')
260 SECUREC_API int vsnprintf_s(char *strDest, size_t destMax, size_t count, const char *format,
267  * the parameter destMax/count and the explicit runtime-constraints violation
269  * Parameter: destMax - The maximum length of destination buffer(including the terminating null  byte '\0')
275 SECUREC_API int snprintf_s(char *strDest, size_t destMax, size_t count, const char *format,
284  * Parameter: destMax - The maximum length of destination buffer(including the terminating null  byte '\0')
288  * If an error occurred Return: -1.Pay special attention to returning destMax - 1 when truncation occurs
290 SECUREC_API int vsnprintf_truncated_s(char *strDest, size_t destMax, const char *format,
297  * Parameter: destMax - The maximum length of destination buffer(including the terminating null byte '\0')
300  * If an error occurred Return: -1.Pay special attention to returning destMax - 1 when truncation occurs.
302 SECUREC_API int snprintf_truncated_s(char *strDest, size_t destMax,
391  * by destMax from the stream pointed to by stdin, into the array pointed to by buffer
393  * Parameter: destMax - The maximum length of destination buffer(including the terminating null character)
396 SECUREC_API char *gets_s(char *buffer, size_t destMax);
405  * Parameter: destMax - The maximum length of destination buffer
410 SECUREC_API errno_t wmemcpy_s(wchar_t *dest, size_t destMax, const wchar_t *src, size_t count);
418  * Parameter: destMax - The maximum length of destination buffer
423 SECUREC_API errno_t wmemmove_s(wchar_t *dest, size_t destMax, const wchar_t *src, size_t count);
431  * Parameter: destMax - The maximum length of destination buffer
435 SECUREC_API errno_t wcscpy_s(wchar_t *strDest, size_t destMax, const wchar_t *strSrc);
443  * Parameter: destMax - The maximum length of destination buffer(including the terminating wide character)
448 SECUREC_API errno_t wcsncpy_s(wchar_t *strDest, size_t destMax, const wchar_t *strSrc, size_t count);
456  * Parameter: destMax - The maximum length of destination buffer(including the terminating wide character)
460 SECUREC_API errno_t wcscat_s(wchar_t *strDest, size_t destMax, const wchar_t *strSrc);
469  * Parameter: destMax - The maximum length of destination buffer(including the terminating wide character)
474 SECUREC_API errno_t wcsncat_s(wchar_t *strDest, size_t destMax, const wchar_t *strSrc, size_t count);
493  * Parameter: destMax - The maximum length of destination buffer(including the terminating null)
499 SECUREC_API int vswprintf_s(wchar_t *strDest, size_t destMax, const wchar_t *format, va_list argList);
506  * Parameter: destMax - The maximum length of destination buffer(including the terminating null)
511 SECUREC_API int swprintf_s(wchar_t *strDest, size_t destMax, const wchar_t *format, ...);
578 extern errno_t strncpy_error(char *strDest, size_t destMax, const char *strSrc, size_t count);
579 extern errno_t strcpy_error(char *strDest, size_t destMax, const char *strSrc);
583 extern errno_t memset_sOptAsm(void *dest, size_t destMax, int c, size_t count);
584 extern errno_t memset_sOptTc(void *dest, size_t destMax, int c, size_t count);
585 extern errno_t memcpy_sOptAsm(void *dest, size_t destMax, const void *src, size_t count);
586 extern errno_t memcpy_sOptTc(void *dest, size_t destMax, const void *src, size_t count);
589 #define strcpy_sp(dest, destMax, src)  ((__builtin_constant_p((destMax)) && \
591     SECUREC_STRCPY_SM((dest), (destMax), (src)) : \
592     strcpy_s((dest), (destMax), (src)))
595 #define strncpy_sp(dest, destMax, src, count)  ((__builtin_constant_p((count)) && \
596     __builtin_constant_p((destMax)) && \
598     SECUREC_STRNCPY_SM((dest), (destMax), (src), (count)) : \
599     strncpy_s((dest), (destMax), (src), (count)))
602 #define strcat_sp(dest, destMax, src) ((__builtin_constant_p((destMax)) && \
604     SECUREC_STRCAT_SM((dest), (destMax), (src)) : \
605     strcat_s((dest), (destMax), (src)))
608 #define strncat_sp(dest, destMax, src, count) ((__builtin_constant_p((count)) &&  \
609     __builtin_constant_p((destMax)) && \
611     SECUREC_STRNCAT_SM((dest), (destMax), (src), (count)) : \
612     strncat_s((dest), (destMax), (src), (count)))
615 #define memcpy_sp(dest, destMax, src, count)  (__builtin_constant_p((count)) ? \
616     (SECUREC_MEMCPY_SM((dest), (destMax), (src), (count))) : \
617     (__builtin_constant_p((destMax)) ? \
618     (((size_t)(destMax) > 0 && \
619     (((unsigned long long)(destMax) & (unsigned long long)(-2)) < SECUREC_MEM_MAX_LEN)) ? \
620     memcpy_sOptTc((dest), (destMax), (src), (count)) : ERANGE) : \
621     memcpy_sOptAsm((dest), (destMax), (src), (count))))
624 #define memset_sp(dest, destMax, c, count)  (__builtin_constant_p((count)) ? \
625     (SECUREC_MEMSET_SM((dest), (destMax), (c), (count))) : \
626     (__builtin_constant_p((destMax)) ? \
627     (((((unsigned long long)(destMax) & (unsigned long long)(-2)) < SECUREC_MEM_MAX_LEN)) ? \
628     memset_sOptTc((dest), (destMax), (c), (count)) : ERANGE) : \
629     memset_sOptAsm((dest), (destMax), (c), (count))))

Indexes created Thu Nov 07 10:32:03 CST 2024