aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-08-31 19:40:20 +0200
committerMattias Andrée <maandree@operamail.com>2015-08-31 19:40:20 +0200
commitd83903d9e26ec17604ebfb66f09adc9dd93fd02d (patch)
tree30e9e4189937cf1f5d73b0f381a498355631ba27 /include
parentadd strlen and wcslen (diff)
downloadslibc-d83903d9e26ec17604ebfb66f09adc9dd93fd02d.tar.gz
slibc-d83903d9e26ec17604ebfb66f09adc9dd93fd02d.tar.bz2
slibc-d83903d9e26ec17604ebfb66f09adc9dd93fd02d.tar.xz
add memory copying functions
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to '')
-rw-r--r--include/string.h564
-rw-r--r--include/wchar.h577
2 files changed, 1135 insertions, 6 deletions
diff --git a/include/string.h b/include/string.h
index 560080b..6c5c80e 100644
--- a/include/string.h
+++ b/include/string.h
@@ -129,9 +129,9 @@ char* __gnu_strerror_r(int, char*, size_t); /* GNU-specific strerror_r */
size_t strlen(const char*)
__GCC_ONLY(__attribute__((nonnull, warn_unused_result)));
-#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) || \
- defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) || \
- defined(_BSD_SOURCE)
+#if (defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) || \
+ defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) || \
+ defined(_BSD_SOURCE)) && !defined(_PORTABLE_SOURCE)
/**
* Variant of `strlen` that only inspects the
* beginning of s string.
@@ -147,5 +147,563 @@ size_t strnlen(const char*, size_t)
+/**
+ * Override a memory segment with a repeated character.
+ *
+ * @param segment The beginning of the memory segment.
+ * @param c The character (8 bits wide.)
+ * @param size The size of the memory segment.
+ * @return `segment` is returned.
+ */
+void* memset(void*, int, size_t);
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of bytes to copy.
+ * @return `whither` is returned.
+ */
+void* memcpy(void* restrict, const void* restrict, size_t);
+
+#if defined(_GNU_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment.
+ *
+ * This is a GNU extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of bytes to copy.
+ * @return `whither + size` is returned.
+ */
+void* mempcpy(void* restrict, const void* restrict, size_t);
+#endif
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of bytes to copy.
+ * @return `whither` is returned.
+ */
+void* memmove(void*, const void*, size_t);
+
+#if defined(_SLIBC_SOURCE) && defined(_GNU_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of bytes to copy.
+ * @return `whither + size` is returned.
+ */
+void* mempmove(void*, const void*, size_t);
+#endif
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * but stop if a specific byte is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The byte to stop at if encountered.
+ * @param size The maximum number of bytes to copy.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written character.
+ */
+void* memccpy(void* restrict, const void* restrict, int, size_t);
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * but stop if a specific byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The byte to stop at if encountered.
+ * @param size The maximum number of bytes to copy.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written character.
+ */
+void* memcmove(void*, const void*, int, size_t);
+#endif
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither` is returned.
+ */
+char* strcpy(char* restrict, const char* restrict)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither + strlen(whence)` is returned.
+ */
+char* stpcpy(char* restrict, const char* restrict)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte or a specified byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop byte.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strccpy(char* restrict, const char* restrict, int)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strstrcpy(char* restrict, const char* restrict, const char* restrict)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+#endif
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `whither` is returned.
+ */
+char* strncpy(char* restrict, const char* restrict, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+#if defined(_GNU_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * This is a GNU extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `whither` plus the number of written bytes,
+ * excluding NUL bytes, is returned.
+ */
+char* stpncpy(char* restrict, const char* restrict, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+# if defined(_SLIBC_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte or a specified byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop byte.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strcncpy(char* restrict, const char* restrict, int, size_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL byte or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strstrncpy(char* restrict, const char* restrict, const char* restrict, size_t)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+# endif
+#endif
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither` is returned.
+ */
+char* strmove(char*, const char*)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither + strlen(whence)` is returned.
+ */
+char* stpmove(char*, const char*)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte or a specified byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop byte.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strcmove(char*, const char*, int)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strstrmove(char*, const char*, const char* restrict)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `whither` is returned.
+ */
+char* strnmove(char*, const char*, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+# if defined(_GNU_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `whither` plus the number of written bytes,
+ * excluding NUL bytes, is returned.
+ */
+char* stpnmove(char*, const char*, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte or a specified byte is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop byte.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strcnmove(char*, const char*, int, size_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL byte or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+char* strstrnmove(char*, const char*, const char* restrict, size_t)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+# endif
+#endif
+
+/**
+ * Concatenate a string to the end of another string.
+ * The resulting strings must not overlap with the appended string.
+ *
+ * The use of this function is often a bad idea.
+ *
+ * @param whither The string to extend.
+ * @param whence The string to append.
+ * @return `whither` is returned.
+ */
+char* strcat(char* restrict, const char* restrict)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/* stpcat does not exsits because use of it would be very inefficient. */
+
+/**
+ * Concatenate a string to the end of another string.
+ * The resulting strings must not overlap with the appended string.
+ *
+ * The use of this function is often a really bad idea.
+ *
+ * @param whither The string to extend.
+ * @param whence The string to append.
+ * @param maxlen The maximum number of bytes to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL byte will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL bytes
+ * until this amount of bytes have been written.
+ * @return `whither` is returned.
+ */
+char* strncat(char* restrict, const char* restrict, size_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/* stpncat does not exsits because use of it would be very inefficient. */
+
+
+/**
+ * Duplicate a string.
+ *
+ * @param string The string to duplicate.
+ * @return The new string. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+char* strdup(const char*)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+
+#if !defined(_PORTABLE_SOURCE)
+# if defined(_GNU_SOURCE)
+/**
+ * Duplicate a string.
+ *
+ * This is a GNU extension.
+ *
+ * @param string The string to duplicate.
+ * @param maxlen Truncate the string to this length, if it is longer.
+ * A NUL byte is guaranteed to always be written
+ * upon successful completion.
+ * @return The new string. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+char* strndup(const char*, size_t)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+# endif
+
+# if defined(_SLIBC_SOURCE)
+/**
+ * Duplicate a memory segment.
+ *
+ * This is a slibc extension.
+ *
+ * @param segment The memory segment to duplicate.
+ * @param size The size of the memory segment.
+ * @return The new segment. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+void* memdup(const void*, size_t)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+# endif
+
+# if defined (__GNUC__)
+# if defined(_GNU_SOURCE) || defined(_SLIBC_SOURCE)
+/**
+ * Duplicate a string, using dymanic stack allocation (`alloca`).
+ *
+ * This is a GNU-compliant slibc extension.
+ * This macro is only available when using GCC.
+ *
+ * @param string:const char* The string to duplicate.
+ * @return :size_t The new string. There is no way to
+ * detect whether the allocation failed.
+ */
+# define strdupa(string) \
+ ({ \
+ size_t n = strlen(string) + 1; \
+ char* r = __builtin_alloca(n * sizeof(char)); \
+ memcpy(r, string, n); \
+ })
+# endif
+
+# if defined(_GNU_SOURCE)
+/**
+ * Duplicate a string, using dymanic stack allocation (`alloca`).
+ *
+ * This is a GNU extension.
+ * This macro is only available when using GCC.
+ *
+ * @param string:const char* The string to duplicate.
+ * @param maxlen:size_t Truncate the string to this length, if it is longer.
+ * A NUL byte is guaranteed to always be written.
+ * @return :size_t The new string. There is no way to
+ * detect whether the allocation failed.
+ */
+# define strndupa(string, maxlen) \
+ ({ \
+ size_t n = strnlen(string, maxlen) + 1; \
+ char* r = __builtin_alloca(n * sizeof(char)); \
+ memcpy(r, string, n); \
+ })
+# endif
+
+# if defined(_SLIBC_SOURCE)
+/**
+ * Duplicate a memory segment, using dymanic stack allocation (`alloca`).
+ *
+ * This is a slibc extension.
+ * This macro is only available when using GCC.
+ *
+ * @param segment:const void* The memory segment to duplicate.
+ * @param size:size_t The size of the memory segment.
+ * @return :size_t The new segment. There is no way to
+ * detect whether the allocation failed.
+ */
+# define memdupa(segment, size) \
+ ({ \
+ wchar_t* r = __builtin_alloca(size * sizeof(wchar_t)); \
+ memcpy(r, segment, size); \
+ })
+# endif
+# endif
+#endif
+
+
+
#endif
diff --git a/include/wchar.h b/include/wchar.h
index c9901d2..32f32b0 100644
--- a/include/wchar.h
+++ b/include/wchar.h
@@ -41,9 +41,9 @@
size_t wcslen(const wchar_t*)
__GCC_ONLY(__attribute__((nonnull, warn_unused_result)));
-#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) || \
- defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) || \
- defined(_BSD_SOURCE)
+#if (defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) || \
+ defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) || \
+ defined(_BSD_SOURCE)) && !defined(_PORTABLE_SOURCE)
/**
* `wchar_t` version of `strnlen`.
*
@@ -59,6 +59,577 @@ size_t wcsnlen(const wchar_t*, size_t)
+/**
+ * Override a memory segment with a repeated wide character.
+ *
+ * @param segment The beginning of the memory segment.
+ * @param c The wide character.
+ * @param size The number of wide characters in the memory segment.
+ * @return `segment` is returned.
+ */
+wchar_t* wmemset(wchar_t*, wchar_t, size_t);
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of wide characters to copy.
+ * @return `whither` is returned.
+ */
+wchar_t* wmemcpy(wchar_t* restrict, const wchar_t* restrict, size_t);
+
+#if defined(_GNU_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment.
+ *
+ * This is a GNU extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of wide characters to copy.
+ * @return `whither + size` is returned.
+ */
+wchar_t* wmempcpy(wchar_t* restrict, const wchar_t* restrict, size_t);
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment.
+ *
+ * This is a GNU extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of wide characters to copy.
+ * @return `whither` is returned.
+ */
+wchar_t* wmemmove(wchar_t*, const wchar_t*, size_t);
+
+# if defined(_SLIBC_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param size The number of wide characters to copy.
+ * @return `whither + size` is returned.
+ */
+wchar_t* wmempmove(wchar_t*, const wchar_t*, size_t);
+# endif
+#endif
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * but stop if a specific character is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The character to stop at if encountered.
+ * @param size The maximum number of wide characters to copy.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the possition of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written character.
+ */
+wchar_t* wmemccpy(wchar_t* restrict, const wchar_t* restrict, wchar_t, size_t);
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * but stop if a specific character is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The character to stop at if encountered.
+ * @param size The maximum number of wide characters to copy.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the possition of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written character.
+ */
+wchar_t* wmemcmove(wchar_t*, const wchar_t*, wchar_t, size_t);
+#endif
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither` is returned.
+ */
+wchar_t* wcscpy(wchar_t* restrict, const wchar_t* restrict)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+#if (defined(_SLIBC_SOURCE) || defined(_GNU_SOURCE)) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * This is a GNU-compliant slibc extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither + wcslen(whence)` is returned.
+ */
+wchar_t* wcpcpy(wchar_t* restrict, const wchar_t* restrict)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+#endif
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character or a specified wide character
+ * is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop character.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcsccpy(wchar_t* restrict, const wchar_t* restrict, wchat_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcswcscpy(wchar_t* restrict, const wchar_t* restrict, const wchar_t* restrict)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+#endif
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `whither` is returned.
+ */
+wchar_t* wcsncpy(wchar_t* restrict, const wchar_t* restrict, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+#if defined(_GNU_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * This is a GNU extension.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `whither` plus the number of written characters,
+ * excluding NUL characters, is returned.
+ */
+wchar_t* wcpncpy(wchar_t* restrict, const wchar_t* restrict, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+# if defined(_SLIBC_SOURCE)
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character or a specified wide character
+ * is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop character.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcscncpy(wchar_t* restrict, const wchar_t* restrict, wchat_t, size_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, non-overlapping, segment,
+ * stop when a NUL wide character or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied chartacters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcswcsncpy(wchar_t* restrict, const wchar_t* restrict, const wchar_t* restrict, size_t)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+# endif
+#endif
+
+#if defined(_SLIBC_SOURCE) && !defined(_PORTABLE_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither` is returned.
+ */
+wchar_t* wcsmove(wchar_t*, const wchar_t*)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @return `whither + wcslen(whence)` is returned.
+ */
+wchar_t* wcpmove(wchar_t*, const wchar_t*)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character or a specified wide character
+ * is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop character.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcscmove(wchar_t*, const wchar_t*, wchat_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcswcsmove(wchar_t*, const wchar_t*, const wchar_t* restrict)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `whither` is returned.
+ */
+wchar_t* wcsnmove(wchar_t*, const wchar_t*, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+# if defined(_GNU_SOURCE)
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `whither` plus the number of written characters,
+ * excluding NUL characters, is returned.
+ */
+wchar_t* wcpnmove(wchar_t*, const wchar_t*, size_t)
+ __GCC_ONLY(__attribute__((returns_nonnull, nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character or a specified wide character
+ * is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param c The stop character.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `NULL` if `c` was not encountered, otherwise
+ * the position of `c` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied characters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcscnmove(wchar_t*, const wchar_t*, wchat_t, size_t)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/**
+ * Copy a memory segment to another, possibly overlapping, segment,
+ * stop when a NUL wide character or a specified substring is encountered.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param whither The destination memory segment.
+ * @param whence The source memory segment.
+ * @param str The substring, ignored if `NULL`.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `NULL` if `str` was not encountered, otherwise
+ * the position of `str` translated to `whither`,
+ * that is, the address of `whither` plus the
+ * number of copied chartacters; the address of
+ * one character passed the last written non-NUL
+ * character.
+ */
+wchar_t* wcswcsnmove(wchar_t*, const wchar_t*, const wchar_t* restrict, size_t)
+ __GCC_ONLY(__attribute__((nonnull(1, 2))));
+# endif
+#endif
+
+/**
+ * Concatenate a string to the end of another string.
+ * The resulting strings must not overlap with the appended string.
+ *
+ * The use of this function is often a bad idea.
+ *
+ * @param whither The string to extend.
+ * @param whence The string to append.
+ * @return `whither` is returned.
+ */
+wchar_t* wcscat(wchar_t* restrict whither, const wchar_t* restrict whence)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/* wcpcat does not exsits because use of it would be very inefficient. */
+
+/**
+ * Concatenate a string to the end of another string.
+ * The resulting strings must not overlap with the appended string.
+ *
+ * The use of this function is often a really bad idea.
+ *
+ * @param whither The string to extend.
+ * @param whence The string to append.
+ * @param maxlen The maximum number of wide characters to copy.
+ * NOTE that if the resulting string at least this
+ * long, no NUL character will be written to `whither'.
+ * On the otherhand, if the resultnig string is
+ * shorter, `whither` will be filled with NUL characters
+ * until this amount of characters have been written.
+ * @return `whither` is returned.
+ */
+wchar_t* wcsncat(wchar_t* restrict whither, const wchar_t* restrict whence, size_t maxlen)
+ __GCC_ONLY(__attribute__((nonnull)));
+
+/* wcpncat does not exsits because use of it would be very inefficient. */
+
+
+#if !defined(_PORTABLE_SOURCE)
+/**
+ * Duplicate a string.
+ *
+ * This is a GNU-compliant slibc extension.
+ *
+ * @param string The string to duplicate.
+ * @return The new string. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+wchar_t* wcsdup(const wchar_t*)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+
+# if defined(_SLIBC_SOURCE)
+# if defined(_GNU_SOURCE)
+/**
+ * Duplicate a string.
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ *
+ * @param string The string to duplicate.
+ * @param maxlen Truncate the string to this length, if it is longer.
+ * A NUL wide character is guaranteed to always be
+ * written upon successful completion.
+ * @return The new string. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+wchar_t* wcsndup(const wchar_t*, size_t)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+# endif
+
+/**
+ * Duplicate a memory segment.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param segment The memory segment to duplicate.
+ * @param size The size of the memory segment.
+ * @return The new segment. `NULL` is returned on error
+ * and `errno` is set to indicate the error.
+ *
+ * @throws ENOMEM The process could not allocate sufficient amount of memory.
+ */
+wchar_t* wmemdup(const wchar_t*, size_t)
+ __GCC_ONLY(__attribute__((malloc, nonnull, warn_unused_result)));
+
+# if defined(__GNUC__)
+# if defined(_GNU_SOURCE)
+/**
+ * Duplicate a string, using dymanic stack allocation (`alloca`).
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ * This macro is only available when using GCC.
+ *
+ * @param string:const wchar_t* The string to duplicate.
+ * @return :size_t The new string. There is no way to
+ * detect whether the allocation failed.
+ */
+# define wcsdupa(string) \
+ ({ \
+ size_t n = wcslen(string) + 1; \
+ wchar_t* r = __builtin_alloca(n * sizeof(char)); \
+ wmemcpy(r, string, n); \
+ })
+
+/**
+ * Duplicate a string, using dymanic stack allocation (`alloca`).
+ *
+ * This is a slibc extension added for completeness.
+ * It is only available if GNU extensions are available.
+ * This macro is only available when using GCC.
+ *
+ * @param string:const wchar_t* The string to duplicate.
+ * @param maxlen:size_t Truncate the string to this length, if it is longer.
+ * A NUL byte is guaranteed to always be written.
+ * @return :size_t The new string. There is no way to
+ * detect whether the allocation failed.
+ */
+# define wstrndupa(string, maxlen) \
+ ({ \
+ size_t n = wcsnlen(string, maxlen) + 1; \
+ wchar_t* r = __builtin_alloca(n * sizeof(wchar_t)); \
+ wmemcpy(r, string, n); \
+ })
+# endif
+
+/**
+ * Duplicate a memory segment, using dymanic stack allocation (`alloca`).
+ *
+ * This is a slibc extension added for completeness.
+ * This macro is only available when using GCC.
+ *
+ * @param segment:const wchar_t* The memory segment to duplicate.
+ * @param size:size_t The size of the memory segment.
+ * @return :size_t The new segment. There is no way to
+ * detect whether the allocation failed.
+ */
+# define wmemdupa(segment, size) \
+ ({ \
+ wchar_t* r = __builtin_alloca(size * sizeof(wchar_t)); \
+ wmemcpy(r, segmetn, size); \
+ })
+# endif
+# endif
+#endif
+
+
+
#endif
#endif