aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2024-08-18 09:43:16 +0200
committerMattias Andrée <maandree@kth.se>2024-08-18 09:43:16 +0200
commit715b59e5002b971a987c3c8a2e1b3e61d80388f7 (patch)
treeaa64aa9fed94388056432f0f4a2180d5c03523fd
parentAdd @since for definitions added in version 1.0 and 1.1 (diff)
parentFix tests and libsimple_arraycpy and libsimple_arraymove (diff)
downloadlibsimple-715b59e5002b971a987c3c8a2e1b3e61d80388f7.tar.gz
libsimple-715b59e5002b971a987c3c8a2e1b3e61d80388f7.tar.bz2
libsimple-715b59e5002b971a987c3c8a2e1b3e61d80388f7.tar.xz
Merge tag '1.2' into since
Version 1.2
Diffstat (limited to '')
-rw-r--r--Makefile34
-rw-r--r--README4
-rw-r--r--aligned_enmemdup.c64
-rw-r--r--aligned_memdup.c7
-rw-r--r--aligned_strndup.c108
-rw-r--r--aligned_wcsndup.c32
-rw-r--r--aligned_wmemdup.c32
-rw-r--r--allocn.c12
-rw-r--r--enaligned_realloc.c105
-rw-r--r--enaligned_reallocarray.c105
-rw-r--r--enaligned_strdup.c78
-rw-r--r--enaligned_strndup.c134
-rw-r--r--enaligned_wcsdup.c78
-rw-r--r--enaligned_wcsndup.c134
-rw-r--r--enaligned_wmemdup.c64
-rw-r--r--engmtime.c24
-rw-r--r--enlocaltime.c24
-rw-r--r--enrealloc.c2
-rw-r--r--enreallocarray.c132
-rw-r--r--envaligned_reallocn.c25
-rw-r--r--enwcsdup.c71
-rw-r--r--enwcsndup.c132
-rw-r--r--enwmemdup.c72
-rw-r--r--gmtime.c61
-rw-r--r--libsimple-arg.h30
-rw-r--r--libsimple.c352
-rw-r--r--libsimple.h111
-rw-r--r--libsimple/aligned_memdup.h6
-rw-r--r--libsimple/aligned_realloc.h655
-rw-r--r--libsimple/aligned_strdup.h74
-rw-r--r--libsimple/aligned_strndup.h79
-rw-r--r--libsimple/aligned_wcsdup.h74
-rw-r--r--libsimple/aligned_wcsndup.h79
-rw-r--r--libsimple/aligned_wmemdup.h79
-rw-r--r--libsimple/array.h4
-rw-r--r--libsimple/memdup.h4
-rw-r--r--libsimple/realloc.h260
-rw-r--r--libsimple/str.h8
-rw-r--r--libsimple/strdup.h2
-rw-r--r--libsimple/strn.h6
-rw-r--r--libsimple/strndup.h2
-rw-r--r--libsimple/time.h102
-rw-r--r--libsimple/wcsdup.h51
-rw-r--r--libsimple/wcsndup.h72
-rw-r--r--libsimple/wmemdup.h68
-rw-r--r--localtime.c61
-rw-r--r--man0/libsimple-arg.h.09
-rw-r--r--man0/libsimple.h.0937
-rw-r--r--man3/ELEMSOF.3libsimple11
-rw-r--r--man3/INTSTRLEN.3libsimple11
-rw-r--r--man3/MAX.3libsimple13
-rw-r--r--man3/MAX3.3libsimple13
-rw-r--r--man3/MIN.3libsimple13
-rw-r--r--man3/MIN3.3libsimple13
-rw-r--r--man3/STRLEN.3libsimple11
-rw-r--r--man3/TYPE_MAX.3libsimple11
-rw-r--r--man3/TYPE_MIN.3libsimple11
l---------man3/aligned_realloc.3libsimple1
l---------man3/aligned_reallocarray.3libsimple1
l---------man3/aligned_reallocarrayf.3libsimple1
l---------man3/aligned_reallocf.3libsimple1
l---------man3/aligned_reallocfn.3libsimple1
l---------man3/aligned_reallocn.3libsimple1
l---------man3/aligned_strdup.3libsimple1
l---------man3/aligned_strdupa.3libsimple1
l---------man3/aligned_strndup.3libsimple1
l---------man3/aligned_strndupa.3libsimple1
l---------man3/aligned_wcsdup.3libsimple1
l---------man3/aligned_wcsdupa.3libsimple1
l---------man3/aligned_wcsndup.3libsimple1
l---------man3/aligned_wcsndupa.3libsimple1
l---------man3/aligned_wmemdup.3libsimple1
l---------man3/aligned_wmemdupa.3libsimple1
l---------man3/ealigned_realloc.3libsimple1
l---------man3/ealigned_reallocarray.3libsimple1
l---------man3/ealigned_reallocn.3libsimple1
l---------man3/ealigned_strdup.3libsimple1
l---------man3/ealigned_strndup.3libsimple1
l---------man3/ealigned_wcsdup.3libsimple1
l---------man3/ealigned_wcsndup.3libsimple1
l---------man3/ealigned_wmemdup.3libsimple1
l---------man3/enaligned_realloc.3libsimple1
l---------man3/enaligned_reallocarray.3libsimple1
l---------man3/enaligned_reallocn.3libsimple1
l---------man3/enaligned_strdup.3libsimple1
l---------man3/enaligned_strndup.3libsimple1
l---------man3/enaligned_wcsdup.3libsimple1
l---------man3/enaligned_wcsndup.3libsimple1
l---------man3/enaligned_wmemdup.3libsimple1
l---------man3/enreallocarray.3libsimple1
l---------man3/envaligned_reallocn.3libsimple1
l---------man3/enwcsdup.3libsimple1
l---------man3/enwcsndup.3libsimple1
l---------man3/enwmemdup.3libsimple1
l---------man3/ereallocarray.3libsimple1
l---------man3/evaligned_reallocn.3libsimple1
l---------man3/ewcsdup.3libsimple1
l---------man3/ewcsndup.3libsimple1
l---------man3/ewmemdup.3libsimple1
-rw-r--r--man3/libsimple_aligned_allocz.324
-rw-r--r--man3/libsimple_aligned_memdup.325
-rw-r--r--man3/libsimple_aligned_realloc.3212
-rw-r--r--man3/libsimple_aligned_reallocarray.3214
-rw-r--r--man3/libsimple_aligned_reallocarrayf.3166
-rw-r--r--man3/libsimple_aligned_reallocf.3164
l---------man3/libsimple_aligned_reallocfn.31
l---------man3/libsimple_aligned_reallocn.31
-rw-r--r--man3/libsimple_aligned_strdup.3163
l---------man3/libsimple_aligned_strdupa.31
-rw-r--r--man3/libsimple_aligned_strndup.3166
l---------man3/libsimple_aligned_strndupa.31
-rw-r--r--man3/libsimple_aligned_wcsdup.3163
l---------man3/libsimple_aligned_wcsdupa.31
-rw-r--r--man3/libsimple_aligned_wcsndup.3168
l---------man3/libsimple_aligned_wcsndupa.31
-rw-r--r--man3/libsimple_aligned_wmemdup.3167
l---------man3/libsimple_aligned_wmemdupa.31
-rw-r--r--man3/libsimple_close.313
-rw-r--r--man3/libsimple_cmptimespec.314
-rw-r--r--man3/libsimple_difftimespec.314
-rw-r--r--man3/libsimple_doubletotimespec.314
l---------man3/libsimple_ealigned_realloc.31
l---------man3/libsimple_ealigned_reallocarray.31
l---------man3/libsimple_ealigned_reallocn.31
l---------man3/libsimple_ealigned_strdup.31
l---------man3/libsimple_ealigned_strndup.31
l---------man3/libsimple_ealigned_wcsdup.31
l---------man3/libsimple_ealigned_wcsndup.31
l---------man3/libsimple_ealigned_wmemdup.31
l---------man3/libsimple_egmtime.31
l---------man3/libsimple_elocaltime.31
-rw-r--r--man3/libsimple_enaligned_alloc.324
l---------man3/libsimple_enaligned_realloc.31
l---------man3/libsimple_enaligned_reallocarray.31
l---------man3/libsimple_enaligned_reallocn.31
l---------man3/libsimple_enaligned_strdup.31
l---------man3/libsimple_enaligned_strndup.31
l---------man3/libsimple_enaligned_wcsdup.31
l---------man3/libsimple_enaligned_wcsndup.31
l---------man3/libsimple_enaligned_wmemdup.31
-rw-r--r--man3/libsimple_encalloc.324
l---------man3/libsimple_engmtime.31
l---------man3/libsimple_enlocaltime.31
-rw-r--r--man3/libsimple_enmalloc.324
-rw-r--r--man3/libsimple_enposix_memalign.324
-rw-r--r--man3/libsimple_enrealloc.324
l---------man3/libsimple_enreallocarray.31
-rw-r--r--man3/libsimple_enstrdup.322
-rw-r--r--man3/libsimple_enstrndup.322
l---------man3/libsimple_envaligned_reallocn.31
-rw-r--r--man3/libsimple_enwcsdup.3136
l---------man3/libsimple_enwcsndup.31
l---------man3/libsimple_enwmemdup.31
l---------man3/libsimple_ereallocarray.31
l---------man3/libsimple_evaligned_reallocn.31
l---------man3/libsimple_ewcsdup.31
l---------man3/libsimple_ewcsndup.31
l---------man3/libsimple_ewmemdup.31
-rw-r--r--man3/libsimple_getenv_e.314
-rw-r--r--man3/libsimple_getenv_ne.314
-rw-r--r--man3/libsimple_gmtime.3133
-rw-r--r--man3/libsimple_inchrset.314
-rw-r--r--man3/libsimple_localtime.3133
-rw-r--r--man3/libsimple_mallocz.324
-rw-r--r--man3/libsimple_memalign.324
-rw-r--r--man3/libsimple_memalignz.324
-rw-r--r--man3/libsimple_memcasechr.314
-rw-r--r--man3/libsimple_memcasechr_inv.314
-rw-r--r--man3/libsimple_memcasecmp.314
-rw-r--r--man3/libsimple_memcaseends.314
-rw-r--r--man3/libsimple_memcaseeq.314
-rw-r--r--man3/libsimple_memcaseeqlen.314
-rw-r--r--man3/libsimple_memcasemem.314
-rw-r--r--man3/libsimple_memcasescan.314
-rw-r--r--man3/libsimple_memcasescan_inv.314
-rw-r--r--man3/libsimple_memcasestarts.314
-rw-r--r--man3/libsimple_memchr_inv.314
-rw-r--r--man3/libsimple_memcmove.314
-rw-r--r--man3/libsimple_memdup.324
-rw-r--r--man3/libsimple_memelem.314
-rw-r--r--man3/libsimple_memelem_inv.314
-rw-r--r--man3/libsimple_memelemmove.314
-rw-r--r--man3/libsimple_memelemscan.314
-rw-r--r--man3/libsimple_memelemscan_inv.314
-rw-r--r--man3/libsimple_memends.314
-rw-r--r--man3/libsimple_memeq.314
-rw-r--r--man3/libsimple_memeqlen.314
-rw-r--r--man3/libsimple_memmem.314
-rw-r--r--man3/libsimple_mempcpy.314
-rw-r--r--man3/libsimple_mempmove.314
-rw-r--r--man3/libsimple_mempset.314
-rw-r--r--man3/libsimple_mempsetelem.314
-rw-r--r--man3/libsimple_memrcasechr.314
-rw-r--r--man3/libsimple_memrcasechr_inv.314
-rw-r--r--man3/libsimple_memrcaseeqlen.314
-rw-r--r--man3/libsimple_memrcasemem.314
-rw-r--r--man3/libsimple_memrchr.314
-rw-r--r--man3/libsimple_memrchr_inv.314
-rw-r--r--man3/libsimple_memrelem.314
-rw-r--r--man3/libsimple_memrelem_inv.314
-rw-r--r--man3/libsimple_memreplace.314
-rw-r--r--man3/libsimple_memreplaceelem.314
-rw-r--r--man3/libsimple_memreqlen.314
-rw-r--r--man3/libsimple_memrmem.314
-rw-r--r--man3/libsimple_memscan.314
-rw-r--r--man3/libsimple_memscan_inv.314
-rw-r--r--man3/libsimple_memsetelem.314
-rw-r--r--man3/libsimple_memstarts.314
-rw-r--r--man3/libsimple_memtolower.314
-rw-r--r--man3/libsimple_memtoupper.314
-rw-r--r--man3/libsimple_minimise_number_string.314
-rw-r--r--man3/libsimple_multimespec.314
-rw-r--r--man3/libsimple_posix_memalignz.324
-rw-r--r--man3/libsimple_pvalloc.324
-rw-r--r--man3/libsimple_pvallocz.324
-rw-r--r--man3/libsimple_rawmemcasechr.314
-rw-r--r--man3/libsimple_rawmemcasechr_inv.314
-rw-r--r--man3/libsimple_rawmemchr.314
-rw-r--r--man3/libsimple_rawmemchr_inv.314
-rw-r--r--man3/libsimple_rawmemcmove.314
-rw-r--r--man3/libsimple_rawmemelem.314
-rw-r--r--man3/libsimple_rawmemelem_inv.314
-rw-r--r--man3/libsimple_rawmemelemmove.314
-rw-r--r--man3/libsimple_rawmemrcasechr.314
-rw-r--r--man3/libsimple_rawmemrcasechr_inv.314
-rw-r--r--man3/libsimple_rawmemrchr.314
-rw-r--r--man3/libsimple_rawmemrchr_inv.314
-rw-r--r--man3/libsimple_rawmemrelem.314
-rw-r--r--man3/libsimple_rawmemrelem_inv.314
-rw-r--r--man3/libsimple_reallocarray.3203
-rw-r--r--man3/libsimple_reallocarrayf.3155
-rw-r--r--man3/libsimple_reallocf.3153
l---------man3/libsimple_reallocfn.31
-rw-r--r--man3/libsimple_stpmove.314
-rw-r--r--man3/libsimple_stpnmove.314
-rw-r--r--man3/libsimple_strcasechr.314
-rw-r--r--man3/libsimple_strcasechr_inv.314
-rw-r--r--man3/libsimple_strcasechrnul.314
-rw-r--r--man3/libsimple_strcasechrnul_inv.314
-rw-r--r--man3/libsimple_strcasecmpnul.314
-rw-r--r--man3/libsimple_strcaseends.314
-rw-r--r--man3/libsimple_strcaseeq.314
-rw-r--r--man3/libsimple_strcaseeqlen.314
-rw-r--r--man3/libsimple_strcaseeqnul.314
-rw-r--r--man3/libsimple_strcasestarts.314
-rw-r--r--man3/libsimple_strcasestr.314
-rw-r--r--man3/libsimple_strchr_inv.314
-rw-r--r--man3/libsimple_strchrnul.314
-rw-r--r--man3/libsimple_strchrnul_inv.314
-rw-r--r--man3/libsimple_strcmove.314
-rw-r--r--man3/libsimple_strcmpnul.314
-rw-r--r--man3/libsimple_strend.314
-rw-r--r--man3/libsimple_strends.314
-rw-r--r--man3/libsimple_streq.314
-rw-r--r--man3/libsimple_streqlen.314
-rw-r--r--man3/libsimple_streqnul.314
-rw-r--r--man3/libsimple_strisutf8.314
-rw-r--r--man3/libsimple_strmove.314
-rw-r--r--man3/libsimple_strncasechr.314
-rw-r--r--man3/libsimple_strncasechr_inv.314
-rw-r--r--man3/libsimple_strncasechrnul.314
-rw-r--r--man3/libsimple_strncasechrnul_inv.314
-rw-r--r--man3/libsimple_strncasecmpnul.314
-rw-r--r--man3/libsimple_strncaseends.314
-rw-r--r--man3/libsimple_strncaseeq.314
-rw-r--r--man3/libsimple_strncaseeqlen.314
-rw-r--r--man3/libsimple_strncaseeqnul.314
-rw-r--r--man3/libsimple_strncasestarts.314
-rw-r--r--man3/libsimple_strncasestr.314
-rw-r--r--man3/libsimple_strnchr.314
-rw-r--r--man3/libsimple_strnchr_inv.314
-rw-r--r--man3/libsimple_strnchrnul.314
-rw-r--r--man3/libsimple_strnchrnul_inv.314
-rw-r--r--man3/libsimple_strncmove.314
-rw-r--r--man3/libsimple_strncmpnul.314
-rw-r--r--man3/libsimple_strnend.314
-rw-r--r--man3/libsimple_strnends.314
-rw-r--r--man3/libsimple_strneq.314
-rw-r--r--man3/libsimple_strneqlen.314
-rw-r--r--man3/libsimple_strneqnul.314
-rw-r--r--man3/libsimple_strnmove.314
-rw-r--r--man3/libsimple_strnreplace.314
-rw-r--r--man3/libsimple_strnset.314
-rw-r--r--man3/libsimple_strnstarts.314
-rw-r--r--man3/libsimple_strnstr.314
-rw-r--r--man3/libsimple_strntolower.314
-rw-r--r--man3/libsimple_strntoupper.314
-rw-r--r--man3/libsimple_strrcasechr.314
-rw-r--r--man3/libsimple_strrcasechr_inv.314
-rw-r--r--man3/libsimple_strrcaseeqlen.314
-rw-r--r--man3/libsimple_strrcasestr.314
-rw-r--r--man3/libsimple_strrchr_inv.314
-rw-r--r--man3/libsimple_strreplace.314
-rw-r--r--man3/libsimple_strreqlen.314
-rw-r--r--man3/libsimple_strrncasechr.314
-rw-r--r--man3/libsimple_strrncasechr_inv.314
-rw-r--r--man3/libsimple_strrncaseeqlen.314
-rw-r--r--man3/libsimple_strrncasestr.314
-rw-r--r--man3/libsimple_strrnchr.314
-rw-r--r--man3/libsimple_strrnchr_inv.314
-rw-r--r--man3/libsimple_strrneqlen.314
-rw-r--r--man3/libsimple_strrnstr.314
-rw-r--r--man3/libsimple_strrstr.314
-rw-r--r--man3/libsimple_strset.314
-rw-r--r--man3/libsimple_strstarts.314
-rw-r--r--man3/libsimple_strtolower.314
-rw-r--r--man3/libsimple_strtotimespec.314
-rw-r--r--man3/libsimple_strtoupper.314
-rw-r--r--man3/libsimple_sumtimespec.314
-rw-r--r--man3/libsimple_timespectodouble.314
-rw-r--r--man3/libsimple_timespectostr.314
-rw-r--r--man3/libsimple_timeval2timespec.314
-rw-r--r--man3/libsimple_unlist.314
-rw-r--r--man3/libsimple_valigned_allocn.324
-rw-r--r--man3/libsimple_valigned_alloczn.324
-rw-r--r--man3/libsimple_valigned_reallocfn.3189
-rw-r--r--man3/libsimple_valigned_reallocn.3279
-rw-r--r--man3/libsimple_valloc.324
-rw-r--r--man3/libsimple_vallocz.324
-rw-r--r--man3/libsimple_varrayalloc.324
-rw-r--r--man3/libsimple_vasprintf.314
-rw-r--r--man3/libsimple_vcallocn.324
-rw-r--r--man3/libsimple_vmallocn.324
-rw-r--r--man3/libsimple_vmalloczn.324
-rw-r--r--man3/libsimple_vmemalignn.324
-rw-r--r--man3/libsimple_vmemalignzn.324
-rw-r--r--man3/libsimple_vmemalloc.324
-rw-r--r--man3/libsimple_vposix_memalignn.324
-rw-r--r--man3/libsimple_vposix_memalignzn.324
-rw-r--r--man3/libsimple_vputenvf.314
-rw-r--r--man3/libsimple_vpvallocn.324
-rw-r--r--man3/libsimple_vpvalloczn.324
-rw-r--r--man3/libsimple_vreallocfn.3178
-rw-r--r--man3/libsimple_vreallocn.331
-rw-r--r--man3/libsimple_vvallocn.324
-rw-r--r--man3/libsimple_vvalloczn.324
-rw-r--r--man3/libsimple_vweprintf.314
l---------man3/libsimple_wcsdupa.31
-rw-r--r--man3/libsimple_wcsndup.3167
l---------man3/libsimple_wcsndupa.31
-rw-r--r--man3/libsimple_wmemdup.3167
l---------man3/libsimple_wmemdupa.31
l---------man3/reallocarray.3libsimple1
l---------man3/reallocarrayf.3libsimple1
l---------man3/reallocf.3libsimple1
l---------man3/reallocfn.3libsimple1
l---------man3/valigned_reallocfn.3libsimple1
l---------man3/valigned_reallocn.3libsimple1
l---------man3/vreallocfn.3libsimple1
l---------man3/wcsdupa.3libsimple1
l---------man3/wcsndup.3libsimple1
l---------man3/wcsndupa.3libsimple1
l---------man3/wmemdup.3libsimple1
l---------man3/wmemdupa.3libsimple1
-rw-r--r--memdup.c2
-rw-r--r--test.c34
-rw-r--r--test.h39
-rw-r--r--wcsndup.c106
-rw-r--r--wmemdup.c52
359 files changed, 10621 insertions, 853 deletions
diff --git a/Makefile b/Makefile
index 90e7363..cc1c5c9 100644
--- a/Makefile
+++ b/Makefile
@@ -7,6 +7,12 @@ SUBHDR =\
libsimple/aligned_alloc.h\
libsimple/aligned_allocz.h\
libsimple/aligned_memdup.h\
+ libsimple/aligned_realloc.h\
+ libsimple/aligned_strdup.h\
+ libsimple/aligned_strndup.h\
+ libsimple/aligned_wcsdup.h\
+ libsimple/aligned_wcsndup.h\
+ libsimple/aligned_wmemdup.h\
libsimple/array.h\
libsimple/calloc.h\
libsimple/definitions.h\
@@ -32,7 +38,10 @@ SUBHDR =\
libsimple/strndup.h\
libsimple/time.h\
libsimple/valloc.h\
- libsimple/vallocz.h
+ libsimple/vallocz.h\
+ libsimple/wcsdup.h\
+ libsimple/wcsndup.h\
+ libsimple/wmemdup.h
HDR =\
$(SUBHDR)\
@@ -40,6 +49,9 @@ HDR =\
OBJ =\
aligned_memdup.o\
+ aligned_strndup.o\
+ aligned_wcsndup.o\
+ aligned_wmemdup.o\
allocn.o\
asprintf.o\
difftimespec.o\
@@ -48,19 +60,35 @@ OBJ =\
doubletotimeval.o\
enaligned_allocz.o\
enaligned_memdup.o\
+ enaligned_realloc.o\
+ enaligned_reallocarray.o\
+ enaligned_strdup.o\
+ enaligned_strndup.o\
+ enaligned_wcsdup.o\
+ enaligned_wcsndup.o\
+ enaligned_wmemdup.o\
encalloc.o\
+ engmtime.o\
+ enlocaltime.o\
enmalloc.o\
enmemdup.o\
enposix_memalignz.o\
enrealloc.o\
+ enreallocarray.o\
enstrdup.o\
enstrndup.o\
envaligned_alloczn.o\
+ envaligned_reallocn.o\
envmalloczn.o\
envmemalloc.o\
envposix_memalignzn.o\
envputenvf.o\
envreallocn.o\
+ enwcsdup.o\
+ enwcsndup.o\
+ enwmemdup.o\
+ gmtime.o\
+ localtime.o\
memcasechr.o\
memcasechr_inv.o\
memcasecmp.o\
@@ -175,6 +203,8 @@ OBJ =\
vmemalloc.o\
vputenvf.o\
vweprintf.o\
+ wcsndup.o\
+ wmemdup.o\
libsimple.o
MAN0 =\
@@ -192,7 +222,9 @@ all: libsimple.a $(TESTS)
$(OBJ): $(@:.o=.c) $(HDR)
$(TESTS): $(@:=.o) test.o libsimple.a
$(TESTS:=.o): $(@:.test.o=.c) $(HDR) test.h
+
test.o: test.c $(HDR) test.h
+ $(CC) -c -o $@ test.c $(CFLAGS) -DTEST -O0 -ffreestanding
libsimple.a: $(OBJ)
$(AR) rc $@ $?
diff --git a/README b/README
index 0effbc4..1de7b5c 100644
--- a/README
+++ b/README
@@ -21,10 +21,10 @@ and <strings.h>, the naming scheme of these functions is:
= wcsn for wide-character strings that may not be NUL-terminated
= wmem for wide-character arrays
- <str> = str if <base> is str, wsc, strn, or wscn
+ <str> = str if <base> is str, wcs, strn, or wcsn
= mem if <base> is mem or wmem
- <scan> = chrnul if <base> is str, wsc, strn, or wscn
+ <scan> = chrnul if <base> is str, wcs, strn, or wcsn
= scan if <base> is mem or wmem
[case] = if case-sensitive
diff --git a/aligned_enmemdup.c b/aligned_enmemdup.c
deleted file mode 100644
index fced863..0000000
--- a/aligned_enmemdup.c
+++ /dev/null
@@ -1,64 +0,0 @@
-/* See LICENSE file for copyright and license details. */
-#include "libsimple.h"
-#ifndef TEST
-
-
-void *
-libsimple_enaligned_memdup(int status, const void *s, size_t alignment, size_t n)
-{
- void *ret = aligned_memdup(s, aligned, n);
- if (!ret)
- enprintf(status, "aligned_memdup:");
- return ret;
-}
-
-
-#else
-#include "test.h"
-
-int
-main(void)
-{
- struct allocinfo *info;
- void *s;
-
- assert((s = libsimple_enaligned_memdup(1, "hello", 3, 5)));
- if (have_custom_malloc()) {
- assert((info = get_allocinfo(s)));
- assert(info->size == 6);
- assert(info->alignment == 3);
- assert(!info->zeroed);
- }
- assert(!memcmp(s, "hello", 5));
- free(s);
-
- assert((s = libsimple_ealigned_memdup("test", 7, 5)));
- if (have_custom_malloc()) {
- assert((info = get_allocinfo(s)));
- assert(info->size == 14);
- assert(info->alignment == 7);
- assert(!info->zeroed);
- }
- assert(!memcmp(s, "test", 5));
- free(s);
-
- if (have_custom_malloc()) {
- alloc_fail_in = 1;
- assert_exit_ptr(libsimple_enaligned_memdup(44, "hello", 3, 2));
- assert(exit_status == 44);
- assert_stderr("%s: memdup: %s\n", argv0, strerror(ENOMEM));
- assert(!alloc_fail_in);
-
- libsimple_default_failure_exit = 55;
- alloc_fail_in = 1;
- assert_exit_ptr(libsimple_ealigned_memdup("test", 7, 2));
- assert(exit_status == 55);
- assert_stderr("%s: memdup: %s\n", argv0, strerror(ENOMEM));
- assert(!alloc_fail_in);
- libsimple_default_failure_exit = 1;
- }
-
- return 0;
-}
-
-#endif
diff --git a/aligned_memdup.c b/aligned_memdup.c
index d66a846..7b2ca71 100644
--- a/aligned_memdup.c
+++ b/aligned_memdup.c
@@ -6,9 +6,9 @@
void *
libsimple_aligned_memdup(const void *s, size_t alignment, size_t n)
{
+ size_t size = n + (alignment - n % alignment) % alignment;
void *ret;
- n = n ? n : 1;
- ret = aligned_alloc(alignment, n + (alignment - n % alignment) % alignment);
+ ret = aligned_alloc(alignment, size ? size : alignment);
if (!ret)
return NULL;
return memcpy(ret, s, n);
@@ -17,6 +17,7 @@ libsimple_aligned_memdup(const void *s, size_t alignment, size_t n)
#else
#include "test.h"
+#undef memset
int
main(void)
@@ -26,7 +27,7 @@ main(void)
void *p = libsimple_aligned_memdup(s, 4, 5);
assert(p);
assert(p != s);
- assert(!((uintptr_t)s % 4));
+ assert(!((uintptr_t)p % 4));
if (have_custom_malloc()) {
assert((info = get_allocinfo(p)));
assert(info->size == 8);
diff --git a/aligned_strndup.c b/aligned_strndup.c
new file mode 100644
index 0000000..f41fa8c
--- /dev/null
+++ b/aligned_strndup.c
@@ -0,0 +1,108 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+char *
+libsimple_aligned_strndup(const char *s, size_t alignment, size_t n)
+{
+ char *ret;
+ n = strnlen(s, n);
+ ret = aligned_alloc(alignment, (n + 1) + (alignment - (n + 1) % alignment) % alignment);
+ if (!ret)
+ return NULL;
+ memcpy(ret, s, n);
+ ret[n] = '\0';
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_aligned_strndup("hello", 2, SIZE_MAX)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 2, 100)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 4, 6)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 4);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 8, 6)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 16, 6)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 16);
+ assert(info->alignment == 16);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 2, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_aligned_strndup("hello", 2, 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hell", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert(!libsimple_aligned_strndup("hello", 2, 10) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/aligned_wcsndup.c b/aligned_wcsndup.c
new file mode 100644
index 0000000..90ce7f7
--- /dev/null
+++ b/aligned_wcsndup.c
@@ -0,0 +1,32 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_aligned_wcsndup(const wchar_t *s, size_t alignment, size_t n)
+{
+ size_t size;
+ wchar_t *ret;
+ n = wcsnlen(s, n);
+ size = (n + 1) * sizeof(wchar_t);
+ size = size + (alignment - size % alignment) % alignment;
+ ret = aligned_alloc(alignment, size);
+ if (!ret)
+ return NULL;
+ wmemcpy(ret, s, n);
+ ret[n] = 0;
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ return 0;
+}
+
+#endif
diff --git a/aligned_wmemdup.c b/aligned_wmemdup.c
new file mode 100644
index 0000000..c92e17f
--- /dev/null
+++ b/aligned_wmemdup.c
@@ -0,0 +1,32 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_aligned_wmemdup(const wchar_t *s, size_t alignment, size_t n)
+{
+ size_t size;
+ void *ret;
+ if (LIBSIMPLE_UMUL_OVERFLOW_NONZERO(n, sizeof(wchar_t), &size, SIZE_MAX)) {
+ errno = ENOMEM;
+ return NULL;
+ }
+ size = size + (alignment - size % alignment) % alignment;
+ ret = aligned_alloc(alignment, size ? size : alignment);
+ if (!ret)
+ return NULL;
+ return wmemcpy(ret, s, n);
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ return 0;
+}
+
+#endif
diff --git a/allocn.c b/allocn.c
index d54542c..ce4fbad 100644
--- a/allocn.c
+++ b/allocn.c
@@ -15,11 +15,10 @@ alloc_size_product(int *errp, size_t n, va_list ap)
n = va_arg(ap, size_t);
if (!n)
break;
- if (n >= SIZE_MAX / prod) {
+ if (LIBSIMPLE_UMUL_OVERFLOW_NONZERO(n, prod, &prod, SIZE_MAX)) {
*errp = ENOMEM;
return 0;
}
- prod *= n;
}
return prod;
}
@@ -62,6 +61,15 @@ libsimple_vposix_memalignzn(void **memptr, int clear, size_t alignment, size_t n
return ret;
}
+#ifdef LIBSIMPLE_HAVE_ALIGNED_REALLOC
+void *
+libsimple_valigned_reallocn(void *ptr, size_t alignment, size_t n, va_list ap) /* TODO test (aligned_reallocn) */
+{
+ n = alloc_size_product(&errno, n, ap);
+ return !n ? NULL : aligned_realloc(ptr, alignment, n);
+}
+#endif
+
#else
#include "test.h"
diff --git a/enaligned_realloc.c b/enaligned_realloc.c
new file mode 100644
index 0000000..6d5ac4e
--- /dev/null
+++ b/enaligned_realloc.c
@@ -0,0 +1,105 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void *
+libsimple_enaligned_realloc(int status, void *ptr, size_t alignment, size_t n)
+{
+ void *ret = aligned_realloc(ptr, alignment, n);
+ if (!ret)
+ enprintf(status, "aligned_realloc:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+#ifdef LIBSIMPLE_HAVE_ALIGNED_REALLOC
+
+ struct allocinfo *info;
+ void *ptr, *old;
+ DEFINE_CACHELINE;
+
+ assert((ptr = libsimple_enaligned_realloc(1, NULL, 16, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 5 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 16);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_enaligned_realloc(1, old = ptr, 32, 10)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 10 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 32);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ assert((ptr = libsimple_ealigned_realloc(NULL, 8, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 5 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 8);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_ealigned_realloc(old = ptr, 64, 10)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 10 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 64);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_realloc(2, NULL, 8, 1));
+ assert(exit_status == 2);
+ assert_stderr("%s: aligned_realloc: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 104;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_realloc(NULL, 16, 1));
+ assert(exit_status == 104);
+ assert_stderr("%s: aligned_realloc: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+#else
+
+ assert_exit_ptr(libsimple_enaligned_realloc(2, NULL, 8, 1));
+ assert(exit_status == 2);
+ assert_stderr("%s: aligned_realloc: %s\n", argv0, strerror(ENOSYS));
+
+ libsimple_default_failure_exit = 104;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_realloc(NULL, 16, 1));
+ assert(exit_status == 104);
+ assert_stderr("%s: aligned_realloc: %s\n", argv0, strerror(ENOSYS));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+#endif
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_reallocarray.c b/enaligned_reallocarray.c
new file mode 100644
index 0000000..5a71207
--- /dev/null
+++ b/enaligned_reallocarray.c
@@ -0,0 +1,105 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void *
+libsimple_enaligned_reallocarray(int status, void *ptr, size_t alignment, size_t n, size_t m)
+{
+ void *ret = aligned_reallocarray(ptr, alignment, n, m);
+ if (!ret)
+ enprintf(status, "aligned_reallocarray:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+#ifdef LIBSIMPLE_HAVE_ALIGNED_REALLOC
+
+ struct allocinfo *info;
+ void *ptr, *old;
+ DEFINE_CACHELINE;
+
+ assert((ptr = libsimple_enaligned_reallocarray(1, NULL, 16, 5, 2)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 10 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 16);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_enaligned_reallocarray(1, old = ptr, 32, 10, 3)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 30 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 32);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ assert((ptr = libsimple_ealigned_reallocarray(NULL, 8, 5, 3)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 15 || info->size == 16);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 8);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_ealigned_reallocarray(old = ptr, 64, 10, 4)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 40 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 64);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_reallocarray(2, NULL, 8, 1, 2));
+ assert(exit_status == 2);
+ assert_stderr("%s: aligned_reallocarray: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 104;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_reallocarray(NULL, 16, 1, 2));
+ assert(exit_status == 104);
+ assert_stderr("%s: aligned_reallocarray: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+#else
+
+ assert_exit_ptr(libsimple_enaligned_reallocarray(2, NULL, 8, 1, 2));
+ assert(exit_status == 2);
+ assert_stderr("%s: aligned_reallocarray: %s\n", argv0, strerror(ENOSYS));
+
+ libsimple_default_failure_exit = 104;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_reallocarray(NULL, 16, 1, 2));
+ assert(exit_status == 104);
+ assert_stderr("%s: aligned_reallocarray: %s\n", argv0, strerror(ENOSYS));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+#endif
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_strdup.c b/enaligned_strdup.c
new file mode 100644
index 0000000..533ff56
--- /dev/null
+++ b/enaligned_strdup.c
@@ -0,0 +1,78 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+char *
+libsimple_enaligned_strdup(int status, const char *s, size_t alignment)
+{
+ void *ret = aligned_strdup(s, alignment);
+ if (!ret)
+ enprintf(status, "aligned_strdup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_enaligned_strdup(1, "hello", 2)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_strdup("test", 8)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ assert((s = libsimple_aligned_strdup("test", 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 4);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_strdup(44, "hello", 2));
+ assert(exit_status == 44);
+ assert_stderr("%s: aligned_strdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_strdup("test", 8));
+ assert(exit_status == 55);
+ assert_stderr("%s: aligned_strdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ alloc_fail_in = 1;
+ assert(!libsimple_aligned_strdup("test", 16) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_strndup.c b/enaligned_strndup.c
new file mode 100644
index 0000000..6812d1c
--- /dev/null
+++ b/enaligned_strndup.c
@@ -0,0 +1,134 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+char *
+libsimple_enaligned_strndup(int status, const char *s, size_t alignment, size_t n)
+{
+ void *ret = aligned_strndup(s, alignment, n);
+ if (!ret)
+ enprintf(status, "aligned_strndup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_enaligned_strndup(1, "hello", 2, SIZE_MAX)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_strndup("test", 8, SIZE_MAX)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_strndup(1, "hello", 2, 100)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_strndup("test", 8, 100)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_strndup(1, "hello", 2, 6)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_strndup("test", 8, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_strndup(1, "hello", 2, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_strndup("test", 8, 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_strndup(1, "hello", 2, 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6);
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!memcmp(s, "hell", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_strndup(44, "hello", 2, 10));
+ assert(exit_status == 44);
+ assert_stderr("%s: aligned_strndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_strndup("test", 8, 10));
+ assert(exit_status == 55);
+ assert_stderr("%s: aligned_strndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_wcsdup.c b/enaligned_wcsdup.c
new file mode 100644
index 0000000..10d9669
--- /dev/null
+++ b/enaligned_wcsdup.c
@@ -0,0 +1,78 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enaligned_wcsdup(int status, const wchar_t *s, size_t alignment)
+{
+ void *ret = aligned_wcsdup(s, alignment);
+ if (!ret)
+ enprintf(status, "aligned_wcsdup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_enaligned_wcsdup(1, L"hello", 2)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_wcsdup(L"test", 8)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ assert((s = libsimple_aligned_wcsdup(L"test", 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (4 - 5 * sizeof(wchar_t) % 4) % 4);
+ assert(info->alignment == 4);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_wcsdup(44, L"hello", 2));
+ assert(exit_status == 44);
+ assert_stderr("%s: aligned_wcsdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_wcsdup(L"test", 8));
+ assert(exit_status == 55);
+ assert_stderr("%s: aligned_wcsdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ alloc_fail_in = 1;
+ assert(!libsimple_aligned_wcsdup(L"test", 16) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_wcsndup.c b/enaligned_wcsndup.c
new file mode 100644
index 0000000..32cce57
--- /dev/null
+++ b/enaligned_wcsndup.c
@@ -0,0 +1,134 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enaligned_wcsndup(int status, const wchar_t *s, size_t alignment, size_t n)
+{
+ void *ret = aligned_wcsndup(s, alignment, n);
+ if (!ret)
+ enprintf(status, "aligned_wcsndup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_enaligned_wcsndup(1, L"hello", 2, SIZE_MAX)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_wcsndup(L"test", 8, SIZE_MAX)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_wcsndup(1, L"hello", 2, 100)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_wcsndup(L"test", 8, 100)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_wcsndup(1, L"hello", 2, 6)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_wcsndup(L"test", 8, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_wcsndup(1, L"hello", 2, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 6));
+ free(s);
+
+ assert((s = libsimple_ealigned_wcsndup(L"test", 8, 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ assert((s = libsimple_enaligned_wcsndup(1, L"hello", 2, 4)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hell", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_wcsndup(44, L"hello", 2, 10));
+ assert(exit_status == 44);
+ assert_stderr("%s: aligned_wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_wcsndup(L"test", 8, 10));
+ assert(exit_status == 55);
+ assert_stderr("%s: aligned_wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enaligned_wmemdup.c b/enaligned_wmemdup.c
new file mode 100644
index 0000000..ad36238
--- /dev/null
+++ b/enaligned_wmemdup.c
@@ -0,0 +1,64 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enaligned_wmemdup(int status, const wchar_t *s, size_t alignment, size_t n)
+{
+ void *ret = aligned_wmemdup(s, alignment, n);
+ if (!ret)
+ enprintf(status, "aligned_wmemdup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *s;
+
+ assert((s = libsimple_enaligned_wmemdup(1, L"hello", 2, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == 2);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 5));
+ free(s);
+
+ assert((s = libsimple_ealigned_wmemdup(L"test", 8, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t) + (8 - 5 * sizeof(wchar_t) % 8) % 8);
+ assert(info->alignment == 8);
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enaligned_wmemdup(44, L"hello", 2, 2));
+ assert(exit_status == 44);
+ assert_stderr("%s: aligned_wmemdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ealigned_wmemdup(L"test", 8, 2));
+ assert(exit_status == 55);
+ assert_stderr("%s: aligned_wmemdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/engmtime.c b/engmtime.c
new file mode 100644
index 0000000..55e6c9c
--- /dev/null
+++ b/engmtime.c
@@ -0,0 +1,24 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void
+libsimple_engmtime(int status, struct tm *tm, struct timespec *ts)
+{
+ if (libsimple_gmtime(tm, ts))
+ enprintf(status, "libsimple_gmtime:");
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ /* TODO test */
+ return 0;
+}
+
+#endif
diff --git a/enlocaltime.c b/enlocaltime.c
new file mode 100644
index 0000000..af8907e
--- /dev/null
+++ b/enlocaltime.c
@@ -0,0 +1,24 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void
+libsimple_enlocaltime(int status, struct tm *tm, struct timespec *ts)
+{
+ if (libsimple_localtime(tm, ts))
+ enprintf(status, "libsimple_localtime:");
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ /* TODO test */
+ return 0;
+}
+
+#endif
diff --git a/enrealloc.c b/enrealloc.c
index 878674c..b27cb18 100644
--- a/enrealloc.c
+++ b/enrealloc.c
@@ -6,7 +6,7 @@
void *
libsimple_enrealloc(int status, void *ptr, size_t n)
{
- char *ret = realloc(ptr, n);
+ void *ret = realloc(ptr, n);
if (!ret)
enprintf(status, "realloc:");
return ret;
diff --git a/enreallocarray.c b/enreallocarray.c
new file mode 100644
index 0000000..c208626
--- /dev/null
+++ b/enreallocarray.c
@@ -0,0 +1,132 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void *
+libsimple_enreallocarray(int status, void *ptr, size_t n, size_t m)
+{
+ void *ret = reallocarray(ptr, n, m);
+ if (!ret)
+ enprintf(status, "reallocarray:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ void *ptr, *old;
+
+ assert((ptr = libsimple_enreallocarray(1, NULL, 5, 3)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 15);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_enreallocarray(1, old = ptr, 10, 2)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 20);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ assert((ptr = libsimple_ereallocarray(NULL, 1, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 5);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_ereallocarray(old = ptr, 10, 10)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 100);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ assert((ptr = libsimple_reallocarray(NULL, 1, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 5);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_reallocarray(old = ptr, 10, 10)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 100);
+ assert(!info->zeroed);
+ assert(!((uintptr_t)ptr % (uintptr_t)(info->alignment)));
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enreallocarray(2, NULL, 1, 1));
+ assert(exit_status == 2);
+ assert_stderr("%s: reallocarray: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 104;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ereallocarray(NULL, 1, 1));
+ assert(exit_status == 104);
+ assert_stderr("%s: reallocarray: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ alloc_fail_in = 1;
+ assert(!libsimple_reallocarray(NULL, 1, 1) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+
+#if defined(__GNUC__) && !defined(__clang)
+# pragma GCC diagnostic push
+# pragma GCC diagnostic ignored "-Walloc-size-larger-than="
+#endif
+
+ assert_exit_ptr(libsimple_enreallocarray(3, NULL, SIZE_MAX, SIZE_MAX));
+ assert(exit_status == 3);
+ assert_stderr("%s: reallocarray: %s\n", argv0, strerror(ENOMEM));
+
+ libsimple_default_failure_exit = 4;
+ assert_exit_ptr(libsimple_ereallocarray(NULL, SIZE_MAX, SIZE_MAX));
+ assert(exit_status == 4);
+ assert_stderr("%s: reallocarray: %s\n", argv0, strerror(ENOMEM));
+ libsimple_default_failure_exit = 1;
+
+ assert(!libsimple_reallocarray(NULL, SIZE_MAX, SIZE_MAX) && errno == ENOMEM);
+
+#if defined(__GNUC__) && !defined(__clang)
+# pragma GCC diagnostic pop
+#endif
+
+ return 0;
+}
+
+#endif
diff --git a/envaligned_reallocn.c b/envaligned_reallocn.c
new file mode 100644
index 0000000..747e8c8
--- /dev/null
+++ b/envaligned_reallocn.c
@@ -0,0 +1,25 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+void *
+libsimple_envaligned_reallocn(int status, void *ptr, size_t alignment, size_t n, va_list ap) /* TODO test (evaligned_reallocn, aligned_reallocn, enaligned_reallocn, ealigned_reallocn) */
+{
+ void *ret = valigned_reallocn(ptr, alignment, n, ap);
+ if (!ret)
+ enprintf(status, "valigned_reallocn:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ return 0;
+}
+
+#endif
diff --git a/enwcsdup.c b/enwcsdup.c
new file mode 100644
index 0000000..1fa27c0
--- /dev/null
+++ b/enwcsdup.c
@@ -0,0 +1,71 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enwcsdup(int status, const wchar_t *s)
+{
+ size_t n = wcslen(s) + 1, size;
+ wchar_t *ret;
+ if (LIBSIMPLE_UMUL_OVERFLOW_NONZERO(n, sizeof(wchar_t), &size, SIZE_MAX)) {
+ errno = ENOMEM;
+ enprintf(status, "wcsdup:");
+ }
+ ret = aligned_alloc(_Alignof(wchar_t), size);
+ if (!ret)
+ enprintf(status, "wcsdup:");
+ wmemcpy(ret, s, n);
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ wchar_t *s;
+
+ assert((s = libsimple_enwcsdup(1, L"hello")));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"hello"));
+ free(s);
+
+ assert((s = libsimple_ewcsdup(L"test")));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"test"));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enwcsdup(18, L"hello"));
+ assert(exit_status == 18);
+ assert_stderr("%s: wcsdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 5;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ewcsdup(L"test"));
+ assert(exit_status == 5);
+ assert_stderr("%s: wcsdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enwcsndup.c b/enwcsndup.c
new file mode 100644
index 0000000..105542c
--- /dev/null
+++ b/enwcsndup.c
@@ -0,0 +1,132 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enwcsndup(int status, const wchar_t *s, size_t n)
+{
+ wchar_t *ret = libsimple_wcsndup(s, n);
+ if (!ret)
+ enprintf(status, "wcsndup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ wchar_t *s;
+
+ assert((s = libsimple_enwcsndup(1, L"hello", 10)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 6 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"hello"));
+ free(s);
+
+ assert((s = libsimple_ewcsndup(L"test", 10)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"test"));
+ free(s);
+
+ assert((s = libsimple_enwcsndup(1, L"hello", 2)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 3 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"he"));
+ free(s);
+
+ assert((s = libsimple_ewcsndup(L"test", 3)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 4 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L"tes"));
+ free(s);
+
+ assert((s = libsimple_enwcsndup(1, L"hello", 0)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 1 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L""));
+ free(s);
+
+ assert((s = libsimple_ewcsndup(L"test", 0)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 1 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wcscmp(s, L""));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enwcsndup(24, L"hello", 10));
+ assert(exit_status == 24);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 25;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ewcsndup(L"test", 10));
+ assert(exit_status == 25);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enwcsndup(26, L"hello", 1));
+ assert(exit_status == 26);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 27;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ewcsndup(L"test", 2));
+ assert(exit_status == 27);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enwcsndup(28, L"hello", 0));
+ assert(exit_status == 28);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 29;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ewcsndup(L"test", 0));
+ assert(exit_status == 29);
+ assert_stderr("%s: wcsndup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/enwmemdup.c b/enwmemdup.c
new file mode 100644
index 0000000..243c99e
--- /dev/null
+++ b/enwmemdup.c
@@ -0,0 +1,72 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_enwmemdup(int status, const wchar_t *s, size_t n)
+{
+ wchar_t *ret = libsimple_wmemdup(s, n);
+ if (!ret)
+ enprintf(status, "wmemdup:");
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ wchar_t *s;
+
+ assert((s = libsimple_enwmemdup(1, L"hello", 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"hello", 5));
+ free(s);
+
+ assert((s = libsimple_ewmemdup(L"test", 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(s)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(!info->zeroed);
+ }
+ assert(!wmemcmp(s, L"test", 5));
+ free(s);
+
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_enwmemdup(44, L"hello", 2));
+ assert(exit_status == 44);
+ assert_stderr("%s: wmemdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+
+ libsimple_default_failure_exit = 55;
+ alloc_fail_in = 1;
+ assert_exit_ptr(libsimple_ewmemdup(L"test", 2));
+ assert(exit_status == 55);
+ assert_stderr("%s: wmemdup: %s\n", argv0, strerror(ENOMEM));
+ assert(!alloc_fail_in);
+ libsimple_default_failure_exit = 1;
+
+ assert_exit_ptr(libsimple_enwmemdup(41, NULL, SSIZE_MAX));
+ assert(exit_status == 41);
+ assert_stderr("%s: wmemdup: %s\n", argv0, strerror(ENOMEM));
+
+ libsimple_default_failure_exit = 51;
+ assert_exit_ptr(libsimple_ewmemdup(NULL, SSIZE_MAX));
+ assert(exit_status == 51);
+ assert_stderr("%s: wmemdup: %s\n", argv0, strerror(ENOMEM));
+ libsimple_default_failure_exit = 1;
+ }
+
+ return 0;
+}
+
+#endif
diff --git a/gmtime.c b/gmtime.c
new file mode 100644
index 0000000..5868e8a
--- /dev/null
+++ b/gmtime.c
@@ -0,0 +1,61 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#include <sys/timex.h>
+#ifndef TEST
+
+
+int
+libsimple_gmtime(struct tm *tm, struct timespec *ts)
+{
+ struct timex timex;
+ int r;
+
+ memset(&timex, 0, sizeof(timex));
+ timex.status = ADJ_NANO;
+ r = adjtimex(&timex);
+ if (r == -1)
+ return -1;
+ if (ts) {
+ ts->tv_sec = timex.time.tv_sec;
+ ts->tv_nsec = timex.time.tv_usec;
+ }
+
+ if (timex.time.tv_sec % (24 * 60 * 60) == 0) {
+ if (r == TIME_INS) {
+ timex.time.tv_sec -= 1;
+ if (!gmtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ tm->tm_sec += 1;
+ return 1;
+ } else if (r == TIME_DEL) {
+ timex.time.tv_sec += 1;
+ if (!gmtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ } else {
+ if (!gmtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ }
+ } else if (r == TIME_OOP) {
+ if (!gmtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ tm->tm_sec += 1;
+ } else {
+ if (!gmtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ }
+
+ return 0;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ /* TODO test */
+ return 0;
+}
+
+#endif
diff --git a/libsimple-arg.h b/libsimple-arg.h
index 25d4c72..3ffc3ed 100644
--- a/libsimple-arg.h
+++ b/libsimple-arg.h
@@ -432,8 +432,19 @@ struct longopt {
#define USAGE(SYNOPSIS)\
NUSAGE(1, SYNOPSIS)
+
+/* Intended for internal use only */
+#if __STDC_VERSION__ >= 201112L
+# define _LIBSIMPLE_NORETURN _Noreturn
+#elif defined(__GNUC__) || defined(__clang__)
+# define _LIBSIMPLE_NORETURN __attribute__((noreturn))
+#else
+# define _LIBSIMPLE_NORETURN
+#endif
+
+
/**
- * Define the function `static void usage(void)`
+ * Define the function `static _Noreturn void usage(void)`
* that prints the error message
* "usage: %s %s\n", argv0, SYNOPSIS
* or
@@ -448,26 +459,15 @@ struct longopt {
*
* @since 1.0
*/
-#if defined(__GNUC__) || defined(__clang__)
-# define NUSAGE(STATUS, SYNOPSIS)\
- __attribute__((noreturn))\
- static void usage(void)\
- {\
- const char *syn = SYNOPSIS ? SYNOPSIS : "";\
- fprintf(stderr, "usage: %s%s%s\n", argv0, *syn ? " " : "", syn);\
- exit(STATUS);\
- }\
- char *argv0 = NULL
-#else
-# define NUSAGE(STATUS, SYNOPSIS)\
- static void usage(void)\
+#define NUSAGE(STATUS, SYNOPSIS)\
+ static _LIBSIMPLE_NORETURN void\
+ usage(void)\
{\
const char *syn = SYNOPSIS ? SYNOPSIS : "";\
fprintf(stderr, "usage: %s%s%s\n", argv0, *syn ? " " : "", syn);\
exit(STATUS);\
}\
char *argv0 = NULL
-#endif
#endif
diff --git a/libsimple.c b/libsimple.c
index 4ef6ec2..5232833 100644
--- a/libsimple.c
+++ b/libsimple.c
@@ -6,27 +6,6 @@
#else
#include "test.h"
-static size_t
-gcd(size_t u, size_t v)
-{
- size_t t;
- int shift = 0;
- /* Not needed because u>0, v>0: if (!(u | v)) return u + v; */
- while (!((u | v) & 1)) u >>= 1, v >>= 1, shift++;
- while (!(u & 1)) u >>= 1;
- do {
- while (!(v & 1)) v >>= 1;
- if (u > v) t = u, u = v, v = t;
- } while (v -= u);
- return u << shift;
-}
-
-static size_t
-lcm(size_t u, size_t v)
-{
- return u / gcd(u, v) * v;
-}
-
static int
test_timespec(double d, time_t sec, long int nsec, double rd, const char *s, const char *ss)
{
@@ -109,22 +88,17 @@ int
main(void)
{
struct allocinfo *volatile info;
- void *ptr;
+ void *ptr, *old;
struct timespec ts, ts1, ts2;
struct timeval tv1, tv2;
const char *cs;
+ const wchar_t *cws;
char buf[1024], *s;
+ wchar_t *ws;
int intarray[10];
size_t i, j, n;
- size_t pagesize, cacheline;
-
- pagesize = (size_t)sysconf(_SC_PAGESIZE);
-
-#ifdef _SC_LEVEL1_DCACHE_LINESIZE
- cacheline = (size_t)sysconf(_SC_LEVEL1_DCACHE_LINESIZE);
-#else
- cacheline = 64;
-#endif
+ DEFINE_PAGESIZE;
+ DEFINE_CACHELINE;
assert(libsimple_default_failure_exit == 1);
@@ -734,6 +708,7 @@ main(void)
s = libsimple_memdupa(cs, n);
assert(s);
assert(s != cs);
+ assert(!((uintptr_t)s % _Alignof(max_align_t)));
assert(!memcmp(s, cs, n));
}
#else
@@ -743,14 +718,253 @@ main(void)
#ifdef libsimple_aligned_memdupa
cs = "xyz";
for (n = 1; n < 4; n++) {
- s = libsimple_aligned_memdupa(cs, 4 + i, n);
+ for (i = 1; i < 5; i++) {
+ s = libsimple_aligned_memdupa(cs, i, n);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!memcmp(s, cs, n));
+ }
+ }
+#else
+ fprintf(stderr, "warning: libsimple_aligned_memdupa missing\n");
+#endif
+
+#ifdef libsimple_aligned_strdupa
+ for (i = 1; i < 5; i++) {
+ cs = "";
+ s = libsimple_aligned_strdupa(cs, i);
assert(s);
assert(s != cs);
- assert(!((uintptr_t)s % (4 + i)));
- assert(!memcmp(s, cs, n));
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, cs));
+
+ cs = "xyz";
+ s = libsimple_aligned_strdupa(cs, i);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, cs));
}
#else
- fprintf(stderr, "warning: libsimple_aligned_memdupa missing\n");
+ fprintf(stderr, "warning: libsimple_aligned_strdupa missing\n");
+#endif
+
+#ifdef libsimple_aligned_strndupa
+ for (i = 1; i < 5; i++) {
+ cs = "";
+ s = libsimple_aligned_strndupa(cs, i, 5);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, ""));
+
+ cs = "xyz";
+
+ s = libsimple_aligned_strndupa(cs, i, 5);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, "xyz"));
+
+ s = libsimple_aligned_strndupa(cs, i, 4);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, "xyz"));
+
+ s = libsimple_aligned_strndupa(cs, i, 3);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, "xyz"));
+
+ s = libsimple_aligned_strndupa(cs, i, 2);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, "xy"));
+
+ s = libsimple_aligned_strndupa(cs, i, 1);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, "x"));
+
+ s = libsimple_aligned_strndupa(cs, i, 0);
+ assert(s);
+ assert(s != cs);
+ assert(!((uintptr_t)s % i));
+ assert(!strcmp(s, ""));
+ }
+#else
+ fprintf(stderr, "warning: libsimple_aligned_strndupa missing\n");
+#endif
+
+#ifdef libsimple_wcsdupa
+ cws = L"";
+ ws = libsimple_wcsdupa(cws);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, cws));
+
+ cws = L"xyz";
+ ws = libsimple_wcsdupa(cws);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, cws));
+#else
+ fprintf(stderr, "warning: libsimple_wcsdupa missing\n");
+#endif
+
+#ifdef libsimple_wcsndupa
+ cws = L"";
+ ws = libsimple_wcsndupa(cws, 5);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L""));
+
+ cws = L"xyz";
+
+ ws = libsimple_wcsndupa(cws, 5);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_wcsndupa(cws, 4);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_wcsndupa(cws, 3);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_wcsndupa(cws, 2);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L"xy"));
+
+ ws = libsimple_wcsndupa(cws, 1);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L"x"));
+
+ ws = libsimple_wcsndupa(cws, 0);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wcscmp(ws, L""));
+#else
+ fprintf(stderr, "warning: libsimple_wcsndupa missing\n");
+#endif
+
+#ifdef libsimple_wmemdupa
+ cws = L"xyz";
+ for (n = 1; n < 4; n++) {
+ ws = libsimple_wmemdupa(cws, n);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % _Alignof(wchar_t)));
+ assert(!wmemcmp(ws, cws, n));
+ }
+#else
+ fprintf(stderr, "warning: libsimple_wmemdupa missing\n");
+#endif
+
+#ifdef libsimple_aligned_wmemdupa
+ cws = L"xyz";
+ for (n = 1; n < 4; n++) {
+ for (i = 1; i < 5; i++) {
+ ws = libsimple_aligned_wmemdupa(cws, i, n);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wmemcmp(ws, cws, n));
+ }
+ }
+#else
+ fprintf(stderr, "warning: libsimple_aligned_wmemdupa missing\n");
+#endif
+
+#ifdef libsimple_aligned_wcsdupa
+ for (i = 1; i < 5; i++) {
+ cws = L"";
+ ws = libsimple_aligned_wcsdupa(cws, i);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, cws));
+
+ cws = L"xyz";
+ ws = libsimple_aligned_wcsdupa(cws, i);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, cws));
+ }
+#else
+ fprintf(stderr, "warning: libsimple_aligned_wcsdupa missing\n");
+#endif
+
+#ifdef libsimple_aligned_wcsndupa
+ for (i = 1; i < 5; i++) {
+ cws = L"";
+ ws = libsimple_aligned_wcsndupa(cws, i, 5);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L""));
+
+ cws = L"xyz";
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 5);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 4);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 3);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L"xyz"));
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 2);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L"xy"));
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 1);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L"x"));
+
+ ws = libsimple_aligned_wcsndupa(cws, i, 0);
+ assert(ws);
+ assert(ws != cws);
+ assert(!((uintptr_t)ws % i));
+ assert(!wcscmp(ws, L""));
+ }
+#else
+ fprintf(stderr, "warning: libsimple_aligned_wcsndupa missing\n");
#endif
unsetenv("X");
@@ -1049,14 +1263,6 @@ main(void)
tv2.tv_sec = 1, tv2.tv_usec = 0L;
assert(libsimple_cmptimeval(&tv1, &tv2) == -1);
-#define ASSERT_ALIGNMENT(INFO, ALIGN)\
- do {\
- assert((INFO)->alignment <= lcm(cacheline, ALIGN));\
- assert(!((INFO)->alignment % (ALIGN)));\
- if ((cacheline - (ALIGN) % cacheline) % cacheline + (INFO)->size % (ALIGN) > cacheline)\
- assert(!((INFO)->alignment % cacheline));\
- } while (0)
-
assert((ptr = libsimple_mallocz(0, 11)));
if (have_custom_malloc()) {
assert((info = get_allocinfo(ptr)));
@@ -2042,6 +2248,66 @@ main(void)
assert_stderr("%s: libsimple_vmemalignz: %s\n", argv0, strerror(EINVAL));
libsimple_default_failure_exit = 1;
+#ifdef LIBSIMPLE_HAVE_ALIGNED_REALLOC
+ assert((ptr = libsimple_aligned_realloc(NULL, 16, 5)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 5 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 16);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_aligned_realloc(old = ptr, 32, 10)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 10 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 32);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert(!libsimple_aligned_realloc(NULL, 8, 1) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+#else
+ assert(libsimple_aligned_realloc(NULL, 8, 1) && errno == ENOSYS);
+#endif
+
+#ifdef LIBSIMPLE_HAVE_ALIGNED_REALLOC
+ assert((ptr = libsimple_aligned_reallocarray(NULL, 16, 5, 3)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 15 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 16);
+ info->refcount += 1;
+ }
+ stpcpy(ptr, "test");
+ assert((ptr = libsimple_aligned_reallocarray(old = ptr, 32, 10, 2)));
+ assert(!strcmp(ptr, "test"));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(ptr)));
+ assert(info->size == 20 || info->size == info->alignment);
+ assert(!info->zeroed);
+ ASSERT_ALIGNMENT(info, 32);
+ assert(ptr != old);
+ free(old);
+ }
+ free(ptr);
+ if (have_custom_malloc()) {
+ alloc_fail_in = 1;
+ assert(!libsimple_aligned_reallocarray(NULL, 8, 1, 1) && errno == ENOMEM);
+ assert(!alloc_fail_in);
+ }
+#else
+ assert(libsimple_aligned_reallocarray(NULL, 8, 1, 1) && errno == ENOSYS);
+#endif
+
assert(libsimple_memeq("abcxyz", "abc123", 3));
assert(!libsimple_memeq("abcxyz", "abc123", 4));
assert(libsimple_memeq("abcxyz", "abcx23", 4));
diff --git a/libsimple.h b/libsimple.h
index 2c68fba..28d884c 100644
--- a/libsimple.h
+++ b/libsimple.h
@@ -39,26 +39,78 @@
#include <strings.h>
#include <time.h>
#include <unistd.h>
+#include <wchar.h>
+#include <wctype.h>
+
#if defined(__GNUC__) && !defined(__clang__)
# define _LIBSIMPLE_GCC_ONLY(x) x
+# define _LIBSIMPLE_NON_GCC_ONLY(x)
#else
# define _LIBSIMPLE_GCC_ONLY(x)
+# define _LIBSIMPLE_NON_GCC_ONLY(x) x
+#endif
+
+#if __STDC_VERSION__ >= 199409L
+# define _LIBSIMPLE_C95_ONLY(x) x
+# define _LIBSIMPLE_PRE_C95_ONLY(x)
+#else
+# define _LIBSIMPLE_C95_ONLY(x)
+# define _LIBSIMPLE_PRE_C95_ONLY(x) x
+#endif
+
+#if __STDC_VERSION__ >= 199901L
+# define _LIBSIMPLE_C99_ONLY(x) x
+# define _LIBSIMPLE_PRE_C99_ONLY(x)
+#else
+# define _LIBSIMPLE_C99_ONLY(x)
+# define _LIBSIMPLE_PRE_C99_ONLY(x) x
+#endif
+
+#if __STDC_VERSION__ >= 201112L
+# define _LIBSIMPLE_C11_ONLY(x) x
+# define _LIBSIMPLE_PRE_C11_ONLY(x)
+#else
+# define _LIBSIMPLE_C11_ONLY(x)
+# define _LIBSIMPLE_PRE_C11_ONLY(x) x
#endif
+#if __STDC_VERSION__ >= 201710L
+# define _LIBSIMPLE_C17_ONLY(x) x
+# define _LIBSIMPLE_PRE_C17_ONLY(x)
+#else
+# define _LIBSIMPLE_C17_ONLY(x)
+# define _LIBSIMPLE_PRE_C17_ONLY(x) x
+#endif
+
+#define _libsimple_assume_aligned_as(TYPE)\
+ _LIBSIMPLE_C11_ONLY(__assume_aligned__(_Alignof(TYPE)))\
+ _LIBSIMPLE_PRE_C11_ONLY(_LIBSIMPLE_GCC_ONLY__assume_aligned__(__alignof(TYPE)))
+
+
+#include "libsimple/overflow.h"
#include "libsimple/printf.h"
#include "libsimple/definitions.h"
#include "libsimple/memalloc.h"
-#include "libsimple/strdup.h"
-#include "libsimple/strndup.h"
#include "libsimple/memdup.h"
#include "libsimple/aligned_memdup.h"
+#include "libsimple/strdup.h"
+#include "libsimple/aligned_strdup.h"
+#include "libsimple/strndup.h"
+#include "libsimple/aligned_strndup.h"
+#include "libsimple/wmemdup.h"
+#include "libsimple/aligned_wmemdup.h"
+#include "libsimple/wcsdup.h"
+#include "libsimple/aligned_wcsdup.h"
+#include "libsimple/wcsndup.h"
+#include "libsimple/aligned_wcsndup.h"
#include "libsimple/mallocz.h"
#include "libsimple/malloc.h"
#include "libsimple/calloc.h"
#include "libsimple/realloc.h"
+#include "libsimple/aligned_realloc.h"
#include "libsimple/memalignz.h"
#include "libsimple/memalign.h"
#include "libsimple/vallocz.h"
@@ -76,7 +128,6 @@
#include "libsimple/array.h"
#include "libsimple/str.h"
#include "libsimple/strn.h"
-#include "libsimple/overflow.h"
/**
@@ -145,4 +196,58 @@ libsimple_unlist(void *__list, size_t __i, size_t *__np, size_t __width)
#endif
+#define _LIBSIMPLE_REMOVE_CONST(X, TYPE, ...) (*(TYPE *)(void *)&(X))
+#define LIBSIMPLE_REMOVE_CONST(...) _LIBSIMPLE_REMOVE_CONST(__VA_ARGS__, void *) /* TODO test, doc, man */
+#ifndef REMOVE_CONST
+# define REMOVE_CONST(...) LIBSIMPLE_REMOVE_CONST(__VA_ARGS__)
+#endif
+
+
+#define LIBSIMPLE_PREFETCH_RDONLY(ADDRESS, LOCALITY) /* void */ /* TODO test, doc, man */\
+ _LIBSIMPLE_GCC_ONLY(__builtin_prefetch(ADDRESS, 0, LOCALITY))
+#ifndef PREFETCH_RDONLY
+# define PREFETCH_RDONLY(...) LIBSIMPLE_PREFETCH_RDONLY(__VA_ARGS__)
+#endif
+
+
+#define LIBSIMPLE_PREFETCH_RDWR(ADDRESS, LOCALITY) /* void */ /* TODO test, doc, man */\
+ _LIBSIMPLE_GCC_ONLY(__builtin_prefetch(ADDRESS, 1, LOCALITY))
+#ifndef PREFETCH_RDWR
+# define PREFETCH_RDWR(...) LIBSIMPLE_PREFETCH_RDWR(__VA_ARGS__)
+#endif
+
+
+#define _LIBSIMPLE_ASSUME_ALIGNED(PTR, ALIGNMENT, ...)\
+ _LIBSIMPLE_GCC_ONLY(__builtin_assume_aligned(PTR, ALIGNMENT))
+#if defined(__GNUC__) && !defined(__clang__)
+# define LIBSIMPLE_ASSUME_ALIGNED(PTR, ...) /* returns PTR */ /* TODO test, doc, man */\
+ _LIBSIMPLE_GCC_ONLY(__builtin_assume_aligned(PTR, ##__VA_ARGS__,\
+ _LIBSIMPLE_C11_ONLY(_Alignof(PTR))\
+ _LIBSIMPLE_PREC11_ONLY(__alignof(PTR))))
+#endif
+#ifndef ASSUME_ALIGNED
+# define ASSUME_ALIGNED(...) LIBSIMPLE_ASSUME_ALIGNED(__VA_ARGS__)
+#endif
+
+
+#define LIBSIMPLE_ASSUME_MISALIGNED(PTR, ALIGNMENT, OFFSET) /* returns PTR */ /* TODO test, doc, man */\
+ __builtin_assume_aligned(PTR, ALIGNMENT, OFFSET)
+#ifndef ASSUME_MISALIGNED
+# define ASSUME_MISALIGNED(...) LIBSIMPLE_ASSUME_MISALIGNED(__VA_ARGS__)
+#endif
+
+
+#define LIBSIMPLE_UNROLLED(N) _LIBSIMPLE_GCC_ONLY(_LIBSIMPLE_C11_ONLY(_Pragma("GCC unroll "#N))) /* TODO test, doc, man */
+#ifndef UNROLLED
+# define UNROLLED(N) LIBSIMPLE_UNROLLED(N)
+#endif
+
+
+#define LIBSIMPLE_SIMDLOOP _LIBSIMPLE_GCC_ONLY(_LIBSIMPLE_C11_ONLY(_Pragma("GCC ivdep"))) /* TODO test, doc, man */
+#ifndef SIMDLOOP
+# define SIMDLOOP LIBSIMPLE_SIMDLOOP
+#endif
+
+
+
#endif
diff --git a/libsimple/aligned_memdup.h b/libsimple/aligned_memdup.h
index b0650a7..36b085f 100644
--- a/libsimple/aligned_memdup.h
+++ b/libsimple/aligned_memdup.h
@@ -17,10 +17,12 @@
const char *__s = (s);\
size_t __n = (n);\
size_t __a = (alignment);\
+ size_t __size;\
uintptr_t __misalignment;\
char *__r;\
__a += !__a;\
- __r = alloca(__n + (__a - 1));\
+ __size = __n + (__a - 1);\
+ __r = alloca(__size + !__size);\
__misalignment = (uintptr_t)__r % (uintptr_t)__a;\
if (__misalignment)\
__r += (uintptr_t)__a - __misalignment;\
@@ -79,7 +81,7 @@ void *libsimple_enaligned_memdup(int, const void *, size_t, size_t);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3), __warn_unused_result__, __returns_nonnull__)))
static inline void *libsimple_ealigned_memdup(const void *__s, size_t __alignment, size_t __n)
-{ return enaligned_memdup(libsimple_default_failure_exit, __s, __alignment, __n); }
+{ return libsimple_enaligned_memdup(libsimple_default_failure_exit, __s, __alignment, __n); }
#ifndef ealigned_memdup
# define ealigned_memdup libsimple_ealigned_memdup
#endif
diff --git a/libsimple/aligned_realloc.h b/libsimple/aligned_realloc.h
new file mode 100644
index 0000000..1da7ba7
--- /dev/null
+++ b/libsimple/aligned_realloc.h
@@ -0,0 +1,655 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param status The exit value for the process in case of failure
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of bytes to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3), __warn_unused_result__)))
+#if defined(__GLIBC__)
+# define LIBSIMPLE_HAVE_ALIGNED_REALLOC
+# include <malloc.h>
+static inline void *
+libsimple_aligned_realloc(void *__ptr, size_t __alignment, size_t __n) /* TODO musl */
+{
+ size_t __old = malloc_usable_size(__ptr);
+#if __STDC_VERSION__ >= 201112L || defined(_ISOC11_SOURCE)
+ size_t __extra = (__alignment - __n % __alignment) % __alignment;
+ void *__new = aligned_alloc(__alignment, __n + __extra);
+#else
+ void *__new = memalign(__alignment, __n);
+#endif
+ if (__new) {
+ memcpy(__new, __ptr, __old < __n ? __old : __n);
+ free(__ptr);
+ }
+ return __new;
+}
+#else
+static inline void *
+libsimple_aligned_realloc(void *__ptr, size_t __alignment, size_t __n)
+{
+ (void) __ptr;
+ (void) __alignment;
+ (void) __n;
+ errno = ENOSYS;
+ return NULL;
+}
+#endif
+#ifndef aligned_realloc
+# define aligned_realloc libsimple_aligned_realloc
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param status The exit value for the process in case of failure
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of bytes to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(3), __alloc_size__(4), __warn_unused_result__, __returns_nonnull__)))
+void *libsimple_enaligned_realloc(int, void *, size_t, size_t);
+#ifndef enaligned_realloc
+# define enaligned_realloc libsimple_enaligned_realloc
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of bytes to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3), __warn_unused_result__, __returns_nonnull__)))
+static inline void *libsimple_ealigned_realloc(void *__ptr, size_t __alignment, size_t __n)
+{ return libsimple_enaligned_realloc(libsimple_default_failure_exit, __ptr, __alignment, __n); }
+#ifndef ealigned_realloc
+# define ealigned_realloc libsimple_ealigned_realloc
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of bytes to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3), __warn_unused_result__)))
+static inline void *
+libsimple_aligned_reallocf(void *__ptr, size_t __alignment, size_t __n) /* TODO test */
+{
+ void *__new = __n ? libsimple_aligned_realloc(__ptr, __alignment, __n) : NULL;
+ if (!__new)
+ free(__ptr);
+ return NULL;
+}
+#ifndef aligned_reallocf
+# define aligned_reallocf libsimple_aligned_reallocf
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` or `m` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3, 4), __warn_unused_result__)))
+static inline void *
+libsimple_aligned_reallocarray(void *__ptr, size_t __alignment, size_t __n, size_t __m)
+{
+ if (LIBSIMPLE_UMUL_OVERFLOW(__n, __m, &__n, SIZE_MAX)) {
+ errno = ENOMEM;
+ return NULL;
+ }
+ return libsimple_aligned_realloc(__ptr, __alignment, __n);
+}
+#ifndef aligned_reallocarray
+# define aligned_reallocarray libsimple_aligned_reallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(3), __alloc_size__(4, 5), __warn_unused_result__, __returns_nonnull__)))
+void *libsimple_enaligned_reallocarray(int, void *, size_t, size_t, size_t);
+#ifndef enaligned_reallocarray
+# define enaligned_reallocarray libsimple_enaligned_reallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3, 4), __warn_unused_result__, __returns_nonnull__)))
+static inline void *libsimple_ealigned_reallocarray(void *__ptr, size_t __alignment, size_t __n, size_t __m)
+{ return libsimple_enaligned_reallocarray(libsimple_default_failure_exit, __ptr, __alignment, __n, __m); }
+#ifndef ealigned_reallocarray
+# define ealigned_reallocarray libsimple_ealigned_reallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` or `m` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __alloc_size__(3, 4), __warn_unused_result__)))
+static inline void *
+libsimple_aligned_reallocarrayf(void *__ptr, size_t __alignment, size_t __n, size_t __m) /* TODO test */
+{
+ void *__new = (__n && __m) ? libsimple_aligned_reallocarray(__ptr, __alignment, __n, __m) : NULL;
+ if (!__new)
+ free(__ptr);
+ return NULL;
+}
+#ifndef aligned_reallocarrayf
+# define aligned_reallocarrayf libsimple_aligned_reallocarrayf
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ap The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__)))
+void *libsimple_valigned_reallocn(void *, size_t, size_t, va_list);
+#ifndef valigned_reallocn
+# define valigned_reallocn libsimple_valigned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments except `status`, up to the
+ * first 0, will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param status The exit value for the process in case of failure
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ap The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(3), __warn_unused_result__, __returns_nonnull__)))
+void *libsimple_envaligned_reallocn(int, void *, size_t, size_t, va_list);
+#ifndef envaligned_reallocn
+# define envaligned_reallocn libsimple_envaligned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ap The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__, __returns_nonnull__)))
+static inline void *libsimple_evaligned_reallocn(void *__ptr, size_t __alignment, size_t __n, va_list __ap)
+{ return libsimple_envaligned_reallocn(libsimple_default_failure_exit, __ptr, __alignment, __n, __ap); }
+#ifndef evaligned_reallocn
+# define evaligned_reallocn libsimple_evaligned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ap The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__)))
+static inline void *
+libsimple_valigned_reallocfn(void *__ptr, size_t __alignment, size_t __n, va_list __ap) /* TODO test (aligned_reallocfn) */
+{
+ void *__new = libsimple_valigned_reallocn(__ptr, __alignment, __n, __ap);
+ if (!__new)
+ free(__ptr);
+ return __new;
+}
+#ifndef valigned_reallocfn
+# define valigned_reallocfn libsimple_aligned_reallocnf
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ... The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__)))
+static inline void *
+libsimple_aligned_reallocn(void *__ptr, size_t __alignment, size_t __n, ... /*, (size_t)0 */)
+{
+ va_list __ap;
+ va_start(__ap, __n);
+ return libsimple_valigned_reallocn(__ptr, __alignment, __n, __ap);
+ va_end(__ap);
+}
+#ifndef aligned_reallocn
+# define aligned_reallocn libsimple_aligned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments except `status`, up to the
+ * first 0, will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param status The exit value for the process in case of failure
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ... The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(3), __warn_unused_result__, __returns_nonnull__)))
+static inline void *
+libsimple_enaligned_reallocn(int __status, void *__ptr, size_t __alignment, size_t __n, ... /*, (size_t)0 */)
+{
+ va_list __ap;
+ va_start(__ap, __n);
+ return libsimple_envaligned_reallocn(__status, __ptr, __alignment, __n, __ap);
+ va_end(__ap);
+}
+#ifndef enaligned_reallocn
+# define enaligned_reallocn libsimple_enaligned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ... The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__, __returns_nonnull__)))
+static inline void *
+libsimple_ealigned_reallocn(void *__ptr, size_t __alignment, size_t __n, ... /*, (size_t)0 */)
+{
+ va_list __ap;
+ va_start(__ap, __n);
+ return libsimple_evaligned_reallocn(__ptr, __alignment, __n, __ap);
+ va_end(__ap);
+}
+#ifndef ealigned_reallocn
+# define ealigned_reallocn libsimple_ealigned_reallocn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with custom alignment as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * This function may not be supported, check for the
+ * existance of the macro `LIBSIMPLE_HAVE_ALIGNED_REALLOC`
+ * to determine if it is supported
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param alignment The alignment of the new pointer
+ * @param n First factor for the allocation size, must not be 0
+ * @param ... The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws EINVAL `alignment` is not a valid alignment
+ * @throws ENOMEM Could not allocated enough memory
+ * @throws ENOSYS Not implemented (requires non-standard libc functions)
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_align__(2), __warn_unused_result__)))
+static inline void *
+libsimple_aligned_reallocfn(void *__ptr, size_t __alignment, size_t __n, ... /*, (size_t)0 */)
+{
+ va_list __ap;
+ va_start(__ap, __n);
+ return libsimple_valigned_reallocfn(__ptr, __alignment, __n, __ap);
+ va_end(__ap);
+}
+#ifndef aligned_reallocfn
+# define aligned_reallocfn libsimple_aligned_reallocfn
+#endif
diff --git a/libsimple/aligned_strdup.h b/libsimple/aligned_strdup.h
new file mode 100644
index 0000000..07b7edf
--- /dev/null
+++ b/libsimple/aligned_strdup.h
@@ -0,0 +1,74 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_aligned_strdup`
+ *
+ * @param s:const char * The string to copy
+ * @param alignment:size_t The alignment of the returned pointer
+ * @return :char * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_aligned_strdupa(s, alignment)\
+ ({\
+ const char *__s = (s);\
+ size_t __n = strlen(__s) + 1;\
+ size_t __a = (alignment);\
+ uintptr_t __misalignment;\
+ char *__r;\
+ __a += !__a;\
+ __r = alloca(__n + (__a - 1));\
+ __misalignment = (uintptr_t)__r % (uintptr_t)__a;\
+ if (__misalignment)\
+ __r += (uintptr_t)__a - __misalignment;\
+ memcpy(__r, __s, __n);\
+ })
+# ifndef aligned_strdupa
+# define aligned_strdupa(s, alignment) libsimple_aligned_strdupa(s, alignment)
+# endif
+#endif
+
+
+/**
+ * Version of strdup(3) that returns a pointer with a custom alignment
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__)))
+static inline char *libsimple_aligned_strdup(const char * __s, size_t __alignment)
+{ return libsimple_aligned_memdup(__s, __alignment, strlen(__s) + 1); }
+#ifndef aligned_strdup
+# define aligned_strdup libsimple_aligned_strdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_strdup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(3), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+char *libsimple_enaligned_strdup(int, const char *, size_t);
+#ifndef enaligned_strdup
+# define enaligned_strdup libsimple_enaligned_strdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_strdup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline char *libsimple_ealigned_strdup(const char *__s, size_t __alignment)
+{ return libsimple_enaligned_strdup(libsimple_default_failure_exit, __s, __alignment); }
+#ifndef ealigned_strdup
+# define ealigned_strdup libsimple_ealigned_strdup
+#endif
diff --git a/libsimple/aligned_strndup.h b/libsimple/aligned_strndup.h
new file mode 100644
index 0000000..16a3aac
--- /dev/null
+++ b/libsimple/aligned_strndup.h
@@ -0,0 +1,79 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_aligned_strndup`
+ *
+ * @param s:const char * The string to copy
+ * @param alignment:size_t The alignment of the returned pointer
+ * @param n:size_t The maximum number of bytes to copy
+ * @return :char * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_aligned_strndupa(s, alignment, n)\
+ ({\
+ const char *__s = (s);\
+ size_t __n = strnlen(__s, n);\
+ size_t __a = (alignment);\
+ uintptr_t __misalignment;\
+ char *__r;\
+ __a += !__a;\
+ __r = alloca(__n + 1 + (__a - 1));\
+ __misalignment = (uintptr_t)__r % (uintptr_t)__a;\
+ if (__misalignment)\
+ __r += (uintptr_t)__a - __misalignment;\
+ memcpy(__r, __s, __n);\
+ __r[__n] = '\0';\
+ __r;\
+ })
+# ifndef aligned_strndupa
+# define aligned_strndupa(s, alignment, n) libsimple_aligned_strndupa(s, alignment, n)
+# endif
+#endif
+
+
+/**
+ * Version of strndup(3) that returns a pointer with a custom alignment
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of bytes to copy
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__)))
+char *libsimple_aligned_strndup(const char * __s, size_t __alignment, size_t __n);
+#ifndef aligned_strndup
+# define aligned_strndup libsimple_aligned_strndup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_strndup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of bytes to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(3), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+char *libsimple_enaligned_strndup(int, const char *, size_t, size_t);
+#ifndef enaligned_strndup
+# define enaligned_strndup libsimple_enaligned_strndup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_strndup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of bytes to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline char *libsimple_ealigned_strndup(const char *__s, size_t __alignment, size_t __n)
+{ return libsimple_enaligned_strndup(libsimple_default_failure_exit, __s, __alignment, __n); }
+#ifndef ealigned_strndup
+# define ealigned_strndup libsimple_ealigned_strndup
+#endif
diff --git a/libsimple/aligned_wcsdup.h b/libsimple/aligned_wcsdup.h
new file mode 100644
index 0000000..527d210
--- /dev/null
+++ b/libsimple/aligned_wcsdup.h
@@ -0,0 +1,74 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_aligned_wcsdup`
+ *
+ * @param s:const wchar_t * The string to copy
+ * @param alignment:size_t The alignment of the returned pointer
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_aligned_wcsdupa(s, alignment)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = wcslen(__s) + 1;\
+ size_t __a = (alignment);\
+ uintptr_t __misalignment;\
+ wchar_t *__r;\
+ __a += !__a;\
+ __r = alloca(__n * sizeof(wchar_t) + (__a - 1));\
+ __misalignment = (uintptr_t)__r % (uintptr_t)__a;\
+ if (__misalignment)\
+ __r += (uintptr_t)__a - __misalignment;\
+ wmemcpy(__r, __s, __n);\
+ })
+# ifndef aligned_wcsdupa
+# define aligned_wcsdupa(s, alignment) libsimple_aligned_wcsdupa(s, alignment)
+# endif
+#endif
+
+
+/**
+ * Version of wcsdup(3) that returns a pointer with a custom alignment
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__)))
+static inline wchar_t *libsimple_aligned_wcsdup(const wchar_t * __s, size_t __alignment)
+{ return libsimple_aligned_wmemdup(__s, __alignment, wcslen(__s) + 1); }
+#ifndef aligned_wcsdup
+# define aligned_wcsdup libsimple_aligned_wcsdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wcsdup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(3), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enaligned_wcsdup(int, const wchar_t *, size_t);
+#ifndef enaligned_wcsdup
+# define enaligned_wcsdup libsimple_enaligned_wcsdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wcsdup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ealigned_wcsdup(const wchar_t *__s, size_t __alignment)
+{ return libsimple_enaligned_wcsdup(libsimple_default_failure_exit, __s, __alignment); }
+#ifndef ealigned_wcsdup
+# define ealigned_wcsdup libsimple_ealigned_wcsdup
+#endif
diff --git a/libsimple/aligned_wcsndup.h b/libsimple/aligned_wcsndup.h
new file mode 100644
index 0000000..015d1dc
--- /dev/null
+++ b/libsimple/aligned_wcsndup.h
@@ -0,0 +1,79 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_aligned_wcsndup`
+ *
+ * @param s:const wchar_t * The string to copy
+ * @param alignment:size_t The alignment of the returned pointer
+ * @param n:size_t The maximum number of wide characters to copy
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_aligned_wcsndupa(s, alignment, n)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = wcsnlen(__s, n);\
+ size_t __a = (alignment);\
+ uintptr_t __misalignment;\
+ wchar_t *__r;\
+ __a += !__a;\
+ __r = alloca((__n + 1) * sizeof(wchar_t) + (__a - 1));\
+ __misalignment = (uintptr_t)__r % (uintptr_t)__a;\
+ if (__misalignment)\
+ __r += (uintptr_t)__a - __misalignment;\
+ wmemcpy(__r, __s, __n);\
+ __r[__n] = 0;\
+ __r;\
+ })
+# ifndef aligned_wcsndupa
+# define aligned_wcsndupa(s, alignment, n) libsimple_aligned_wcsndupa(s, alignment, n)
+# endif
+#endif
+
+
+/**
+ * Version of wcsndup(3) that returns a pointer with a custom alignment
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__)))
+wchar_t *libsimple_aligned_wcsndup(const wchar_t * __s, size_t __alignment, size_t __n);
+#ifndef aligned_wcsndup
+# define aligned_wcsndup libsimple_aligned_wcsndup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wcsndup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(3), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enaligned_wcsndup(int, const wchar_t *, size_t, size_t);
+#ifndef enaligned_wcsndup
+# define enaligned_wcsndup libsimple_enaligned_wcsndup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wcsndup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ealigned_wcsndup(const wchar_t *__s, size_t __alignment, size_t __n)
+{ return libsimple_enaligned_wcsndup(libsimple_default_failure_exit, __s, __alignment, __n); }
+#ifndef ealigned_wcsndup
+# define ealigned_wcsndup libsimple_ealigned_wcsndup
+#endif
diff --git a/libsimple/aligned_wmemdup.h b/libsimple/aligned_wmemdup.h
new file mode 100644
index 0000000..63a9d40
--- /dev/null
+++ b/libsimple/aligned_wmemdup.h
@@ -0,0 +1,79 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_aligned_wmemdup`
+ *
+ * @param s:const wchar_t * The wide characters to copy
+ * @param alignment:size_t The alignment of the returned pointer
+ * @param n:size_t The number of wide characters to copy
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_aligned_wmemdupa(s, alignment, n)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = (n);\
+ size_t __a = (alignment);\
+ size_t __size;\
+ uintptr_t __misalignment;\
+ wchar_t *__r;\
+ __a += !__a;\
+ __size = __n * sizeof(wchar_t) + (__a - 1);\
+ __r = alloca(__size + !__size);\
+ __misalignment = (uintptr_t)__r % (uintptr_t)__a;\
+ if (__misalignment)\
+ __r += (uintptr_t)__a - __misalignment;\
+ wmemcpy(__r, __s, __n);\
+ })
+# ifndef aligned_wmemdupa
+# define aligned_wmemdupa(s, alignment, n) libsimple_aligned_wmemdupa(s, alignment, n)
+# endif
+#endif
+
+
+/**
+ * Create a new allocation, with custom alignment, and copy wide characters into it
+ *
+ * @param s The wide characters to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __alloc_size__(3), __nonnull__, __warn_unused_result__)))
+wchar_t *libsimple_aligned_wmemdup(const wchar_t *, size_t, size_t);
+#ifndef aligned_wmemdup
+# define aligned_wmemdup libsimple_aligned_wmemdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wmemdup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The wide characters to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(3), __alloc_size__(4), __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enaligned_wmemdup(int, const wchar_t *, size_t, size_t);
+#ifndef enaligned_wmemdup
+# define enaligned_wmemdup libsimple_enaligned_wmemdup
+#endif
+
+
+/**
+ * Version of `libsimple_aligned_wmemdup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The wide characters to copy
+ * @param alignment The alignment of the returned pointer
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __alloc_align__(2), __alloc_size__(3), __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ealigned_wmemdup(const wchar_t *__s, size_t __alignment, size_t __n)
+{ return libsimple_enaligned_wmemdup(libsimple_default_failure_exit, __s, __alignment, __n); }
+#ifndef ealigned_wmemdup
+# define ealigned_wmemdup libsimple_ealigned_wmemdup
+#endif
diff --git a/libsimple/array.h b/libsimple/array.h
index 2eea727..2016540 100644
--- a/libsimple/array.h
+++ b/libsimple/array.h
@@ -144,14 +144,14 @@
/* @since 1.1 */
-#define libsimple_arraycpy(d, s, n) libsimple_memcpy(d, s, (n) * sizeof *(s))
+#define libsimple_arraycpy(d, s, n) memcpy(d, s, (n) * sizeof *(s))
#ifndef arraycpy
# define arraycpy(...) libsimple_arraycpy(__VA_ARGS__)
#endif
/* @since 1.1 */
-#define libsimple_arraymove(d, s, n) libsimple_memmove(d, s, (n) * sizeof *(s))
+#define libsimple_arraymove(d, s, n) memmove(d, s, (n) * sizeof *(s))
#ifndef arraymove
# define arraymove(...) libsimple_arraymove(__VA_ARGS__)
#endif
diff --git a/libsimple/memdup.h b/libsimple/memdup.h
index 6125a0d..8e5b41f 100644
--- a/libsimple/memdup.h
+++ b/libsimple/memdup.h
@@ -15,7 +15,7 @@
({\
const char *__s = (s);\
size_t __n = (n);\
- char *__r = alloca(__n);\
+ char *__r = alloca(__n + !__n);\
memcpy(__r, __s, __n);\
})
# ifndef memdupa
@@ -68,7 +68,7 @@ void *libsimple_enmemdup(int, const void *, size_t);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2), __warn_unused_result__, __returns_nonnull__)))
static inline void *libsimple_ememdup(const void *__s, size_t __n)
-{ return enmemdup(libsimple_default_failure_exit, __s, __n); }
+{ return libsimple_enmemdup(libsimple_default_failure_exit, __s, __n); }
#ifndef ememdup
# define ememdup libsimple_ememdup
#endif
diff --git a/libsimple/realloc.h b/libsimple/realloc.h
index 2d8af2e..32a5f59 100644
--- a/libsimple/realloc.h
+++ b/libsimple/realloc.h
@@ -215,7 +215,7 @@ libsimple_enreallocn(int __status, void *__ptr, size_t __n, ... /*, (size_t)0 */
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2), __warn_unused_result__, __returns_nonnull__)))
static inline void *libsimple_erealloc(void *__ptr, size_t __n)
-{ return enrealloc(libsimple_default_failure_exit, __ptr, __n); }
+{ return libsimple_enrealloc(libsimple_default_failure_exit, __ptr, __n); }
#ifndef erealloc
# define erealloc libsimple_erealloc
#endif
@@ -299,3 +299,261 @@ libsimple_ereallocn(void *__ptr, size_t __n, ... /*, (size_t)0 */)
#ifndef ereallocn
# define ereallocn libsimple_ereallocn
#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n The number of bytes to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2), __warn_unused_result__)))
+static inline void *
+libsimple_reallocf(void *__ptr, size_t __n) /* TODO test */
+{
+ void *__new = __n ? realloc(__ptr, __n) : NULL;
+ if (!__new)
+ free(__ptr);
+ return __new;
+}
+#ifndef reallocf
+# define reallocf libsimple_reallocf
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`; `NULL` on failure
+ * @throws EINVAL `n` or `m` is 0
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2, 3), __warn_unused_result__)))
+static inline void *
+libsimple_reallocarray(void *__ptr, size_t __n, size_t __m)
+{
+ if (LIBSIMPLE_UMUL_OVERFLOW(__n, __m, &__n, SIZE_MAX)) {
+ errno = ENOMEM;
+ return NULL;
+ }
+ return realloc(__ptr, __n);
+}
+#ifndef reallocarray
+# define reallocarray libsimple_reallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(3, 4), __warn_unused_result__, __returns_nonnull__)))
+void *libsimple_enreallocarray(int, void *, size_t, size_t);
+#ifndef enreallocarray
+# define enreallocarray libsimple_enreallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is still valid. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2, 3), __warn_unused_result__, __returns_nonnull__)))
+static inline void *libsimple_ereallocarray(void *__ptr, size_t __n, size_t __m)
+{ return libsimple_enreallocarray(libsimple_default_failure_exit, __ptr, __n, __m); }
+#ifndef ereallocarray
+# define ereallocarray libsimple_ereallocarray
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * The allocation size will be at least `n * m`
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n The number of elements to allocate, the behaviour of
+ * this function is unspecified for the value 0
+ * @param m Size, in bytes, of each element, the behaviour of
+ * this function is unspecified for the value 0
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`; `NULL` on failure
+ * @throws EINVAL `n` or `m` is 0
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__alloc_size__(2, 3), __warn_unused_result__)))
+static inline void *
+libsimple_reallocarrayf(void *__ptr, size_t __n, size_t __m) /* TODO test */
+{
+ void *__new = __n ? libsimple_reallocarray(__ptr, __n, __m) : NULL;
+ if (!__new)
+ free(__ptr);
+ return __new;
+}
+#ifndef reallocarrayf
+# define reallocarrayf libsimple_reallocarrayf
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n First factor for the allocation size, must not be 0
+ * @param ap The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__warn_unused_result__)))
+static inline void *
+libsimple_vreallocfn(void *__ptr, size_t __n, va_list __ap) /* TODO test (reallocfn) */
+{
+ void *__new = libsimple_vreallocn(__ptr, __n, __ap);
+ if (!__new)
+ free(__ptr);
+ return __new;
+}
+#ifndef vreallocfn
+# define vreallocfn libsimple_vreallocfn
+#endif
+
+
+/**
+ * Dynamically reallocates heap allocated, uninitialised,
+ * memory with default alignment (`alignof(max_align_t)`)
+ * as the new alignment
+ *
+ * The product of all arguments, up to the first 0,
+ * will be used as the number of bytes to allocated
+ *
+ * On success, either `ptr` is returned, or a new non-null
+ * pointer is returned with the same content (truncated to
+ * `n` bytes if size shrunk), in which case `ptr` is
+ * deallocated. On failure `ptr` is deallocated. If `ptr`
+ * is `NULL` a new allocation is made.
+ *
+ * @param ptr Pointer to reallocated, `NULL` for a new allocation
+ * @param n First factor for the allocation size, must not be 0
+ * @param ... The rest of the factors for the allocation size,
+ * all arguments should have the type `size_t`, and
+ * list must end with 0 (which is not factor)
+ * @return Either `ptr` or a unique pointer with at least
+ * the specified size and with the alignment
+ * `alignof(max_align_t)`; `NULL` on failure
+ * @throws EINVAL `n` is 0
+ * @throws ENOMEM Could not allocated enough memory
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__warn_unused_result__)))
+static inline void *
+libsimple_reallocfn(void *__ptr, size_t __n, ... /*, (size_t)0 */)
+{
+ va_list __ap;
+ va_start(__ap, __n);
+ return libsimple_vreallocfn(__ptr, __n, __ap);
+ va_end(__ap);
+}
+#ifndef reallocfn
+# define reallocfn libsimple_reallocfn
+#endif
diff --git a/libsimple/str.h b/libsimple/str.h
index 3e321e1..4c17a0a 100644
--- a/libsimple/str.h
+++ b/libsimple/str.h
@@ -382,7 +382,7 @@ static inline int libsimple_streq(const char *__a, const char *__b)
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __warn_unused_result__)))
static inline int libsimple_streqnul(const char *__a, const char *__b)
-{ return !strcmpnul(__a, __b); }
+{ return !libsimple_strcmpnul(__a, __b); }
#ifndef streqnul
# define streqnul libsimple_streqnul
#endif
@@ -418,7 +418,7 @@ static inline int libsimple_strcaseeq(const char *__a, const char *__b)
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __warn_unused_result__)))
static inline int libsimple_strcaseeqnul(const char *__a, const char *__b)
-{ return !strcasecmpnul(__a, __b); }
+{ return !libsimple_strcasecmpnul(__a, __b); }
#ifndef strcaseeqnul
# define strcaseeqnul libsimple_strcaseeqnul
#endif
@@ -470,7 +470,7 @@ size_t libsimple_strcaseeqlen(const char *, const char *);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __nonnull__, __warn_unused_result__)))
static inline size_t libsimple_strreqlen(const char *__a, const char *__b)
-{ return memreqlen(__a, strlen(__a), __b, strlen(__b)); }
+{ return libsimple_memreqlen(__a, strlen(__a), __b, strlen(__b)); }
#ifndef strreqlen
# define strreqlen libsimple_strreqlen
#endif
@@ -488,7 +488,7 @@ static inline size_t libsimple_strreqlen(const char *__a, const char *__b)
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __nonnull__, __warn_unused_result__)))
static inline size_t libsimple_strrcaseeqlen(const char *__a, const char *__b)
-{ return memrcaseeqlen(__a, strlen(__a), __b, strlen(__b)); }
+{ return libsimple_memrcaseeqlen(__a, strlen(__a), __b, strlen(__b)); }
#ifndef strrcaseeqlen
# define strrcaseeqlen libsimple_strrcaseeqlen
#endif
diff --git a/libsimple/strdup.h b/libsimple/strdup.h
index 1d23b24..3db9d95 100644
--- a/libsimple/strdup.h
+++ b/libsimple/strdup.h
@@ -49,7 +49,7 @@ char *libsimple_enstrdup(int, const char *);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __assume_aligned__(1), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
static inline char *libsimple_estrdup(const char *__s)
-{ return enstrdup(libsimple_default_failure_exit, __s); }
+{ return libsimple_enstrdup(libsimple_default_failure_exit, __s); }
#ifndef estrdup
# define estrdup libsimple_estrdup
#endif
diff --git a/libsimple/strn.h b/libsimple/strn.h
index 5f5740e..dc6e695 100644
--- a/libsimple/strn.h
+++ b/libsimple/strn.h
@@ -513,7 +513,7 @@ static inline int libsimple_strncaseeq(const char *__a, const char *__b, size_t
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __warn_unused_result__)))
static inline int libsimple_strncaseeqnul(const char *__a, const char *__b, size_t __n)
-{ return !strncasecmpnul(__a, __b, __n); }
+{ return !libsimple_strncasecmpnul(__a, __b, __n); }
#ifndef strncaseeqnul
# define strncaseeqnul libsimple_strncaseeqnul
#endif
@@ -571,7 +571,7 @@ size_t libsimple_strncaseeqlen(const char *, const char *, size_t);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __nonnull__, __warn_unused_result__)))
static inline size_t libsimple_strrneqlen(const char *__a, const char *__b, size_t __n)
-{ return memreqlen(__a, strnlen(__a, __n), __b, strnlen(__b, __n)); }
+{ return libsimple_memreqlen(__a, strnlen(__a, __n), __b, strnlen(__b, __n)); }
#ifndef strrneqlen
# define strrneqlen libsimple_strrneqlen
#endif
@@ -591,7 +591,7 @@ static inline size_t libsimple_strrneqlen(const char *__a, const char *__b, size
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__pure__, __nonnull__, __warn_unused_result__)))
static inline size_t libsimple_strrncaseeqlen(const char *__a, const char *__b, size_t __n)
-{ return memrcaseeqlen(__a, strnlen(__a, __n), __b, strnlen(__b, __n)); }
+{ return libsimple_memrcaseeqlen(__a, strnlen(__a, __n), __b, strnlen(__b, __n)); }
#ifndef strrncaseeqlen
# define strrncaseeqlen libsimple_strrncaseeqlen
#endif
diff --git a/libsimple/strndup.h b/libsimple/strndup.h
index c7d0b3a..b3229d5 100644
--- a/libsimple/strndup.h
+++ b/libsimple/strndup.h
@@ -55,7 +55,7 @@ char *libsimple_enstrndup(int, const char *, size_t);
*/
_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, __assume_aligned__(1), __nonnull__, __warn_unused_result__, __returns_nonnull__)))
static inline char *libsimple_estrndup(const char *__s, size_t __n)
-{ return enstrndup(libsimple_default_failure_exit, __s, __n); }
+{ return libsimple_enstrndup(libsimple_default_failure_exit, __s, __n); }
#ifndef estrndup
# define estrndup libsimple_estrndup
#endif
diff --git a/libsimple/time.h b/libsimple/time.h
index b6eb923..aa92314 100644
--- a/libsimple/time.h
+++ b/libsimple/time.h
@@ -399,3 +399,105 @@ char *libsimple_minimise_number_string(char *);
#ifndef minimise_number_string
# define minimise_number_string libsimple_minimise_number_string
#endif
+
+
+/**
+ * Get the current time in the local timezone
+ *
+ * This function is leap-second aware
+ *
+ * @param tm Output parameter for the local time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ * @return 0 on success, -1 on failure
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(1))))
+int libsimple_localtime(struct tm *, struct timespec *);
+
+/**
+ * Get the current time in the local timezone
+ *
+ * This function is leap-second aware
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * @param status The exit value for the process in case of failure
+ * @param tm Output parameter for the local time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(2))))
+void libsimple_enlocaltime(int, struct tm *, struct timespec *);
+
+/**
+ * Get the current time in the local timezone
+ *
+ * This function is leap-second aware
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * @param tm Output parameter for the local time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(1))))
+static inline void libsimple_elocaltime(struct tm *__tm, struct timespec *__ts)
+{ libsimple_enlocaltime(libsimple_default_failure_exit, __tm, __ts); }
+
+
+/**
+ * Get the current time in the UTC timezone
+ *
+ * This function is leap-second aware
+ *
+ * @param tm Output parameter for the UTC time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ * @return 0 on success, -1 on failure
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(1))))
+int libsimple_gmtime(struct tm *, struct timespec *);
+
+/**
+ * Get the current time in the UTC timezone
+ *
+ * This function is leap-second aware
+ *
+ * On failure, the `libsimple_enprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_enprintf` for more information
+ *
+ * @param status The exit value for the process in case of failure
+ * @param tm Output parameter for the UTC time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(2))))
+void libsimple_engmtime(int, struct tm *, struct timespec *);
+
+/**
+ * Get the current time in the UTC timezone
+ *
+ * This function is leap-second aware
+ *
+ * On failure, the `libsimple_eprintf` function is called,
+ * cause the program to print an error message and exit,
+ * see `libsimple_eprintf` for more information
+ *
+ * @param tm Output parameter for the UTC time
+ * @param ts Output parameter for the POSIX time, may be NULL
+ *
+ * @since 1.2
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__nonnull__(1))))
+static inline void libsimple_egmtime(struct tm *__tm, struct timespec *__ts)
+{ libsimple_engmtime(libsimple_default_failure_exit, __tm, __ts); }
diff --git a/libsimple/wcsdup.h b/libsimple/wcsdup.h
new file mode 100644
index 0000000..b85d265
--- /dev/null
+++ b/libsimple/wcsdup.h
@@ -0,0 +1,51 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of wcsdup(3)
+ *
+ * @param s:const wchar_t * The string to copy
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_wcsdupa(s)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = wcslen(__s) + 1;\
+ wchar_t *__r = alloca(__n * sizeof(wchar_t));\
+ wmemcpy(__r, __s, __n);\
+ })
+# ifndef wcsdupa
+# define wcsdupa(s) libsimple_wcsdupa(s)
+# endif
+#endif
+
+
+/**
+ * Version of wcsdup(3) that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __nonnull__,
+ __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enwcsdup(int, const wchar_t *);
+#ifndef enwcsdup
+# define enwcsdup libsimple_enwcsdup
+#endif
+
+
+/**
+ * Version of wcsdup(3) that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t),
+ __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ewcsdup(const wchar_t *__s)
+{ return enwcsdup(libsimple_default_failure_exit, __s); }
+#ifndef ewcsdup
+# define ewcsdup libsimple_ewcsdup
+#endif
diff --git a/libsimple/wcsndup.h b/libsimple/wcsndup.h
new file mode 100644
index 0000000..31e9118
--- /dev/null
+++ b/libsimple/wcsndup.h
@@ -0,0 +1,72 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_wcsndup`
+ *
+ * @param s:const wchar_t * The string to copy
+ * @param n:size_t The maximum number of wide characters to copy
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_wcsndupa(s, n)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = wcsnlen(__s, n);\
+ wchar_t *__r;\
+ __r = alloca((__n + 1) * sizeof(wchar_t));\
+ wmemcpy(__r, __s, __n);\
+ __r[__n] = 0;\
+ __r;\
+ })
+# ifndef wcsndupa
+# define wcsndupa(s, n) libsimple_wcsndupa(s, n)
+# endif
+#endif
+
+
+/**
+ * Create a new allocation and copy a wide-character string into it
+ *
+ * @param s The string to copy
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __nonnull__,
+ __warn_unused_result__)))
+wchar_t *libsimple_wcsndup(const wchar_t *, size_t);
+#ifndef wcsndup
+# define wcsndup libsimple_wcsndup
+#endif
+
+
+/**
+ * Version of `libsimple_wcsndup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The string to copy
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __nonnull__,
+ __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enwcsndup(int, const wchar_t *, size_t);
+#ifndef enwcsndup
+# define enwcsndup libsimple_enwcsndup
+#endif
+
+
+/**
+ * Version of `libsimple_wcsndup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The string to copy
+ * @param n The maximum number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t),
+ __nonnull__, __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ewcsndup(const wchar_t *__s, size_t __n)
+{ return libsimple_enwcsndup(libsimple_default_failure_exit, __s, __n); }
+#ifndef ewcsndup
+# define ewcsndup libsimple_ewcsndup
+#endif
diff --git a/libsimple/wmemdup.h b/libsimple/wmemdup.h
new file mode 100644
index 0000000..2c1f899
--- /dev/null
+++ b/libsimple/wmemdup.h
@@ -0,0 +1,68 @@
+/* See LICENSE file for copyright and license details. */
+
+
+/**
+ * Stack allocation version of `libsimple_wmemdup`
+ *
+ * @param s:const wchar_t * The wide characters to copy
+ * @param n:size_t The number of wide characters to copy
+ * @return :wchar_t * Duplicate of `s` with automatic storage
+ */
+#if defined(__GNUC__) || defined(__clang__)
+# define libsimple_wmemdupa(s, n)\
+ ({\
+ const wchar_t *__s = (s);\
+ size_t __n = (n);\
+ wchar_t *__r = alloca(__n * sizeof(wchar_t) + !__n);\
+ wmemcpy(__r, __s, __n);\
+ })
+# ifndef wmemdupa
+# define wmemdupa(s, n) libsimple_wmemdupa(s, n)
+# endif
+#endif
+
+
+/**
+ * Create a new allocation and copy wide characters into it
+ *
+ * @param s The wide characters to copy
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`, `NULL` on failure
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __alloc_size__(2), __warn_unused_result__)))
+wchar_t *libsimple_wmemdup(const wchar_t *, size_t);
+#ifndef wmemdup
+# define wmemdup libsimple_wmemdup
+#endif
+
+
+/**
+ * Version of `libsimple_wmemdup` that calls `libsimple_enprintf` on error
+ *
+ * @param status Exit value in case of failure
+ * @param s The wide characters to copy
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __alloc_size__(3),
+ __warn_unused_result__, __returns_nonnull__)))
+wchar_t *libsimple_enwmemdup(int, const wchar_t *, size_t);
+#ifndef enwmemdup
+# define enwmemdup libsimple_enwmemdup
+#endif
+
+
+/**
+ * Version of `libsimple_wmemdup` that calls `libsimple_eprintf` on error
+ *
+ * @param s The wide characters to copy
+ * @param n The number of wide characters to copy
+ * @return Duplicate of `s`
+ */
+_LIBSIMPLE_GCC_ONLY(__attribute__((__malloc__, _libsimple_assume_aligned_as(wchar_t), __alloc_size__(2),
+ __warn_unused_result__, __returns_nonnull__)))
+static inline wchar_t *libsimple_ewmemdup(const wchar_t *__s, size_t __n)
+{ return libsimple_enwmemdup(libsimple_default_failure_exit, __s, __n); }
+#ifndef ewmemdup
+# define ewmemdup libsimple_ewmemdup
+#endif
diff --git a/localtime.c b/localtime.c
new file mode 100644
index 0000000..0b075a0
--- /dev/null
+++ b/localtime.c
@@ -0,0 +1,61 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#include <sys/timex.h>
+#ifndef TEST
+
+
+int
+libsimple_localtime(struct tm *tm, struct timespec *ts)
+{
+ struct timex timex;
+ int r;
+
+ memset(&timex, 0, sizeof(timex));
+ timex.status = ADJ_NANO;
+ r = adjtimex(&timex);
+ if (r == -1)
+ return -1;
+ if (ts) {
+ ts->tv_sec = timex.time.tv_sec;
+ ts->tv_nsec = timex.time.tv_usec;
+ }
+
+ if (timex.time.tv_sec % (24 * 60 * 60) == 0) {
+ if (r == TIME_INS) {
+ timex.time.tv_sec -= 1;
+ if (!localtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ tm->tm_sec += 1;
+ return 1;
+ } else if (r == TIME_DEL) {
+ timex.time.tv_sec += 1;
+ if (!localtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ } else {
+ if (!localtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ }
+ } else if (r == TIME_OOP) {
+ if (!localtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ tm->tm_sec += 1;
+ } else {
+ if (!localtime_r(&timex.time.tv_sec, tm))
+ return -1;
+ }
+
+ return 0;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ /* TODO test */
+ return 0;
+}
+
+#endif
diff --git a/man0/libsimple-arg.h.0 b/man0/libsimple-arg.h.0
index d60e59e..abc8619 100644
--- a/man0/libsimple-arg.h.0
+++ b/man0/libsimple-arg.h.0
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE\-ARG.H 0 2018-11-15 libsimple
+.TH LIBSIMPLE\-ARG.H 0 libsimple
.SH NAME
libsimple\-arg.h \- command line argument parsing header for libsimple
+
.SH SYNOPSIS
.nf
#include <libsimple\-arg.h>
@@ -29,6 +30,7 @@ struct longopt {
#define USAGE(\fISYNOPSIS\fP) /* implementation omitted */
#define NUSAGE(\fISTATUS\fP, \fISYNOPSIS\fP) /* implementation omitted */
.fi
+
.SH DESCRIPTION
The
.I <libsimple\-arg.h>
@@ -467,13 +469,18 @@ once, or if flags are used, never. So if your application
should not have any options or operands,
.I NOFLAGS(argc)
can be used.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH SEE ALSO
.BR libsimple.h (0)
diff --git a/man0/libsimple.h.0 b/man0/libsimple.h.0
index c9055d5..36e4f71 100644
--- a/man0/libsimple.h.0
+++ b/man0/libsimple.h.0
@@ -1,10 +1,12 @@
-.TH LIBSIMPLE.H 0 2018-11-24 libsimple
+.TH LIBSIMPLE.H 0 libsimple
.SH NAME
libsimple.h \- main header for libsimple
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
.fi
+
.SH DESCRIPTION
The header
.I <libsimple.h>
@@ -43,8 +45,10 @@ includes the following header files:
.IR <string.h> ,
.IR <strings.h> ,
.IR <time.h> ,
+.IR <unistd.h> ,
+.IR <wchar.h> ,
and
-.IR <unistd.h> .
+.IR <wctype.h> .
.PP
The header
.I <libsimple.h>
@@ -139,20 +143,17 @@ are defined only with namespacing:
.TP
.BR libsimple_arrayalloc (3),
-.RS 0
+.TQ
.BR libsimple_earrayalloc (3),
-.br
+.TQ
.BR libsimple_enarrayalloc (3),
-.br
+.TQ
.BR libsimple_varrayalloc (3),
-.br
+.TQ
.BR libsimple_evarrayalloc (3),
-.br
+.TQ
.BR libsimple_envarrayalloc (3)
-.RE
-.RS
Flexible allocation of memory suitable for allocating arrays.
-.RE
.TP
.BR libsimple_close (3)
@@ -168,20 +169,17 @@ Function called after printing error messages.
Function called before printing error messages.
.TP
.BR libsimple_memalloc (3),
-.RS 0
+.TQ
.BR libsimple_ememalloc (3),
-.br
+.TQ
.BR libsimple_enmemalloc (3),
-.br
+.TQ
.BR libsimple_vmemalloc (3),
-.br
+.TQ
.BR libsimple_evmemalloc (3),
-.br
+.TQ
.BR libsimple_envmemalloc (3)
-.RE
-.RS
Flexible allocation of memory.
-.RE
.PP
The following functions and macros are
@@ -189,177 +187,309 @@ defined both with and without namespacing:
.TP
.BR libsimple_ealigned_alloc (3),
-.RS 0
+.TQ
.BR libsimple_enaligned_alloc (3)
-.RE
-.RS
Wrappers for
.BR aligned_alloc (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_aligned_allocn (3),
-.RS 0
+.TQ
.BR libsimple_ealigned_allocn (3),
-.br
+.TQ
.BR libsimple_enaligned_allocn (3),
-.br
+.TQ
.BR libsimple_valigned_allocn (3),
-.br
+.TQ
.BR libsimple_evaligned_allocn (3),
-.br
+.TQ
.BR libsimple_envaligned_allocn (3)
-.RE
-.RS
Wrappers for
.BR aligned_alloc (3)
that take the product of multiple
arguments as the allocation size.
-.RE
.TP
.BR libsimple_aligned_allocz (3),
-.RS 0
+.TQ
.BR libsimple_ealigned_allocz (3),
-.br
+.TQ
.BR libsimple_enaligned_allocz (3)
-.RE
-.RS
Wrappers for
.BR aligned_alloc (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_aligned_alloczn (3),
-.RS 0
+.TQ
.BR libsimple_ealigned_alloczn (3),
-.br
+.TQ
.BR libsimple_enaligned_alloczn (3),
-.br
+.TQ
.BR libsimple_valigned_alloczn (3),
-.br
+.TQ
.BR libsimple_evaligned_alloczn (3),
-.br
+.TQ
.BR libsimple_envaligned_alloczn (3)
-.RE
-.RS
Wrappers for
.BR aligned_alloc (3)
that take the product of multiple
arguments as the allocation size
and conditionally initialises the memory.
-.RE
.TP
.BR libsimple_aligned_memdup (3),
-.RS 0
+.TQ
.BR libsimple_ealigned_memdup (3),
-.br
+.TQ
.BR libsimple_enaligned_memdup (3)
-.RE
-.RS
Duplicate an array of bytes into a
new pointer with a custom alignment.
-.RE
.TP
.BR libsimple_aligned_memdupa (3)
-Duplicate an array of bytes onto the stack.
+Duplicate an array of bytes onto the stack,
+with custom alignment.
+
+.TP
+.BR libsimple_aligned_realloc (3),
+.TQ
+.BR libsimple_ealigned_realloc (3),
+.TQ
+.BR libsimple_enaligned_realloc (3)
+Version of
+.BR realloc (3)
+with custom alignment.
+
+.TP
+.BR libsimple_aligned_reallocf (3)
+Version of
+.BR realloc (3)
+with custom alignment that deallocates
+the pointer on failure.
+
+.TP
+.BR libsimple_aligned_reallocarray (3),
+.TQ
+.BR libsimple_ealigned_reallocarray (3),
+.TQ
+.BR libsimple_enaligned_reallocarray (3)
+Version of
+.BR realloc (3)
+with custom alignment that, like
+.BR calloc (3),
+takes two size arguments.
+
+.TP
+.BR libsimple_aligned_reallocarrayf (3)
+Version of
+.BR realloc (3)
+with custom alignment that, like
+.BR calloc (3),
+takes two size arguments, and that
+deallocates the pointer on failure.
+
+.TP
+.BR libsimple_aligned_reallocfn (3),
+.TQ
+.BR libsimple_valigned_reallocfn (3)
+Version of
+.BR realloc (3)
+that take the product of multiple arguments
+as the allocation size, and that
+deallocates the pointer on failure.
+
+.TP
+.BR libsimple_aligned_reallocn (3),
+.TQ
+.BR libsimple_ealigned_reallocn (3),
+.TQ
+.BR libsimple_enaligned_reallocn (3),
+.TQ
+.BR libsimple_valigned_reallocn (3),
+.TQ
+.BR libsimple_evaligned_reallocn (3),
+.TQ
+.BR libsimple_envaligned_reallocn (3)
+Version of
+.BR realloc (3)
+that take the product of multiple arguments
+as the allocation size.
+
+.TP
+.BR libsimple_reallocarray (3),
+.TQ
+.BR libsimple_ereallocarray (3),
+.TQ
+.BR libsimple_enreallocarray (3)
+Version of
+.BR realloc (3)
+that, like
+.BR calloc (3),
+takes to size arguments.
+
+.TP
+.BR libsimple_reallocarrayf (3)
+Version of
+.BR realloc (3)
+that, like
+.BR calloc (3),
+takes to size arguments, and that
+deallocates the pointer on failure.
+
+.TP
+.BR libsimple_reallocf (3)
+Version of
+.BR realloc (3)
+that deallocates the pointer on failure.
+
+.TP
+.BR libsimple_reallocfn (3),
+.TQ
+.BR libsimple_vreallocfn (3)
+Version of
+.BR realloc (3)
+that take the product of multiple arguments
+as the allocation size, and that
+deallocates the pointer on failure.
+
+.TP
+.BR libsimple_aligned_strdup (3),
+.TQ
+.BR libsimple_ealigned_strdup (3),
+.TQ
+.BR libsimple_enaligned_strdup (3),
+.TQ
+.BR libsimple_aligned_strndup (3),
+.TQ
+.BR libsimple_ealigned_strndup (3),
+.TQ
+.BR libsimple_enaligned_strndup (3)
+Duplicate a string into a new pointer
+with a custom alignment.
+
+.TP
+.BR libsimple_aligned_strdupa (3),
+.TQ
+.BR libsimple_aligned_strndupa (3)
+Duplicate a string onto the stack,
+with custom alignment.
+
+.TP
+.BR libsimple_aligned_wcsdup (3),
+.TQ
+.BR libsimple_ealigned_wcsdup (3),
+.TQ
+.BR libsimple_enaligned_wcsdup (3),
+.TQ
+.BR libsimple_aligned_wcsndup (3),
+.TQ
+.BR libsimple_ealigned_wcsndup (3),
+.TQ
+.BR libsimple_enaligned_wcsndup (3)
+Duplicate a wide-character string into a
+new pointer with a custom alignment.
+
+.TP
+.BR libsimple_aligned_wcsdupa (3),
+.TQ
+.BR libsimple_aligned_wcsndupa (3)
+Duplicate a wide-character string onto
+the stack, with custom alignment.
+
+.TP
+.BR libsimple_aligned_wmemdup (3),
+.TQ
+.BR libsimple_ealigned_wmemdup (3),
+.TQ
+.BR libsimple_enaligned_wmemdup (3)
+Duplicate an array of wide characters into
+a new pointer with a custom alignment.
+
+.TP
+.BR libsimple_aligned_wmemdupa (3)
+Duplicate an array of wide characters onto
+the stack, with custom alignment.
.TP
.BR libsimple_asprintf (3),
-.RS 0
+.TQ
.BR libsimple_vasprintf (3)
-.RE
-.RS
Format a string and allocate a sufficient large string.
-.RE
.TP
.BR libsimple_asprintfa (3),
-.RS 0
+.TQ
.BR libsimple_vasprintfa (3)
-.RE
-.RS
-Format a string and allocate a sufficient large string onto the stack.
-.RE
+Format a string and allocate a sufficient large
+string onto the stack.
.TP
.BR libsimple_ecalloc (3),
-.RS 0
+.TQ
.BR libsimple_encalloc (3)
-.RE
-.RS
Wrappers for
.BR calloc (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_callocn (3),
-.RS 0
+.TQ
.BR libsimple_ecallocn (3),
-.br
+.TQ
.BR libsimple_encallocn (3),
-.br
+.TQ
.BR libsimple_vcallocn (3),
-.br
+.TQ
.BR libsimple_evcallocn (3),
-.br
+.TQ
.BR libsimple_envcallocn (3)
-.RE
-.RS
Wrappers for
.BR calloc (3)
that take the product of multiple arguments as the allocation size.
-.RE
.TP
.BR libsimple_cmptimespec (3),
-.RS 0
+.TQ
.BR libsimple_cmptimeval (3)
-.RE
-.RS
Compare two durations.
-.RE
.TP
.BR libsimple_difftimespec (3),
-.RS 0
+.TQ
.BR libsimple_difftimeval (3)
-.RE
-.RS
Calculate the difference of two durations.
-.RE
.TP
.BR libsimple_doubletotimespec (3),
-.RS 0
+.TQ
.BR libsimple_doubletotimeval (3)
-.RE
-.RS
Convert a real value to a duration data structure.
-.RE
.TP
.BR libsimple_eprintf (3),
-.RS 0
+.TQ
.BR libsimple_enprintf (3),
-.br
+.TQ
.BR libsimple_veprintf (3),
-.br
+.TQ
.BR libsimple_venprintf (3),
-.br
+.TQ
.BR libsimple_weprintf (3),
-.br
+.TQ
.BR libsimple_vweprintf (3)
-.RE
-.RS
Print an error message and (except for the two last functions)
terminate the process.
-.RE
+
+.TP
+.BR libsimple_gmtime (3),
+.TQ
+.BR libsimple_egmtime (3),
+.TQ
+.BR libsimple_engmtime (3)
+Get the current time in the UTC timezone, and adjust
+for leapsecond insertions and delections.
.TP
.BR libsimple_getenv_e (3)
@@ -372,142 +502,124 @@ Get the value of a non-empty environment value or
.TP
.BR libsimple_inchrset (3)
-.RS 0
+.TQ
.BR libsimple_inchrcaseset (3)
-.RE
-.RS
Test if a byte belongs to set of byte.
-.RE
+
+.TP
+.BR libsimple_localtime (3),
+.TQ
+.BR libsimple_elocaltime (3),
+.TQ
+.BR libsimple_enlocaltime (3)
+Get the current time in the UTC timezone, and adjust
+for leapsecond insertions and delections.
.TP
.BR libsimple_emalloc (3),
-.RS 0
+.TQ
.BR libsimple_enmalloc (3)
-.RE
-.RS
Wrappers for
.BR malloc (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_mallocn (3),
-.RS 0
+.TQ
.BR libsimple_emallocn (3),
-.br
+.TQ
.BR libsimple_enmallocn (3),
-.br
+.TQ
.BR libsimple_vmallocn (3),
-.br
+.TQ
.BR libsimple_evmallocn (3),
-.br
+.TQ
.BR libsimple_envmallocn (3)
-.RE
-.RS
Wrappers for
.BR malloc (3)
that take the product of multiple arguments
as the allocation size.
-.RE
.TP
.BR libsimple_mallocz (3),
-.RS 0
+.TQ
.BR libsimple_emallocz (3),
-.br
+.TQ
.BR libsimple_enmallocz (3)
-.RE
-.RS
Wrappers for
.BR aligned_alloc (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_malloczn (3),
-.RS 0
+.TQ
.BR libsimple_emalloczn (3),
-.br
+.TQ
.BR libsimple_enmalloczn (3),
-.br
+.TQ
.BR libsimple_vmalloczn (3),
-.br
+.TQ
.BR libsimple_evmalloczn (3),
-.br
+.TQ
.BR libsimple_envmalloczn (3)
-.RE
-.RS
Wrappers for
.BR malloc (3)
that take the product of multiple arguments as the
allocation size and conditionally initialises the memory.
-.RE
.TP
.BR libsimple_memalign (3),
-.RS 0
+.TQ
.BR libsimple_ememalign (3),
-.br
+.TQ
.BR libsimple_enmemalign (3)
-.RE
-.RS
Implementation of the nonstandard
.BR memalign (3)
function.
-.RE
.TP
.BR libsimple_memalignn (3),
-.RS 0
+.TQ
.BR libsimple_ememalignn (3),
-.br
+.TQ
.BR libsimple_enmemalignn (3),
-.br
+.TQ
.BR libsimple_vmemalignn (3),
-.br
+.TQ
.BR libsimple_evmemalignn (3),
-.br
+.TQ
.BR libsimple_envmemalignn (3)
-.RE
-.RS
Versions of
.BR libsimple_memalign (3)
that take the product of multiple arguments as the
allocation size.
-.RE
.TP
.BR libsimple_memalignz (3),
-.RS 0
+.TQ
.BR libsimple_ememalignz (3),
-.br
+.TQ
.BR libsimple_enmemalignz (3)
-.RE
-.RS
Versions of
.BR libsimple_memalign (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_memalignzn (3),
-.RS 0
+.TQ
.BR libsimple_ememalignzn (3),
-.br
+.TQ
.BR libsimple_enmemalignzn (3),
-.br
+.TQ
.BR libsimple_vmemalignzn (3),
-.br
+.TQ
.BR libsimple_evmemalignzn (3),
-.br
+.TQ
.BR libsimple_envmemalignzn (3)
-.RE
-.RS
Versions of
.BR libsimple_memalign (3)
that take the product of multiple arguments as the
allocation size and conditionally initialises the memory.
-.RE
.TP
.BR libsimple_memcasechr (3)
@@ -521,36 +633,27 @@ Case-insensitive version of
.TP
.BR libsimple_memchr_inv (3),
-.RS 0
+.TQ
.BR libsimple_memcasechr_inv (3)
-.RE
-.RS
Find first byte that is different from a specified byte.
-.RE
.TP
.BR libsimple_memcmove (3),
-.RS 0
+.TQ
.BR libsimple_rawmemcmove (3)
-.RE
-.RS
Versions of
.BR memccpy (3)
and
.BR libsimple_rawmemccpy (3)
that allow overlap of the arrays.
-.RE
.TP
.BR libsimple_memdup (3),
-.RS 0
+.TQ
.BR libsimple_ememdup (3),
-.br
+.TQ
.BR libsimple_enmemdup (3)
-.RE
-.RS
Duplicate an array of bytes into a new pointer.
-.RE
.TP
.BR libsimple_memdupa (3)
@@ -572,14 +675,12 @@ rather than simple bytes.
.TP
.BR libsimple_memelemcpy (3),
-.RS 0
+.TQ
.BR libsimple_rawmemelemcpy (3),
-.br
+.TQ
.BR libsimple_memelemmove (3),
-.br
+.TQ
.BR libsimple_rawmemelemmove (3)
-.RE
-.RS
Versions of
.BR memccpy (3),
.BR libsimple_rawmemccpy (3),
@@ -588,7 +689,6 @@ and
.BR libsimple_rawmemcmove (3)
that that operate on multibyte units
rather than simple bytes.
-.RE
.TP
.BR libsimple_memelemscan (3)
@@ -606,40 +706,28 @@ rather than simple bytes.
.TP
.BR libsimple_memends (3),
-.RS 0
+.TQ
.BR libsimple_memcaseends (3)
-.RE
-.RS
Check the end if an array of bytes.
-.RE
.TP
.BR libsimple_memeq (3),
-.RS 0
+.TQ
.BR libsimple_memcaseeq (3)
-.RE
-.RS
Compare two arrays of bytes for equality.
-.RE
.TP
.BR libsimple_memeqlen (3),
-.RS 0
+.TQ
.BR libsimple_memcaseeqlen (3)
-.RE
-.RS
Get the number if bytes two arrays of bytes
have in common at their beginning.
-.RE
.TP
.BR libsimple_memmem (3),
-.RS 0
+.TQ
.BR libsimple_memcasemem (3)
-.RE
-.RS
Find a substring of bytes in an array of bytes.
-.RE
.TP
.BR libsimple_mempcpy (3)
@@ -667,23 +755,17 @@ that returns the end of the written array.
.TP
.BR libsimple_memrchr (3),
-.RS 0
+.TQ
.BR libsimple_memrcasechr (3)
-.RE
-.RS
Find the last occurrence of a specific byte
in an array of bytes.
-.RE
.TP
.BR libsimple_memrchr_inv (3),
-.RS 0
+.TQ
.BR libsimple_memrcasechr_inv (3)
-.RE
-.RS
Find the last byte that is different from a
specified byte.
-.RE
.TP
.BR libsimple_memrelem_inv (3)
@@ -709,46 +791,34 @@ another element.
.TP
.BR libsimple_memreqlen (3),
-.RS 0
+.TQ
.BR libsimple_memrcaseeqlen (3)
-.RE
-.RS
Get the number if bytes two arrays of bytes
have in common at their end.
-.RE
.TP
.BR libsimple_memrmem (3),
-.RS 0
+.TQ
.BR libsimple_memrcasemem (3)
-.RE
-.RS
Find the last occurrence of string of byte
in an array of bytes.
-.RE
.TP
.BR libsimple_memscan (3),
-.RS 0
+.TQ
.BR libsimple_memcasescan (3)
-.RE
-.RS
Versions of
.BR memchr (3)
and
.BR libsimple_memcasechr (3)
that return the end of the array
if the byte is not found.
-.RE
.TP
.BR libsimple_memscan_inv (3),
-.RS 0
+.TQ
.BR libsimple_memcasescan_inv (3)
-.RE
-.RS
Skip leading bytes.
-.RE
.TP
.BR libsimple_memsetelem (3)
@@ -756,171 +826,138 @@ Fill en array.
.TP
.BR libsimple_memstarts (3),
-.RS 0
+.TQ
.BR libsimple_memcasestarts (3)
-.RE
-.RS
Check the beginning if an array of bytes.
-.RE
.TP
.BR libsimple_multimespec (3),
-.RS 0
+.TQ
.BR libsimple_multimeval (3)
-.RE
-.RS
Multiple a duration with an integer.
-.RE
.TP
.BR libsimple_eposix_memalign (3),
-.RS 0
+.TQ
.BR libsimple_enposix_memalign (3)
-.RE
-.RS
Wrappers for
.BR posix_memalign (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_posix_memalignn (3),
-.RS 0
+.TQ
.BR libsimple_eposix_memalignn (3),
-.br
+.TQ
.BR libsimple_enposix_memalignn (3),
-.br
+.TQ
.BR libsimple_vposix_memalignn (3),
-.br
+.TQ
.BR libsimple_evposix_memalignn (3),
-.br
+.TQ
.BR libsimple_envposix_memalignn (3)
-.RE
-.RS
Wrappers for
.BR posix_memalign (3)
that take the product of multiple
arguments as the allocation size.
-.RE
.TP
.BR libsimple_posix_memalignz (3),
-.RS 0
+.TQ
.BR libsimple_eposix_memalignz (3),
-.br
+.TQ
.BR libsimple_enposix_memalignz (3)
-.RE
-.RS
Wrappers for
.BR posix_memalign (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_posix_memalignzn (3),
-.RS 0
+.TQ
.BR libsimple_eposix_memalignzn (3),
-.br
+.TQ
.BR libsimple_enposix_memalignzn (3),
-.br
+.TQ
.BR libsimple_vposix_memalignzn (3),
-.br
+.TQ
.BR libsimple_evposix_memalignzn (3),
-.br
+.TQ
.BR libsimple_envposix_memalignzn (3)
-.RE
-.RS
Wrappers for
.BR posix_memalign (3)
that take the product of multiple
arguments as the allocation size
and conditionally initialises the memory.
-.RE
.TP
.BR libsimple_putenvf (3),
-.RS 0
+.TQ
.BR libsimple_eputenvf (3),
-.br
+.TQ
.BR libsimple_enputenvf (3),
-.br
+.TQ
.BR libsimple_vputenvf (3),
-.br
+.TQ
.BR libsimple_evputenvf (3),
-.br
+.TQ
.BR libsimple_envputenvf (3)
-.RE
-.RS
Verion of
.BR putenv (3)
that formats the string.
-.RE
.TP
.BR libsimple_pvalloc (3),
-.RS 0
+.TQ
.BR libsimple_epvalloc (3),
-.br
+.TQ
.BR libsimple_enpvalloc (3)
-.RE
-.RS
Implementation of the nonstandard
.BR pvalloc (3)
function.
-.RE
.TP
.BR libsimple_pvallocn (3),
-.RS 0
+.TQ
.BR libsimple_epvallocn (3),
-.br
+.TQ
.BR libsimple_enpvallocn (3),
-.br
+.TQ
.BR libsimple_vpvallocn (3),
-.br
+.TQ
.BR libsimple_evpvallocn (3),
-.br
+.TQ
.BR libsimple_envpvallocn (3)
-.RE
-.RS
Versions of
.BR libsimple_pvalloc (3)
that take the product of multiple arguments as the
allocation size.
-.RE
.TP
.BR libsimple_pvallocz (3),
-.RS 0
+.TQ
.BR libsimple_epvallocz (3),
-.br
+.TQ
.BR libsimple_enpvallocz (3)
-.RE
-.RS
Versions of
.BR libsimple_pvalloc (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_pvalloczn (3),
-.RS 0
+.TQ
.BR libsimple_epvalloczn (3),
-.br
+.TQ
.BR libsimple_enpvalloczn (3),
-.br
+.TQ
.BR libsimple_vpvalloczn (3),
-.br
+.TQ
.BR libsimple_evpvalloczn (3),
-.br
+.TQ
.BR libsimple_envpvalloczn (3)
-.RE
-.RS
Versions of
.BR libsimple_pvalloc (3)
that take the product of multiple arguments as the
allocation size and conditionally initialises the memory.
-.RE
.TP
.BR libsimple_rawmemccpy (3)
@@ -931,25 +968,19 @@ byte actually exists in the array.
.TP
.BR libsimple_rawmemchr (3),
-.RS 0
+.TQ
.BR libsimple_rawmemcasechr (3)
-.RE
-.RS
Find the first occurrence of a specific byte
in an array of bytes, with the optimising
assumption that it actually exists in the array.
-.RE
.TP
.BR libsimple_rawmemchr_inv (3),
-.RS 0
+.TQ
.BR libsimple_rawmemcasechr_inv (3)
-.RE
-.RS
Find first byte that is different from a specified
byte, with the optimising assumption that such a
byte actually exists in the array.
-.RE
.TP
.BR libsimple_rawmemelem (3)
@@ -967,21 +998,16 @@ element actually exists in the array.
.TP
.BR libsimple_rawmemrchr (3)
-.RS 0
+.TQ
.BR libsimple_rawmemrcasechr (3)
-.RE
-.RS
Find the last occurrence of a specific byte
in an array of bytes, with the optimising
assumption that it actually exists in the array.
-.RE
.TP
.BR libsimple_rawmemrchr_inv (3),
-.RS 0
+.TQ
.BR libsimple_rawmemrcasechr_inv (3)
-.RE
-.RS
Find last byte that is different from a specified
byte, with the optimising assumption that such a
byte actually exists in the array.
@@ -999,38 +1025,31 @@ Version of
.BR libsimple_memrelem_inv (3),
with the optimising assumption that such a
element actually exists in the array.
-.RE
.TP
.BR libsimple_erealloc (3),
-.RS 0
+.TQ
.BR libsimple_enrealloc (3)
-.RE
-.RS
Wrappers for
.BR realloc (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_reallocn (3),
-.RS 0
+.TQ
.BR libsimple_ereallocn (3),
-.br
+.TQ
.BR libsimple_enreallocn (3),
-.br
+.TQ
.BR libsimple_vreallocn (3),
-.br
+.TQ
.BR libsimple_evreallocn (3),
-.br
+.TQ
.BR libsimple_envreallocn (3)
-.RE
-.RS
Wrappers for
.BR realloc (3)
that take the product of multiple arguments
as the allocation size.
-.RE
.TP
.BR libsimple_strcasechr (3)
@@ -1044,38 +1063,30 @@ Case-insensitive version of
.TP
.BR libsimple_strccpy (3),
-.RS 0
+.TQ
.BR libsimple_strnccpy (3)
-.RE
-.RS
Copy a string but stop after the first
occurrence of a specified character.
-.RE
.TP
.BR libsimple_strchr_inv (3),
-.RS 0
+.TQ
.BR libsimple_strcasechr_inv (3),
-.br
+.TQ
.BR libsimple_strnchr_inv (3),
-.br
+.TQ
.BR libsimple_strncasechr_inv (3)
-.RE
-.RS
Find the first character that is different
from a specified character.
-.RE
.TP
.BR libsimple_strchrnul (3),
-.RS 0
+.TQ
.BR libsimple_strcasechrnul (3),
-.br
+.TQ
.BR libsimple_strnchrnul (3),
-.br
+.TQ
.BR libsimple_strncasechrnul (3)
-.RE
-.RS
Versions of
.BR strchr (3),
.BR libsimple_strcasechr (3),
@@ -1084,41 +1095,32 @@ and
.BR libsimple_strncasechr (3)
that return the end of the
string if the byte is not found.
-.RE
.TP
.BR libsimple_strchrnul_inv (3),
-.RS 0
+.TQ
.BR libsimple_strcasechrnul_inv (3),
-.br
+.TQ
.BR libsimple_strnchrnul_inv (3),
-.br
+.TQ
.BR libsimple_strncasechrnul_inv (3)
-.RE
-.RS
Skip leading characters.
-.RE
.TP
.BR libsimple_strcmove (3),
-.RS 0
+.TQ
.BR libsimple_strncmove (3)
-.RE
-.RS
Move a string but stop after the first
occurrence of a specified character.
-.RE
.TP
.BR libsimple_strcmpnul (3),
-.RS 0
+.TQ
.BR libsimple_strcasecmpnul (3),
-.br
+.TQ
.BR libsimple_strncmpnul (3),
-.br
+.TQ
.BR libsimple_strncasecmpnul (3)
-.RE
-.RS
Versions of
.BR strcmp (3),
.BR strcasecmp (3),
@@ -1127,158 +1129,124 @@ and
.BR strncasecmp (3)
that support
.BR NULL .
-.RE
.TP
.BR libsimple_estrdup (3),
-.RS 0
+.TQ
.BR libsimple_enstrdup (3),
-.br
+.TQ
.BR libsimple_estrndup (3),
-.br
+.TQ
.BR libsimple_enstrndup (3)
-.RE
-.RS
Wrappers of
.BR strdup (3)
and
.BR strndup (3)
that terminate the process on failure.
-.RE
.TP
.BR libsimple_strdupa (3),
-.RS 0
+.TQ
.BR libsimple_strndupa (3)
-.RE
-.RS
Versions of
.BR strdup (3),
and
.BR strndup (3)
that allocate the string on the stack.
-.RE
.TP
.BR libsimple_strend (3),
-.RS 0
+.TQ
.BR libsimple_strnend (3)
-.RE
-.RS
Locate end of string.
-.RE
.TP
.BR libsimple_strends (3),
-.RS 0
+.TQ
.BR libsimple_strcaseends (3),
-.br
+.TQ
.BR libsimple_strnends (3),
-.br
+.TQ
.BR libsimple_strncaseends (3)
-.RE
-.RS
Check the end if a string.
-.RE
.TP
.BR libsimple_streq (3),
-.RS 0
+.TQ
.BR libsimple_strcaseeq (3),
-.br
+.TQ
.BR libsimple_strneq (3),
-.br
+.TQ
.BR libsimple_strncaseeq (3)
-.RE
-.RS
Compare two strings for equality.
-.RE
.TP
.BR libsimple_streqlen (3),
-.RS 0
+.TQ
.BR libsimple_strcaseeqlen (3),
-.br
+.TQ
.BR libsimple_strneqlen (3),
-.br
+.TQ
.BR libsimple_strncaseeqlen (3)
-.RE
-.RS
Get the number if bytes two strings
have in common at their beginning.
-.RE
.TP
.BR libsimple_streqnul (3),
-.RS 0
+.TQ
.BR libsimple_strcaseeqnul (3),
-.br
+.TQ
.BR libsimple_strneqnul (3),
-.br
+.TQ
.BR libsimple_strncaseeqnul (3)
-.RE
-.RS
Verions of
.BR libsimple_streq (3)
and
.BR libsimple_strcaseeq (3)
that support
.BR NULL .
-.RE
.TP
.BR libsimple_strisutf8 (3),
-.RS 0
+.TQ
.BR libsimple_strnisutf8 (3),
-.br
+.TQ
.BR libsimple_memisutf8 (3)
-.RE
-.RS
Check if a string is valid UTF-8.
-.RE
.TP
.BR libsimple_strmove (3),
-.RS 0
+.TQ
.BR libsimple_strnmove (3),
-.br
+.TQ
.BR libsimple_stpmove (3),
-.br
+.TQ
.BR libsimple_stpnmove (3)
-.RE
-.RS
Versions of
.BR memmove (3)
and
.BR libsimple_mempmove (3)
that moves an entire string.
-.RE
.TP
.BR libsimple_strnchr (3),
-.RS 0
+.TQ
.BR libsimple_strncasechr (3)
-.RE
-.RS
Versions of
.BR strchr (3)
and
.BR libsimple_strcasechr (3)
that support strings without NUL-termination.
-.RE
.TP
.BR libsimple_strnstr (3),
-.RS 0
+.TQ
.BR libsimple_strncasestr (3)
-.RE
-.RS
Versions of
.BR strstr (3)
and
.BR libsimple_strcasestr (3)
that support strings without NUL-termination.
-.RE
.TP
.BR libsimple_strrcasechr (3)
@@ -1287,260 +1255,243 @@ Case-insensitive version of the
.TP
.BR libsimple_strrchrnul_inv (3),
-.RS 0
+.TQ
.BR libsimple_strrcasechrnul_inv (3),
-.br
+.TQ
.BR libsimple_strrnchrnul_inv (3),
-.br
+.TQ
.BR libsimple_strrncasechrnul_inv (3)
-.RE
-.RS
Skip trailing characters.
-.RE
.TP
.BR libsimple_strreplace (3),
-.RS 0
+.TQ
.BR libsimple_strnreplace (3)
-.RE
-.RS
Replace all occurrences of a character with
another character.
-.RE
.TP
.BR libsimple_strreqlen (3),
-.RS 0
+.TQ
.BR libsimple_strrcaseeqlen (3),
-.br
+.TQ
.BR libsimple_strrneqlen (3),
-.br
+.TQ
.BR libsimple_strrncaseeqlen (3)
-.RE
-.RS
Get the number if bytes two strings
have in common at their end.
-.RE
.TP
.BR libsimple_strrnchr (3),
-.RS 0
+.TQ
.BR libsimple_strrncasechr (3)
-.RE
-.RS
Versions of
.BR strrchr (3)
and
.BR libsimple_strrcasechr (3)
that support strings without NUL-termination.
-.RE
.TP
.BR libsimple_strrstr (3),
-.RS 0
+.TQ
.BR libsimple_strrcasestr (3),
-.br
+.TQ
.BR libsimple_strrnstr (3),
-.br
+.TQ
.BR libsimple_strrncasestr (3)
-.RE
-.RS
Find the last occurrence of a substring.
-.RE
.TP
.BR libsimple_stpnset (3),
-.RS 0
+.TQ
.BR libsimple_stpset (3),
-.br
+.TQ
.BR libsimple_strnset (3),
-.br
+.TQ
.BR libsimple_strset (3)
-.RE
-.RS
Fill a string a with character.
-.RE
.TP
.BR libsimple_strstarts (3),
-.RS 0
+.TQ
.BR libsimple_strcasestarts (3),
-.br
+.TQ
.BR libsimple_strnstarts (3),
-.br
+.TQ
.BR libsimple_strncasestarts (3)
-.RE
-.RS
Check the beginning if a string.
-.RE
.TP
.BR libsimple_strtolower (3),
-.RS 0
+.TQ
.BR libsimple_strntolower (3),
-.br
+.TQ
.BR libsimple_memtolower (3),
-.br
+.TQ
.BR libsimple_stptolower (3),
-.br
+.TQ
.BR libsimple_stpntolower (3),
-.br
+.TQ
.BR libsimple_memptolower (3)
-.RE
-.RS
Convert a string to lower case.
-.RE
.TP
.BR libsimple_strtotimespec (3),
-.RS 0
+.TQ
.BR libsimple_strtotimeval (3)
-.RE
-.RS
Convert a string, with a real value
representing a number of seconds, to
a duration.
-.RE
.TP
.BR libsimple_strtoupper (3),
-.RS 0
+.TQ
.BR libsimple_strntoupper (3),
-.br
+.TQ
.BR libsimple_memtoupper (3),
-.br
+.TQ
.BR libsimple_stptoupper (3),
-.br
+.TQ
.BR libsimple_stpntoupper (3),
-.br
+.TQ
.BR libsimple_memptoupper (3)
-.RE
-.RS
Convert a string to upper case.
-.RE
.TP
.BR libsimple_sumtimespec (3),
-.RS 0
+.TQ
.BR libsimple_sumtimeval (3)
-.RE
-.RS
Calculate the sum of two durations.
-.RE
.TP
.BR libsimple_timespec2timeval (3),
-.RS 0
+.TQ
.BR libsimple_timeval2timespec (3)
-.RE
-.RS
Convert a duration between to storage formats.
-.RE
.TP
.BR libsimple_timespectodouble (3),
-.RS 0
+.TQ
.BR libsimple_timevaltodouble (3)
-.RE
-.RS
Convert a duration stored in a duration
specific format to a double.
-.RE
.TP
.BR libsimple_timespectostr (3),
-.RS 0
+.TQ
.BR libsimple_timevaltostr (3),
-.br
+.TQ
.BR libsimple_minimise_number_string (3)
-.RE
-.RS
Convert a duration stored in a duration
specific format to a string.
-.RE
.TP
.BR libsimple_unlist (3),
-.RS 0
+.TQ
.BR LIBSIMPLE_UNLIST (3)
-.RE
-.RS
Remove an item from an array without changing the order of the items in the array.
-.RE
.TP
.BR libsimple_valloc (3),
-.RS 0
+.TQ
.BR libsimple_evalloc (3),
-.br
+.TQ
.BR libsimple_envalloc (3)
-.RE
-.RS
Implementation of the nonstandard
.BR valloc (3)
function.
-.RE
.TP
.BR libsimple_vallocn (3),
-.RS 0
+.TQ
.BR libsimple_evallocn (3),
-.br
+.TQ
.BR libsimple_envallocn (3),
-.br
+.TQ
.BR libsimple_vvallocn (3),
-.br
+.TQ
.BR libsimple_evvallocn (3),
-.br
+.TQ
.BR libsimple_envvallocn (3)
-.RE
-.RS
Versions of
.BR libsimple_valloc (3)
that take the product of multiple arguments as the
allocation size.
-.RE
.TP
.BR libsimple_vallocz (3),
-.RS 0
+.TQ
.BR libsimple_evallocz (3),
-.br
+.TQ
.BR libsimple_envallocz (3)
-.RE
-.RS
Versions of
.BR libsimple_valloc (3)
that conditionally initialises the memory.
-.RE
.TP
.BR libsimple_valloczn (3),
-.RS 0
+.TQ
.BR libsimple_evalloczn (3),
-.br
+.TQ
.BR libsimple_envalloczn (3),
-.br
+.TQ
.BR libsimple_vvalloczn (3),
-.br
+.TQ
.BR libsimple_evvalloczn (3),
-.br
+.TQ
.BR libsimple_envvalloczn (3)
-.RE
-.RS
Versions of
.BR libsimple_valloc (3)
that take the product of multiple arguments as the
allocation size and conditionally initialises the memory.
-.RE
+
+.TP
+.BR libsimple_ewcsdup (3),
+.TQ
+.BR libsimple_enwcsdup (3),
+.TQ
+.BR libsimple_wcsndup (3),
+.TQ
+.BR libsimple_ewcsndup (3),
+.TQ
+.BR libsimple_enwcsndup (3)
+Duplicate a wide-character string.
+
+.TP
+.BR libsimple_wcsdupa (3),
+.TQ
+.BR libsimple_wcsndupa (3)
+Versions of
+.BR wcsdup (3),
+and
+.BR libsimple_wcsndup (3)
+that allocate the string on the stack.
+
+.TP
+.BR libsimple_wmemdup (3),
+.TQ
+.BR libsimple_ewmemdup (3),
+.TQ
+.BR libsimple_enwmemdup (3)
+Duplicate an array of wide character.
+
+.TP
+.BR libsimple_wmemdupa (3)
+Version of
+.BR libsimple_wmemdup (3)
+that allocate the string on the stack.
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH SEE ALSO
.BR libsimple-arg.h (0)
diff --git a/man3/ELEMSOF.3libsimple b/man3/ELEMSOF.3libsimple
index b40d563..9391607 100644
--- a/man3/ELEMSOF.3libsimple
+++ b/man3/ELEMSOF.3libsimple
@@ -1,6 +1,7 @@
-.TH ELEMSOF 3 2018-11-05 libsimple
+.TH ELEMSOF 3 libsimple
.SH NAME
ELEMSOF \- get the size of an array
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ ELEMSOF \- get the size of an array
# define ELEMSOF(arr) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR ELEMSOF ()
@@ -18,17 +20,24 @@ is an array (not a pointer) and expands, as
a constant expression. The type of the expression
the macro expands to is
.BR size_t .
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR STRLEN (3libsimple)
diff --git a/man3/INTSTRLEN.3libsimple b/man3/INTSTRLEN.3libsimple
index 63c1485..9477eb6 100644
--- a/man3/INTSTRLEN.3libsimple
+++ b/man3/INTSTRLEN.3libsimple
@@ -1,6 +1,7 @@
-.TH INTSTRLEN 3 2018-11-05 libsimple
+.TH INTSTRLEN 3 libsimple
.SH NAME
INTSTRLEN \- get the maximum length of an integer string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ INTSTRLEN \- get the maximum length of an integer string
# define INTSTRLEN(type) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR INTSTRLEN ()
@@ -29,18 +31,25 @@ signed or unsigned, and can be slightly larger than
necessary, it can however not be smaller. (For integers
up to 64 bits, the result is only off by one for signed
64-bit integer types.)
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR TYPE_MIN (3libsimple)
.BR TYPE_MAX (3libsimple)
diff --git a/man3/MAX.3libsimple b/man3/MAX.3libsimple
index e4a4d62..ac374d0 100644
--- a/man3/MAX.3libsimple
+++ b/man3/MAX.3libsimple
@@ -1,6 +1,7 @@
-.TH MAX 3 2018-11-05 libsimple
+.TH MAX 3 libsimple
.SH NAME
MAX \- get the greater of two values
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ MAX \- get the greater of two values
# define MAX(a, b) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR MAX ()
@@ -30,28 +32,37 @@ and
.I b
parameters are constants expressions, the
return value is also a constant expression.
+
.SH RETURN VALUE
The
.BR MAX ()
macro returns to the greater value.
+
.SH ERRORS
The
.BR libsimple_close ()
function fail for the reasons specified for the
.BR close (3)
function.
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR MIN (3libsimple),
.BR MIN3 (3libsimple),
diff --git a/man3/MAX3.3libsimple b/man3/MAX3.3libsimple
index 103169a..d0171f8 100644
--- a/man3/MAX3.3libsimple
+++ b/man3/MAX3.3libsimple
@@ -1,6 +1,7 @@
-.TH MAX3 3 2018-11-05 libsimple
+.TH MAX3 3 libsimple
.SH NAME
MAX3 \- get the greatest of three values
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ MAX3 \- get the greatest of three values
# define MAX3(a, b, c) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR MAX3 ()
@@ -33,28 +35,37 @@ and
.I c
parameters are constants expressions, the
return value is also a constant expression.
+
.SH RETURN VALUE
The
.BR MAX3 ()
macro returns to the greatest of value.
+
.SH ERRORS
The
.BR libsimple_close ()
function fail for the reasons specified for the
.BR close (3)
function.
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR MIN (3libsimple),
.BR MAX (3libsimple),
diff --git a/man3/MIN.3libsimple b/man3/MIN.3libsimple
index d88216e..552b334 100644
--- a/man3/MIN.3libsimple
+++ b/man3/MIN.3libsimple
@@ -1,6 +1,7 @@
-.TH MIN 3 2018-11-05 libsimple
+.TH MIN 3 libsimple
.SH NAME
MIN \- get the lesser of two values
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ MIN \- get the lesser of two values
# define MIN(a, b) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR MIN ()
@@ -30,28 +32,37 @@ and
.I b
parameters are constants expressions, the
return value is also a constant expression.
+
.SH RETURN VALUE
The
.BR MIN ()
macro returns to the lesser value.
+
.SH ERRORS
The
.BR libsimple_close ()
function fail for the reasons specified for the
.BR close (3)
function.
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR MAX (3libsimple),
.BR MIN3 (3libsimple),
diff --git a/man3/MIN3.3libsimple b/man3/MIN3.3libsimple
index c915781..19eeae9 100644
--- a/man3/MIN3.3libsimple
+++ b/man3/MIN3.3libsimple
@@ -1,6 +1,7 @@
-.TH MIN3 3 2018-11-05 libsimple
+.TH MIN3 3 libsimple
.SH NAME
MIN3 \- get the smallest of three values
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ MIN3 \- get the smallest of three values
# define MIN3(a, b, c) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR MIN3 ()
@@ -33,28 +35,37 @@ and
.I c
parameters are constants expressions, the
return value is also a constant expression.
+
.SH RETURN VALUE
The
.BR MIN3 ()
macro returns to the smallest of value.
+
.SH ERRORS
The
.BR libsimple_close ()
function fail for the reasons specified for the
.BR close (3)
function.
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR MIN (3libsimple),
.BR MAX (3libsimple),
diff --git a/man3/STRLEN.3libsimple b/man3/STRLEN.3libsimple
index 06ccecf..4d48e66 100644
--- a/man3/STRLEN.3libsimple
+++ b/man3/STRLEN.3libsimple
@@ -1,6 +1,7 @@
-.TH STRLEN 3 2018-11-05 libsimple
+.TH STRLEN 3 libsimple
.SH NAME
STRLEN \- get the length of a string literal
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ STRLEN \- get the length of a string literal
# define STRLEN(str) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR STRLEN ()
@@ -25,17 +27,24 @@ however it is not suitable for
.BR #if .
The type of the expression the macro expands to is
.BR size_t .
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR ELEMSOF (3libsimple)
diff --git a/man3/TYPE_MAX.3libsimple b/man3/TYPE_MAX.3libsimple
index c132ec9..158f189 100644
--- a/man3/TYPE_MAX.3libsimple
+++ b/man3/TYPE_MAX.3libsimple
@@ -1,6 +1,7 @@
-.TH TYPE_MAX 3 2018-11-05 libsimple
+.TH TYPE_MAX 3 libsimple
.SH NAME
TYPE_MAX \- get largest value for an integer type
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ TYPE_MAX \- get largest value for an integer type
# define TYPE_MAX(type) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR TYPE_MAX ()
@@ -60,18 +62,25 @@ macro, for the maximum value for multiple integer types:
.BR USECONDS_MAX ,
and
.BR U_QUAD_MAX .
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR TYPE_MIN (3libsimple)
.BR INTSTRLEN (3libsimple)
diff --git a/man3/TYPE_MIN.3libsimple b/man3/TYPE_MIN.3libsimple
index 6720465..0ec8fac 100644
--- a/man3/TYPE_MIN.3libsimple
+++ b/man3/TYPE_MIN.3libsimple
@@ -1,6 +1,7 @@
-.TH TYPE_MIN 3 2018-11-05 libsimple
+.TH TYPE_MIN 3 libsimple
.SH NAME
TYPE_MIN \- get smallest value for an integer type
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -9,6 +10,7 @@ TYPE_MIN \- get smallest value for an integer type
# define TYPE_MIN(type) /* implementation omitted */
#endif
.fi
+
.SH DESCRIPTION
The
.BR TYPE_MIN ()
@@ -60,18 +62,25 @@ macro, for the minimum value for multiple integer types:
.BR USECONDS_MIN ,
and
.BR U_QUAD_MIN .
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR TYPE_MAX (3libsimple)
.BR INTSTRLEN (3libsimple)
diff --git a/man3/aligned_realloc.3libsimple b/man3/aligned_realloc.3libsimple
new file mode 120000
index 0000000..45a72de
--- /dev/null
+++ b/man3/aligned_realloc.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_realloc.3 \ No newline at end of file
diff --git a/man3/aligned_reallocarray.3libsimple b/man3/aligned_reallocarray.3libsimple
new file mode 120000
index 0000000..fb3f8b9
--- /dev/null
+++ b/man3/aligned_reallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_reallocarray.3 \ No newline at end of file
diff --git a/man3/aligned_reallocarrayf.3libsimple b/man3/aligned_reallocarrayf.3libsimple
new file mode 120000
index 0000000..8670b37
--- /dev/null
+++ b/man3/aligned_reallocarrayf.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_reallocarrayf.3 \ No newline at end of file
diff --git a/man3/aligned_reallocf.3libsimple b/man3/aligned_reallocf.3libsimple
new file mode 120000
index 0000000..656041f
--- /dev/null
+++ b/man3/aligned_reallocf.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_reallocf.3 \ No newline at end of file
diff --git a/man3/aligned_reallocfn.3libsimple b/man3/aligned_reallocfn.3libsimple
new file mode 120000
index 0000000..73c5a60
--- /dev/null
+++ b/man3/aligned_reallocfn.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_reallocfn.3 \ No newline at end of file
diff --git a/man3/aligned_reallocn.3libsimple b/man3/aligned_reallocn.3libsimple
new file mode 120000
index 0000000..3a6b8aa
--- /dev/null
+++ b/man3/aligned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_reallocn.3 \ No newline at end of file
diff --git a/man3/aligned_strdup.3libsimple b/man3/aligned_strdup.3libsimple
new file mode 120000
index 0000000..005dc6f
--- /dev/null
+++ b/man3/aligned_strdup.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_strdup.3 \ No newline at end of file
diff --git a/man3/aligned_strdupa.3libsimple b/man3/aligned_strdupa.3libsimple
new file mode 120000
index 0000000..1cc07db
--- /dev/null
+++ b/man3/aligned_strdupa.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_strdupa.3 \ No newline at end of file
diff --git a/man3/aligned_strndup.3libsimple b/man3/aligned_strndup.3libsimple
new file mode 120000
index 0000000..4be204c
--- /dev/null
+++ b/man3/aligned_strndup.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_strndup.3 \ No newline at end of file
diff --git a/man3/aligned_strndupa.3libsimple b/man3/aligned_strndupa.3libsimple
new file mode 120000
index 0000000..40eec87
--- /dev/null
+++ b/man3/aligned_strndupa.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_strndupa.3 \ No newline at end of file
diff --git a/man3/aligned_wcsdup.3libsimple b/man3/aligned_wcsdup.3libsimple
new file mode 120000
index 0000000..cb194a0
--- /dev/null
+++ b/man3/aligned_wcsdup.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wcsdup.3 \ No newline at end of file
diff --git a/man3/aligned_wcsdupa.3libsimple b/man3/aligned_wcsdupa.3libsimple
new file mode 120000
index 0000000..1e2225d
--- /dev/null
+++ b/man3/aligned_wcsdupa.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wcsdupa.3 \ No newline at end of file
diff --git a/man3/aligned_wcsndup.3libsimple b/man3/aligned_wcsndup.3libsimple
new file mode 120000
index 0000000..043dad0
--- /dev/null
+++ b/man3/aligned_wcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wcsndup.3 \ No newline at end of file
diff --git a/man3/aligned_wcsndupa.3libsimple b/man3/aligned_wcsndupa.3libsimple
new file mode 120000
index 0000000..d24f553
--- /dev/null
+++ b/man3/aligned_wcsndupa.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wcsndupa.3 \ No newline at end of file
diff --git a/man3/aligned_wmemdup.3libsimple b/man3/aligned_wmemdup.3libsimple
new file mode 120000
index 0000000..264a7e1
--- /dev/null
+++ b/man3/aligned_wmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wmemdup.3 \ No newline at end of file
diff --git a/man3/aligned_wmemdupa.3libsimple b/man3/aligned_wmemdupa.3libsimple
new file mode 120000
index 0000000..567563a
--- /dev/null
+++ b/man3/aligned_wmemdupa.3libsimple
@@ -0,0 +1 @@
+libsimple_aligned_wmemdupa.3 \ No newline at end of file
diff --git a/man3/ealigned_realloc.3libsimple b/man3/ealigned_realloc.3libsimple
new file mode 120000
index 0000000..dbb92ec
--- /dev/null
+++ b/man3/ealigned_realloc.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_realloc.3 \ No newline at end of file
diff --git a/man3/ealigned_reallocarray.3libsimple b/man3/ealigned_reallocarray.3libsimple
new file mode 120000
index 0000000..2d830d6
--- /dev/null
+++ b/man3/ealigned_reallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_reallocarray.3 \ No newline at end of file
diff --git a/man3/ealigned_reallocn.3libsimple b/man3/ealigned_reallocn.3libsimple
new file mode 120000
index 0000000..d61ddf8
--- /dev/null
+++ b/man3/ealigned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_reallocn.3 \ No newline at end of file
diff --git a/man3/ealigned_strdup.3libsimple b/man3/ealigned_strdup.3libsimple
new file mode 120000
index 0000000..eb5cf8d
--- /dev/null
+++ b/man3/ealigned_strdup.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_strdup.3 \ No newline at end of file
diff --git a/man3/ealigned_strndup.3libsimple b/man3/ealigned_strndup.3libsimple
new file mode 120000
index 0000000..50b1c4a
--- /dev/null
+++ b/man3/ealigned_strndup.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_strndup.3 \ No newline at end of file
diff --git a/man3/ealigned_wcsdup.3libsimple b/man3/ealigned_wcsdup.3libsimple
new file mode 120000
index 0000000..01ef193
--- /dev/null
+++ b/man3/ealigned_wcsdup.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_wcsdup.3 \ No newline at end of file
diff --git a/man3/ealigned_wcsndup.3libsimple b/man3/ealigned_wcsndup.3libsimple
new file mode 120000
index 0000000..87cfe1b
--- /dev/null
+++ b/man3/ealigned_wcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_wcsndup.3 \ No newline at end of file
diff --git a/man3/ealigned_wmemdup.3libsimple b/man3/ealigned_wmemdup.3libsimple
new file mode 120000
index 0000000..0029c68
--- /dev/null
+++ b/man3/ealigned_wmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_ealigned_wmemdup.3 \ No newline at end of file
diff --git a/man3/enaligned_realloc.3libsimple b/man3/enaligned_realloc.3libsimple
new file mode 120000
index 0000000..2d95e24
--- /dev/null
+++ b/man3/enaligned_realloc.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_realloc.3 \ No newline at end of file
diff --git a/man3/enaligned_reallocarray.3libsimple b/man3/enaligned_reallocarray.3libsimple
new file mode 120000
index 0000000..1b2e0f8
--- /dev/null
+++ b/man3/enaligned_reallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_reallocarray.3 \ No newline at end of file
diff --git a/man3/enaligned_reallocn.3libsimple b/man3/enaligned_reallocn.3libsimple
new file mode 120000
index 0000000..ce4ea5d
--- /dev/null
+++ b/man3/enaligned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/enaligned_strdup.3libsimple b/man3/enaligned_strdup.3libsimple
new file mode 120000
index 0000000..83e40a2
--- /dev/null
+++ b/man3/enaligned_strdup.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_strdup.3 \ No newline at end of file
diff --git a/man3/enaligned_strndup.3libsimple b/man3/enaligned_strndup.3libsimple
new file mode 120000
index 0000000..2b79c93
--- /dev/null
+++ b/man3/enaligned_strndup.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_strndup.3 \ No newline at end of file
diff --git a/man3/enaligned_wcsdup.3libsimple b/man3/enaligned_wcsdup.3libsimple
new file mode 120000
index 0000000..c52f2c8
--- /dev/null
+++ b/man3/enaligned_wcsdup.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_wcsdup.3 \ No newline at end of file
diff --git a/man3/enaligned_wcsndup.3libsimple b/man3/enaligned_wcsndup.3libsimple
new file mode 120000
index 0000000..f5772b1
--- /dev/null
+++ b/man3/enaligned_wcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_wcsndup.3 \ No newline at end of file
diff --git a/man3/enaligned_wmemdup.3libsimple b/man3/enaligned_wmemdup.3libsimple
new file mode 120000
index 0000000..07321e1
--- /dev/null
+++ b/man3/enaligned_wmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_enaligned_wmemdup.3 \ No newline at end of file
diff --git a/man3/enreallocarray.3libsimple b/man3/enreallocarray.3libsimple
new file mode 120000
index 0000000..5f83973
--- /dev/null
+++ b/man3/enreallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_enreallocarray.3 \ No newline at end of file
diff --git a/man3/envaligned_reallocn.3libsimple b/man3/envaligned_reallocn.3libsimple
new file mode 120000
index 0000000..36205a3
--- /dev/null
+++ b/man3/envaligned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_envaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/enwcsdup.3libsimple b/man3/enwcsdup.3libsimple
new file mode 120000
index 0000000..85a85a6
--- /dev/null
+++ b/man3/enwcsdup.3libsimple
@@ -0,0 +1 @@
+libsimple_enwcsdup.3 \ No newline at end of file
diff --git a/man3/enwcsndup.3libsimple b/man3/enwcsndup.3libsimple
new file mode 120000
index 0000000..801d72f
--- /dev/null
+++ b/man3/enwcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_enwcsndup.3 \ No newline at end of file
diff --git a/man3/enwmemdup.3libsimple b/man3/enwmemdup.3libsimple
new file mode 120000
index 0000000..b2983f6
--- /dev/null
+++ b/man3/enwmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_enwmemdup.3 \ No newline at end of file
diff --git a/man3/ereallocarray.3libsimple b/man3/ereallocarray.3libsimple
new file mode 120000
index 0000000..3e43375
--- /dev/null
+++ b/man3/ereallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_ereallocarray.3 \ No newline at end of file
diff --git a/man3/evaligned_reallocn.3libsimple b/man3/evaligned_reallocn.3libsimple
new file mode 120000
index 0000000..b7dde1d
--- /dev/null
+++ b/man3/evaligned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_evaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/ewcsdup.3libsimple b/man3/ewcsdup.3libsimple
new file mode 120000
index 0000000..5c84dbe
--- /dev/null
+++ b/man3/ewcsdup.3libsimple
@@ -0,0 +1 @@
+libsimple_ewcsdup.3 \ No newline at end of file
diff --git a/man3/ewcsndup.3libsimple b/man3/ewcsndup.3libsimple
new file mode 120000
index 0000000..09026d6
--- /dev/null
+++ b/man3/ewcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_ewcsndup.3 \ No newline at end of file
diff --git a/man3/ewmemdup.3libsimple b/man3/ewmemdup.3libsimple
new file mode 120000
index 0000000..3cbe8cf
--- /dev/null
+++ b/man3/ewmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_ewmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_allocz.3 b/man3/libsimple_aligned_allocz.3
index 751cf4f..0bee4d9 100644
--- a/man3/libsimple_aligned_allocz.3
+++ b/man3/libsimple_aligned_allocz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ALIGNED_ALLOCZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ALIGNED_ALLOCZ 3 libsimple
.SH NAME
libsimple_aligned_allocz \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_ealigned_allocz(int \fIclear\fP, size_t \fIalignme
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_aligned_allocz (),
@@ -69,6 +71,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_aligned_allocz (),
@@ -87,6 +90,7 @@ it indicate the error, and the
and
.BR libsimple_ealigned_allocz ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_aligned_allocz ()
@@ -113,6 +117,7 @@ The
and
.BR libsimple_ealigned_allocz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -143,18 +148,25 @@ T{
.BR libsimple_ealigned_allocz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -163,7 +175,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_aligned_memdup.3 b/man3/libsimple_aligned_memdup.3
index 6cd287a..cff094d 100644
--- a/man3/libsimple_aligned_memdup.3
+++ b/man3/libsimple_aligned_memdup.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ALIGNED_MEMDUP 3 2018-10-27 libsimple
+.TH LIBSIMPLE_ALIGNED_MEMDUP 3 libsimple
.SH NAME
libsimple_aligned_memdup, libsimple_aligned_memdupa \- duplicate bytes in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -26,10 +27,11 @@ static inline void *libsimple_ealigned_memdup(const void *\fIs\fP, size_t \fIali
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_aligned_memdup ()
-function constructs allocates memory with the alignment
+function allocates memory with the alignment
specified in the
.I alignment
parameter and copies
@@ -60,6 +62,7 @@ function that uses allocates the memory on the stack
rather than on the heap, causing the return pointer
to become invalid when the calling function returns.
It is only available when compling with GCC or Clang.
+
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_aligned_memdupa (),
@@ -90,12 +93,14 @@ by the
.BR libsimple_aligned_memdupa ()
function, it is automatically deallocated when the
calling function returns.
+
.SH ERRORS
The
.BR libsimple_aligned_memdup ()
function may fail for any reason specified for the
.BR aligned_alloc (3)
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -132,21 +137,29 @@ T{
.BR libsimple_ealigned_memdup (),
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memdup (3),
-.BR libsimple_enstrndup (3),
-.BR libsimple_enstrdup (3),
-.BR strndup (3),
-.BR strdup (3)
+.BR libsimple_aligned_strndup (3),
+.BR libsimple_aligned_strdup (3),
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_aligned_wcsndup (3),
+.BR libsimple_aligned_wmemdup (3)
diff --git a/man3/libsimple_aligned_realloc.3 b/man3/libsimple_aligned_realloc.3
new file mode 100644
index 0000000..1845408
--- /dev/null
+++ b/man3/libsimple_aligned_realloc.3
@@ -0,0 +1,212 @@
+.TH LIBSIMPLE_ALIGNED_REALLOC 3 libsimple
+.SH NAME
+libsimple_aligned_realloc \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_aligned_realloc(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+void *libsimple_enaligned_realloc(int \fIstatus\fP, void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+static inline void *libsimple_ealigned_realloc(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+
+#ifndef aligned_realloc
+# define aligned_realloc libsimple_aligned_realloc
+#endif
+#ifndef enaligned_realloc
+# define enaligned_realloc libsimple_enaligned_realloc
+#endif
+#ifndef ealigned_realloc
+# define ealigned_realloc libsimple_ealigned_realloc
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_realloc (),
+.BR libsimple_enaligned_realloc (),
+and
+.BR libsimple_ealigned_realloc ()
+functions reallocate memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I n
+bytes. The behaviour is unspecified if
+.I n
+is 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is not deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_enaligned_realloc ()
+and
+.BR libsimple_ealigned_realloc ()
+functions will terminate the process if the memory
+cannot be allocated, by calling the
+.BR libsimple_enprintf ()
+and
+.BR libsimple_eprintf ()
+functions, respectively.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_enaligned_realloc ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_ealigned_realloc ()
+function is used.
+
+.SH RETURN VALUE
+The
+.BR libsimple_aligned_realloc (),
+.BR libsimple_enaligned_realloc (),
+and
+.BR libsimple_ealigned_realloc ()
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_aligned_realloc ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error, and the
+.BR libsimple_enaligned_realloc ()
+and
+.BR libsimple_ealigned_realloc ()
+functions terminated the process.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_realloc ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+.PP
+The
+.BR libsimple_enaligned_realloc ()
+and
+.BR libsimple_ealigned_realloc ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_realloc (),
+.br
+.BR libsimple_enaligned_realloc (),
+.br
+.BR libsimple_ealigned_realloc ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_realloc (),
+.br
+.BR libsimple_enaligned_realloc (),
+.br
+.BR libsimple_ealigned_realloc ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_realloc (),
+.br
+.BR libsimple_enaligned_realloc (),
+.br
+.BR libsimple_ealigned_realloc ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_aligned_reallocarray.3 b/man3/libsimple_aligned_reallocarray.3
new file mode 100644
index 0000000..e056c72
--- /dev/null
+++ b/man3/libsimple_aligned_reallocarray.3
@@ -0,0 +1,214 @@
+.TH LIBSIMPLE_ALIGNED_REALLOCARRAY 3 libsimple
+.SH NAME
+libsimple_aligned_reallocarray \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_aligned_reallocarray(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, size_t \fIm\fP);
+void *libsimple_enaligned_reallocarray(int \fIstatus\fP, void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, size_t \fIm\fP);
+static inline void *libsimple_ealigned_reallocarray(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, size_t \fIm\fP);
+
+#ifndef aligned_reallocarray
+# define aligned_reallocarray libsimple_aligned_reallocarray
+#endif
+#ifndef enaligned_reallocarray
+# define enaligned_reallocarray libsimple_enaligned_reallocarray
+#endif
+#ifndef ealigned_reallocarray
+# define ealigned_reallocarray libsimple_ealigned_reallocarray
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_reallocarray (),
+.BR libsimple_enaligned_reallocarray (),
+and
+.BR libsimple_ealigned_reallocarray ()
+functions reallocate memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I n*m
+bytes. The behaviour is unspecified if
+.I n
+or
+.I m
+is 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n*m
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is not deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_enaligned_reallocarray ()
+and
+.BR libsimple_ealigned_reallocarray ()
+functions will terminate the process if the memory
+cannot be allocated, by calling the
+.BR libsimple_enprintf ()
+and
+.BR libsimple_eprintf ()
+functions, respectively.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_enaligned_reallocarray ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_ealigned_reallocarray ()
+function is used.
+
+.SH RETURN VALUE
+The
+.BR libsimple_aligned_reallocarray (),
+.BR libsimple_enaligned_reallocarray (),
+and
+.BR libsimple_ealigned_reallocarray ()
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_aligned_reallocarray ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error, and the
+.BR libsimple_enaligned_reallocarray ()
+and
+.BR libsimple_ealigned_reallocarray ()
+functions terminated the process.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_reallocarray ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+.PP
+The
+.BR libsimple_enaligned_reallocarray ()
+and
+.BR libsimple_ealigned_reallocarray ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_reallocarray (),
+.br
+.BR libsimple_enaligned_reallocarray (),
+.br
+.BR libsimple_ealigned_reallocarray ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_reallocarray (),
+.br
+.BR libsimple_enaligned_reallocarray (),
+.br
+.BR libsimple_ealigned_reallocarray ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_reallocarray (),
+.br
+.BR libsimple_enaligned_reallocarray (),
+.br
+.BR libsimple_ealigned_reallocarray ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_aligned_reallocarrayf.3 b/man3/libsimple_aligned_reallocarrayf.3
new file mode 100644
index 0000000..998d49a
--- /dev/null
+++ b/man3/libsimple_aligned_reallocarrayf.3
@@ -0,0 +1,166 @@
+.TH LIBSIMPLE_ALIGNED_REALLOCARRAYF 3 libsimple
+.SH NAME
+libsimple_aligned_reallocarrayf \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_aligned_reallocarrayf(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, size_t \fIm\fP);
+
+#ifndef aligned_reallocarrayf
+# define aligned_reallocarrayf libsimple_aligned_reallocarrayf
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_reallocarrayf ()
+function reallocates memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I n*m
+bytes. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n*m
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+If
+.I n
+or
+.I m
+is 0,
+.I ptr
+is deallocaed and
+.B NULL
+is returned, however portable applications should,
+unless the namespaced alias is used, assume the
+behaviour is unspecifed in this case.
+
+.SH RETURN VALUE
+The
+.BR libsimple_aligned_reallocarrayf (),
+function returns a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_aligned_reallocarrayf ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_reallocarrayf ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_reallocarrayf ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_reallocarrayf ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_reallocarrayf ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_aligned_reallocf.3 b/man3/libsimple_aligned_reallocf.3
new file mode 100644
index 0000000..97d6dff
--- /dev/null
+++ b/man3/libsimple_aligned_reallocf.3
@@ -0,0 +1,164 @@
+.TH LIBSIMPLE_ALIGNED_REALLOCF 3 libsimple
+.SH NAME
+libsimple_aligned_reallocf \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_aligned_reallocf(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+
+#ifndef aligned_reallocf
+# define aligned_reallocf libsimple_aligned_reallocf
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_reallocf ()
+function reallocates memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I n
+bytes. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+If
+.I n
+is 0,
+.I ptr
+is deallocaed and
+.B NULL
+is returned, however portable applications should,
+unless the namespaced alias is used, assume the
+behaviour is unspecifed in this case.
+
+.SH RETURN VALUE
+The
+.BR libsimple_aligned_reallocf (),
+function returns a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_aligned_reallocf ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_reallocf ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_reallocf ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_reallocf ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_reallocf ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_aligned_reallocfn.3 b/man3/libsimple_aligned_reallocfn.3
new file mode 120000
index 0000000..1ba44a5
--- /dev/null
+++ b/man3/libsimple_aligned_reallocfn.3
@@ -0,0 +1 @@
+libsimple_valigned_reallocfn.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_reallocn.3 b/man3/libsimple_aligned_reallocn.3
new file mode 120000
index 0000000..7c3a84f
--- /dev/null
+++ b/man3/libsimple_aligned_reallocn.3
@@ -0,0 +1 @@
+libsimple_valigned_reallocn.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_strdup.3 b/man3/libsimple_aligned_strdup.3
new file mode 100644
index 0000000..1570e68
--- /dev/null
+++ b/man3/libsimple_aligned_strdup.3
@@ -0,0 +1,163 @@
+.TH LIBSIMPLE_ALIGNED_STRDUP 3 libsimple
+.SH NAME
+libsimple_aligned_strdup, libsimple_aligned_strdupa \- duplicate a string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+char *libsimple_aligned_strdupa(const char *\fIs\fP, size_t \fIn\fP);
+char *libsimple_aligned_strdup(const char *\fIs\fP, size_t \fIn\fP);
+char *libsimple_enaligned_strdup(int \fIstatus\fP, const char *\fIs\fP, size_t \fIn\fP);
+static inline char *libsimple_ealigned_strdup(const char *\fIs\fP, size_t \fIn\fP);
+
+#ifndef aligned_strdupa
+# define aligned_strdupa libsimple_aligned_strdupa
+#endif
+#ifndef aligned_strdup
+# define aligned_strdup libsimple_aligned_strdup
+#endif
+#ifndef enaligned_strdup
+# define enaligned_strdup libsimple_enaligned_strdup
+#endif
+#ifndef ealigned_strdup
+# define ealigned_strdup libsimple_ealigned_strdup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_strdup ()
+function allocates memory with the alignment
+specified in the
+.I alignment
+parameter and copies the string
+.I s
+into the new allocation.
+.PP
+The
+.BR libsimple_enaligned_strdup ()
+and
+.BR libsimple_ealigned_strdup ()
+functions are versions of the
+.BR libsimple_aligned_strdup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_strdupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_strdup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_aligned_strdupa (),
+.BR libsimple_aligned_strdup (),
+.BR libsimple_enaligned_strdup (),
+and
+.BR libsimple_ealigned_strdup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_aligned_strdup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enaligned_strdup (),
+and
+.BR libsimple_ealigned_strdup ()
+functions exit the process. The
+.BR libsimple_aligned_strdupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_aligned_strdupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_strdup ()
+function may fail for any reason specified for the
+.BR aligned_alloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_strdupa (),
+.br
+.BR libsimple_aligned_strdup (),
+.br
+.BR libsimple_enaligned_strdup (),
+.br
+.BR libsimple_ealigned_strdup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_strdupa (),
+.br
+.BR libsimple_aligned_strdup (),
+.br
+.BR libsimple_enaligned_strdup (),
+.br
+.BR libsimple_ealigned_strdup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_strdupa (),
+.br
+.BR libsimple_aligned_strdup (),
+.br
+.BR libsimple_enaligned_strdup (),
+.br
+.BR libsimple_ealigned_strdup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_strndup (3),
+.BR libsimple_aligned_memdup (3),
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_aligned_wcsndup (3),
+.BR libsimple_aligned_wmemdup (3),
+.BR strdup (3)
diff --git a/man3/libsimple_aligned_strdupa.3 b/man3/libsimple_aligned_strdupa.3
new file mode 120000
index 0000000..005dc6f
--- /dev/null
+++ b/man3/libsimple_aligned_strdupa.3
@@ -0,0 +1 @@
+libsimple_aligned_strdup.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_strndup.3 b/man3/libsimple_aligned_strndup.3
new file mode 100644
index 0000000..05c6d3a
--- /dev/null
+++ b/man3/libsimple_aligned_strndup.3
@@ -0,0 +1,166 @@
+.TH LIBSIMPLE_ALIGNED_STRNDUP 3 libsimple
+.SH NAME
+libsimple_aligned_strndup, libsimple_aligned_strndupa \- duplicate a string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+char *libsimple_aligned_strndupa(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+char *libsimple_aligned_strndup(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+char *libsimple_enaligned_strndup(int \fIstatus\fP, const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+static inline char *libsimple_ealigned_strndup(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+
+#ifndef aligned_strndupa
+# define aligned_strndupa libsimple_aligned_strndupa
+#endif
+#ifndef aligned_strndup
+# define aligned_strndup libsimple_aligned_strndup
+#endif
+#ifndef enaligned_strndup
+# define enaligned_strndup libsimple_enaligned_strndup
+#endif
+#ifndef ealigned_strndup
+# define ealigned_strndup libsimple_ealigned_strndup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_strndup ()
+function allocates memory with the alignment
+specified in the
+.I alignment
+parameter and copies the string
+.I s
+into the new allocation, up to the
+.IR n th
+byte. A NUL byte will always be written
+to the end of the new string.
+.PP
+The
+.BR libsimple_enaligned_strndup ()
+and
+.BR libsimple_ealigned_strndup ()
+functions are versions of the
+.BR libsimple_aligned_strndup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_strndupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_strndup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_aligned_strndupa (),
+.BR libsimple_aligned_strndup (),
+.BR libsimple_enaligned_strndup (),
+and
+.BR libsimple_ealigned_strndup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_aligned_strndup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enaligned_strndup (),
+and
+.BR libsimple_ealigned_strndup ()
+functions exit the process. The
+.BR libsimple_aligned_strndupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_aligned_strndupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_strndup ()
+function may fail for any reason specified for the
+.BR aligned_alloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_strndupa (),
+.br
+.BR libsimple_aligned_strndup (),
+.br
+.BR libsimple_enaligned_strndup (),
+.br
+.BR libsimple_ealigned_strndup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_strndupa (),
+.br
+.BR libsimple_aligned_strndup (),
+.br
+.BR libsimple_enaligned_strndup (),
+.br
+.BR libsimple_ealigned_strndup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_strndupa (),
+.br
+.BR libsimple_aligned_strndup (),
+.br
+.BR libsimple_enaligned_strndup (),
+.br
+.BR libsimple_ealigned_strndup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_strdup (3),
+.BR libsimple_aligned_memdup (3),
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_aligned_wcsndup (3),
+.BR libsimple_aligned_wmemdup (3),
+.BR strndup (3)
diff --git a/man3/libsimple_aligned_strndupa.3 b/man3/libsimple_aligned_strndupa.3
new file mode 120000
index 0000000..4be204c
--- /dev/null
+++ b/man3/libsimple_aligned_strndupa.3
@@ -0,0 +1 @@
+libsimple_aligned_strndup.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_wcsdup.3 b/man3/libsimple_aligned_wcsdup.3
new file mode 100644
index 0000000..42f9cd9
--- /dev/null
+++ b/man3/libsimple_aligned_wcsdup.3
@@ -0,0 +1,163 @@
+.TH LIBSIMPLE_ALIGNED_WCSDUP 3 libsimple
+.SH NAME
+libsimple_aligned_wcsdup, libsimple_aligned_wcsdupa \- duplicate a wide-character string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_aligned_wcsdupa(const wchar_t *\fIs\fP, size_t \fIalignment\fP);
+wchar_t *libsimple_aligned_wcsdup(const wchar_t *\fIs\fP, size_t \fIalignment\fP);
+wchar_t *libsimple_enaligned_wcsdup(int \fIstatus\fP, const wchar_t *\fIs\fP, size_t \fIalignment\fP);
+static inline wchar_t *libsimple_ealigned_wcsdup(const wchar_t *\fIs\fP, size_t \fIalignment\fP);
+
+#ifndef aligned_wcsdupa
+# define aligned_wcsdupa libsimple_aligned_wcsdupa
+#endif
+#ifndef aligned_wcsdup
+# define aligned_wcsdup libsimple_aligned_wcsdup
+#endif
+#ifndef enaligned_wcsdup
+# define enaligned_wcsdup libsimple_enaligned_wcsdup
+#endif
+#ifndef ealigned_wcsdup
+# define ealigned_wcsdup libsimple_ealigned_wcsdup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_wcsdup ()
+function allocates memory with the alignment
+specified in the
+.I alignment
+parameter and copies the wide-character string
+.I s
+into the new allocation.
+.PP
+The
+.BR libsimple_enaligned_wcsdup ()
+and
+.BR libsimple_ealigned_wcsdup ()
+functions are versions of the
+.BR libsimple_aligned_wcsdup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wcsdupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_wcsdup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_aligned_wcsdupa (),
+.BR libsimple_aligned_wcsdup (),
+.BR libsimple_enaligned_wcsdup (),
+and
+.BR libsimple_ealigned_wcsdup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_aligned_wcsdup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enaligned_wcsdup (),
+and
+.BR libsimple_ealigned_wcsdup ()
+functions exit the process. The
+.BR libsimple_aligned_wcsdupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_aligned_wcsdupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_wcsdup ()
+function may fail for any reason specified for the
+.BR aligned_alloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_wcsdupa (),
+.br
+.BR libsimple_aligned_wcsdup (),
+.br
+.BR libsimple_enaligned_wcsdup (),
+.br
+.BR libsimple_ealigned_wcsdup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_wcsdupa (),
+.br
+.BR libsimple_aligned_wcsdup (),
+.br
+.BR libsimple_enaligned_wcsdup (),
+.br
+.BR libsimple_ealigned_wcsdup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_wcsdupa (),
+.br
+.BR libsimple_aligned_wcsdup (),
+.br
+.BR libsimple_enaligned_wcsdup (),
+.br
+.BR libsimple_ealigned_wcsdup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_strndup (3),
+.BR libsimple_aligned_strdup (3),
+.BR libsimple_aligned_memdup (3),
+.BR libsimple_aligned_wcsndup (3),
+.BR libsimple_aligned_wmemdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_aligned_wcsdupa.3 b/man3/libsimple_aligned_wcsdupa.3
new file mode 120000
index 0000000..cb194a0
--- /dev/null
+++ b/man3/libsimple_aligned_wcsdupa.3
@@ -0,0 +1 @@
+libsimple_aligned_wcsdup.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_wcsndup.3 b/man3/libsimple_aligned_wcsndup.3
new file mode 100644
index 0000000..669b790
--- /dev/null
+++ b/man3/libsimple_aligned_wcsndup.3
@@ -0,0 +1,168 @@
+.TH LIBSIMPLE_ALIGNED_WCSNDUP 3 libsimple
+.SH NAME
+libsimple_aligned_wcsndup, libsimple_aligned_wcsndupa \- duplicate a wide-character string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_aligned_wcsndupa(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+wchar_t *libsimple_aligned_wcsndup(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+wchar_t *libsimple_enaligned_wcsndup(int \fIstatus\fP, const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+static inline wchar_t *libsimple_ealigned_wcsndup(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+
+#ifndef aligned_wcsndupa
+# define aligned_wcsndupa libsimple_aligned_wcsndupa
+#endif
+#ifndef aligned_wcsndup
+# define aligned_wcsndup libsimple_aligned_wcsndup
+#endif
+#ifndef enaligned_wcsndup
+# define enaligned_wcsndup libsimple_enaligned_wcsndup
+#endif
+#ifndef ealigned_wcsndup
+# define ealigned_wcsndup libsimple_ealigned_wcsndup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_wcsndup ()
+function allocates memory with the alignment
+specified in the
+.I alignment
+parameter and copies the wide-character string
+.I s
+into the new allocation, up to the
+.IR n th
+wide character
+.RB ( wchar_t ).
+A NUL wide-character will always be written
+to the end of the new string.
+.PP
+The
+.BR libsimple_enaligned_wcsndup ()
+and
+.BR libsimple_ealigned_wcsndup ()
+functions are versions of the
+.BR libsimple_aligned_wcsndup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wcsndupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_wcsndup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_aligned_wcsndupa (),
+.BR libsimple_aligned_wcsndup (),
+.BR libsimple_enaligned_wcsndup (),
+and
+.BR libsimple_ealigned_wcsndup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_aligned_wcsndup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enaligned_wcsndup (),
+and
+.BR libsimple_ealigned_wcsndup ()
+functions exit the process. The
+.BR libsimple_aligned_wcsndupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_aligned_wcsndupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_wcsndup ()
+function may fail for any reason specified for the
+.BR aligned_alloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_wcsndupa (),
+.br
+.BR libsimple_aligned_wcsndup (),
+.br
+.BR libsimple_enaligned_wcsndup (),
+.br
+.BR libsimple_ealigned_wcsndup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_wcsndupa (),
+.br
+.BR libsimple_aligned_wcsndup (),
+.br
+.BR libsimple_enaligned_wcsndup (),
+.br
+.BR libsimple_ealigned_wcsndup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_wcsndupa (),
+.br
+.BR libsimple_aligned_wcsndup (),
+.br
+.BR libsimple_enaligned_wcsndup (),
+.br
+.BR libsimple_ealigned_wcsndup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_wcsndup (3),
+.BR libsimple_aligned_strndup (3),
+.BR libsimple_aligned_strdup (3),
+.BR libsimple_aligned_memdup (3),
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_aligned_wmemdup (3)
diff --git a/man3/libsimple_aligned_wcsndupa.3 b/man3/libsimple_aligned_wcsndupa.3
new file mode 120000
index 0000000..043dad0
--- /dev/null
+++ b/man3/libsimple_aligned_wcsndupa.3
@@ -0,0 +1 @@
+libsimple_aligned_wcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_aligned_wmemdup.3 b/man3/libsimple_aligned_wmemdup.3
new file mode 100644
index 0000000..a269082
--- /dev/null
+++ b/man3/libsimple_aligned_wmemdup.3
@@ -0,0 +1,167 @@
+.TH LIBSIMPLE_ALIGNED_WMEMDUP 3 libsimple
+.SH NAME
+libsimple_aligned_wmemdup, libsimple_aligned_wmemdupa \- duplicate a wide-character array
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_aligned_wmemdupa(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+wchar_t *libsimple_aligned_wmemdup(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+wchar_t *libsimple_enaligned_wmemdup(int \fIstatus\fP, const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+static inline wchar_t *libsimple_ealigned_wmemdup(const wchar_t *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
+
+#ifndef aligned_wmemdupa
+# define aligned_wmemdupa libsimple_aligned_wmemdupa
+#endif
+#ifndef aligned_wmemdup
+# define aligned_wmemdup libsimple_aligned_wmemdup
+#endif
+#ifndef enaligned_wmemdup
+# define enaligned_wmemdup libsimple_enaligned_wmemdup
+#endif
+#ifndef ealigned_wmemdup
+# define ealigned_wmemdup libsimple_ealigned_wmemdup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_wmemdup ()
+function allocates memory with the alignment
+specified in the
+.I alignment
+parameter and copies
+.I n
+first wide characters
+.RB ( wchar_t )
+from
+.I s
+into the new allocation.
+.PP
+The
+.BR libsimple_enaligned_wmemdup ()
+and
+.BR libsimple_ealigned_wmemdup ()
+functions are versions of the
+.BR libsimple_aligned_wmemdup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wmemdupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_wmemdup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_aligned_wmemdupa (),
+.BR libsimple_aligned_wmemdup (),
+.BR libsimple_enaligned_wmemdup (),
+and
+.BR libsimple_ealigned_wmemdup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_aligned_wmemdup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enaligned_wmemdup (),
+and
+.BR libsimple_ealigned_wmemdup ()
+functions exit the process. The
+.BR libsimple_aligned_wmemdupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_aligned_wmemdupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_aligned_wmemdup ()
+function may fail for any reason specified for the
+.BR aligned_alloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_aligned_wmemdupa (),
+.br
+.BR libsimple_aligned_wmemdup (),
+.br
+.BR libsimple_enaligned_wmemdup (),
+.br
+.BR libsimple_ealigned_wmemdup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_aligned_wmemdupa (),
+.br
+.BR libsimple_aligned_wmemdup (),
+.br
+.BR libsimple_enaligned_wmemdup (),
+.br
+.BR libsimple_ealigned_wmemdup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_aligned_wmemdupa (),
+.br
+.BR libsimple_aligned_wmemdup (),
+.br
+.BR libsimple_enaligned_wmemdup (),
+.br
+.BR libsimple_ealigned_wmemdup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_wmemdup (3),
+.BR libsimple_aligned_strndup (3),
+.BR libsimple_aligned_strdup (3),
+.BR libsimple_aligned_memdup (3),
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_aligned_wcsndup (3)
diff --git a/man3/libsimple_aligned_wmemdupa.3 b/man3/libsimple_aligned_wmemdupa.3
new file mode 120000
index 0000000..264a7e1
--- /dev/null
+++ b/man3/libsimple_aligned_wmemdupa.3
@@ -0,0 +1 @@
+libsimple_aligned_wmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_close.3 b/man3/libsimple_close.3
index d5e18c6..d9fb852 100644
--- a/man3/libsimple_close.3
+++ b/man3/libsimple_close.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_CLOSE 3 2018-11-05 libsimple
+.TH LIBSIMPLE_CLOSE 3 libsimple
.SH NAME
libsimple_close \- close file descriptor and mark it as closed
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -10,6 +11,7 @@ static inline int libsimple_close(int *\fIfdp\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_close ()
@@ -22,28 +24,37 @@ to
However if
.IR *fdp<0 ,
does not except return 0.
+
.SH RETURN VALUE
The
.BR libsimple_close ()
function returns 0 upon successful completion;
otherwise \-1 is returned.
+
.SH ERRORS
The
.BR libsimple_close ()
function fail for the reasons specified for the
.BR close (3)
function.
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR close (3)
diff --git a/man3/libsimple_cmptimespec.3 b/man3/libsimple_cmptimespec.3
index 14873ea..9d6869a 100644
--- a/man3/libsimple_cmptimespec.3
+++ b/man3/libsimple_cmptimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_CMPTIMESPEC 3 2018-10-29 libsimple
+.TH LIBSIMPLE_CMPTIMESPEC 3 libsimple
.SH NAME
libsimple_cmptimespec, libsimple_cmptimeval \- calculate the sum of two durations
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline int libsimple_cmptimeval(const struct timeval *\fIa\fP, const stru
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_cmptimespec ()
@@ -28,6 +30,7 @@ functions compares the values of
and
.IR b ,
returning a value indicating which is larger, if any.
+
.SH RETURN VALUE
The
.BR libsimple_cmptimespec ()
@@ -42,12 +45,14 @@ is less than
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_cmptimespec ()
and
.BR libsimple_cmptimeval ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -72,18 +77,25 @@ T{
.BR libsimple_cmptimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_difftimespec.3 b/man3/libsimple_difftimespec.3
index bf26446..91df8e9 100644
--- a/man3/libsimple_difftimespec.3
+++ b/man3/libsimple_difftimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_DIFFTIMESPEC 3 2018-10-29 libsimple
+.TH LIBSIMPLE_DIFFTIMESPEC 3 libsimple
.SH NAME
libsimple_difftimespec, libsimple_difftimeval \- calculate the difference of two durations
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ int libsimple_difftimeval(struct timeval *\fIdiff\fP, const struct timeval *\fIm
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_difftimespec ()
@@ -41,6 +43,7 @@ are in thier valid range ([0, 1000000000) for
.BR libsimple_sumtimespec ()
and [0, 1000000) for
.BR libsimple_sumtimeval ())
+
.SH RETURN VALUE
The
.BR libsimple_difftimespec ()
@@ -50,6 +53,7 @@ functions return 0 on successful completion;
otherwise, \-1 is returned and
.I errno
is set to indicate the error.
+
.SH ERRORS
The
.BR libsimple_difftimespec ()
@@ -80,6 +84,7 @@ function and to
for the
.BR libsimple_difftimeval ()
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -104,18 +109,25 @@ T{
.BR libsimple_difftimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_multimespec (3),
diff --git a/man3/libsimple_doubletotimespec.3 b/man3/libsimple_doubletotimespec.3
index 1d8790c..1fddc74 100644
--- a/man3/libsimple_doubletotimespec.3
+++ b/man3/libsimple_doubletotimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_DOUBLETOTIMESPEC 3 2018-10-30 libsimple
+.TH LIBSIMPLE_DOUBLETOTIMESPEC 3 libsimple
.SH NAME
libsimple_doubletotimespec, libsimple_doubletotimeval \- convert a double to a duration data structure
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ void libsimple_doubletotimeval(struct timeval *\fItv\fP, double \fId\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_doubletotimespec ()
@@ -37,10 +39,13 @@ and stores the result in
.IR tv .
.PP
Neither of these functions perform an overflow check.
+
.SH RETURN VALUE
None.
+
.SH ERRORS
No error checks are made.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_doubletotimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_ealigned_realloc.3 b/man3/libsimple_ealigned_realloc.3
new file mode 120000
index 0000000..2d95e24
--- /dev/null
+++ b/man3/libsimple_ealigned_realloc.3
@@ -0,0 +1 @@
+libsimple_enaligned_realloc.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_reallocarray.3 b/man3/libsimple_ealigned_reallocarray.3
new file mode 120000
index 0000000..1b2e0f8
--- /dev/null
+++ b/man3/libsimple_ealigned_reallocarray.3
@@ -0,0 +1 @@
+libsimple_enaligned_reallocarray.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_reallocn.3 b/man3/libsimple_ealigned_reallocn.3
new file mode 120000
index 0000000..b7dde1d
--- /dev/null
+++ b/man3/libsimple_ealigned_reallocn.3
@@ -0,0 +1 @@
+libsimple_evaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_strdup.3 b/man3/libsimple_ealigned_strdup.3
new file mode 120000
index 0000000..83e40a2
--- /dev/null
+++ b/man3/libsimple_ealigned_strdup.3
@@ -0,0 +1 @@
+libsimple_enaligned_strdup.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_strndup.3 b/man3/libsimple_ealigned_strndup.3
new file mode 120000
index 0000000..2b79c93
--- /dev/null
+++ b/man3/libsimple_ealigned_strndup.3
@@ -0,0 +1 @@
+libsimple_enaligned_strndup.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_wcsdup.3 b/man3/libsimple_ealigned_wcsdup.3
new file mode 120000
index 0000000..c52f2c8
--- /dev/null
+++ b/man3/libsimple_ealigned_wcsdup.3
@@ -0,0 +1 @@
+libsimple_enaligned_wcsdup.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_wcsndup.3 b/man3/libsimple_ealigned_wcsndup.3
new file mode 120000
index 0000000..f5772b1
--- /dev/null
+++ b/man3/libsimple_ealigned_wcsndup.3
@@ -0,0 +1 @@
+libsimple_enaligned_wcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_ealigned_wmemdup.3 b/man3/libsimple_ealigned_wmemdup.3
new file mode 120000
index 0000000..07321e1
--- /dev/null
+++ b/man3/libsimple_ealigned_wmemdup.3
@@ -0,0 +1 @@
+libsimple_enaligned_wmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_egmtime.3 b/man3/libsimple_egmtime.3
new file mode 120000
index 0000000..b670cdd
--- /dev/null
+++ b/man3/libsimple_egmtime.3
@@ -0,0 +1 @@
+libsimple_gmtime.3 \ No newline at end of file
diff --git a/man3/libsimple_elocaltime.3 b/man3/libsimple_elocaltime.3
new file mode 120000
index 0000000..0b426b9
--- /dev/null
+++ b/man3/libsimple_elocaltime.3
@@ -0,0 +1 @@
+libsimple_localtime.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_alloc.3 b/man3/libsimple_enaligned_alloc.3
index 1ea36cb..27abe3d 100644
--- a/man3/libsimple_enaligned_alloc.3
+++ b/man3/libsimple_enaligned_alloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENALIGNED_ALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ENALIGNED_ALLOC 3 libsimple
.SH NAME
libsimple_enaligned_alloc \- allocate memory with custom alignment or die
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_ealigned_alloc(size_t \fIalignment\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enaligned_alloc ()
@@ -66,6 +68,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_enaligned_alloc ()
@@ -74,12 +77,14 @@ and
functions return a pointer to the allocated memory
upon success completion; otherwise the process is
terminated.
+
.SH ERRORS
The
.BR libsimple_enaligned_alloc ()
and
.BR libsimple_ealigned_alloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -104,18 +109,25 @@ T{
.BR libsimple_ealigned_alloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -124,7 +136,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_enaligned_realloc.3 b/man3/libsimple_enaligned_realloc.3
new file mode 120000
index 0000000..45a72de
--- /dev/null
+++ b/man3/libsimple_enaligned_realloc.3
@@ -0,0 +1 @@
+libsimple_aligned_realloc.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_reallocarray.3 b/man3/libsimple_enaligned_reallocarray.3
new file mode 120000
index 0000000..fb3f8b9
--- /dev/null
+++ b/man3/libsimple_enaligned_reallocarray.3
@@ -0,0 +1 @@
+libsimple_aligned_reallocarray.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_reallocn.3 b/man3/libsimple_enaligned_reallocn.3
new file mode 120000
index 0000000..36205a3
--- /dev/null
+++ b/man3/libsimple_enaligned_reallocn.3
@@ -0,0 +1 @@
+libsimple_envaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_strdup.3 b/man3/libsimple_enaligned_strdup.3
new file mode 120000
index 0000000..005dc6f
--- /dev/null
+++ b/man3/libsimple_enaligned_strdup.3
@@ -0,0 +1 @@
+libsimple_aligned_strdup.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_strndup.3 b/man3/libsimple_enaligned_strndup.3
new file mode 120000
index 0000000..4be204c
--- /dev/null
+++ b/man3/libsimple_enaligned_strndup.3
@@ -0,0 +1 @@
+libsimple_aligned_strndup.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_wcsdup.3 b/man3/libsimple_enaligned_wcsdup.3
new file mode 120000
index 0000000..cb194a0
--- /dev/null
+++ b/man3/libsimple_enaligned_wcsdup.3
@@ -0,0 +1 @@
+libsimple_aligned_wcsdup.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_wcsndup.3 b/man3/libsimple_enaligned_wcsndup.3
new file mode 120000
index 0000000..043dad0
--- /dev/null
+++ b/man3/libsimple_enaligned_wcsndup.3
@@ -0,0 +1 @@
+libsimple_aligned_wcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_enaligned_wmemdup.3 b/man3/libsimple_enaligned_wmemdup.3
new file mode 120000
index 0000000..264a7e1
--- /dev/null
+++ b/man3/libsimple_enaligned_wmemdup.3
@@ -0,0 +1 @@
+libsimple_aligned_wmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_encalloc.3 b/man3/libsimple_encalloc.3
index a8696e6..905bdd2 100644
--- a/man3/libsimple_encalloc.3
+++ b/man3/libsimple_encalloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENCALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ENCALLOC 3 libsimple
.SH NAME
libsimple_encalloc \- allocate initialised memory or die
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_ecalloc(size_t \fIn\fP, size_t \fIm\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_encalloc ()
@@ -72,6 +74,7 @@ functions behaviour is unspecified if
or
.I m
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_encalloc ()
@@ -79,12 +82,14 @@ and
.BR libsimple_ecalloc ()
functions return a pointer to the allocated memory
upon success completion; otherwise the process is terminated.
+
.SH ERRORS
The
.BR libsimple_encalloc ()
and
.BR libsimple_ecalloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -109,18 +114,25 @@ T{
.BR libsimple_ecalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -128,7 +140,17 @@ None.
.BR libsimple_vmalloczn (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_engmtime.3 b/man3/libsimple_engmtime.3
new file mode 120000
index 0000000..b670cdd
--- /dev/null
+++ b/man3/libsimple_engmtime.3
@@ -0,0 +1 @@
+libsimple_gmtime.3 \ No newline at end of file
diff --git a/man3/libsimple_enlocaltime.3 b/man3/libsimple_enlocaltime.3
new file mode 120000
index 0000000..0b426b9
--- /dev/null
+++ b/man3/libsimple_enlocaltime.3
@@ -0,0 +1 @@
+libsimple_localtime.3 \ No newline at end of file
diff --git a/man3/libsimple_enmalloc.3 b/man3/libsimple_enmalloc.3
index 796eafd..975f44c 100644
--- a/man3/libsimple_enmalloc.3
+++ b/man3/libsimple_enmalloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENMALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ENMALLOC 3 libsimple
.SH NAME
libsimple_enmalloc \- allocate memory or die
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_emalloc(size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enmalloc ()
@@ -68,6 +70,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_enmalloc ()
@@ -75,12 +78,14 @@ and
.BR libsimple_emalloc ()
functions return a pointer to the allocated memory
upon success completion; otherwise the process is terminated.
+
.SH ERRORS
The
.BR libsimple_enmalloc ()
and
.BR libsimple_emalloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -105,18 +110,25 @@ T{
.BR libsimple_emalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_mallocz (3),
.BR libsimple_vmallocn (3),
@@ -124,7 +136,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_enposix_memalign.3 b/man3/libsimple_enposix_memalign.3
index c1157f3..1d8ec20 100644
--- a/man3/libsimple_enposix_memalign.3
+++ b/man3/libsimple_enposix_memalign.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENPOSIX_MEMALIGN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ENPOSIX_MEMALIGN 3 libsimple
.SH NAME
libsimple_enposix_memalign \- allocate memory with custom alignment or die
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void libsimple_eposix_memalign(void **\fImemptr\fP, size_t \fIalig
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enposix_memalign ()
@@ -71,6 +73,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_enposix_memalign ()
@@ -78,12 +81,14 @@ and
.BR libsimple_eposix_memalign ()
functions do not return a value, but
terminated the process on failure.
+
.SH ERRORS
The
.BR libsimple_enposix_memalign ()
and
.BR libsimple_eposix_memalign ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -108,18 +113,25 @@ T{
.BR libsimple_eposix_memalign ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -128,7 +140,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_enrealloc.3 b/man3/libsimple_enrealloc.3
index 5262193..829a0f5 100644
--- a/man3/libsimple_enrealloc.3
+++ b/man3/libsimple_enrealloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENREALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_ENREALLOC 3 libsimple
.SH NAME
libsimple_enrealloc \- reallocate memory or die
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_erealloc(void *\fIptr\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enrealloc ()
@@ -79,6 +81,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_enrealloc ()
@@ -86,12 +89,14 @@ and
.BR libsimple_erealloc ()
functions return a pointer to the allocated memory
upon success completion; otherwise the process is terminated.
+
.SH ERRORS
The
.BR libsimple_enrealloc ()
and
.BR libsimple_erealloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -116,18 +121,25 @@ T{
.BR libsimple_erealloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -135,7 +147,17 @@ None.
.BR libsimple_vmalloczn (3),
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_enreallocarray.3 b/man3/libsimple_enreallocarray.3
new file mode 120000
index 0000000..9cb5fe4
--- /dev/null
+++ b/man3/libsimple_enreallocarray.3
@@ -0,0 +1 @@
+libsimple_reallocarray.3 \ No newline at end of file
diff --git a/man3/libsimple_enstrdup.3 b/man3/libsimple_enstrdup.3
index 4a2aa4f..33cc6c7 100644
--- a/man3/libsimple_enstrdup.3
+++ b/man3/libsimple_enstrdup.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENSTRDUP 3 2018-10-27 libsimple
+.TH LIBSIMPLE_ENSTRDUP 3 libsimple
.SH NAME
libsimple_enstrdup, libsimple_strdupa \- duplicate a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline char *libsimple_estrdup(const char *\fIs\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enstrdup ()
@@ -45,6 +47,7 @@ function that uses allocates the memory on the stack
rather than on the heap, causing the return pointer
to become invalid when the calling function returns.
It is only available when compling with GCC or Clang.
+
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_strdupa (),
@@ -68,8 +71,10 @@ by the
.BR libsimple_strdupa ()
function, it is automatically deallocated when the
calling function returns.
+
.SH ERRORS
None.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -100,21 +105,32 @@ T{
.BR libsimple_estrdup (),
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
+.BR libsimple_aligned_strdup (3),
.BR libsimple_enstrndup (3),
.BR libsimple_memdup (3),
-.BR libsimple_aligned_memdup (3),
+.BR libsimple_enwcsdup (3),
+.BR libsimple_wcsndup (3),
+.BR libsimple_wmemdup (3),
.BR strndup (3),
-.BR strdup (3)
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_enstrndup.3 b/man3/libsimple_enstrndup.3
index 66272b0..2c62600 100644
--- a/man3/libsimple_enstrndup.3
+++ b/man3/libsimple_enstrndup.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_ENSTRNDUP 3 2018-10-27 libsimple
+.TH LIBSIMPLE_ENSTRNDUP 3 libsimple
.SH NAME
libsimple_enstrndup, libsimple_strndupa \- duplicate the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline char *libsimple_estrndup(const char *\fIs\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_enstrndup ()
@@ -45,6 +47,7 @@ function that uses allocates the memory on the stack
rather than on the heap, causing the return pointer
to become invalid when the calling function returns.
It is only available when compling with GCC or Clang.
+
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_strndupa (),
@@ -68,8 +71,10 @@ by the
.BR libsimple_strndupa ()
function, it is automatically deallocated when the
calling function returns.
+
.SH ERRORS
None.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -100,21 +105,32 @@ T{
.BR libsimple_estrndup (),
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
+.BR libsimple_aligned_strndup (3),
.BR libsimple_enstrdup (3),
.BR libsimple_memdup (3),
-.BR libsimple_aligned_memdup (3),
+.BR libsimple_enwcsdup (3),
+.BR libsimple_wcsndup (3),
+.BR libsimple_wmemdup (3),
.BR strndup (3),
-.BR strdup (3)
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_envaligned_reallocn.3 b/man3/libsimple_envaligned_reallocn.3
new file mode 120000
index 0000000..7c3a84f
--- /dev/null
+++ b/man3/libsimple_envaligned_reallocn.3
@@ -0,0 +1 @@
+libsimple_valigned_reallocn.3 \ No newline at end of file
diff --git a/man3/libsimple_enwcsdup.3 b/man3/libsimple_enwcsdup.3
new file mode 100644
index 0000000..df013a8
--- /dev/null
+++ b/man3/libsimple_enwcsdup.3
@@ -0,0 +1,136 @@
+.TH LIBSIMPLE_ENWCSDUP 3 libsimple
+.SH NAME
+libsimple_enwcsdup, libsimple_wcsdupa \- duplicate a wide-character string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_wcsdupa(const wchar_t *\fIs\fP);
+wchar_t *libsimple_enwcsdup(int \fIstatus\fP, const wchar_t *\fIs\fP);
+static inline char *libsimple_ewcsdup(const wchar_t *\fIs\fP);
+
+#ifndef wcsdupa
+# define wcsdupa libsimple_wcsdupa
+#endif
+#ifndef enwcsdup
+# define enwcsdup libsimple_enwcsdup
+#endif
+#ifndef ewcsdup
+# define ewcsdup libsimple_ewcsdup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_enwcsdup ()
+and
+.BR libsimple_ewcsdup ()
+functions are versions of the
+.BR wcsdup (3)
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wcsdupa ()
+function is implemented as a macro and is a version
+of the
+.BR wcsdup (3)
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_wcsdupa (),
+.BR libsimple_enwcsdup (),
+and
+.BR libsimple_ewcsdup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_enwcsdup (),
+and
+.BR libsimple_ewcsdup ()
+functions exit the process. The
+.BR libsimple_wcsdupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_wcsdupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+None.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_wcsdupa (),
+.br
+.BR libsimple_enwcsdup (),
+.br
+.BR libsimple_ewcsdup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_wcsdupa (),
+.br
+.BR libsimple_enwcsdup (),
+.br
+.BR libsimple_ewcsdup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_wcsdupa (),
+.br
+.BR libsimple_enwcsdup (),
+.br
+.BR libsimple_ewcsdup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_wcsdup (3),
+.BR libsimple_enstrdup (3),
+.BR libsimple_enstrndup (3),
+.BR libsimple_memdup (3),
+.BR libsimple_wcsndup (3),
+.BR libsimple_wmemdup (3),
+.BR strndup (3),
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_enwcsndup.3 b/man3/libsimple_enwcsndup.3
new file mode 120000
index 0000000..57c8250
--- /dev/null
+++ b/man3/libsimple_enwcsndup.3
@@ -0,0 +1 @@
+libsimple_wcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_enwmemdup.3 b/man3/libsimple_enwmemdup.3
new file mode 120000
index 0000000..93381ef
--- /dev/null
+++ b/man3/libsimple_enwmemdup.3
@@ -0,0 +1 @@
+libsimple_wmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_ereallocarray.3 b/man3/libsimple_ereallocarray.3
new file mode 120000
index 0000000..5f83973
--- /dev/null
+++ b/man3/libsimple_ereallocarray.3
@@ -0,0 +1 @@
+libsimple_enreallocarray.3 \ No newline at end of file
diff --git a/man3/libsimple_evaligned_reallocn.3 b/man3/libsimple_evaligned_reallocn.3
new file mode 120000
index 0000000..36205a3
--- /dev/null
+++ b/man3/libsimple_evaligned_reallocn.3
@@ -0,0 +1 @@
+libsimple_envaligned_reallocn.3 \ No newline at end of file
diff --git a/man3/libsimple_ewcsdup.3 b/man3/libsimple_ewcsdup.3
new file mode 120000
index 0000000..85a85a6
--- /dev/null
+++ b/man3/libsimple_ewcsdup.3
@@ -0,0 +1 @@
+libsimple_enwcsdup.3 \ No newline at end of file
diff --git a/man3/libsimple_ewcsndup.3 b/man3/libsimple_ewcsndup.3
new file mode 120000
index 0000000..801d72f
--- /dev/null
+++ b/man3/libsimple_ewcsndup.3
@@ -0,0 +1 @@
+libsimple_enwcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_ewmemdup.3 b/man3/libsimple_ewmemdup.3
new file mode 120000
index 0000000..b2983f6
--- /dev/null
+++ b/man3/libsimple_ewmemdup.3
@@ -0,0 +1 @@
+libsimple_enwmemdup.3 \ No newline at end of file
diff --git a/man3/libsimple_getenv_e.3 b/man3/libsimple_getenv_e.3
index 7e3a3ca..0ed445b 100644
--- a/man3/libsimple_getenv_e.3
+++ b/man3/libsimple_getenv_e.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_GETENV_E 3 2018-10-20 libsimple
+.TH LIBSIMPLE_GETENV_E 3 libsimple
.SH NAME
libsimple_getenv_e \- get value of an environment variable or the empty string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline const char *libsimple_getenv_e(const char *\fIname\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_getenv_e ()
@@ -29,15 +31,18 @@ that have not be come visible to other process via
replacement of the process image, are visible to the
.BR libsimple_getenv_e ()
function.
+
.SH RETURN VALUE
If the environment variable
.I name
is defined, its value is returned, otherwise the
empty string is returned.
+
.SH ERRORS
The
.BR libsimple_getenv_e ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_getenv_e ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_getenv_ne (3),
.BR getenv (3)
diff --git a/man3/libsimple_getenv_ne.3 b/man3/libsimple_getenv_ne.3
index cd788d3..69c7de8 100644
--- a/man3/libsimple_getenv_ne.3
+++ b/man3/libsimple_getenv_ne.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_GETENV_NE 3 2018-10-20 libsimple
+.TH LIBSIMPLE_GETENV_NE 3 libsimple
.SH NAME
libsimple_getenv_ne \- get non-empty value of an environment variable
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline char *libsimple_getenv_ne(const char *\fIname\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_getenv_ne ()
@@ -29,6 +31,7 @@ that have not be come visible to other process via
replacement of the process image, are visible to the
.BR libsimple_getenv_ne ()
function.
+
.SH RETURN VALUE
If the environment variable
.I name
@@ -42,10 +45,12 @@ its content should not be modified. The returned
pointer becomes invalid when the environment variable
.I name
is unset or modified.
+
.SH ERRORS
The
.BR libsimple_getenv_ne ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_getenv_ne ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_getenv_e (3),
.BR getenv (3)
diff --git a/man3/libsimple_gmtime.3 b/man3/libsimple_gmtime.3
new file mode 100644
index 0000000..be050f2
--- /dev/null
+++ b/man3/libsimple_gmtime.3
@@ -0,0 +1,133 @@
+.TH LIBSIMPLE_GMTIME 3 libsimple
+.SH NAME
+libsimple_gmtime \- get the current UTC time with leap second adjustment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+int libsimple_gmtime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_engmtime(int \fIstatus\fPstruct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_egmtime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_gmtime (),
+.BR libsimple_engmtime (),
+and
+.BR libsimple_egmtime ()
+functions get the current UTC time, with adjustments
+for leap seconds insertions and deletions.
+.PP
+The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions will terminate the process on failure.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_engmtime ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_egmtime ()
+fucntion is used.
+.PP
+The local time is stored in
+.IR *tm ,
+and the POSIX time (not timezone adjusted),
+with leap second adjustments, is stored in
+.I *ts
+unless
+.I ts
+is
+.IR NULL .
+.I tm
+may
+.I not
+be
+.RI NULL .
+
+.SH RETURN VALUE
+The
+.BR libsimple_gmtime ()
+function return a 0 upon successful completion;
+otherwise the they return -1 and set
+.I errno
+to indicate the error. The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions terminate the processes on failure.
+
+.SH ERRORS
+The
+.BR libsimple_gmtime ()
+function will fail for the reasons specified for the
+.BR gmtime_r (3)
+function.
+.PP
+The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_gmtime (3),
+.BR ntp_adjtime (2),
+.BR gmtime_r (3)
diff --git a/man3/libsimple_inchrset.3 b/man3/libsimple_inchrset.3
index f07263c..44a3eb1 100644
--- a/man3/libsimple_inchrset.3
+++ b/man3/libsimple_inchrset.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_INCHRSET 3 2018-11-05 libsimple
+.TH LIBSIMPLE_INCHRSET 3 libsimple
.SH NAME
libsimple_inchrset, libsimple_inchrcaseset \- the whether a character belongs to a set
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline int libsimple_inchrcaseset(int \fIc\fP, const char *\fIs\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_inchrset ()
@@ -39,6 +41,7 @@ The comparison is case-sensitive for the
function, and case-insensitive for the
.BR libsimple_inchrcaseset ()
function.
+
.SH RETURN VALUE
The
.BR libsimple_inchrset ()
@@ -49,12 +52,14 @@ functions returns 1 if
is not the NUL byte but can be found in
.IR s ;
otherwise 0 is returned.
+
.SH ERRORS
The
.BR libsimple_inchrset ()
and
.BR libsimple_inchrcaseset ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -79,18 +84,25 @@ T{
.BR libsimple_strchrnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechr (3),
.BR strchr (3)
diff --git a/man3/libsimple_localtime.3 b/man3/libsimple_localtime.3
new file mode 100644
index 0000000..0f6aa19
--- /dev/null
+++ b/man3/libsimple_localtime.3
@@ -0,0 +1,133 @@
+.TH LIBSIMPLE_LOCALTIME 3 libsimple
+.SH NAME
+libsimple_localtime \- get the current local time with leap second adjustment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+int libsimple_localtime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_enlocaltime(int \fIstatus\fPstruct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_elocaltime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_localtime (),
+.BR libsimple_enlocaltime (),
+and
+.BR libsimple_elocaltime ()
+functions get the current local time, with adjustments
+for leap seconds insertions and deletions.
+.PP
+The
+.BR libsimple_enlocaltime ()
+and
+.BR libsimple_elocaltime ()
+functions will terminate the process on failure.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_enlocaltime ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_elocaltime ()
+fucntion is used.
+.PP
+The local time is stored in
+.IR *tm ,
+and the POSIX time (not timezone adjusted),
+with leap second adjustments, is stored in
+.I *ts
+unless
+.I ts
+is
+.IR NULL .
+.I tm
+may
+.I not
+be
+.RI NULL .
+
+.SH RETURN VALUE
+The
+.BR libsimple_localtime ()
+function return a 0 upon successful completion;
+otherwise the they return -1 and set
+.I errno
+to indicate the error. The
+.BR libsimple_enlocaltime ()
+and
+.BR libsimple_elocaltime ()
+functions terminate the processes on failure.
+
+.SH ERRORS
+The
+.BR libsimple_localtime ()
+function will fail for the reasons specified for the
+.BR localtime_r (3)
+function.
+.PP
+The
+.BR libsimple_enlocaltime ()
+and
+.BR libsimple_elocaltime ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_localtime (),
+.br
+.BR libsimple_enlocaltime (),
+.br
+.BR libsimple_elocaltime ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_localtime (),
+.br
+.BR libsimple_enlocaltime (),
+.br
+.BR libsimple_elocaltime ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_localtime (),
+.br
+.BR libsimple_enlocaltime (),
+.br
+.BR libsimple_elocaltime ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_gmtime (3),
+.BR ntp_adjtime (2),
+.BR localtime_r (3)
diff --git a/man3/libsimple_mallocz.3 b/man3/libsimple_mallocz.3
index 86254ec..54ca3e7 100644
--- a/man3/libsimple_mallocz.3
+++ b/man3/libsimple_mallocz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MALLOCZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_MALLOCZ 3 libsimple
.SH NAME
libsimple_mallocz \- allocate optionally initialised memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_emallocz(int \fIclear\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mallocz (),
@@ -80,6 +82,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_mallocz (),
@@ -98,6 +101,7 @@ it indicate the error, and the
and
.BR libsimple_emallocz ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_mallocz ()
@@ -112,6 +116,7 @@ The
and
.BR libsimple_emallocz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -142,18 +147,25 @@ T{
.BR libsimple_emallocz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_vmallocn (3),
@@ -161,7 +173,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_memalign.3 b/man3/libsimple_memalign.3
index 8bf04a1..8bbf57e 100644
--- a/man3/libsimple_memalign.3
+++ b/man3/libsimple_memalign.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMALIGN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_MEMALIGN 3 libsimple
.SH NAME
libsimple_memalign \- allocate memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_ememalign(size_t \fIalignment\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memalign (),
@@ -68,6 +70,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_memalign (),
@@ -86,6 +89,7 @@ it indicate the error, and the
and
.BR libsimple_ememalign ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_memalign ()
@@ -107,6 +111,7 @@ The
and
.BR libsimple_ememalign ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -137,14 +142,19 @@ T{
.BR libsimple_ememalign ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
Portable applications shall assume that pointer
returned by the
@@ -154,8 +164,10 @@ function can be deallocated with the
functon, unless the namespaced alias
.BR libsimple_memalign ()
is used explicitly.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -164,7 +176,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
.BR libsimple_vmemalignzn (3),
diff --git a/man3/libsimple_memalignz.3 b/man3/libsimple_memalignz.3
index 11a70d7..f756539 100644
--- a/man3/libsimple_memalignz.3
+++ b/man3/libsimple_memalignz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMALIGNZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_MEMALIGNZ 3 libsimple
.SH NAME
libsimple_memalignz \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_ememalignz(int \fIclear\fP, size_t \fIalignment\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memalignz (),
@@ -69,6 +71,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_memalignz (),
@@ -87,6 +90,7 @@ it indicate the error, and the
and
.BR libsimple_ememalignz ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_memalignz ()
@@ -108,6 +112,7 @@ The
and
.BR libsimple_ememalignz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -138,18 +143,25 @@ T{
.BR libsimple_ememalignz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -158,7 +170,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_vmemalignn (3),
.BR libsimple_vmemalignzn (3),
diff --git a/man3/libsimple_memcasechr.3 b/man3/libsimple_memcasechr.3
index d06a6d8..bfbea2f 100644
--- a/man3/libsimple_memcasechr.3
+++ b/man3/libsimple_memcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASECHR 3 libsimple
.SH NAME
libsimple_memcasechr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcasechr(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasechr ()
@@ -27,6 +29,7 @@ for the first occurence of the byte
.BR char ).
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasechr ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasechr_inv (3),
.BR libsimple_memrcasechr (3),
diff --git a/man3/libsimple_memcasechr_inv.3 b/man3/libsimple_memcasechr_inv.3
index e14d7d4..c547403 100644
--- a/man3/libsimple_memcasechr_inv.3
+++ b/man3/libsimple_memcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASECHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMCASECHR_INV 3 libsimple
.SH NAME
libsimple_memcasechr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcasechr_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP)
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasechr_inv ()
@@ -28,6 +30,7 @@ other than
.BR char ).
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasechr_inv ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasechr (3),
.BR libsimple_memchr_inv (3),
diff --git a/man3/libsimple_memcasecmp.3 b/man3/libsimple_memcasecmp.3
index 63e0e27..a7ccf79 100644
--- a/man3/libsimple_memcasecmp.3
+++ b/man3/libsimple_memcasecmp.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASECMP 3 2018-10-21 libsimple
+.TH LIBSIMPLE_MEMCASECMP 3 libsimple
.SH NAME
libsimple_memcasecmp \- compare two memory segments
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_memcasecmp(const void *\fIa\fP, const void *\fIb\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasecmp ()
@@ -27,6 +29,7 @@ and
The comparison is case-insensitive and made as
if the strings were converted to lowercase and as
.BR "unsigned char *" s.
+
.SH RETURN VALUE
The
.BR libsimple_memcasecmp ()
@@ -39,10 +42,12 @@ a positive value if
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_memcasecmp ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_memcasecmp ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcaseeq (3),
.BR libsimple_memcaseeqlen (3),
diff --git a/man3/libsimple_memcaseends.3 b/man3/libsimple_memcaseends.3
index 6605f79..1357f7b 100644
--- a/man3/libsimple_memcaseends.3
+++ b/man3/libsimple_memcaseends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASEENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASEENDS 3 libsimple
.SH NAME
libsimple_memcaseends \- checks end of memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_memcaseends(const void *\fIs\fP, size_t \fIn\fP, const void *\fIt\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcaseends ()
@@ -33,6 +35,7 @@ first bytes of
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcaseends ()
@@ -41,10 +44,12 @@ function returns 1 if
ends with
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memcaseends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memcaseends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memends (3),
.BR libsimple_memcasestarts (3),
diff --git a/man3/libsimple_memcaseeq.3 b/man3/libsimple_memcaseeq.3
index 6e30970..c48b7c5 100644
--- a/man3/libsimple_memcaseeq.3
+++ b/man3/libsimple_memcaseeq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASEEQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASEEQ 3 libsimple
.SH NAME
libsimple_memcaseeq \- check two memory segments for equality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_memcaseeq(const void *\fIa\fP, const void *\fIb\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcaseeq ()
@@ -26,6 +28,7 @@ and
are equal.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcaseeq ()
@@ -35,10 +38,12 @@ and
.I b
are equal, with the possible exception if
their case, otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memcaseeq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -57,18 +62,25 @@ T{
.BR libsimple_memcaseeq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memeq (3),
.BR libsimple_memcaseeqlen (3),
diff --git a/man3/libsimple_memcaseeqlen.3 b/man3/libsimple_memcaseeqlen.3
index f8779c8..341725a 100644
--- a/man3/libsimple_memcaseeqlen.3
+++ b/man3/libsimple_memcaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASEEQLEN 3 libsimple
.SH NAME
libsimple_memcaseeqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_memcaseeqlen(const void *\fIa\fP, size_t \fIn\fP, const void *\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcaseeqlen ()
@@ -28,6 +30,7 @@ with size
at their beginnings.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcaseeqlen ()
@@ -36,10 +39,12 @@ function returns the number of bytes
and
.I b
have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_memcaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_memcaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcaseeq (3),
.BR libsimple_memeqlen (3),
diff --git a/man3/libsimple_memcasemem.3 b/man3/libsimple_memcasemem.3
index 37c6cda..ce4de17 100644
--- a/man3/libsimple_memcasemem.3
+++ b/man3/libsimple_memcasemem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASEMEM 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASEMEM 3 libsimple
.SH NAME
libsimple_memcasemem \- find byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcasemem(const void *\fIhaystack\fP, size_t \fInhaystack\fP, c
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasemem ()
@@ -27,6 +29,7 @@ with the size
.IR nneedle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasemem ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memcasemem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memcasemem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memmem (3),
.BR libsimple_memrcasemem (3),
diff --git a/man3/libsimple_memcasescan.3 b/man3/libsimple_memcasescan.3
index 7479a05..ef2a6ec 100644
--- a/man3/libsimple_memcasescan.3
+++ b/man3/libsimple_memcasescan.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASESCAN 3 2018-11-17 libsimple
+.TH LIBSIMPLE_MEMCASESCAN 3 libsimple
.SH NAME
libsimple_memcasescan \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcasescan(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasescan ()
@@ -29,6 +31,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasescan ()
@@ -42,10 +45,12 @@ is the returned pointer.
If no such offset exists,
.I &s[n]
is returned.
+
.SH ERRORS
The
.BR libsimple_memcasescan ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_memcasescan ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasescan_inv (3),
.BR libsimple_memscan (3),
diff --git a/man3/libsimple_memcasescan_inv.3 b/man3/libsimple_memcasescan_inv.3
index f58c222..d43529f 100644
--- a/man3/libsimple_memcasescan_inv.3
+++ b/man3/libsimple_memcasescan_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASESCAN_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMCASESCAN_INV 3 libsimple
.SH NAME
libsimple_memcasescan_inv \- skip byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcasescan_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasescan_inv ()
@@ -30,6 +32,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasescan_inv ()
@@ -43,10 +46,12 @@ is the returned pointer.
If no such offset exists,
.I &s[n]
is returned.
+
.SH ERRORS
The
.BR libsimple_memcasescan_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_memcasescan_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasescan (3),
.BR libsimple_memscan_inv (3),
diff --git a/man3/libsimple_memcasestarts.3 b/man3/libsimple_memcasestarts.3
index d8a7259..9e93a5f 100644
--- a/man3/libsimple_memcasestarts.3
+++ b/man3/libsimple_memcasestarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCASESTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMCASESTARTS 3 libsimple
.SH NAME
libsimple_memcasestarts \- checks beginning of memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_memcasestarts(const void *\fIs\fP, size_t \fIn\fP, const void *\fI
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcasestarts ()
@@ -31,6 +33,7 @@ first bytes of
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcasestarts ()
@@ -39,10 +42,12 @@ function returns 1 if
begins with
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memcasestarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_memcasestarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memstarts (3),
.BR libsimple_memcaseends (3),
diff --git a/man3/libsimple_memchr_inv.3 b/man3/libsimple_memchr_inv.3
index 23c8271..8003aa9 100644
--- a/man3/libsimple_memchr_inv.3
+++ b/man3/libsimple_memchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMCHR_INV 3 libsimple
.SH NAME
libsimple_memchr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memchr_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memchr_inv ()
@@ -28,6 +30,7 @@ other than
.BR char ).
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memchr_inv ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasechr_inv (3),
.BR libsimple_memrchr_inv (3),
diff --git a/man3/libsimple_memcmove.3 b/man3/libsimple_memcmove.3
index 0079e28..88d7e4f 100644
--- a/man3/libsimple_memcmove.3
+++ b/man3/libsimple_memcmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMCMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMCMOVE 3 libsimple
.SH NAME
libsimple_memcmove \- move bytes within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memcmove(void *\fIdest\fP, const void *\fIsrc\fP, int \fIc\fP, s
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memcmove ()
@@ -30,6 +32,7 @@ However the move stops after the character
is moved. The arrays may overlap in the.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memcmove ()
@@ -43,10 +46,12 @@ after it was move, if the character
was not moved
.I NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memcmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_memcmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemcmove (3),
.BR libsimple_mempmove (3),
diff --git a/man3/libsimple_memdup.3 b/man3/libsimple_memdup.3
index e111574..8a6903d 100644
--- a/man3/libsimple_memdup.3
+++ b/man3/libsimple_memdup.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMDUP 3 2018-10-27 libsimple
+.TH LIBSIMPLE_MEMDUP 3 libsimple
.SH NAME
libsimple_memdup \- duplicate bytes in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -26,10 +27,11 @@ static inline void *libsimple_ememdup(const void *\fIs\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memdup ()
-function constructs allocates memory and copies
+function allocates memory and copies
.I n
first bytes from
.I s
@@ -57,6 +59,7 @@ function that uses allocates the memory on the stack
rather than on the heap, causing the return pointer
to become invalid when the calling function returns.
It is only available when compling with GCC or Clang.
+
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_memdupa (),
@@ -87,12 +90,14 @@ by the
.BR libsimple_memdupa ()
function, it is automatically deallocated when the
calling function returns.
+
.SH ERRORS
The
.BR libsimple_memdup ()
function may fail for any reason specified for the
-.BR alloc (3)
+.BR malloc (3)
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -129,21 +134,32 @@ T{
.BR libsimple_ememdup (),
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_aligned_memdup (3),
.BR libsimple_enstrndup (3),
.BR libsimple_enstrdup (3),
+.BR libsimple_enwcsdup (3),
+.BR libsimple_wcsndup (3),
+.BR libsimple_wmemdup (3),
.BR strndup (3),
-.BR strdup (3)
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_memelem.3 b/man3/libsimple_memelem.3
index 4ccdb3a..cdab273 100644
--- a/man3/libsimple_memelem.3
+++ b/man3/libsimple_memelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMELEM 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMELEM 3 libsimple
.SH NAME
libsimple_memelem \- find aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memelem(const void *\fIhaystack\fP, const void *\fIneedle\fP, si
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memelem ()
@@ -29,6 +31,7 @@ and with an offset equivalent to zero modulo
.IR width .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memelem ()
@@ -44,10 +47,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_memelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memelem_inv (3),
.BR libsimple_memelemscan (3),
diff --git a/man3/libsimple_memelem_inv.3 b/man3/libsimple_memelem_inv.3
index c3b3208..c87e590 100644
--- a/man3/libsimple_memelem_inv.3
+++ b/man3/libsimple_memelem_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMELEM_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMELEM_INV 3 libsimple
.SH NAME
libsimple_memelem_inv \- find different aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memelem_inv(const void *\fIhaystack\fP, const void *\fIneedle\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memelem_inv ()
@@ -30,6 +32,7 @@ and with an offset equivalent to zero modulo
.IR width .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memelem_inv ()
@@ -45,10 +48,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memelem_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_memelem_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memelem (3),
.BR libsimple_memelemscan_inv (3),
diff --git a/man3/libsimple_memelemmove.3 b/man3/libsimple_memelemmove.3
index d566b5d..194ff79 100644
--- a/man3/libsimple_memelemmove.3
+++ b/man3/libsimple_memelemmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMELEMMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMELEMMOVE 3 libsimple
.SH NAME
libsimple_memelemmove, libsimple_memelemcpy \- copy or move elements within an array
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_memelemcpy(void *\fIdest\fP, const void *\fIsrc\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memelemmove ()
@@ -43,6 +45,7 @@ The arrays may overlap in the
function but not in the
.BR libsimple_memelemcpy ()
function.
+
.SH RETURN VALUE
The
.BR libsimple_memelemmove ()
@@ -58,12 +61,14 @@ after it was copied. If the element
was not copied
.I NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memelemmove ()
and
.BR libsimple_memelemcpy ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -88,18 +93,25 @@ and
.BR libsimple_memelemcpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemelemmove (3),
.BR libsimple_mempmove (3),
diff --git a/man3/libsimple_memelemscan.3 b/man3/libsimple_memelemscan.3
index 092508e..67b96cb 100644
--- a/man3/libsimple_memelemscan.3
+++ b/man3/libsimple_memelemscan.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMELEMSCAN 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMELEMSCAN 3 libsimple
.SH NAME
libsimple_memelemscan \- find aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memelemscan(const void *\fIhaystack\fP, const void *\fIneedle\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memelemscan ()
@@ -31,6 +33,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memelemscan ()
@@ -46,10 +49,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.I (void *)&((char *)haystack)[n*width]
is returned.
+
.SH ERRORS
The
.BR libsimple_memelemscan ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -68,18 +73,25 @@ T{
.BR libsimple_memelemscan ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memelemscan_inv (3),
.BR libsimple_memelem (3),
diff --git a/man3/libsimple_memelemscan_inv.3 b/man3/libsimple_memelemscan_inv.3
index 3fdd8f8..24eb8ac 100644
--- a/man3/libsimple_memelemscan_inv.3
+++ b/man3/libsimple_memelemscan_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMELEMSCAN_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMELEMSCAN_INV 3 libsimple
.SH NAME
libsimple_memelemscan_inv \- skip aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memelemscan_inv(const void *\fIhaystack\fP, const void *\fIneedl
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memelemscan_inv ()
@@ -32,6 +34,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memelemscan_inv ()
@@ -47,10 +50,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.I (void *)&((char *)haystack)[n*width]
is returned.
+
.SH ERRORS
The
.BR libsimple_memelemscan_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -69,18 +74,25 @@ T{
.BR libsimple_memelemscan_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memelemscan (3),
.BR libsimple_memelem_inv (3),
diff --git a/man3/libsimple_memends.3 b/man3/libsimple_memends.3
index 34db568..2529370 100644
--- a/man3/libsimple_memends.3
+++ b/man3/libsimple_memends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMENDS 3 libsimple
.SH NAME
libsimple_memends \- checks end of memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_memends(const void *\fIs\fP, size_t \fIn\fP, const void *\fIt\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memends ()
@@ -33,6 +35,7 @@ first bytes of
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memends ()
@@ -41,10 +44,12 @@ function returns 1 if
ends with
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcaseends (3),
.BR libsimple_memstarts (3),
diff --git a/man3/libsimple_memeq.3 b/man3/libsimple_memeq.3
index 6631328..a5683e5 100644
--- a/man3/libsimple_memeq.3
+++ b/man3/libsimple_memeq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMEQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMEQ 3 libsimple
.SH NAME
libsimple_memeq \- check two memory segments for equality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_memeq(const void *\fIa\fP, const void *\fIb\fP, size
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memeq ()
@@ -26,6 +28,7 @@ and
are equal.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memeq ()
@@ -34,10 +37,12 @@ function returns 1 one if
and
.I b
are equal, otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memeq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_memeq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcaseeq (3),
.BR libsimple_memeqlen (3),
diff --git a/man3/libsimple_memeqlen.3 b/man3/libsimple_memeqlen.3
index 6a03808..4344a39 100644
--- a/man3/libsimple_memeqlen.3
+++ b/man3/libsimple_memeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMEQLEN 3 libsimple
.SH NAME
libsimple_memeqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_memeqlen(const void *\fIa\fP, size_t \fIn\fP, const void *\fIb\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memeqlen ()
@@ -28,6 +30,7 @@ with size
at their beginnings.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memeqlen ()
@@ -36,10 +39,12 @@ function returns the number of bytes
and
.I b
have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_memeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_memeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memeq (3),
.BR libsimple_memcaseeqlen (3),
diff --git a/man3/libsimple_memmem.3 b/man3/libsimple_memmem.3
index 30dea44..cb24cc4 100644
--- a/man3/libsimple_memmem.3
+++ b/man3/libsimple_memmem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMMEM 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMMEM 3 libsimple
.SH NAME
libsimple_memmem \- find byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memmem(const void *\fIhaystack\fP, size_t \fInhaystack\fP, const
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memmem ()
@@ -27,6 +29,7 @@ with the size
.IR nneedle .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memmem ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memmem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memmem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrcasemem (3),
.BR libsimple_memrmem (3),
diff --git a/man3/libsimple_mempcpy.3 b/man3/libsimple_mempcpy.3
index c23a041..a10bba0 100644
--- a/man3/libsimple_mempcpy.3
+++ b/man3/libsimple_mempcpy.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMPCPY 3 2018-11-16 libsimple
+.TH LIBSIMPLE_MEMPCPY 3 libsimple
.SH NAME
libsimple_mempcpy \- copy an array of bytes into another
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_mempcpy(void *restrict \fIdest\fP, const void *res
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mempcpy ()
@@ -31,6 +33,7 @@ must not overlap with the first
.I n
bytes of
.IR src .
+
.SH RETURN VALUE
The
.BR libsimple_mempcpy ()
@@ -39,10 +42,12 @@ function returns the pointer
with the offset
.I n
(the byte where the copy stopped).
+
.SH ERRORS
The
.BR libsimple_mempcpy ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_mempcpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_mempmove (3),
.BR libsimple_mempset (3),
diff --git a/man3/libsimple_mempmove.3 b/man3/libsimple_mempmove.3
index 3545412..29b7e4e 100644
--- a/man3/libsimple_mempmove.3
+++ b/man3/libsimple_mempmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMPMOVE 3 2018-11-16 libsimple
+.TH LIBSIMPLE_MEMPMOVE 3 libsimple
.SH NAME
libsimple_mempmove \- move bytes within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_mempmove(void *\fIdest\fP, const void *\fIsrc\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mempmove ()
@@ -24,6 +26,7 @@ bytes of
into
.IR dest .
The arrays may overlap.
+
.SH RETURN VALUE
The
.BR libsimple_mempmove ()
@@ -32,10 +35,12 @@ function returns the pointer
with the offset
.I n
(the byte where the copy stopped).
+
.SH ERRORS
The
.BR libsimple_mempmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_mempmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_mempcpy (3),
.BR libsimple_mempset (3),
diff --git a/man3/libsimple_mempset.3 b/man3/libsimple_mempset.3
index e6ce289..31ebd06 100644
--- a/man3/libsimple_mempset.3
+++ b/man3/libsimple_mempset.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMPSET 3 2018-10-20 libsimple
+.TH LIBSIMPLE_MEMPSET 3 libsimple
.SH NAME
libsimple_mempset \- fill an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_mempset(void *\fIs\fP, int \fIc\fP, size_t \fIn\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mempset ()
@@ -25,6 +27,7 @@ with the value
.I c
coverted to a
.BR char .
+
.SH RETURN VALUE
The
.BR libsimple_mempset ()
@@ -33,10 +36,12 @@ function returns the pointer
with the offset
.I n
(the byte where the copy stopped).
+
.SH ERRORS
The
.BR libsimple_mempset ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -55,18 +60,25 @@ T{
.BR libsimple_mempset ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_mempsetelem (3),
.BR libsimple_mempcpy (3),
diff --git a/man3/libsimple_mempsetelem.3 b/man3/libsimple_mempsetelem.3
index e10a252..805b3cd 100644
--- a/man3/libsimple_mempsetelem.3
+++ b/man3/libsimple_mempsetelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMPSETELEM 3 2018-10-20 libsimple
+.TH LIBSIMPLE_MEMPSETELEM 3 libsimple
.SH NAME
libsimple_mempsetelem \- fill an array with a value
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_mempsetelem(void *\fIbuf\fP, const void *\fIitem\fP, size_t \fIw
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mempsetelem ()
@@ -25,6 +27,7 @@ copies of the element
.I item
with the size
.IR width .
+
.SH RETURN VALUE
The
.BR libsimple_mempsetelem ()
@@ -33,10 +36,12 @@ function returns the pointer
with the offset
.I n*width
(the byte where the copy stopped).
+
.SH ERRORS
The
.BR libsimple_mempsetelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -55,18 +60,25 @@ T{
.BR libsimple_mempsetelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memsetelem (3),
.BR libsimple_mempset (3)
diff --git a/man3/libsimple_memrcasechr.3 b/man3/libsimple_memrcasechr.3
index 5bb60b4..77322d5 100644
--- a/man3/libsimple_memrcasechr.3
+++ b/man3/libsimple_memrcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMRCASECHR 3 libsimple
.SH NAME
libsimple_memrcasechr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrcasechr(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrcasechr ()
@@ -27,6 +29,7 @@ for the last occurence of the byte
.BR char ).
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrcasechr ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memrcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrcasechr_inv (3),
.BR libsimple_memcasechr (3),
diff --git a/man3/libsimple_memrcasechr_inv.3 b/man3/libsimple_memrcasechr_inv.3
index c5936a7..c9e5068 100644
--- a/man3/libsimple_memrcasechr_inv.3
+++ b/man3/libsimple_memrcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCASECHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMRCASECHR_INV 3 libsimple
.SH NAME
libsimple_memrcasechr_inv \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrcasechr_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrcasechr_inv ()
@@ -28,6 +30,7 @@ other than
.BR char ).
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrcasechr_inv ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memrcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrcasechr (3),
.BR libsimple_memcasechr_inv (3),
diff --git a/man3/libsimple_memrcaseeqlen.3 b/man3/libsimple_memrcaseeqlen.3
index 9991e05..cf3734b 100644
--- a/man3/libsimple_memrcaseeqlen.3
+++ b/man3/libsimple_memrcaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMRCASEEQLEN 3 libsimple
.SH NAME
libsimple_memrcaseeqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_memrcaseeqlen(const void *\fIa\fP, size_t \fIn\fP, const void *
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrcaseeqlen ()
@@ -28,6 +30,7 @@ with size
at their ends.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrcaseeqlen ()
@@ -36,10 +39,12 @@ function returns the number of bytes
and
.I b
have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_memrcaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_memrcaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memreqlen (3),
.BR libsimple_memcaseeqlen (3),
diff --git a/man3/libsimple_memrcasemem.3 b/man3/libsimple_memrcasemem.3
index 76b6ea5..e10fd9e 100644
--- a/man3/libsimple_memrcasemem.3
+++ b/man3/libsimple_memrcasemem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCASEMEM 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMRCASEMEM 3 libsimple
.SH NAME
libsimple_memrcasemem \- find byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrcasemem(const void *\fIhaystack\fP, size_t \fInhaystack\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrcasemem ()
@@ -27,6 +29,7 @@ with the size
.IR nneedle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrcasemem ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrcasemem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memrcasemem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrmem (3),
.BR libsimple_memcasemem (3),
diff --git a/man3/libsimple_memrchr.3 b/man3/libsimple_memrchr.3
index 71d0c0a..b75e797 100644
--- a/man3/libsimple_memrchr.3
+++ b/man3/libsimple_memrchr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMRCHR 3 libsimple
.SH NAME
libsimple_memrchr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrchr(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrchr ()
@@ -27,6 +29,7 @@ for the last occurence of the byte
.BR char ).
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrchr ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrchr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memrchr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrchr_inv (3),
.BR libsimple_memrcasechr (3),
diff --git a/man3/libsimple_memrchr_inv.3 b/man3/libsimple_memrchr_inv.3
index d498245..80af59c 100644
--- a/man3/libsimple_memrchr_inv.3
+++ b/man3/libsimple_memrchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRCHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMRCHR_INV 3 libsimple
.SH NAME
libsimple_memrchr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrchr_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrchr_inv ()
@@ -28,6 +30,7 @@ other than
.BR char ).
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrchr_inv ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_memrchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrchr (3),
.BR libsimple_memchr_inv (3),
diff --git a/man3/libsimple_memrelem.3 b/man3/libsimple_memrelem.3
index 26bcfb8..8cbfba2 100644
--- a/man3/libsimple_memrelem.3
+++ b/man3/libsimple_memrelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRELEM 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMRELEM 3 libsimple
.SH NAME
libsimple_memrelem \- find aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrelem(const void *\fIhaystack\fP, const void *\fIneedle\fP, s
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrelem ()
@@ -29,6 +31,7 @@ and with an offset equivalent to zero modulo
.IR width .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrelem ()
@@ -44,10 +47,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_memrelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrelem_inv (3),
.BR libsimple_rawmemrelem (3),
diff --git a/man3/libsimple_memrelem_inv.3 b/man3/libsimple_memrelem_inv.3
index f3d5736..b2e7680 100644
--- a/man3/libsimple_memrelem_inv.3
+++ b/man3/libsimple_memrelem_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRELEM_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMRELEM_INV 3 libsimple
.SH NAME
libsimple_memrelem_inv \- find different aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrelem_inv(const void *\fIhaystack\fP, const void *\fIneedle\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrelem_inv ()
@@ -30,6 +32,7 @@ and with an offset equivalent to zero modulo
.IR width .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrelem_inv ()
@@ -45,10 +48,12 @@ the offset is equivalent to zero modulo
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrelem_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_memrelem_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrelem (3),
.BR libsimple_rawmemrelem_inv (3),
diff --git a/man3/libsimple_memreplace.3 b/man3/libsimple_memreplace.3
index 25fd6d1..45800bb 100644
--- a/man3/libsimple_memreplace.3
+++ b/man3/libsimple_memreplace.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMREPLACE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMREPLACE 3 libsimple
.SH NAME
libsimple_memreplace \- replace bytes in an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_memreplace(void *\fIs\fP, int \fIold\fP, int \fIne
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memreplace ()
@@ -29,15 +31,18 @@ with the byte
.IR new .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memreplace ()
function returns
.IR &s[n] .
+
.SH ERRORS
The
.BR libsimple_memreplace ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_memreplace ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memtolower (3),
.BR libsimple_memtoupper (3),
diff --git a/man3/libsimple_memreplaceelem.3 b/man3/libsimple_memreplaceelem.3
index 6ad5c6c..63ffbef 100644
--- a/man3/libsimple_memreplaceelem.3
+++ b/man3/libsimple_memreplaceelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMREPLACEELEM 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMREPLACEELEM 3 libsimple
.SH NAME
libsimple_memreplaceelem \- replace elements in an array
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memreplaceelem(void *\fIs\fP, int \fIold\fP, int \fInew\fP, size
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memreplaceelem ()
@@ -37,15 +39,18 @@ are aligned by
.I width
bytes in
.IR s .
+
.SH RETURN VALUE
The
.BR libsimple_memreplaceelem ()
function returns
.IR &s[n*width] .
+
.SH ERRORS
The
.BR libsimple_memreplaceelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_memreplaceelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memreplace (3),
.BR libsimple_strreplace (3),
diff --git a/man3/libsimple_memreqlen.3 b/man3/libsimple_memreqlen.3
index 93b49b4..d4ef7d0 100644
--- a/man3/libsimple_memreqlen.3
+++ b/man3/libsimple_memreqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMREQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMREQLEN 3 libsimple
.SH NAME
libsimple_memreqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_memreqlen(const void *\fIa\fP, size_t \fIn\fP, const void *\fIb
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memreqlen ()
@@ -28,6 +30,7 @@ with size
at their ends.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memreqlen ()
@@ -36,10 +39,12 @@ function returns the number of bytes
and
.I b
have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_memreqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_memreqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memrcaseeqlen (3),
.BR libsimple_memeqlen (3),
diff --git a/man3/libsimple_memrmem.3 b/man3/libsimple_memrmem.3
index 706fc03..95ebccd 100644
--- a/man3/libsimple_memrmem.3
+++ b/man3/libsimple_memrmem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMRMEM 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMRMEM 3 libsimple
.SH NAME
libsimple_memrmem \- find byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memrmem(const void *\fIhaystack\fP, size_t \fInhaystack\fP, cons
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memrmem ()
@@ -27,6 +29,7 @@ with the size
.IR nneedle .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memrmem ()
@@ -40,10 +43,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_memrmem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_memrmem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasemem (3),
.BR libsimple_memmem (3),
diff --git a/man3/libsimple_memscan.3 b/man3/libsimple_memscan.3
index 1d85c6a..b79677a 100644
--- a/man3/libsimple_memscan.3
+++ b/man3/libsimple_memscan.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMSCAN 3 2018-11-17 libsimple
+.TH LIBSIMPLE_MEMSCAN 3 libsimple
.SH NAME
libsimple_memscan \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memscan(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memscan ()
@@ -29,6 +31,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memscan ()
@@ -42,10 +45,12 @@ is the returned pointer.
If no such offset exists,
.I &r[n]
is returned.
+
.SH ERRORS
The
.BR libsimple_memscan ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_memscan ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memscan_inv (3),
.BR libsimple_memcasescan (3),
diff --git a/man3/libsimple_memscan_inv.3 b/man3/libsimple_memscan_inv.3
index 39a6071..805e42f 100644
--- a/man3/libsimple_memscan_inv.3
+++ b/man3/libsimple_memscan_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMSCAN_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_MEMSCAN_INV 3 libsimple
.SH NAME
libsimple_memscan_inv \- skip byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_memscan_inv(const void *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memscan_inv ()
@@ -30,6 +32,7 @@ If no such character exist in the memory
segment, the memory segment's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memscan_inv ()
@@ -43,10 +46,12 @@ is the returned pointer.
If no such offset exists,
.I &r[n]
is returned.
+
.SH ERRORS
The
.BR libsimple_memscan_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_memscan_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memscan (3),
.BR libsimple_memchr_inv (3),
diff --git a/man3/libsimple_memsetelem.3 b/man3/libsimple_memsetelem.3
index 91e5b63..37e7022 100644
--- a/man3/libsimple_memsetelem.3
+++ b/man3/libsimple_memsetelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMSETELEM 3 2018-10-20 libsimple
+.TH LIBSIMPLE_MEMSETELEM 3 libsimple
.SH NAME
libsimple_memsetelem \- fill an array with a value
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_memsetelem(void *\fIbuf\fP, const void *\fIitem\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memsetelem ()
@@ -25,15 +27,18 @@ copies of the element
.I item
with the size
.IR width .
+
.SH RETURN VALUE
The
.BR libsimple_memsetelem ()
function returns the pointer
.IR buf .
+
.SH ERRORS
The
.BR libsimple_memsetelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -52,18 +57,25 @@ T{
.BR libsimple_memsetelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_mempsetelem (3),
.BR memset (3)
diff --git a/man3/libsimple_memstarts.3 b/man3/libsimple_memstarts.3
index 527397b..9c6b0ef 100644
--- a/man3/libsimple_memstarts.3
+++ b/man3/libsimple_memstarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMSTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_MEMSTARTS 3 libsimple
.SH NAME
libsimple_memstarts \- checks beginning of memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_memstarts(const void *\fIs\fP, size_t \fIn\fP, const void *\fIt\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memstarts ()
@@ -31,6 +33,7 @@ first bytes of
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_memstarts ()
@@ -39,10 +42,12 @@ function returns 1 if
begins with
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_memstarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_memstarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcasestarts (3),
.BR libsimple_memends (3),
diff --git a/man3/libsimple_memtolower.3 b/man3/libsimple_memtolower.3
index be09689..facb09d 100644
--- a/man3/libsimple_memtolower.3
+++ b/man3/libsimple_memtolower.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMTOLOWER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMTOLOWER 3 libsimple
.SH NAME
libsimple_memtolower, libsimple_memptolower \- convert a character array to lower case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ void *libsimple_memptolower(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memtolower ()
@@ -33,6 +35,7 @@ All upper case ASCII characters will be converted
to lower case. The arrays may overlap, and there
is an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_memtolower ()
@@ -43,12 +46,14 @@ The
.BR libsimple_memptolower ()
function returns
.IR &dest[n] .
+
.SH ERRORS
The
.BR libsimple_memtolower ()
and
.BR libsimple_memptolower ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -73,18 +78,25 @@ T{
.BR libsimple_memptolower ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memtoupper (3),
.BR libsimple_memreplace (3),
diff --git a/man3/libsimple_memtoupper.3 b/man3/libsimple_memtoupper.3
index 6f45d54..17a747c 100644
--- a/man3/libsimple_memtoupper.3
+++ b/man3/libsimple_memtoupper.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MEMTOUPPER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_MEMTOUPPER 3 libsimple
.SH NAME
libsimple_memtoupper, libsimple_memptoupper \- convert a character array to upper case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ void *libsimple_memptoupper(void *\fIdest\fP, const void *\fIsrc\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memtoupper ()
@@ -33,6 +35,7 @@ All lower case ASCII characters will be converted
to upper case. The arrays may overlap, and there
is an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_memtoupper ()
@@ -43,12 +46,14 @@ The
.BR libsimple_memptoupper ()
function returns
.IR &dest[n] .
+
.SH ERRORS
The
.BR libsimple_memtoupper ()
and
.BR libsimple_memptoupper ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -73,18 +78,25 @@ T{
.BR libsimple_memptoupper ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memtolower (3),
.BR libsimple_memreplace (3),
diff --git a/man3/libsimple_minimise_number_string.3 b/man3/libsimple_minimise_number_string.3
index 310b725..19533c6 100644
--- a/man3/libsimple_minimise_number_string.3
+++ b/man3/libsimple_minimise_number_string.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MINIMISE_NUMBER_STRING 3 2018-10-31 libsimple
+.TH LIBSIMPLE_MINIMISE_NUMBER_STRING 3 libsimple
.SH NAME
libsimple_minimise_number_string \- ninimise a numerical string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_minimise_number_string(char *\fIs\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_minimise_number_string ()
@@ -21,15 +23,18 @@ function minimises a string representing a real value with
the assumption that the string is on the format
.B [+-]\e?[0-9]*\e(\e.[0-9]*\e)\e?
(repeating decimals are not supported).
+
.SH RETURN VALUE
The
.BR libsimple_minimise_number_string ()
function returns the pointer
.IR s .
+
.SH ERRORS
The
.BR libsimple_minimise_number_string ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -48,17 +53,24 @@ T{
.BR libsimple_minimise_number_string ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_timespectostr (3)
diff --git a/man3/libsimple_multimespec.3 b/man3/libsimple_multimespec.3
index 34b352d..ad99b22 100644
--- a/man3/libsimple_multimespec.3
+++ b/man3/libsimple_multimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_MULTIMESPEC 3 2018-10-29 libsimple
+.TH LIBSIMPLE_MULTIMESPEC 3 libsimple
.SH NAME
libsimple_multimespec, libsimple_multimeval \- multiply a duration with an integer
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ int libsimple_multimeval(struct timeval *\fIprod\fP, const struct timeval *\fImu
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_multimespec ()
@@ -36,6 +38,7 @@ is in its valid range ([0, 1000000000) for
.BR libsimple_multimespec ()
and [0, 1000000) for
.BR libsimple_multimeval ()).
+
.SH RETURN VALUE
The
.BR libsimple_multimespec ()
@@ -45,6 +48,7 @@ functions return 0 on successful completion;
otherwise, \-1 is returned and
.I errno
is set to indicate the error.
+
.SH ERRORS
The
.BR libsimple_multimespec ()
@@ -75,6 +79,7 @@ function and to
for the
.BR libsimple_multimeval ()
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -99,18 +104,25 @@ T{
.BR libsimple_multimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_posix_memalignz.3 b/man3/libsimple_posix_memalignz.3
index 3ea4655..a82605f 100644
--- a/man3/libsimple_posix_memalignz.3
+++ b/man3/libsimple_posix_memalignz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_POSIX_MEMALIGNZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_POSIX_MEMALIGNZ 3 libsimple
.SH NAME
libsimple_posix_memalignz \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void libsimple_eposix_memalignz(void **\fImemptr\fP, int \fIclear\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_posix_memalignz (),
@@ -73,6 +75,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_posix_memalignz ()
@@ -86,6 +89,7 @@ and
.BR libsimple_eposix_memalignz ()
functions do not return a value, but
terminated the process on failure.
+
.SH ERRORS
The
.BR libsimple_posix_memalignz ()
@@ -112,6 +116,7 @@ The
and
.BR libsimple_eposix_memalignz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -142,18 +147,25 @@ T{
.BR libsimple_eposix_memalignz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -162,7 +174,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_pvalloc.3 b/man3/libsimple_pvalloc.3
index b6cf4c6..9440712 100644
--- a/man3/libsimple_pvalloc.3
+++ b/man3/libsimple_pvalloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_PVALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_PVALLOC 3 libsimple
.SH NAME
libsimple_pvalloc \- allocate memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_epvalloc(size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_pvalloc (),
@@ -60,6 +62,7 @@ function is used or
if the
.BR libsimple_epvalloc ()
function is used.
+
.SH RETURN VALUE
The
.BR libsimple_pvalloc (),
@@ -78,6 +81,7 @@ it indicate the error, and the
and
.BR libsimple_epvalloc ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_pvalloc ()
@@ -95,6 +99,7 @@ The
and
.BR libsimple_epvalloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -125,14 +130,19 @@ T{
.BR libsimple_epvalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
Portable applications shall assume that pointer
returned by the
@@ -146,8 +156,10 @@ is used explicitly.
The GNU implementation of
.BR pvalloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -156,7 +168,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_pvallocz.3 b/man3/libsimple_pvallocz.3
index c758fcd..1fcc898 100644
--- a/man3/libsimple_pvallocz.3
+++ b/man3/libsimple_pvallocz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_PVALLOCZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_PVALLOCZ 3 libsimple
.SH NAME
libsimple_pvallocz \- allocate optionally initialised memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_epvallocz(int \fIclear\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_pvallocz (),
@@ -68,6 +70,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_pvallocz (),
@@ -86,6 +89,7 @@ it indicate the error, and the
and
.BR libsimple_epvallocz ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_pvallocz ()
@@ -103,6 +107,7 @@ The
and
.BR libsimple_epvallocz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -133,20 +138,27 @@ T{
.BR libsimple_epvallocz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR pvalloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -155,7 +167,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_rawmemcasechr.3 b/man3/libsimple_rawmemcasechr.3
index 455a818..a6f3b31 100644
--- a/man3/libsimple_rawmemcasechr.3
+++ b/man3/libsimple_rawmemcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMCASECHR 3 2018-10-21 libsimple
+.TH LIBSIMPLE_RAWMEMCASECHR 3 libsimple
.SH NAME
libsimple_rawmemcasechr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemcasechr(const void *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemcasechr ()
@@ -31,6 +33,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemcasechr ()
@@ -41,10 +44,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_rawmemcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemcasechr_inv (3),
.BR libsimple_memcasechr (3),
diff --git a/man3/libsimple_rawmemcasechr_inv.3 b/man3/libsimple_rawmemcasechr_inv.3
index f5241a2..f282c7b 100644
--- a/man3/libsimple_rawmemcasechr_inv.3
+++ b/man3/libsimple_rawmemcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMCASECHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_RAWMEMCASECHR_INV 3 libsimple
.SH NAME
libsimple_rawmemcasechr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemcasechr_inv(const void *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemcasechr_inv ()
@@ -32,6 +34,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemcasechr_inv ()
@@ -42,10 +45,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_rawmemcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemcasechr (3),
.BR libsimple_memcasechr_inv (3),
diff --git a/man3/libsimple_rawmemchr.3 b/man3/libsimple_rawmemchr.3
index 1df9b02..f2bf84c 100644
--- a/man3/libsimple_rawmemchr.3
+++ b/man3/libsimple_rawmemchr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMCHR 3 2018-10-21 libsimple
+.TH LIBSIMPLE_RAWMEMCHR 3 libsimple
.SH NAME
libsimple_rawmemchr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemchr(const void *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemchr ()
@@ -31,6 +33,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemchr ()
@@ -41,10 +44,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemchr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_rawmemchr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemchr_inv (3),
.BR libsimple_rawmemcasechr (3),
diff --git a/man3/libsimple_rawmemchr_inv.3 b/man3/libsimple_rawmemchr_inv.3
index 011e957..4fd5a48 100644
--- a/man3/libsimple_rawmemchr_inv.3
+++ b/man3/libsimple_rawmemchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMCHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_RAWMEMCHR_INV 3 libsimple
.SH NAME
libsimple_rawmemchr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemchr_inv(const void *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemchr_inv ()
@@ -32,6 +34,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemchr_inv ()
@@ -42,10 +45,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -64,18 +69,25 @@ T{
.BR libsimple_rawmemchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemchr (3),
.BR libsimple_memchr_inv (3),
diff --git a/man3/libsimple_rawmemcmove.3 b/man3/libsimple_rawmemcmove.3
index 51e9ef4..d4df247 100644
--- a/man3/libsimple_rawmemcmove.3
+++ b/man3/libsimple_rawmemcmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMCMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMCMOVE 3 libsimple
.SH NAME
libsimple_rawmemcmove, libsimple_rawmemccpy \- copy or move bytes within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_rawmemccpy(void *\fIdest\fP, const void *\fIsrc\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemcmove ()
@@ -40,6 +42,7 @@ function but not in the
function.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemcmove ()
@@ -55,12 +58,14 @@ after it was copied. If the character
does not exist in
.IR src ,
the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemcmove ()
and
.BR libsimple_rawmemccpy ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -85,18 +90,25 @@ and
.BR libsimple_rawmemccpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memcmove (3),
.BR libsimple_mempmove (3),
diff --git a/man3/libsimple_rawmemelem.3 b/man3/libsimple_rawmemelem.3
index 62c986c..348ce14 100644
--- a/man3/libsimple_rawmemelem.3
+++ b/man3/libsimple_rawmemelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMELEM 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMELEM 3 libsimple
.SH NAME
libsimple_rawmemelem \- find aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemelem(const void *\fIhaystack\fP, const void *\fIneedle\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemelem ()
@@ -33,6 +35,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemelem ()
@@ -46,10 +49,12 @@ is the returned pointer, and such that
the offset is equivalent to zero modulo
.IR width .
If no such offset exists, the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -68,18 +73,25 @@ T{
.BR libsimple_rawmemelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemelem_inv (3),
.BR libsimple_rawmemrelem (3),
diff --git a/man3/libsimple_rawmemelem_inv.3 b/man3/libsimple_rawmemelem_inv.3
index 28e5bef..cd179c2 100644
--- a/man3/libsimple_rawmemelem_inv.3
+++ b/man3/libsimple_rawmemelem_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMELEM_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMELEM_INV 3 libsimple
.SH NAME
libsimple_rawmemelem_inv \- find different aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemelem_inv(const void *\fIhaystack\fP, const void *\fIneedle
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemelem_inv ()
@@ -34,6 +36,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemelem_inv ()
@@ -47,10 +50,12 @@ is the returned pointer, and such that
the offset is equivalent to zero modulo
.IR width .
If no such offset exists, the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemelem_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -69,18 +74,25 @@ T{
.BR libsimple_rawmemelem_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemelem (3),
.BR libsimple_rawmemrelem_inv (3),
diff --git a/man3/libsimple_rawmemelemmove.3 b/man3/libsimple_rawmemelemmove.3
index cafd956..da7b242 100644
--- a/man3/libsimple_rawmemelemmove.3
+++ b/man3/libsimple_rawmemelemmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMELEMMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMELEMMOVE 3 libsimple
.SH NAME
libsimple_rawmemelemmove, libsimple_rawmemelemcpy \- copy or move elements within an array
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline void *libsimple_rawmemelemcpy(void *\fIdest\fP, const void *\fIsrc
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemelemmove ()
@@ -41,6 +43,7 @@ The arrays may overlap in the
function but not in the
.BR libsimple_rawmemelemcpy ()
function.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemelemmove ()
@@ -56,12 +59,14 @@ after it was copied. If the element
does not exist in
.IR src ,
the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemelemmove ()
and
.BR libsimple_rawmemelemcpy ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -86,18 +91,25 @@ and
.BR libsimple_rawmemelemcpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_memelemmove (3),
.BR libsimple_mempmove (3),
diff --git a/man3/libsimple_rawmemrcasechr.3 b/man3/libsimple_rawmemrcasechr.3
index 2959691..4ae1adb 100644
--- a/man3/libsimple_rawmemrcasechr.3
+++ b/man3/libsimple_rawmemrcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRCASECHR 3 2018-10-21 libsimple
+.TH LIBSIMPLE_RAWMEMRCASECHR 3 libsimple
.SH NAME
libsimple_rawmemrcasechr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrcasechr(const void *s, int c, size_t n);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrcasechr ()
@@ -33,6 +35,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrcasechr ()
@@ -43,10 +46,12 @@ with a maximal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemrcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_rawmemrcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrcasechr_inv (3),
.BR libsimple_rawmemrchr (3),
diff --git a/man3/libsimple_rawmemrcasechr_inv.3 b/man3/libsimple_rawmemrcasechr_inv.3
index 060779d..7c82736 100644
--- a/man3/libsimple_rawmemrcasechr_inv.3
+++ b/man3/libsimple_rawmemrcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRCASECHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_RAWMEMRCASECHR_INV 3 libsimple
.SH NAME
libsimple_rawmemrcasechr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrcasechr_inv(const void *s, int c, size_t n);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrcasechr_inv ()
@@ -34,6 +36,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrcasechr_inv ()
@@ -44,10 +47,12 @@ with a maximal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemrcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_rawmemrcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrcasechr (3),
.BR libsimple_rawmemrchr_inv (3),
diff --git a/man3/libsimple_rawmemrchr.3 b/man3/libsimple_rawmemrchr.3
index 5bf0fd6..5bd898c 100644
--- a/man3/libsimple_rawmemrchr.3
+++ b/man3/libsimple_rawmemrchr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRCHR 3 2018-10-21 libsimple
+.TH LIBSIMPLE_RAWMEMRCHR 3 libsimple
.SH NAME
libsimple_rawmemrchr \- find byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrchr(const void *s, int c, size_t n);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrchr ()
@@ -33,6 +35,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrchr ()
@@ -43,10 +46,12 @@ with a maximal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemrchr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -65,18 +70,25 @@ T{
.BR libsimple_rawmemrchr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrchr_inv (3),
.BR libsimple_rawmemrcasechr (3),
diff --git a/man3/libsimple_rawmemrchr_inv.3 b/man3/libsimple_rawmemrchr_inv.3
index 28bd733..4603026 100644
--- a/man3/libsimple_rawmemrchr_inv.3
+++ b/man3/libsimple_rawmemrchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRCHR_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_RAWMEMRCHR_INV 3 libsimple
.SH NAME
libsimple_rawmemrchr_inv \- find different byte in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrchr_inv(const void *s, int c, size_t n);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrchr_inv ()
@@ -34,6 +36,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrchr_inv ()
@@ -44,10 +47,12 @@ with a maximal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_rawmemrchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_rawmemrchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrchr (3),
.BR libsimple_rawmemrcasechr_inv (3),
diff --git a/man3/libsimple_rawmemrelem.3 b/man3/libsimple_rawmemrelem.3
index 4ac85aa..1628f2f 100644
--- a/man3/libsimple_rawmemrelem.3
+++ b/man3/libsimple_rawmemrelem.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRELEM 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMRELEM 3 libsimple
.SH NAME
libsimple_rawmemrelem \- find aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrelem(const void *\fIhaystack\fP, const void *\fIneedle\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrelem ()
@@ -34,6 +36,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrelem ()
@@ -47,10 +50,12 @@ is the returned pointer, and such that
the offset is equivalent to zero modulo
.IR width .
If no such offset exists, the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemrelem ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -69,18 +74,25 @@ T{
.BR libsimple_rawmemrelem ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrelem_inv (3),
.BR libsimple_memrelem (3),
diff --git a/man3/libsimple_rawmemrelem_inv.3 b/man3/libsimple_rawmemrelem_inv.3
index ee16eb9..1bedba9 100644
--- a/man3/libsimple_rawmemrelem_inv.3
+++ b/man3/libsimple_rawmemrelem_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_RAWMEMRELEM_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_RAWMEMRELEM_INV 3 libsimple
.SH NAME
libsimple_rawmemrelem_inv \- find different aligned byte string in memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ void *libsimple_rawmemrelem_inv(const void *\fIhaystack\fP, const void *\fIneedl
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_rawmemrelem_inv ()
@@ -35,6 +37,7 @@ occurence, its behaviour is undefined
if this is not the case.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_rawmemrelem_inv ()
@@ -48,10 +51,12 @@ is the returned pointer, and such that
the offset is equivalent to zero modulo
.IR width .
If no such offset exists, the behaviour is undefined.
+
.SH ERRORS
The
.BR libsimple_rawmemrelem_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -70,18 +75,25 @@ T{
.BR libsimple_rawmemrelem_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_rawmemrelem (3),
.BR libsimple_memrelem_inv (3),
diff --git a/man3/libsimple_reallocarray.3 b/man3/libsimple_reallocarray.3
new file mode 100644
index 0000000..c6c6635
--- /dev/null
+++ b/man3/libsimple_reallocarray.3
@@ -0,0 +1,203 @@
+.TH LIBSIMPLE_REALLOCARRAY 3 libsimple
+.SH NAME
+libsimple_reallocarray \- reallocate memory
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_reallocarray(void *\fIptr\fP, size_t \fIn\fP, size_t \fIm\fP);
+static inline void *libsimple_enreallocarray(int \fIstatus\fP, void *\fIptr\fP, size_t \fIn\fP, size_t \fIm\fP);
+static inline void *libsimple_ereallocarray(void *\fIptr\fP, size_t \fIn\fP, size_t \fIm\fP);
+
+#ifndef reallocarray
+# define reallocarray libsimple_reallocarray
+#endif
+#ifndef enreallocarray
+# define enreallocarray libsimple_enreallocarray
+#endif
+#ifndef ereallocarray
+# define ereallocarray libsimple_ereallocarray
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_reallocarray (),
+.BR libsimple_enreallocarray (),
+and
+.BR libsimple_ereallocarray ()
+functions are wrappers for the
+.BR realloc (3)
+function, they reallocate memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignof(max_align_t)
+to the allocated memory of
+.I n*m
+bytes. The behaviour is unspecified if
+.I n
+or
+.I m
+is 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n*m
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is not deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_enreallocarray ()
+and
+.BR libsimple_ereallocarray ()
+functions will terminate the process if the memory
+cannot be allocated, by calling the
+.BR libsimple_enprintf ()
+and
+.BR libsimple_eprintf ()
+functions, respectively.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_enreallocarray ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_ereallocarray ()
+function is used.
+
+.SH RETURN VALUE
+The
+.BR libsimple_reallocarray (),
+.BR libsimple_enreallocarray (),
+and
+.BR libsimple_ereallocarray ()
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_reallocarray ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error, and the
+.BR libsimple_enreallocarray ()
+and
+.BR libsimple_ereallocarray ()
+functions terminated the process.
+
+.SH ERRORS
+The
+.BR libsimple_reallocarray ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function.
+.PP
+The
+.BR libsimple_enreallocarray ()
+and
+.BR libsimple_ereallocarray ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_reallocarray (),
+.br
+.BR libsimple_enreallocarray (),
+.br
+.BR libsimple_ereallocarray ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_reallocarray (),
+.br
+.BR libsimple_enreallocarray (),
+.br
+.BR libsimple_ereallocarray ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_reallocarray (),
+.br
+.BR libsimple_enreallocarray (),
+.br
+.BR libsimple_ereallocarray ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_reallocarrayf.3 b/man3/libsimple_reallocarrayf.3
new file mode 100644
index 0000000..b3c2504
--- /dev/null
+++ b/man3/libsimple_reallocarrayf.3
@@ -0,0 +1,155 @@
+.TH LIBSIMPLE_REALLOCARRAYF 3 libsimple
+.SH NAME
+libsimple_reallocarrayf \- reallocate memory
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_reallocarrayf(void *\fIptr\fP, size_t \fIn\fP, size_t \fIm\fP);
+
+#ifndef reallocarrayf
+# define reallocarrayf libsimple_reallocarrayf
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_reallocarrayf ()
+function is a wrapper for the
+.BR realloc(3)
+function that reallocates memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignof(max_align_t)
+to the allocated memory of
+.I n*m
+bytes. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n*m
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+If
+.I n
+or
+.I m
+is 0,
+.I ptr
+is deallocaed and
+.B NULL
+is returned, however portable applications should,
+unless the namespaced alias is used, assume the
+behaviour is unspecifed in this case.
+
+.SH RETURN VALUE
+The
+.BR libsimple_reallocarrayf (),
+function returns a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_reallocarrayf ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_reallocarrayf ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_reallocarrayf ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_reallocarrayf ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_reallocarrayf ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_reallocf.3 b/man3/libsimple_reallocf.3
new file mode 100644
index 0000000..b0c2d1b
--- /dev/null
+++ b/man3/libsimple_reallocf.3
@@ -0,0 +1,153 @@
+.TH LIBSIMPLE_REALLOCF 3 libsimple
+.SH NAME
+libsimple_reallocf \- reallocate memory
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_reallocf(void *\fIptr\fP, size_t \fIn\fP);
+
+#ifndef reallocf
+# define reallocf libsimple_reallocf
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_reallocf ()
+function is a wrapper for the
+.BR realloc(3)
+function that reallocates memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignof(max_align_t)
+to the allocated memory of
+.I n
+bytes. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I n
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+If
+.I n
+is 0,
+.I ptr
+is deallocaed and
+.B NULL
+is returned, however portable applications should,
+unless the namespaced alias is used, assume the
+behaviour is unspecifed in this case.
+
+.SH RETURN VALUE
+The
+.BR libsimple_reallocf (),
+function returns a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_reallocf ()
+function returns
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_reallocf ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_reallocf ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_reallocf ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_reallocf ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_reallocfn.3 b/man3/libsimple_reallocfn.3
new file mode 120000
index 0000000..d06b871
--- /dev/null
+++ b/man3/libsimple_reallocfn.3
@@ -0,0 +1 @@
+libsimple_vreallocfn.3 \ No newline at end of file
diff --git a/man3/libsimple_stpmove.3 b/man3/libsimple_stpmove.3
index 62282d6..d9e8db1 100644
--- a/man3/libsimple_stpmove.3
+++ b/man3/libsimple_stpmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STPMOVE 3 2018-11-16 libsimple
+.TH LIBSIMPLE_STPMOVE 3 libsimple
.SH NAME
libsimple_stpmove \- move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_stpmove(void *\fIdest\fP, const void *\fIsrc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_stpmove ()
@@ -23,6 +25,7 @@ NUL byte that terminates it,
into
.IR dest .
The arrays may overlap.
+
.SH RETURN VALUE
The
.BR libsimple_stpmove ()
@@ -32,10 +35,12 @@ with the offset of the length of string
.I str
(the address of the copied NUL byte in
.IR dest ).
+
.SH ERRORS
The
.BR libsimple_stpmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_stpmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strmove (3),
.BR libsimple_stpnmove (3),
diff --git a/man3/libsimple_stpnmove.3 b/man3/libsimple_stpnmove.3
index eed841a..f2fd267 100644
--- a/man3/libsimple_stpnmove.3
+++ b/man3/libsimple_stpnmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STPNMOVE 3 2018-11-16 libsimple
+.TH LIBSIMPLE_STPNMOVE 3 libsimple
.SH NAME
libsimple_stpnmove \- move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_stpnmove(void *\fIdest\fP, const void *\fIsrc\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_stpnmove ()
@@ -25,6 +27,7 @@ NUL byte that terminates it (if any),
into
.IR dest .
The arrays may overlap.
+
.SH RETURN VALUE
The
.BR libsimple_stpnmove ()
@@ -37,10 +40,12 @@ with the offset of the length of string
or
.I &dest[n]
if no NUL byte was copied).
+
.SH ERRORS
The
.BR libsimple_stpnmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -59,18 +64,25 @@ T{
.BR libsimple_stpnmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnmove (3),
.BR libsimple_stpmove (3),
diff --git a/man3/libsimple_strcasechr.3 b/man3/libsimple_strcasechr.3
index 0f1a7f3..7e6d897 100644
--- a/man3/libsimple_strcasechr.3
+++ b/man3/libsimple_strcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASECHR 3 libsimple
.SH NAME
libsimple_strcasechr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strcasechr(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasechr ()
@@ -27,6 +29,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasechr ()
@@ -39,10 +42,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_strcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechr_inv (3),
.BR libsimple_strcasechrnul (3),
diff --git a/man3/libsimple_strcasechr_inv.3 b/man3/libsimple_strcasechr_inv.3
index baf5574..cfd2862 100644
--- a/man3/libsimple_strcasechr_inv.3
+++ b/man3/libsimple_strcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASECHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRCASECHR_INV 3 libsimple
.SH NAME
libsimple_strcasechr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strcasechr_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasechr_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasechr_inv ()
@@ -40,10 +43,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechr (3),
.BR libsimple_strchr_inv (3),
diff --git a/man3/libsimple_strcasechrnul.3 b/man3/libsimple_strcasechrnul.3
index 08dbce4..550893a 100644
--- a/man3/libsimple_strcasechrnul.3
+++ b/man3/libsimple_strcasechrnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASECHRNUL 3 2018-10-21 libsimple
+.TH LIBSIMPLE_STRCASECHRNUL 3 libsimple
.SH NAME
libsimple_strcasechrnul \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strcasechrnul(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasechrnul ()
@@ -27,6 +29,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasechrnul ()
@@ -37,10 +40,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_strcasechrnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -59,18 +64,25 @@ T{
.BR libsimple_strcasechrnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechrnul_inv (3),
.BR libsimple_strcasechr (3),
diff --git a/man3/libsimple_strcasechrnul_inv.3 b/man3/libsimple_strcasechrnul_inv.3
index 61c8179..01c085c 100644
--- a/man3/libsimple_strcasechrnul_inv.3
+++ b/man3/libsimple_strcasechrnul_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASECHRNUL_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_STRCASECHRNUL_INV 3 libsimple
.SH NAME
libsimple_strcasechrnul_inv \- skip a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strcasechrnul_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasechrnul_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasechrnul_inv ()
@@ -38,10 +41,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_strcasechrnul_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strcasechrnul_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechrnul (3),
.BR libsimple_strcasechr_inv (3),
diff --git a/man3/libsimple_strcasecmpnul.3 b/man3/libsimple_strcasecmpnul.3
index 2b0afe6..1f4561e 100644
--- a/man3/libsimple_strcasecmpnul.3
+++ b/man3/libsimple_strcasecmpnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASECMPNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASECMPNUL 3 libsimple
.SH NAME
libsimple_strcasecmpnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strcasecmpnul(const char *\fIa\fP, const char *\fIb\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasecmpnul ()
@@ -32,6 +34,7 @@ greater than the shorter string.
The comparison is case-insensitive and made as
if the strings were converted to lowercase and as
.BR "unsigned char *" s.
+
.SH RETURN VALUE
The
.BR libsimple_strcasecmpnul ()
@@ -44,10 +47,12 @@ a positive value if
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_strcasecmpnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strcasecmpnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcmpnul (3),
.BR libsimple_strcaseeqnul (3),
diff --git a/man3/libsimple_strcaseends.3 b/man3/libsimple_strcaseends.3
index f658699..22e015f 100644
--- a/man3/libsimple_strcaseends.3
+++ b/man3/libsimple_strcaseends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASEENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASEENDS 3 libsimple
.SH NAME
libsimple_strcaseends \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strcaseends(const char *\fIs\fP, const char *\fIt\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcaseends ()
@@ -23,6 +25,7 @@ ends with the string
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcaseends ()
@@ -31,10 +34,12 @@ function returns 1 if the string
ends with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strcaseends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strcaseends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strends (3),
.BR libsimple_strcasestarts (3),
diff --git a/man3/libsimple_strcaseeq.3 b/man3/libsimple_strcaseeq.3
index b1a25bd..e0dbf7f 100644
--- a/man3/libsimple_strcaseeq.3
+++ b/man3/libsimple_strcaseeq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASEEQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASEEQ 3 libsimple
.SH NAME
libsimple_strcaseeq \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strcaseeq(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcaseeq ()
@@ -25,16 +27,19 @@ neither of which may be
.BR NULL .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcaseeq ()
function returns 1 if the strings are equals,
with the possible exception of the case,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strcaseeq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strcaseeq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcaseeqnul (3),
.BR libsimple_streq (3),
diff --git a/man3/libsimple_strcaseeqlen.3 b/man3/libsimple_strcaseeqlen.3
index 6adba9c..975300e 100644
--- a/man3/libsimple_strcaseeqlen.3
+++ b/man3/libsimple_strcaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASEEQLEN 3 libsimple
.SH NAME
libsimple_strcaseeqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_strcaseeqlen(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcaseeqlen ()
@@ -24,6 +26,7 @@ have in common the string
at their beginnings.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcaseeqlen ()
@@ -32,10 +35,12 @@ function returns the number of bytes
and
.I b
have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_strcaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_strcaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcaseeq (3),
.BR libsimple_streqlen (3),
diff --git a/man3/libsimple_strcaseeqnul.3 b/man3/libsimple_strcaseeqnul.3
index fa26a17..27595b0 100644
--- a/man3/libsimple_strcaseeqnul.3
+++ b/man3/libsimple_strcaseeqnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASEEQNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASEEQNUL 3 libsimple
.SH NAME
libsimple_strcaseeqnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strcaseeqnul(const char *\fIa\fP, const char *\fIb\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcaseeqnul ()
@@ -25,16 +27,19 @@ both of which may be
.BR NULL .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcaseeqnul ()
function returns 1 if the strings are equals,
with the possible exception of the case,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strcaseeqnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strcaseeqnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcaseeq (3),
.BR libsimple_streqnul (3),
diff --git a/man3/libsimple_strcasestarts.3 b/man3/libsimple_strcasestarts.3
index 0f9d689..bf6786c 100644
--- a/man3/libsimple_strcasestarts.3
+++ b/man3/libsimple_strcasestarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASESTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASESTARTS 3 libsimple
.SH NAME
libsimple_strcasestarts \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strcasestarts(const char *\fIs\fP, const char *\fIt\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasestarts ()
@@ -23,6 +25,7 @@ starts with the string
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasestarts ()
@@ -31,10 +34,12 @@ function returns 1 if the string
begins with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strcasestarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strcasestarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strstarts (3),
.BR libsimple_strcaseends (3),
diff --git a/man3/libsimple_strcasestr.3 b/man3/libsimple_strcasestr.3
index 8ee2c45..47b396f 100644
--- a/man3/libsimple_strcasestr.3
+++ b/man3/libsimple_strcasestr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCASESTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCASESTR 3 libsimple
.SH NAME
libsimple_strcasestr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strcasestr(const char *\fIhaystack\fP, const char *\fIneedle\fP)
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcasestr ()
@@ -23,6 +25,7 @@ the first occurrence of the substring
.IR needle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcasestr ()
@@ -38,10 +41,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strcasestr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strcasestr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrcasestr (3),
.BR libsimple_strncasestr (3),
diff --git a/man3/libsimple_strchr_inv.3 b/man3/libsimple_strchr_inv.3
index e1cdf53..df2fda5 100644
--- a/man3/libsimple_strchr_inv.3
+++ b/man3/libsimple_strchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRCHR_INV 3 libsimple
.SH NAME
libsimple_strchr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strchr_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strchr_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strchr_inv ()
@@ -40,10 +43,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasechr_inv (3),
.BR libsimple_strchrnul_inv (3),
diff --git a/man3/libsimple_strchrnul.3 b/man3/libsimple_strchrnul.3
index ed54f0b..13c577b 100644
--- a/man3/libsimple_strchrnul.3
+++ b/man3/libsimple_strchrnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCHRNUL 3 2018-10-21 libsimple
+.TH LIBSIMPLE_STRCHRNUL 3 libsimple
.SH NAME
libsimple_strchrnul \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strchrnul(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strchrnul ()
@@ -27,6 +29,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strchrnul ()
@@ -37,10 +40,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_strchrnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -59,18 +64,25 @@ T{
.BR libsimple_strchrnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_charstrnul_inv (3),
.BR libsimple_strcasechrnul (3),
diff --git a/man3/libsimple_strchrnul_inv.3 b/man3/libsimple_strchrnul_inv.3
index 4664d1a..1ce6e42 100644
--- a/man3/libsimple_strchrnul_inv.3
+++ b/man3/libsimple_strchrnul_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCHRNUL_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_STRCHRNUL_INV 3 libsimple
.SH NAME
libsimple_strchrnul_inv \- skip a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strchrnul_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strchrnul_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strchrnul_inv ()
@@ -38,10 +41,12 @@ with a minimal offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_strchrnul_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strchrnul_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_charstrnul (3),
.BR libsimple_strchr_inv (3),
diff --git a/man3/libsimple_strcmove.3 b/man3/libsimple_strcmove.3
index 328e696..4888832 100644
--- a/man3/libsimple_strcmove.3
+++ b/man3/libsimple_strcmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRCMOVE 3 libsimple
.SH NAME
libsimple_strcmove, libsimple_strccpy \- copy or move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline char *libsimple_strccpy(char *restrict \fIdest\fP, const char *res
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcmove ()
@@ -41,6 +43,7 @@ function but not in the
function.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strcmove ()
@@ -56,12 +59,14 @@ after it was copied, if the character
was not copied
.I NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strcmove ()
and
.BR libsimple_strccpy ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -86,18 +91,25 @@ T{
.BR libsimple_strccpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strmove (3),
.BR libsimple_stpmove (3),
diff --git a/man3/libsimple_strcmpnul.3 b/man3/libsimple_strcmpnul.3
index 9f6ec47..01a512c 100644
--- a/man3/libsimple_strcmpnul.3
+++ b/man3/libsimple_strcmpnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRCMPNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRCMPNUL 3 libsimple
.SH NAME
libsimple_strcmpnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strcmpnul(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strcmpnul ()
@@ -32,6 +34,7 @@ greater than the shorter string.
The comparison is case-sensitive and made as if
the strings were
.IR "unsigned char *" s.
+
.SH RETURN VALUE
The
.BR libsimple_strcmpnul ()
@@ -44,10 +47,12 @@ a positive value if
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_strcmpnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strcmpnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasecmpnul (3),
.BR libsimple_streqnul (3),
diff --git a/man3/libsimple_strend.3 b/man3/libsimple_strend.3
index adfdf6f..a3a1bfe 100644
--- a/man3/libsimple_strend.3
+++ b/man3/libsimple_strend.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STREND 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STREND 3 libsimple
.SH NAME
libsimple_strend \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,12 +15,14 @@ static inline char *libsimple_strend(const char *\fIs\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strend ()
function scans the string
.I s
for its end.
+
.SH RETURN VALUE
The
.BR libsimple_strend ()
@@ -30,10 +33,12 @@ with an offset such that
where
.I r
is the returned pointer.
+
.SH ERRORS
The
.BR libsimple_strend ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -52,18 +57,25 @@ T{
.BR libsimple_strend ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strchrnul (3),
.BR libsimple_strnend (3),
diff --git a/man3/libsimple_strends.3 b/man3/libsimple_strends.3
index 9ab8b45..c7d55c5 100644
--- a/man3/libsimple_strends.3
+++ b/man3/libsimple_strends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRENDS 3 libsimple
.SH NAME
libsimple_strends \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strends(const char *\fIs\fP, const char *\fIt\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strends ()
@@ -23,6 +25,7 @@ ends with the string
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strends ()
@@ -31,10 +34,12 @@ function returns 1 if the string
ends with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcaseends (3),
.BR libsimple_strstarts (3),
diff --git a/man3/libsimple_streq.3 b/man3/libsimple_streq.3
index 76c1779..2a1fada 100644
--- a/man3/libsimple_streq.3
+++ b/man3/libsimple_streq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STREQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STREQ 3 libsimple
.SH NAME
libsimple_streq \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_streq(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_streq ()
@@ -25,15 +27,18 @@ neither of which may be
.BR NULL .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_streq ()
function returns 1 if the strings are equals,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_streq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -52,18 +57,25 @@ T{
.BR libsimple_streq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_streqnul (3),
.BR libsimple_strcaseeq (3),
diff --git a/man3/libsimple_streqlen.3 b/man3/libsimple_streqlen.3
index cb92bc6..2ec78fe 100644
--- a/man3/libsimple_streqlen.3
+++ b/man3/libsimple_streqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STREQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STREQLEN 3 libsimple
.SH NAME
libsimple_streqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_streqlen(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_streqlen ()
@@ -24,6 +26,7 @@ have in common the string
at their beginnings.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_streqlen ()
@@ -32,10 +35,12 @@ function returns the number of bytes
and
.I b
have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_streqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_streqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_streq (3),
.BR libsimple_strreqlen (3),
diff --git a/man3/libsimple_streqnul.3 b/man3/libsimple_streqnul.3
index 84ccf88..f2d7d07 100644
--- a/man3/libsimple_streqnul.3
+++ b/man3/libsimple_streqnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STREQNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STREQNUL 3 libsimple
.SH NAME
libsimple_streqnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_streqnul(const char *\fIa\fP, const char *\fIb\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_streqnul ()
@@ -25,15 +27,18 @@ both of which may be
.BR NULL .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_streqnul ()
function returns 1 if the strings are equals,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_streqnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -52,18 +57,25 @@ T{
.BR libsimple_streqnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_streq (3),
.BR libsimple_strcaseeqnul (3),
diff --git a/man3/libsimple_strisutf8.3 b/man3/libsimple_strisutf8.3
index ff8f609..0a525f1 100644
--- a/man3/libsimple_strisutf8.3
+++ b/man3/libsimple_strisutf8.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRISUTF8 3 2018-11-16 libsimple
+.TH LIBSIMPLE_STRISUTF8 3 libsimple
.SH NAME
libsimple_strisutf8, libsimple_strnisutf8, libsimple_memisutf8 \- check if a string is encoded in UTF-8
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ int libsimple_memisutf8(const char *\fIstring\fP, size_t \fIn\fP, int \fIallow_m
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strisutf8 (),
@@ -65,6 +67,7 @@ function is a
.B const char *
rather than a
.BR "const void *" .
+
.SH RETURN VALUE
The
.BR libsimple_strisutf8 (),
@@ -76,6 +79,7 @@ function returns 1 if the
is in valid UTF-8 (Modified UTF-8 if
.I allow_modified_nul
is non-zero); otherwise 0 is returned.
+
.SH ERRORS
The
.BR libsimple_strisutf8 (),
@@ -83,6 +87,7 @@ The
and
.BR libsimple_memisutf8 ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -113,17 +118,24 @@ T{
.BR libsimple_memisutf8 ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO,
None.
diff --git a/man3/libsimple_strmove.3 b/man3/libsimple_strmove.3
index 90d5dfc..1b03800 100644
--- a/man3/libsimple_strmove.3
+++ b/man3/libsimple_strmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRMOVE 3 2018-11-16 libsimple
+.TH LIBSIMPLE_STRMOVE 3 libsimple
.SH NAME
libsimple_strmove \- move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline char *libsimple_strmove(char *\fIdest\fP, const char *\fIsrc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strmove ()
@@ -23,15 +25,18 @@ NUL byte that terminates it,
into
.IR dest .
The arrays may overlap.
+
.SH RETURN VALUE
The
.BR libsimple_strmove ()
function returns the pointer
.IR dest .
+
.SH ERRORS
The
.BR libsimple_strmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -50,18 +55,25 @@ T{
.BR libsimple_strmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_stpmove (3),
.BR libsimple_strnmove (3),
diff --git a/man3/libsimple_strncasechr.3 b/man3/libsimple_strncasechr.3
index b0a1c96..064a588 100644
--- a/man3/libsimple_strncasechr.3
+++ b/man3/libsimple_strncasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASECHR 3 libsimple
.SH NAME
libsimple_strncasechr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strncasechr(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasechr ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasechr ()
@@ -44,10 +47,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strncasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strncasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasechr_inv (3),
.BR libsimple_strncasechrnul (3),
diff --git a/man3/libsimple_strncasechr_inv.3 b/man3/libsimple_strncasechr_inv.3
index c23fe84..11ba3f6 100644
--- a/man3/libsimple_strncasechr_inv.3
+++ b/man3/libsimple_strncasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASECHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNCASECHR_INV 3 libsimple
.SH NAME
libsimple_strncasechr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strncasechr_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasechr_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasechr_inv ()
@@ -45,10 +48,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strncasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strncasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasechr (3),
.BR libsimple_strncasechrnul_inv (3),
diff --git a/man3/libsimple_strncasechrnul.3 b/man3/libsimple_strncasechrnul.3
index d73f186..fd757a8 100644
--- a/man3/libsimple_strncasechrnul.3
+++ b/man3/libsimple_strncasechrnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASECHRNUL 3 2018-10-21 libsimple
+.TH LIBSIMPLE_STRNCASECHRNUL 3 libsimple
.SH NAME
libsimple_strncasechrnul \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strncasechrnul(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP)
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasechrnul ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasechrnul ()
@@ -45,10 +48,12 @@ offset less than
exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strncasechrnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strncasechrnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasechrnul_inv (3),
.BR libsimple_strncasechr (3),
diff --git a/man3/libsimple_strncasechrnul_inv.3 b/man3/libsimple_strncasechrnul_inv.3
index 48cced8..ad409ab 100644
--- a/man3/libsimple_strncasechrnul_inv.3
+++ b/man3/libsimple_strncasechrnul_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASECHRNUL_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_STRNCASECHRNUL_INV 3 libsimple
.SH NAME
libsimple_strncasechrnul_inv \- skip a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strncasechrnul_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasechrnul_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasechrnul_inv ()
@@ -46,10 +49,12 @@ offset less than
exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strncasechrnul_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -68,18 +73,25 @@ T{
.BR libsimple_strncasechrnul_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasechrnul (3),
.BR libsimple_strncasechr_inv (3),
diff --git a/man3/libsimple_strncasecmpnul.3 b/man3/libsimple_strncasecmpnul.3
index 959ea78..25b7239 100644
--- a/man3/libsimple_strncasecmpnul.3
+++ b/man3/libsimple_strncasecmpnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASECMPNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASECMPNUL 3 libsimple
.SH NAME
libsimple_strncasecmpnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strncasecmpnul(const char *\fIa\fP, const char *\fIb
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasecmpnul ()
@@ -38,6 +40,7 @@ greater than the shorter string.
The comparison is case-insensitive and made as
if the strings were converted to lowercase and as
.BR "unsigned char *" s.
+
.SH RETURN VALUE
The
.BR libsimple_strncasecmpnul ()
@@ -50,10 +53,12 @@ a positive value if
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_strncasecmpnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -72,18 +77,25 @@ T{
.BR libsimple_strncasecmpnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncmpnul (3),
.BR libsimple_strncaseeqnul (3),
diff --git a/man3/libsimple_strncaseends.3 b/man3/libsimple_strncaseends.3
index 5bdc0d9..c9911ef 100644
--- a/man3/libsimple_strncaseends.3
+++ b/man3/libsimple_strncaseends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASEENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASEENDS 3 libsimple
.SH NAME
libsimple_strncaseends \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strncaseends(const char *\fIs\fP, const char *\fIt\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncaseends ()
@@ -26,6 +28,7 @@ ends with the string
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncaseends ()
@@ -34,10 +37,12 @@ function returns 1 if the string
ends with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strncaseends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_strncaseends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnends (3),
.BR libsimple_strncasestarts (3),
diff --git a/man3/libsimple_strncaseeq.3 b/man3/libsimple_strncaseeq.3
index 55c2f79..5b7a6a9 100644
--- a/man3/libsimple_strncaseeq.3
+++ b/man3/libsimple_strncaseeq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASEEQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASEEQ 3 libsimple
.SH NAME
libsimple_strncaseeq \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strncaseeq(const char *\fIa\fP, const char *\fIb\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncaseeq ()
@@ -31,16 +33,19 @@ neither of which may be
.BR NULL .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncaseeq ()
function returns 1 if the strings are equals,
with the possible exception of the case,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strncaseeq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -59,18 +64,25 @@ T{
.BR libsimple_strncaseeq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncaseeqnul (3),
.BR libsimple_strneq (3),
diff --git a/man3/libsimple_strncaseeqlen.3 b/man3/libsimple_strncaseeqlen.3
index 8fbc236..72cc85e 100644
--- a/man3/libsimple_strncaseeqlen.3
+++ b/man3/libsimple_strncaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASEEQLEN 3 libsimple
.SH NAME
libsimple_strncaseeqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_strncaseeqlen(const char *\fIa\fP, const char *\fIb\fP, size_t
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncaseeqlen ()
@@ -30,6 +32,7 @@ bytes unless it is shorter,
at their beginnings.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncaseeqlen ()
@@ -40,10 +43,12 @@ and
(both truncated to
.I n
bytes) have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_strncaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strncaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcaseeq (3),
.BR libsimple_streqlen (3),
diff --git a/man3/libsimple_strncaseeqnul.3 b/man3/libsimple_strncaseeqnul.3
index 743d4be..b713996 100644
--- a/man3/libsimple_strncaseeqnul.3
+++ b/man3/libsimple_strncaseeqnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASEEQNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASEEQNUL 3 libsimple
.SH NAME
libsimple_strncaseeqnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strncaseeqnul(const char *\fIa\fP, const char *\fIb\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncaseeqnul ()
@@ -31,16 +33,19 @@ both of which may be
.BR NULL .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncaseeqnul ()
function returns 1 if the strings are equals,
with the possible exception of the case,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strncaseeqnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -59,18 +64,25 @@ T{
.BR libsimple_strncaseeqnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncaseeq (3),
.BR libsimple_strneqnul (3),
diff --git a/man3/libsimple_strncasestarts.3 b/man3/libsimple_strncasestarts.3
index b1efd80..9cd63dd 100644
--- a/man3/libsimple_strncasestarts.3
+++ b/man3/libsimple_strncasestarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASESTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASESTARTS 3 libsimple
.SH NAME
libsimple_strncasestarts \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strncasestarts(const char *\fIs\fP, const char *\fIt\fP, size_t \f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasestarts ()
@@ -26,6 +28,7 @@ starts with the string
.IR t .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasestarts ()
@@ -34,10 +37,12 @@ function returns 1 if the string
begins with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strncasestarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_strncasestarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnstarts (3),
.BR libsimple_strncaseends (3),
diff --git a/man3/libsimple_strncasestr.3 b/man3/libsimple_strncasestr.3
index 0235f7c..1a49c83 100644
--- a/man3/libsimple_strncasestr.3
+++ b/man3/libsimple_strncasestr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCASESTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCASESTR 3 libsimple
.SH NAME
libsimple_strncasestr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strncasestr(const char *\fIhaystack\fP, const char *\fIneedle\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncasestr ()
@@ -26,6 +28,7 @@ the first occurrence of the substring
.IR needle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncasestr ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strncasestr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_strncasestr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrncasestr (3),
.BR libsimple_strnstr (3),
diff --git a/man3/libsimple_strnchr.3 b/man3/libsimple_strnchr.3
index bdb2787..533c417 100644
--- a/man3/libsimple_strnchr.3
+++ b/man3/libsimple_strnchr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCHR 3 libsimple
.SH NAME
libsimple_strnchr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strnchr(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnchr ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnchr ()
@@ -44,10 +47,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strnchr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strnchr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnchr_inv (3),
.BR libsimple_strnchrnul (3),
diff --git a/man3/libsimple_strnchr_inv.3 b/man3/libsimple_strnchr_inv.3
index 594021f..8331f63 100644
--- a/man3/libsimple_strnchr_inv.3
+++ b/man3/libsimple_strnchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNCHR_INV 3 libsimple
.SH NAME
libsimple_strnchr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strnchr_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnchr_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnchr_inv ()
@@ -45,10 +48,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strnchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strnchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnchr (3),
.BR libsimple_strnchrnul_inv (3),
diff --git a/man3/libsimple_strnchrnul.3 b/man3/libsimple_strnchrnul.3
index b0c328e..bc16d4b 100644
--- a/man3/libsimple_strnchrnul.3
+++ b/man3/libsimple_strnchrnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCHRNUL 3 2018-10-21 libsimple
+.TH LIBSIMPLE_STRNCHRNUL 3 libsimple
.SH NAME
libsimple_strnchrnul \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strnchrnul(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnchrnul ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnchrnul ()
@@ -45,10 +48,12 @@ offset less than
exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strnchrnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strnchrnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None. I promise!
+
.SH SEE ALSO
.BR libsimple_strnchrnul_inv (3),
.BR libsimple_strncasechrnul (3),
diff --git a/man3/libsimple_strnchrnul_inv.3 b/man3/libsimple_strnchrnul_inv.3
index d11a7df..fb7083a 100644
--- a/man3/libsimple_strnchrnul_inv.3
+++ b/man3/libsimple_strnchrnul_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCHRNUL_INV 3 2018-11-24 libsimple
+.TH LIBSIMPLE_STRNCHRNUL_INV 3 libsimple
.SH NAME
libsimple_strnchrnul_inv \- skip a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strnchrnul_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP)
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnchrnul_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnchrnul_inv ()
@@ -46,10 +49,12 @@ offset less than
exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strnchrnul_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -68,18 +73,25 @@ T{
.BR libsimple_strnchrnul_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None. I promise!
+
.SH SEE ALSO
.BR libsimple_strnchrnul (3),
.BR libsimple_strncasechrnul_inv (3),
diff --git a/man3/libsimple_strncmove.3 b/man3/libsimple_strncmove.3
index c944372..0f33ad9 100644
--- a/man3/libsimple_strncmove.3
+++ b/man3/libsimple_strncmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCMOVE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNCMOVE 3 libsimple
.SH NAME
libsimple_strncmove, libsimple_strnccpy \- copy or move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline char *libsimple_strnccpy(char *restrict \fIdest\fP, const char *re
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncmove ()
@@ -46,6 +48,7 @@ function but not in the
function.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strncmove ()
@@ -61,12 +64,14 @@ after it was copied, if the character
was not copied
.I NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strncmove ()
and
.BR libsimple_strnccpy ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -91,18 +96,25 @@ T{
.BR libsimple_strnccpy ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnmove (3),
.BR libsimple_stpnmove (3),
diff --git a/man3/libsimple_strncmpnul.3 b/man3/libsimple_strncmpnul.3
index f53dc8c..d6a6cbe 100644
--- a/man3/libsimple_strncmpnul.3
+++ b/man3/libsimple_strncmpnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNCMPNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNCMPNUL 3 libsimple
.SH NAME
libsimple_strncmpnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strncmpnul(const char *\fIa\fP, const char *\fIb\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strncmpnul ()
@@ -38,6 +40,7 @@ greater than the shorter string.
The comparison is case-sensitive and made as if
the strings were
.BR "unsigned char *" s.
+
.SH RETURN VALUE
The
.BR libsimple_strncmpnul ()
@@ -50,10 +53,12 @@ a positive value if
is greater than
.IR b ,
and 0 otherwise.
+
.SH ERRORS
The
.BR libsimple_strncmpnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -72,18 +77,25 @@ T{
.BR libsimple_strncmpnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasecmpnul (3),
.BR libsimple_strneqnul (3),
diff --git a/man3/libsimple_strnend.3 b/man3/libsimple_strnend.3
index 26ed564..c3d918d 100644
--- a/man3/libsimple_strnend.3
+++ b/man3/libsimple_strnend.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNEND 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNEND 3 libsimple
.SH NAME
libsimple_strnend \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline char *libsimple_strnend(const char *\fIs\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnend ()
@@ -23,6 +25,7 @@ truncated to
.I n
bytes unless it is shorter,
for its end.
+
.SH RETURN VALUE
The
.BR libsimple_strnend ()
@@ -38,10 +41,12 @@ if no such offset less than
exists,
.I &s[n]
is returned.
+
.SH ERRORS
The
.BR libsimple_strnend ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strnend ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnchrnul (3),
.BR libsimple_strnchr (3),
diff --git a/man3/libsimple_strnends.3 b/man3/libsimple_strnends.3
index a733b6b..e7ce864 100644
--- a/man3/libsimple_strnends.3
+++ b/man3/libsimple_strnends.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNENDS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNENDS 3 libsimple
.SH NAME
libsimple_strnends \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strnends(const char *\fIs\fP, const char *\fIt\fP, size_t \fIn\fP)
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnends ()
@@ -26,6 +28,7 @@ ends with the string
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnends ()
@@ -34,10 +37,12 @@ function returns 1 if the string
ends with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strnends ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_strnends ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncaseends (3),
.BR libsimple_strnstarts (3),
diff --git a/man3/libsimple_strneq.3 b/man3/libsimple_strneq.3
index a315870..43f2442 100644
--- a/man3/libsimple_strneq.3
+++ b/man3/libsimple_strneq.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNEQ 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNEQ 3 libsimple
.SH NAME
libsimple_strneq \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strneq(const char *\fIa\fP, const char *\fIb\fP, siz
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strneq ()
@@ -31,15 +33,18 @@ neither of which may be
.BR NULL .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strneq ()
function returns 1 if the strings are equals,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strneq ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_strneq ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strneqnul (3),
.BR libsimple_strncaseeq (3),
diff --git a/man3/libsimple_strneqlen.3 b/man3/libsimple_strneqlen.3
index df01480..093d6fa 100644
--- a/man3/libsimple_strneqlen.3
+++ b/man3/libsimple_strneqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNEQLEN 3 libsimple
.SH NAME
libsimple_strneqlen \- check initial commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ size_t libsimple_strneqlen(const char *\fIa\fP, const char *\fIb\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strneqlen ()
@@ -30,6 +32,7 @@ bytes unless it is shorter,
at their beginnings.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strneqlen ()
@@ -40,10 +43,12 @@ and
(both truncated to
.I n
bytes) have in common at their beginnings.
+
.SH ERRORS
The
.BR libsimple_strneqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strneqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_streq (3),
.BR libsimple_strreqlen (3),
diff --git a/man3/libsimple_strneqnul.3 b/man3/libsimple_strneqnul.3
index 610844b..b3de167 100644
--- a/man3/libsimple_strneqnul.3
+++ b/man3/libsimple_strneqnul.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNEQNUL 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNEQNUL 3 libsimple
.SH NAME
libsimple_strneqnul \- compare two strings
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline int libsimple_strneqnul(const char *\fIa\fP, const char *\fIb\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strneqnul ()
@@ -31,15 +33,18 @@ both of which may be
.BR NULL .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strneqnul ()
function returns 1 if the strings are equals,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strneqnul ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -58,18 +63,25 @@ T{
.BR libsimple_strneqnul ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strneq (3),
.BR libsimple_strncaseeqnul (3),
diff --git a/man3/libsimple_strnmove.3 b/man3/libsimple_strnmove.3
index 593a5cb..38c58f6 100644
--- a/man3/libsimple_strnmove.3
+++ b/man3/libsimple_strnmove.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNMOVE 3 2018-11-16 libsimple
+.TH LIBSIMPLE_STRNMOVE 3 libsimple
.SH NAME
libsimple_strnmove \- move a string within an array of bytes
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline void *libsimple_strnmove(void *\fIdest\fP, const void *\fIsrc\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnmove ()
@@ -25,15 +27,18 @@ NUL byte that terminates it (if any),
into
.IR dest .
The arrays may overlap.
+
.SH RETURN VALUE
The
.BR libsimple_strnmove ()
function returns the pointer
.IR dest .
+
.SH ERRORS
The
.BR libsimple_strnmove ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -52,18 +57,25 @@ T{
.BR libsimple_strnmove ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_stpnmove (3),
.BR libsimple_strmove (3),
diff --git a/man3/libsimple_strnreplace.3 b/man3/libsimple_strnreplace.3
index ef2a4fe..fc8718c 100644
--- a/man3/libsimple_strnreplace.3
+++ b/man3/libsimple_strnreplace.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNREPLACE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNREPLACE 3 libsimple
.SH NAME
libsimple_strnreplace \- replace characters in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline char *libsimple_strnreplace(char *\fIs\fP, int \fIold\fP, int \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnreplace ()
@@ -32,6 +34,7 @@ character (up the last character
is shorter).
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnreplace ()
@@ -40,10 +43,12 @@ function returns the end of
that is
.I &s[strnlen(s,n)]
(as evaluated before the function call).
+
.SH ERRORS
The
.BR libsimple_strnreplace ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strnreplace ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strntolower (3),
.BR libsimple_strntoupper (3),
diff --git a/man3/libsimple_strnset.3 b/man3/libsimple_strnset.3
index 3807917..1a9ce21 100644
--- a/man3/libsimple_strnset.3
+++ b/man3/libsimple_strnset.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNSET 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNSET 3 libsimple
.SH NAME
libsimple_strnset, libsimple_stpnset \- fill a string with a character
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline char *libsimple_stpnset(char *\fIs\fP, int \fIc\fP, size_t \fIn\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnset ()
@@ -31,6 +33,7 @@ characters in the string
.I s
is shorter) with the character
.IR c .
+
.SH RETURN VALUE
The
.BR libsimple_strnset ()
@@ -43,12 +46,14 @@ function returns the end of
(that is
.IR &s[strnlen(s,n)] ,
as evaluated before the function call.
+
.SH ERRORS
The
.BR libsimple_strnset ()
and
.BR libsimple_stpnset ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -73,18 +78,25 @@ T{
.BR libsimple_stpnset ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strset (3),
.BR libsimple_mempset (3),
diff --git a/man3/libsimple_strnstarts.3 b/man3/libsimple_strnstarts.3
index 4f084ea..108afd1 100644
--- a/man3/libsimple_strnstarts.3
+++ b/man3/libsimple_strnstarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNSTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNSTARTS 3 libsimple
.SH NAME
libsimple_strnstarts \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strnstarts(const char *\fIs\fP, const char *\fIt\fP, size_t \fIn\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnstarts ()
@@ -26,6 +28,7 @@ starts with the string
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnstarts ()
@@ -34,10 +37,12 @@ function returns 1 if the string
begins with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strnstarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -56,18 +61,25 @@ T{
.BR libsimple_strnstarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strncasestarts (3),
.BR libsimple_strnends (3),
diff --git a/man3/libsimple_strnstr.3 b/man3/libsimple_strnstr.3
index dca50bb..d2c9825 100644
--- a/man3/libsimple_strnstr.3
+++ b/man3/libsimple_strnstr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNSTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRNSTR 3 libsimple
.SH NAME
libsimple_strnstr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strnstr(const char *\fIhaystack\fP, const char *\fIneedle\fP, si
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strnstr ()
@@ -26,6 +28,7 @@ the first occurrence of the substring
.IR needle .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strnstr ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strnstr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_strnstr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrnstr (3),
.BR libsimple_strncasestr (3)
diff --git a/man3/libsimple_strntolower.3 b/man3/libsimple_strntolower.3
index 805adf4..8c0f41c 100644
--- a/man3/libsimple_strntolower.3
+++ b/man3/libsimple_strntolower.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNTOLOWER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNTOLOWER 3 libsimple
.SH NAME
libsimple_strntolower, libsimple_stpntolower \- convert a string to lower case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ char *libsimple_stpntolower(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strntolower ()
@@ -35,6 +37,7 @@ lower case; however no more than
bytes will be copied or coverted. The arrays may overlap,
and there is an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_strntolower ()
@@ -48,12 +51,14 @@ end of the string copied into
.IR dest ,
that is
.IR &dest[strnlen(src,n)] .
+
.SH ERRORS
The
.BR libsimple_strntolower ()
and
.BR libsimple_stpntolower ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -78,18 +83,25 @@ T{
.BR libsimple_stpntolower ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strntoupper (3),
.BR libsimple_strnreplace (3),
diff --git a/man3/libsimple_strntoupper.3 b/man3/libsimple_strntoupper.3
index f045291..abb3408 100644
--- a/man3/libsimple_strntoupper.3
+++ b/man3/libsimple_strntoupper.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRNTOUPPER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRNTOUPPER 3 libsimple
.SH NAME
libsimple_strntoupper, libsimple_stpntoupper \- convert a string to upper case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ char *libsimple_stpntoupper(char *\fIdest\fP, const char *\fIsrc\fP, size_t \fIn
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strntoupper ()
@@ -35,6 +37,7 @@ upper case; however no more than
bytes will be copied or coverted. The arrays may overlap,
and there is an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_strntoupper ()
@@ -48,12 +51,14 @@ end of the string copied into
.IR dest ,
that is
.IR &dest[strnlen(src,n)] .
+
.SH ERRORS
The
.BR libsimple_strntoupper ()
and
.BR libsimple_stpntoupper ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -78,18 +83,25 @@ T{
.BR libsimple_stpntoupper ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strntolower (3),
.BR libsimple_strnreplace (3),
diff --git a/man3/libsimple_strrcasechr.3 b/man3/libsimple_strrcasechr.3
index 62ff883..84e5f7e 100644
--- a/man3/libsimple_strrcasechr.3
+++ b/man3/libsimple_strrcasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRCASECHR 3 libsimple
.SH NAME
libsimple_strrcasechr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrcasechr(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrcasechr ()
@@ -27,6 +29,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrcasechr ()
@@ -39,10 +42,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrcasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -61,18 +66,25 @@ T{
.BR libsimple_strrcasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrcasechr_inv (3),
.BR libsimple_strcasechr (3),
diff --git a/man3/libsimple_strrcasechr_inv.3 b/man3/libsimple_strrcasechr_inv.3
index 66f9df4..47581c7 100644
--- a/man3/libsimple_strrcasechr_inv.3
+++ b/man3/libsimple_strrcasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRCASECHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRRCASECHR_INV 3 libsimple
.SH NAME
libsimple_strrcasechr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrcasechr_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrcasechr_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrcasechr_inv ()
@@ -40,10 +43,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrcasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strrcasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrcasechr (3),
.BR libsimple_strrchr_inv (3),
diff --git a/man3/libsimple_strrcaseeqlen.3 b/man3/libsimple_strrcaseeqlen.3
index 551debe..714c65a 100644
--- a/man3/libsimple_strrcaseeqlen.3
+++ b/man3/libsimple_strrcaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRCASEEQLEN 3 libsimple
.SH NAME
libsimple_strrcaseeqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline size_t libsimple_strrcaseeqlen(const char *\fIa\fP, const char *\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrcaseeqlen ()
@@ -24,6 +26,7 @@ have in common the string
at their ends.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrcaseeqlen ()
@@ -32,10 +35,12 @@ function returns the number of bytes
and
.I b
have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_strrcaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_strrcaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strreqlen (3),
.BR libsimple_strcaseeqlen (3),
diff --git a/man3/libsimple_strrcasestr.3 b/man3/libsimple_strrcasestr.3
index a2844b5..44585b1 100644
--- a/man3/libsimple_strrcasestr.3
+++ b/man3/libsimple_strrcasestr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRCASESTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRCASESTR 3 libsimple
.SH NAME
libsimple_strrcasestr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrcasestr(const char *\fIhaystack\fP, const char *\fIneedle\fP
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrcasestr ()
@@ -23,6 +25,7 @@ the last occurrence of the substring
.IR needle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrcasestr ()
@@ -38,10 +41,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strrcasestr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strrcasestr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrstr (3),
.BR libsimple_strcasestr (3),
diff --git a/man3/libsimple_strrchr_inv.3 b/man3/libsimple_strrchr_inv.3
index 71059fa..8864e83 100644
--- a/man3/libsimple_strrchr_inv.3
+++ b/man3/libsimple_strrchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRCHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRRCHR_INV 3 libsimple
.SH NAME
libsimple_strrchr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrchr_inv(const char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrchr_inv ()
@@ -28,6 +30,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrchr_inv ()
@@ -40,10 +43,12 @@ where
is the returned pointer, if no such
offset exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strrchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrchr (3),
.BR libsimple_strrcasechr_inv (3),
diff --git a/man3/libsimple_strreplace.3 b/man3/libsimple_strreplace.3
index 96d20e0..0cdedd8 100644
--- a/man3/libsimple_strreplace.3
+++ b/man3/libsimple_strreplace.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRREPLACE 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRREPLACE 3 libsimple
.SH NAME
libsimple_strreplace \- replace characters in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline char *libsimple_strreplace(char *\fIs\fP, int \fIold\fP, int \fIne
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strreplace ()
@@ -27,6 +29,7 @@ with the character
.IR new .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strreplace ()
@@ -35,10 +38,12 @@ function returns the end of
that is
.I &s[strlen(s)]
(as evaluated before the function call).
+
.SH ERRORS
The
.BR libsimple_strreplace ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -57,18 +62,25 @@ T{
.BR libsimple_strreplace ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strtolower (3),
.BR libsimple_strtoupper (3),
diff --git a/man3/libsimple_strreqlen.3 b/man3/libsimple_strreqlen.3
index 3fa4105..16c785e 100644
--- a/man3/libsimple_strreqlen.3
+++ b/man3/libsimple_strreqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRREQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRREQLEN 3 libsimple
.SH NAME
libsimple_strreqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline size_t libsimple_strreqlen(const char *\fIa\fP, const char *\fIb\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strreqlen ()
@@ -24,6 +26,7 @@ have in common the string
at their ends.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strreqlen ()
@@ -32,10 +35,12 @@ function returns the number of bytes
and
.I b
have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_strreqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -54,18 +59,25 @@ T{
.BR libsimple_strreqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strreqlen (3),
.BR libsimple_streqlen (3),
diff --git a/man3/libsimple_strrncasechr.3 b/man3/libsimple_strrncasechr.3
index 7e3ae4e..0a8450d 100644
--- a/man3/libsimple_strrncasechr.3
+++ b/man3/libsimple_strrncasechr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCASECHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNCASECHR 3 libsimple
.SH NAME
libsimple_strrncasechr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrncasechr(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrncasechr ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrncasechr ()
@@ -44,10 +47,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrncasechr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strrncasechr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrncasechr_inv (3),
.BR libsimple_strncasechr (3),
diff --git a/man3/libsimple_strrncasechr_inv.3 b/man3/libsimple_strrncasechr_inv.3
index 40426d6..7666cb3 100644
--- a/man3/libsimple_strrncasechr_inv.3
+++ b/man3/libsimple_strrncasechr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCASECHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRRNCASECHR_INV 3 libsimple
.SH NAME
libsimple_strrncasechr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrncasechr_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrncasechr_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrncasechr_inv ()
@@ -45,10 +48,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrncasechr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strrncasechr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrncasechr (3),
.BR libsimple_strncasechr_inv (3),
diff --git a/man3/libsimple_strrncaseeqlen.3 b/man3/libsimple_strrncaseeqlen.3
index d938154..0d245f0 100644
--- a/man3/libsimple_strrncaseeqlen.3
+++ b/man3/libsimple_strrncaseeqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCASEEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNCASEEQLEN 3 libsimple
.SH NAME
libsimple_strrncaseeqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline size_t libsimple_strrncaseeqlen(const char *\fIa\fP, const char *\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrncaseeqlen ()
@@ -30,6 +32,7 @@ bytes unless it is shorter,
at their ends.
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrncaseeqlen ()
@@ -40,10 +43,12 @@ and
(both truncated to
.I n
bytes) have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_strrncaseeqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strrncaseeqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrneqlen (3),
.BR libsimple_strncaseeqlen (3),
diff --git a/man3/libsimple_strrncasestr.3 b/man3/libsimple_strrncasestr.3
index dcf48b5..f06cb20 100644
--- a/man3/libsimple_strrncasestr.3
+++ b/man3/libsimple_strrncasestr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCASESTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNCASESTR 3 libsimple
.SH NAME
libsimple_strrncasestr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrncasestr(const char *\fIhaystack\fP, const char *\fIneedle\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrncasestr ()
@@ -26,6 +28,7 @@ the last occurrence of the substring
.IR needle .
.PP
The comparison is case-insensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrncasestr ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strrncasestr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_strrncasestr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrnstr (3),
.BR libsimple_strncasestr (3),
diff --git a/man3/libsimple_strrnchr.3 b/man3/libsimple_strrnchr.3
index a677bfe..fedb688 100644
--- a/man3/libsimple_strrnchr.3
+++ b/man3/libsimple_strrnchr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCHR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNCHR 3 libsimple
.SH NAME
libsimple_strrnchr \- find a character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrnchr(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrnchr ()
@@ -30,6 +32,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrnchr ()
@@ -44,10 +47,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrnchr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -66,18 +71,25 @@ T{
.BR libsimple_strrnchr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrnchr_inv (3),
.BR libsimple_strrncasechr (3),
diff --git a/man3/libsimple_strrnchr_inv.3 b/man3/libsimple_strrnchr_inv.3
index 3cfdac9..1f47baa 100644
--- a/man3/libsimple_strrnchr_inv.3
+++ b/man3/libsimple_strrnchr_inv.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNCHR_INV 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRRNCHR_INV 3 libsimple
.SH NAME
libsimple_strrnchr_inv \- find a different character in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrnchr_inv(const char *\fIs\fP, int \fIc\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrnchr_inv ()
@@ -31,6 +33,7 @@ If no such character exist in the string,
the string's end is returned.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrnchr_inv ()
@@ -45,10 +48,12 @@ offset less than
.I n
exists, it returns
.BR NULL .
+
.SH ERRORS
The
.BR libsimple_strrnchr_inv ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_strrnchr_inv ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrnchr (3),
.BR libsimple_strrncasechr_inv (3),
diff --git a/man3/libsimple_strrneqlen.3 b/man3/libsimple_strrneqlen.3
index 6828fa0..eced333 100644
--- a/man3/libsimple_strrneqlen.3
+++ b/man3/libsimple_strrneqlen.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNEQLEN 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNEQLEN 3 libsimple
.SH NAME
libsimple_strrneqlen \- check terminal commonality
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ static inline size_t libsimple_strrneqlen(const char *\fIa\fP, const char *\fIb\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrneqlen ()
@@ -30,6 +32,7 @@ bytes unless it is shorter,
at their ends.
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrneqlen ()
@@ -40,10 +43,12 @@ and
(both truncated to
.I n
bytes) have in common at their ends.
+
.SH ERRORS
The
.BR libsimple_strrneqlen ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -62,18 +67,25 @@ T{
.BR libsimple_strrneqlen ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrneqlen (3),
.BR libsimple_strneqlen (3),
diff --git a/man3/libsimple_strrnstr.3 b/man3/libsimple_strrnstr.3
index 9e95196..6bd1ae8 100644
--- a/man3/libsimple_strrnstr.3
+++ b/man3/libsimple_strrnstr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRNSTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRNSTR 3 libsimple
.SH NAME
libsimple_strrnstr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrnstr(const char *\fIhaystack\fP, const char *\fIneedle\fP, s
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrnstr ()
@@ -26,6 +28,7 @@ the last occurrence of the substring
.IR needle .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrnstr ()
@@ -41,10 +44,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strrnstr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -63,18 +68,25 @@ T{
.BR libsimple_strrnstr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrncasestr (3),
.BR libsimple_strnstr (3),
diff --git a/man3/libsimple_strrstr.3 b/man3/libsimple_strrstr.3
index c3c16b7..19d5d98 100644
--- a/man3/libsimple_strrstr.3
+++ b/man3/libsimple_strrstr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRRSTR 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRRSTR 3 libsimple
.SH NAME
libsimple_strrstr \- find a substring in a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ char *libsimple_strrstr(const char *\fIhaystack\fP, const char *\fIneedle\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strrstr ()
@@ -23,6 +25,7 @@ the last occurrence of the substring
.IR needle .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strrstr ()
@@ -38,10 +41,12 @@ is the returned pointer.
If no such offset exists,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_strrstr ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -60,18 +65,25 @@ T{
.BR libsimple_strrstr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strrcasestr (3),
.BR libsimple_strrnstr (3),
diff --git a/man3/libsimple_strset.3 b/man3/libsimple_strset.3
index d504edf..6ed9ff4 100644
--- a/man3/libsimple_strset.3
+++ b/man3/libsimple_strset.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRSET 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRSET 3 libsimple
.SH NAME
libsimple_strset, libsimple_stpset \- fill a string with a character
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline char *libsimple_stpset(char *\fIs\fP, int \fIc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strset ()
@@ -27,6 +29,7 @@ functions replace all characters in the string
.I s
with the character
.IR c .
+
.SH RETURN VALUE
The
.BR libsimple_strset ()
@@ -39,12 +42,14 @@ function returns the end of
(that is
.IR &s[strlen(s)] ,
as evaluated before the function call.
+
.SH ERRORS
The
.BR libsimple_strset ()
and
.BR libsimple_stpset ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -69,18 +74,25 @@ T{
.BR libsimple_stpset ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strnset (3),
.BR libsimple_mempset (3),
diff --git a/man3/libsimple_strstarts.3 b/man3/libsimple_strstarts.3
index fbd3412..0daf04e 100644
--- a/man3/libsimple_strstarts.3
+++ b/man3/libsimple_strstarts.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRSTARTS 3 2018-10-23 libsimple
+.TH LIBSIMPLE_STRSTARTS 3 libsimple
.SH NAME
libsimple_strstarts \- check the beginning of a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -14,6 +15,7 @@ int libsimple_strstarts(const char *\fIs\fP, const char *\fIt\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strstarts ()
@@ -23,6 +25,7 @@ starts with the string
.IR t .
.PP
The comparison is case-sensitive.
+
.SH RETURN VALUE
The
.BR libsimple_strstarts ()
@@ -31,10 +34,12 @@ function returns 1 if the string
begins with the string
.IR t ,
otherwise it returns 0.
+
.SH ERRORS
The
.BR libsimple_strstarts ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -53,18 +58,25 @@ T{
.BR libsimple_strstarts ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strcasestarts (3),
.BR libsimple_strends (3),
diff --git a/man3/libsimple_strtolower.3 b/man3/libsimple_strtolower.3
index 385de39..8075dde 100644
--- a/man3/libsimple_strtolower.3
+++ b/man3/libsimple_strtolower.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRTOLOWER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRTOLOWER 3 libsimple
.SH NAME
libsimple_strtolower, libsimple_stptolower \- convert a string to lower case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ char *libsimple_stptolower(char *\fIdest\fP, const char *\fIsrc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strtolower ()
@@ -33,6 +35,7 @@ with all upper case ASCII characters converted to
lower case. The arrays may overlap, and there is
an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_strtolower ()
@@ -46,12 +49,14 @@ end of the string copied into
.IR dest ,
that is
.IR &dest[strlen(src)] .
+
.SH ERRORS
The
.BR libsimple_strtolower ()
and
.BR libsimple_stptolower ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -76,18 +81,25 @@ T{
.BR libsimple_stptolower ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strtoupper (3),
.BR libsimple_strreplace (3),
diff --git a/man3/libsimple_strtotimespec.3 b/man3/libsimple_strtotimespec.3
index 85ff88b..b6d4a71 100644
--- a/man3/libsimple_strtotimespec.3
+++ b/man3/libsimple_strtotimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRTOTIMESPEC 3 2018-10-31 libsimple
+.TH LIBSIMPLE_STRTOTIMESPEC 3 libsimple
.SH NAME
libsimple_strtotimespec, libsimple_strtotimeval \- convert a string to a duration data structure
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ int libsimple_strtotimeval(struct timeval *restrict \fItv\fP, const char *\fIs\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strtotimespec ()
@@ -50,6 +52,7 @@ where the digits in
.BR \e2 ,
if any, are repeating decimals and must contain atleast
one digit if it is included.
+
.SH RETURN VALUE
The
.BR libsimple_strtotimespec ()
@@ -57,6 +60,7 @@ and
.BR libsimple_strtotimeval ()
functions return 0 upon successful completion;
otherwise \-1 is returned.
+
.SH ERRORS
The
.BR libsimple_strtotimespec ()
@@ -86,6 +90,7 @@ and
(if the result is too small).
.I *end
will be set.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -110,18 +115,25 @@ T{
.BR libsimple_strtotimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_strtoupper.3 b/man3/libsimple_strtoupper.3
index cc1de4f..10333e5 100644
--- a/man3/libsimple_strtoupper.3
+++ b/man3/libsimple_strtoupper.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_STRTOUPPER 3 2018-11-25 libsimple
+.TH LIBSIMPLE_STRTOUPPER 3 libsimple
.SH NAME
libsimple_strtoupper, libsimple_stptoupper \- convert a string to upper case
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ char *libsimple_stptoupper(char *\fIdest\fP, const char *\fIsrc\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_strtoupper ()
@@ -33,6 +35,7 @@ with all lower case ASCII characters converted to
upper case. The arrays may overlap, and there is
an optimisation for the case where
.IR dest==src .
+
.SH RETURN VALUE
The
.BR libsimple_strtoupper ()
@@ -46,12 +49,14 @@ end of the string copied into
.IR dest ,
that is
.IR &dest[strlen(src)] .
+
.SH ERRORS
The
.BR libsimple_strtoupper ()
and
.BR libsimple_stptoupper ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -76,18 +81,25 @@ T{
.BR libsimple_stptoupper ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_strtolower (3),
.BR libsimple_strreplace (3),
diff --git a/man3/libsimple_sumtimespec.3 b/man3/libsimple_sumtimespec.3
index 7d587e0..f5b9af3 100644
--- a/man3/libsimple_sumtimespec.3
+++ b/man3/libsimple_sumtimespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_SUMTIMESPEC 3 2018-10-29 libsimple
+.TH LIBSIMPLE_SUMTIMESPEC 3 libsimple
.SH NAME
libsimple_sumtimespec, libsimple_sumtimeval \- calculate the sum of two durations
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ int libsimple_sumtimeval(struct timeval *\fIsum\fP, const struct timeval *\fIaug
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_sumtimespec ()
@@ -29,6 +31,7 @@ and
.I addend
and stores the result in
.IR sum .
+
.SH RETURN VALUE
The
.BR libsimple_sumtimespec ()
@@ -47,6 +50,7 @@ are in thier valid range ([0, 1000000000) for
.BR libsimple_sumtimespec ()
and [0, 1000000) for
.BR libsimple_sumtimeval ()).
+
.SH ERRORS
The
.BR libsimple_sumtimespec ()
@@ -77,6 +81,7 @@ function and to
for the
.BR libsimple_sumtimeval ()
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -101,18 +106,25 @@ T{
.BR libsimple_sumtimeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_difftimespec (3),
.BR libsimple_multimespec (3),
diff --git a/man3/libsimple_timespectodouble.3 b/man3/libsimple_timespectodouble.3
index fddc899..4413f8f 100644
--- a/man3/libsimple_timespectodouble.3
+++ b/man3/libsimple_timespectodouble.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_TIMESPECTODOUBLE 3 2018-10-30 libsimple
+.TH LIBSIMPLE_TIMESPECTODOUBLE 3 libsimple
.SH NAME
libsimple_timespectodouble, libsimple_timevaltodouble \- convert a duration data structure to a double
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ static inline double libsimple_timevaltodouble(const struct timeval *\fItv\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_timespectodouble ()
@@ -30,6 +32,7 @@ and
respectively, to a
.B double
and return the result.
+
.SH RETURN VALUE
The
.BR libsimple_timespectodouble ()
@@ -37,12 +40,14 @@ and
.BR libsimple_timevaltodouble ()
functions return the input argument as a
.BR double .
+
.SH ERRORS
The
.BR libsimple_timespectodouble ()
and
.BR libsimple_timevaltodouble ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -67,18 +72,25 @@ T{
.BR libsimple_timevaltodouble ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_timespectostr.3 b/man3/libsimple_timespectostr.3
index d6e2b71..c1ce154 100644
--- a/man3/libsimple_timespectostr.3
+++ b/man3/libsimple_timespectostr.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_TIMESPECTOSTR 3 2018-10-30 libsimple
+.TH LIBSIMPLE_TIMESPECTOSTR 3 libsimple
.SH NAME
libsimple_timespectostr, libsimple_timevaltostr \- convert a duration data structure to a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ char *libsimple_timevaltostr(char *restrict \fIbuf\fP, const struct timeval *res
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_timespectostr ()
@@ -59,6 +61,7 @@ and will always contain 9 (for the
function) or 6 (for the
.BR libsimple_timevaltostr ()
function) decimals.
+
.SH RETURN VALUE
The
.BR libsimple_timespectostr ()
@@ -77,6 +80,7 @@ pointer, otherwise the pointer
is returned. On failure,
.B NULL
is returned.
+
.SH ERRORS
The
.BR libsimple_timespectostr ()
@@ -97,6 +101,7 @@ failed because it could not allocate enough memory.
is negative or greater than 999\ 999\ 999, or
.I tv->tv_usec
is negative or greater than 999\ 999.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -121,18 +126,25 @@ T{
.BR libsimple_timevaltostr ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_minimise_number_string (3),
.BR libsimple_sumtimespec (3),
diff --git a/man3/libsimple_timeval2timespec.3 b/man3/libsimple_timeval2timespec.3
index d4381ce..f6dcf90 100644
--- a/man3/libsimple_timeval2timespec.3
+++ b/man3/libsimple_timeval2timespec.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_TIMEVAL2TIMESPEC 3 2018-10-30 libsimple
+.TH LIBSIMPLE_TIMEVAL2TIMESPEC 3 libsimple
.SH NAME
libsimple_timeval2timespec, libsimple_timespec2timeval \- convert between timespec and timeval
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ int libsimple_timespec2timeval(struct timeval *restrict \fItv\fP, const struct t
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_timeval2timespec ()
@@ -37,6 +39,7 @@ to a
rounding to nearest microsecond,
and stores the result in
.IR tv .
+
.SH RETURN VALUE
The
.BR libsimple_timespec2timeval ()
@@ -48,6 +51,7 @@ to indicate the error.
The
.BR libsimple_timeval2timespec ()
function does not return a value.
+
.SH ERRORS
The
.BR libsimple_timespec2timeval ()
@@ -65,6 +69,7 @@ will be stored in
The
.BR libsimple_timeval2timespec ()
function cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -89,18 +94,25 @@ T{
.BR libsimple_timespec2timeval ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_sumtimespec (3),
.BR libsimple_difftimespec (3),
diff --git a/man3/libsimple_unlist.3 b/man3/libsimple_unlist.3
index 5be3858..d3c2df1 100644
--- a/man3/libsimple_unlist.3
+++ b/man3/libsimple_unlist.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_UNLIST 3 2018-11-05 libsimple
+.TH LIBSIMPLE_UNLIST 3 libsimple
.SH NAME
libsimple_unlist \- remove item for array and keep order
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -18,6 +19,7 @@ void LIBSIMPLE_UNLIST(\fItype\fP *\fIlist\fP, size_t \fIi\fP, size_t *\fInp\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_unlist ()
@@ -50,14 +52,17 @@ instead it is inferred from the type of
as such,
.I type
must be a complete, non-void type.
+
.SH RETURN VALUE
None.
+
.SH ERRORS
The
.BR libsimple_unlist ()
and
.BR LIBSIMPLE_UNLIST ()
functions cannot fail.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -82,17 +87,24 @@ T{
.BR LIBSIMPLE_UNLIST ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR memmove (3)
diff --git a/man3/libsimple_valigned_allocn.3 b/man3/libsimple_valigned_allocn.3
index 2600571..ab93f30 100644
--- a/man3/libsimple_valigned_allocn.3
+++ b/man3/libsimple_valigned_allocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VALIGNED_ALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VALIGNED_ALLOCN 3 libsimple
.SH NAME
libsimple_valigned_allocn \- allocate memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ealigned_allocn(size_t \fIalignment\fP, size_t \fI
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_aligned_allocn (),
@@ -91,6 +93,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_valigned_allocn (),
@@ -116,6 +119,7 @@ it indicate the error, and the
and
.BR libsimple_ealigned_allocn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_valigned_allocn (),
@@ -145,6 +149,7 @@ The
and
.BR libsimple_ealigned_allocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -193,18 +198,25 @@ T{
.BR libsimple_ealigned_allocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -213,7 +225,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_valigned_alloczn.3 b/man3/libsimple_valigned_alloczn.3
index 9f68adb..c40979e 100644
--- a/man3/libsimple_valigned_alloczn.3
+++ b/man3/libsimple_valigned_alloczn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VALIGNED_ALLOCZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VALIGNED_ALLOCZN 3 libsimple
.SH NAME
libsimple_valigned_alloczn \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ealigned_alloczn(int \fIclear\fP, size_t \fIalignm
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_aligned_alloczn (),
@@ -94,6 +96,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_valigned_alloczn (),
@@ -119,6 +122,7 @@ it indicate the error, and the
and
.BR libsimple_ealigned_alloczn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_valigned_alloczn (),
@@ -148,6 +152,7 @@ The
and
.BR libsimple_ealigned_alloczn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -196,18 +201,25 @@ T{
.BR libsimple_ealigned_alloczn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -216,7 +228,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_valigned_reallocfn.3 b/man3/libsimple_valigned_reallocfn.3
new file mode 100644
index 0000000..0acf175
--- /dev/null
+++ b/man3/libsimple_valigned_reallocfn.3
@@ -0,0 +1,189 @@
+.TH LIBSIMPLE_VALIGNED_REALLOCFN 3 libsimple
+.SH NAME
+libsimple_valigned_reallocfn \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_valigned_reallocfn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, va_list \fIap\fP);
+static inline void *libsimple_aligned_reallocfn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, ..., /* (size_t)0 */);
+
+#ifndef valigned_reallocfn
+# define valigned_reallocfn libsimple_valigned_reallocfn
+#endif
+#ifndef aligned_reallocfn
+# define aligned_reallocfn libsimple_aligned_reallocfn
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_reallocfn ()
+function reallocates memory allocated on the
+heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I N
+bytes, where
+.I N
+is the product of
+.I n
+and all following arguments (which should have the type
+.BR size_t )
+up to the first 0;
+.I n
+must not be 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I N
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is also deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_valigned_reallocfn ()
+function is a version of the
+.BR libsimple_aligned_reallocfn ()
+function that use
+.B va_list
+instead of variadic arguments.
+
+.SH RETURN VALUE
+The
+.BR libsimple_valigned_reallocfn ()
+and
+.BR libsimple_aligned_reallocfn (),
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_valigned_reallocfn ()
+and
+.BR libsimple_aligned_reallocfn ()
+functions return
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_vreallocn (),
+.BR libsimple_reallocn ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I n
+is 0.
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_valigned_reallocfn (),
+.br
+.BR libsimple_aligned_reallocfn ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_valigned_reallocfn (),
+.br
+.BR libsimple_aligned_reallocfn ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_valigned_reallocfn (),
+.br
+.BR libsimple_aligned_reallocfn ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_valigned_reallocn.3 b/man3/libsimple_valigned_reallocn.3
new file mode 100644
index 0000000..94baffb
--- /dev/null
+++ b/man3/libsimple_valigned_reallocn.3
@@ -0,0 +1,279 @@
+.TH LIBSIMPLE_VALIGNED_REALLOCN 3 libsimple
+.SH NAME
+libsimple_valigned_reallocn \- reallocate memory and customise alignment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+void *libsimple_valigned_reallocn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, va_list \fIap\fP);
+void *libsimple_envaligned_reallocn(int \fIstatus\fP, void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, va_list \fIap\fP);
+static inline void *libsimple_evaligned_reallocn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, va_list \fIap\fP);
+static inline void *libsimple_aligned_reallocn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, ..., /* (size_t)0 */);
+static inline void *libsimple_enaligned_reallocn(int \fIstatus\fP, void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, ..., /* (size_t)0 */);
+static inline void *libsimple_ealigned_reallocn(void *\fIptr\fP, size_t \fIalignment\fP, size_t \fIn\fP, ..., /* (size_t)0 */);
+
+#ifndef valigned_reallocn
+# define valigned_reallocn libsimple_valigned_reallocn
+#endif
+#ifndef envaligned_reallocn
+# define envaligned_reallocn libsimple_envaligned_reallocn
+#endif
+#ifndef evaligned_reallocn
+# define evaligned_reallocn libsimple_evaligned_reallocn
+#endif
+#ifndef aligned_reallocn
+# define aligned_reallocn libsimple_aligned_reallocn
+#endif
+#ifndef enaligned_reallocn
+# define enaligned_reallocn libsimple_enaligned_reallocn
+#endif
+#ifndef ealigned_reallocn
+# define ealigned_reallocn libsimple_ealigned_reallocn
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_aligned_reallocn (),
+.BR libsimple_enaligned_reallocn (),
+and
+.BR libsimple_ealigned_reallocn ()
+functions are wrappers for the
+.BR realloc (3)
+function, they reallocate memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignment
+to the allocated memory of
+.I N
+bytes, where
+.I N
+is the product of
+.I n
+and all following arguments (which should have the type
+.BR size_t )
+up to the first 0;
+.I n
+must not be 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I N
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is not deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_enaligned_reallocn ()
+and
+.BR libsimple_ealigned_reallocn ()
+functions will terminate the process if the memory
+cannot be allocated, by calling the
+.BR libsimple_enprintf ()
+and
+.BR libsimple_eprintf ()
+functions, respectively.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_enaligned_reallocn ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_ealigned_reallocn ()
+function is used.
+.PP
+The
+.BR libsimple_valigned_reallocn (),
+.BR libsimple_envaligned_reallocn (),
+and
+.BR libsimple_evaligned_reallocn ()
+functions are versions of the
+.BR libsimple_aligned_reallocn (),
+.BR libsimple_enaligned_reallocn (),
+and
+.BR libsimple_ealigned_reallocn (),
+respectively, that use
+.B va_list
+instead of variadic arguments.
+
+.SH RETURN VALUE
+The
+.BR libsimple_valigned_reallocn (),
+.BR libsimple_envaligned_reallocn (),
+.BR libsimple_evaligned_reallocn (),
+.BR libsimple_aligned_reallocn (),
+.BR libsimple_enaligned_reallocn (),
+and
+.BR libsimple_ealigned_reallocn ()
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_valigned_reallocn ()
+and
+.BR libsimple_aligned_reallocn ()
+functions return
+.B NULL
+and set
+.I errno
+it indicate the error, and the
+.BR libsimple_envaligned_reallocn (),
+.BR libsimple_evaligned_reallocn (),
+.BR libsimple_enaligned_reallocn (),
+and
+.BR libsimple_ealigned_reallocn ()
+functions terminated the process.
+
+.SH ERRORS
+The
+.BR libsimple_valigned_reallocn ()
+and
+.BR libsimple_aligned_reallocn ()
+functions will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I n
+is 0.
+.TP
+.B EINVAL
+.I alignment
+is an invalid alignment (usually it needs to be an power of 2).
+.TP
+.B ENOSYS
+The function is not implemented. The function requires
+non-standard libc functions, and is therefore not supported
+for all libc implementations.
+
+The function is implemented if and only if the macro
+.B LIBSIMPLE_HAVE_ALIGNED_REALLOC
+is defined by the library.
+.PP
+The
+.BR libsimple_envaligned_reallocn (),
+.BR libsimple_evaligned_reallocn (),
+.BR libsimple_enaligned_reallocn (),
+and
+.BR libsimple_ealigned_reallocn ()
+functions will terminate the process on failure.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_valigned_reallocn (),
+.br
+.BR libsimple_envaligned_reallocn (),
+.br
+.BR libsimple_evaligned_reallocn (),
+.br
+.BR libsimple_aligned_reallocn (),
+.br
+.BR libsimple_enaligned_reallocn (),
+.br
+.BR libsimple_ealigned_reallocn ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_valigned_reallocn (),
+.br
+.BR libsimple_envaligned_reallocn (),
+.br
+.BR libsimple_evaligned_reallocn (),
+.br
+.BR libsimple_aligned_reallocn (),
+.br
+.BR libsimple_enaligned_reallocn (),
+.br
+.BR libsimple_ealigned_reallocn ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_valigned_reallocn (),
+.br
+.BR libsimple_envaligned_reallocn (),
+.br
+.BR libsimple_evaligned_reallocn (),
+.br
+.BR libsimple_aligned_reallocn (),
+.br
+.BR libsimple_enaligned_reallocn (),
+.br
+.BR libsimple_ealigned_reallocn ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_valloc.3 b/man3/libsimple_valloc.3
index 84cce32..97e7b97 100644
--- a/man3/libsimple_valloc.3
+++ b/man3/libsimple_valloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VALLOC 3 libsimple
.SH NAME
libsimple_valloc \- allocate memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_evalloc(size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_valloc (),
@@ -59,6 +61,7 @@ function is used or
if the
.BR libsimple_evalloc ()
function is used.
+
.SH RETURN VALUE
The
.BR libsimple_valloc (),
@@ -77,6 +80,7 @@ it indicate the error, and the
and
.BR libsimple_evalloc ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_valloc ()
@@ -94,6 +98,7 @@ The
and
.BR libsimple_evalloc ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -124,14 +129,19 @@ T{
.BR libsimple_evalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
Portable applications shall assume that pointer
returned by the
@@ -145,8 +155,10 @@ is used explicitly.
The GNU implementation of
.BR valloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -155,7 +167,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vallocz.3 b/man3/libsimple_vallocz.3
index 3559a32..bc2f8b8 100644
--- a/man3/libsimple_vallocz.3
+++ b/man3/libsimple_vallocz.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VALLOCZ 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VALLOCZ 3 libsimple
.SH NAME
libsimple_vallocz \- allocate optionally initialised memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -22,6 +23,7 @@ static inline void *libsimple_evallocz(int \fIclear\fP, size_t \fIn\fP);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vallocz (),
@@ -68,6 +70,7 @@ and
functions behaviour is unspecified if
.I n
is 0.
+
.SH RETURN VALUE
The
.BR libsimple_vallocz (),
@@ -86,6 +89,7 @@ it indicate the error, and the
and
.BR libsimple_evallocz ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vallocz ()
@@ -103,6 +107,7 @@ The
and
.BR libsimple_evallocz ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -133,20 +138,27 @@ T{
.BR libsimple_evallocz ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR valloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -155,7 +167,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_varrayalloc.3 b/man3/libsimple_varrayalloc.3
index ceea9f1..d009b92 100644
--- a/man3/libsimple_varrayalloc.3
+++ b/man3/libsimple_varrayalloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VARRAYALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VARRAYALLOC 3 libsimple
.SH NAME
libsimple_varrayalloc \- allocate memory in a flexible manner
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -19,6 +20,7 @@ void *libsimple_earrayalloc(\fItype\fP, size_t \fIn\fP, ..., /* LIBSIMPLE_ARRAYA
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_varrayalloc (),
@@ -74,6 +76,7 @@ will be used as the alignment for the returned pointer.
*
The specified allocatio size will be multiplied by
.IR sizeof(type) .
+
.SH RETURN VALUE
The
.BR libsimple_varrayalloc (),
@@ -99,6 +102,7 @@ to indicate the error, whereas the
and
.BR libsimple_earrayalloc ()
functions terminate the process.
+
.SH ERRORS
The
.BR libsimple_varrayalloc ()
@@ -123,6 +127,7 @@ The
and
.BR libsimple_earrayalloc ()
functions terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -171,18 +176,25 @@ T{
.BR libsimple_earrayalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_vmemalloc (3),
.BR libsimple_enmalloc (3),
@@ -192,7 +204,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vasprintf.3 b/man3/libsimple_vasprintf.3
index e91c404..250e65f 100644
--- a/man3/libsimple_vasprintf.3
+++ b/man3/libsimple_vasprintf.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VASPRINTF 3 2018-11-04 libsimple
+.TH LIBSIMPLE_VASPRINTF 3 libsimple
.SH NAME
libsimple_vasprintf \- allocate and format a string
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -26,6 +27,7 @@ char *libsimple_asprintfa(const char *\fIfmt\fP, ...);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vasprintf ()
@@ -92,6 +94,7 @@ and
.BR libsimple_asprintfa ()
functions are implemented as macros and are only
available if compiling with GCC or Clang.
+
.SH RETURN VALUE
The
.BR libsimple_vasprintf ()
@@ -113,6 +116,7 @@ completion; otherwise
is returned and
.I errno
set to indicate the error.
+
.SH ERRORS
The
.BR libsimple_vasprintf (),
@@ -141,6 +145,7 @@ and
functions, the kernel will kill the thread with a
.B SIGSEGV
signal.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -177,18 +182,25 @@ T{
.BR libsimple_asprintfa ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_vweprintf (3),
.BR sprintf (3),
diff --git a/man3/libsimple_vcallocn.3 b/man3/libsimple_vcallocn.3
index 0d1c71d..449cfd6 100644
--- a/man3/libsimple_vcallocn.3
+++ b/man3/libsimple_vcallocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VCALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VCALLOCN 3 libsimple
.SH NAME
libsimple_vcallocn \- allocate memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ecallocn(size_t \fIn\fP, ..., /* (size_t)0 */);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_callocn (),
@@ -93,6 +95,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vcallocn (),
@@ -118,6 +121,7 @@ it indicate the error, and the
and
.BR libsimple_ecallocn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vcallocn (),
@@ -137,6 +141,7 @@ The
and
.BR libsimple_ecallocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -185,18 +190,25 @@ T{
.BR libsimple_ecallocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -204,7 +216,17 @@ None.
.BR libsimple_vmalloczn (3),
.BR libsimple_encalloc (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vmallocn.3 b/man3/libsimple_vmallocn.3
index 0aed464..9383069 100644
--- a/man3/libsimple_vmallocn.3
+++ b/man3/libsimple_vmallocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VMALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VMALLOCN 3 libsimple
.SH NAME
libsimple_vmallocn \- allocate memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_emallocn(size_t \fIn\fP, ..., /* (size_t)0 */);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_mallocn (),
@@ -93,6 +95,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vmallocn (),
@@ -118,6 +121,7 @@ it indicate the error, and the
and
.BR libsimple_emallocn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vmallocn (),
@@ -137,6 +141,7 @@ The
and
.BR libsimple_emallocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -185,18 +190,25 @@ T{
.BR libsimple_emallocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -204,7 +216,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vmalloczn.3 b/man3/libsimple_vmalloczn.3
index 8b12b4a..67354e6 100644
--- a/man3/libsimple_vmalloczn.3
+++ b/man3/libsimple_vmalloczn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VMALLOCZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VMALLOCZN 3 libsimple
.SH NAME
libsimple_vmalloczn \- allocate optionally initialised memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_emalloczn(int \fIclear\fP, size_t \fIn\fP, ..., /*
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_malloczn (),
@@ -98,6 +100,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vmalloczn (),
@@ -123,6 +126,7 @@ it indicate the error, and the
and
.BR libsimple_emalloczn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vmalloczn (),
@@ -144,6 +148,7 @@ The
and
.BR libsimple_emalloczn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -192,18 +197,25 @@ T{
.BR libsimple_emalloczn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -211,7 +223,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vmemalignn.3 b/man3/libsimple_vmemalignn.3
index 8a6c5c1..1f13cd7 100644
--- a/man3/libsimple_vmemalignn.3
+++ b/man3/libsimple_vmemalignn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VMEMALIGNN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VMEMALIGNN 3 libsimple
.SH NAME
libsimple_vmemalignn \- allocate memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ememalignn(size_t \fIalignment\fP, size_t \fIn\fP,
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memalignn (),
@@ -91,6 +93,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vmemalignn (),
@@ -116,6 +119,7 @@ it indicate the error, and the
and
.BR libsimple_ememalignn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vmemalignn (),
@@ -140,6 +144,7 @@ The
and
.BR libsimple_ememalignn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -188,18 +193,25 @@ T{
.BR libsimple_ememalignn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -208,7 +220,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignzn (3),
diff --git a/man3/libsimple_vmemalignzn.3 b/man3/libsimple_vmemalignzn.3
index f59b3a0..d9b0434 100644
--- a/man3/libsimple_vmemalignzn.3
+++ b/man3/libsimple_vmemalignzn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VMEMALIGNZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VMEMALIGNZN 3 libsimple
.SH NAME
libsimple_vmemalignzn \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ememalignzn(int \fIclear\fP, size_t \fIalignment\f
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_memalignzn (),
@@ -94,6 +96,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vmemalignzn (),
@@ -119,6 +122,7 @@ it indicate the error, and the
and
.BR libsimple_ememalignzn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vmemalignzn (),
@@ -143,6 +147,7 @@ The
and
.BR libsimple_ememalignzn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -191,18 +196,25 @@ T{
.BR libsimple_ememalignzn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -211,7 +223,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vmemalloc.3 b/man3/libsimple_vmemalloc.3
index e088af2..ab0b4c3 100644
--- a/man3/libsimple_vmemalloc.3
+++ b/man3/libsimple_vmemalloc.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VMEMALLOC 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VMEMALLOC 3 libsimple
.SH NAME
libsimple_vmemalloc \- allocate memory in a flexible manner
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -19,6 +20,7 @@ static inline void *libsimple_ememalloc(size_t \fIn\fP, ..., /* LIBSIMPLE_MEMALL
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vmemalloc ()
@@ -178,6 +180,7 @@ and
functions, respectively, that use variadic arguments
instead of
.BR va_list .
+
.SH RETURN VALUE
The
.BR libsimple_vmemalloc (),
@@ -203,6 +206,7 @@ to indicate the error, whereas the
and
.BR libsimple_ememalloc ()
functions terminate the process.
+
.SH ERRORS
The
.BR libsimple_vmemalloc ()
@@ -227,6 +231,7 @@ The
and
.BR libsimple_ememalloc ()
functions terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -275,18 +280,25 @@ T{
.BR libsimple_ememalloc ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_varrayalloc (3),
.BR libsimple_enmalloc (3),
@@ -296,7 +308,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vposix_memalignn.3 b/man3/libsimple_vposix_memalignn.3
index f05ab6b..b8da3e8 100644
--- a/man3/libsimple_vposix_memalignn.3
+++ b/man3/libsimple_vposix_memalignn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VPOSIX_MEMALIGNN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VPOSIX_MEMALIGNN 3 libsimple
.SH NAME
libsimple_vposix_memalignn \- allocate memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void libsimple_eposix_memalignn(void **\fImemptr\fP, size_t \fIali
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_posix_memalignn (),
@@ -96,6 +98,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vposix_memalignn ()
@@ -113,6 +116,7 @@ and
.BR libsimple_eposix_memalignn ()
functions to not return a value, but
terminated the process on failure.
+
.SH ERRORS
The
.BR libsimple_vposix_memalignn (),
@@ -142,6 +146,7 @@ The
and
.BR libsimple_eposix_memalignn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -190,18 +195,25 @@ T{
.BR libsimple_eposix_memalignn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -210,7 +222,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vposix_memalignzn.3 b/man3/libsimple_vposix_memalignzn.3
index 481a4b1..fd4c682 100644
--- a/man3/libsimple_vposix_memalignzn.3
+++ b/man3/libsimple_vposix_memalignzn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VPOSIX_MEMALIGNZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VPOSIX_MEMALIGNZN 3 libsimple
.SH NAME
libsimple_vposix_memalignzn \- allocate optionally initialised memory with custom alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline int libsimple_eposix_memalignzn(void **\fImemptr\fP, int \fIclear\
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_posix_memalignzn (),
@@ -99,6 +101,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vposix_memalignzn ()
@@ -116,6 +119,7 @@ and
.BR libsimple_eposix_memalignzn ()
functions do not return a value, but
terminated the process on failure.
+
.SH ERRORS
The
.BR libsimple_vposix_memalignzn (),
@@ -145,6 +149,7 @@ The
and
.BR libsimple_eposix_memalignzn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -193,18 +198,25 @@ T{
.BR libsimple_eposix_memalignzn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -213,7 +225,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vputenvf.3 b/man3/libsimple_vputenvf.3
index 33c5559..d772c81 100644
--- a/man3/libsimple_vputenvf.3
+++ b/man3/libsimple_vputenvf.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VPUTENVF 3 2018-10-20 libsimple
+.TH LIBSIMPLE_VPUTENVF 3 libsimple
.SH NAME
libsimple_vputenvf \- change or add a string formatted value to the environment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void libsimple_eputenvf(const char *\fIfmt\fP, ...);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vputenvf ()
@@ -88,6 +90,7 @@ for more information.
Modifications made to the environment do not become
visible to other process until the process image is
changed.
+
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_vputenvf ()
@@ -96,6 +99,7 @@ and
functions return 0; otherwise, they return \-1 and set
.I errno
to indicate the error.
+
.SH ERRORS
The
.BR libsimple_vputenvf ()
@@ -114,6 +118,7 @@ Insufficient memory was available.
They may also fail for any reason specified for the
.BR vsnprintf (3)
function.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -162,14 +167,19 @@ T{
.BR libsimple_eputenvf ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
If the construct does not contain the
.B '='
@@ -182,12 +192,14 @@ the behaviour is unspecified when countered by the
and
.BR unsetenv (3)
functions.
+
.SH BUGS
There is no mechanism for detecting which entries in the
environment are statically allocated and which are
dynamically allocated, this can lead to memory leaks
with are detected by
.BR valgrind (1).
+
.SH SEE ALSO
.BR putenv (3),
.BR setenv (3),
diff --git a/man3/libsimple_vpvallocn.3 b/man3/libsimple_vpvallocn.3
index 4c05134..1d4bbbb 100644
--- a/man3/libsimple_vpvallocn.3
+++ b/man3/libsimple_vpvallocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VPVALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VPVALLOCN 3 libsimple
.SH NAME
libsimple_vpvallocn \- allocate memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_epvallocn(size_t \fIn\fP, ..., /* (size_t)0 */);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_pvallocn (),
@@ -91,6 +93,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vpvallocn (),
@@ -116,6 +119,7 @@ it indicate the error, and the
and
.BR libsimple_epvallocn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vpvallocn (),
@@ -136,6 +140,7 @@ The
and
.BR libsimple_epvallocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -184,20 +189,27 @@ T{
.BR libsimple_epvallocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR pvalloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -206,7 +218,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vpvalloczn.3 b/man3/libsimple_vpvalloczn.3
index be9f1c5..e620758 100644
--- a/man3/libsimple_vpvalloczn.3
+++ b/man3/libsimple_vpvalloczn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VPVALLOCZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VPVALLOCZN 3 libsimple
.SH NAME
libsimple_vpvalloczn \- allocate optionally initialised memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_epvalloczn(int \fIclear\fP, size_t \fIn\fP, ..., /
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_pvalloczn (),
@@ -93,6 +95,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vpvalloczn (),
@@ -118,6 +121,7 @@ it indicate the error, and the
and
.BR libsimple_epvalloczn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vpvalloczn (),
@@ -138,6 +142,7 @@ The
and
.BR libsimple_epvalloczn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -186,20 +191,27 @@ T{
.BR libsimple_epvalloczn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR pvalloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -208,7 +220,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vreallocfn.3 b/man3/libsimple_vreallocfn.3
new file mode 100644
index 0000000..5dd5390
--- /dev/null
+++ b/man3/libsimple_vreallocfn.3
@@ -0,0 +1,178 @@
+.TH LIBSIMPLE_VREALLOCFN 3 libsimple
+.SH NAME
+libsimple_vreallocfn \- reallocate memory
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+static inline void *libsimple_vreallocfn(void *\fIptr\fP, size_t \fIn\fP, va_list \fIap\fP);
+static inline void *libsimple_reallocfn(void *\fIptr\fP, size_t \fIn\fP, ..., /* (size_t)0 */);
+
+#ifndef vreallocfn
+# define vreallocfn libsimple_vreallocfn
+#endif
+#ifndef reallocfn
+# define reallocfn libsimple_reallocfn
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_reallocfn ()
+function is a wrapper for the
+.BR realloc (3)
+function, it reallocate memory allocated on
+the heap and return the older pointer or a new
+pointer with the alignment of
+.I alignof(max_align_t)
+to the allocated memory of
+.I N
+bytes, where
+.I N
+is the product of
+.I n
+and all following arguments (which should have the type
+.BR size_t )
+up to the first 0;
+.I n
+must not be 0. The returned pointer will contain the
+same content as
+.IR ptr ,
+but truncated to
+.I N
+bytes if it is smaller or with the new bytes
+unitialised if it is larger. If a new pointer
+is returned, rather than
+.IR ptr ,
+.I ptr
+is deallocated;
+.I ptr
+is also deallocated on failure. The function
+.BR free (3)
+shall be called with the returned pointer as
+input when the allocated memory is no longer needed.
+.PP
+The
+.BR libsimple_vreallocfn ()
+function is a version of the
+.BR libsimple_reallocfn ()
+function that use
+.B va_list
+instead of variadic arguments.
+
+.SH RETURN VALUE
+The
+.BR libsimple_vreallocfn ()
+and
+.BR libsimple_reallocfn (),
+functions return a pointer to the allocated memory
+upon success completion; otherwise the
+.BR libsimple_vreallocfn ()
+and
+.BR libsimple_reallocfn ()
+functions return
+.B NULL
+and set
+.I errno
+it indicate the error.
+
+.SH ERRORS
+The
+.BR libsimple_vreallocn (),
+.BR libsimple_reallocn ()
+function will fail for the reasons specified for the
+.BR realloc (3)
+function, and if:
+.TP
+.B EINVAL
+.I n
+is 0.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_vreallocfn (),
+.br
+.BR libsimple_reallocfn ()
+T} Thread safety MT-Safe
+T{
+.BR libsimple_vreallocfn (),
+.br
+.BR libsimple_reallocfn ()
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_vreallocfn (),
+.br
+.BR libsimple_reallocfn ()
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_enmalloc (3),
+.BR libsimple_mallocz (3),
+.BR libsimple_vmallocn (3),
+.BR libsimple_vmalloczn (3),
+.BR libsimple_encalloc (3),
+.BR libsimple_vcallocn (3),
+.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
+.BR libsimple_memalign (3),
+.BR libsimple_memalignz (3),
+.BR libsimple_vmemalignn (3),
+.BR libsimple_vmemalignzn (3),
+.BR libsimple_enposix_memalign (3),
+.BR libsimple_posix_memalignz (3),
+.BR libsimple_vposix_memalignn (3),
+.BR libsimple_vposix_memalignzn (3),
+.BR libsimple_enaligned_alloc (3),
+.BR libsimple_aligned_allocz (3),
+.BR libsimple_valigned_allocn (3),
+.BR libsimple_valigned_alloczn (3),
+.BR libsimple_pvalloc (3),
+.BR libsimple_pvallocz (3),
+.BR libsimple_vpvallocn (3),
+.BR libsimple_vpvalloczn (3),
+.BR libsimple_valloc (3),
+.BR libsimple_vallocz (3),
+.BR libsimple_vvallocn (3),
+.BR libsimple_vvalloczn (3),
+.BR libsimple_vmemalloc (3),
+.BR libsimple_varrayalloc (3),
+.BR malloc (3)
diff --git a/man3/libsimple_vreallocn.3 b/man3/libsimple_vreallocn.3
index 2f61307..bddce8b 100644
--- a/man3/libsimple_vreallocn.3
+++ b/man3/libsimple_vreallocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VREALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VREALLOCN 3 libsimple
.SH NAME
libsimple_vreallocn \- reallocate memory
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_ereallocn(void *\fIptr\fP, size_t \fIn\fP, ..., /*
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_reallocn (),
@@ -43,7 +45,7 @@ and
functions are wrappers for the
.BR realloc (3)
function, they reallocate memory allocated on
-the heap and return the older pointer ot a new
+the heap and return the older pointer or a new
pointer with the alignment of
.I alignof(max_align_t)
to the allocated memory of
@@ -106,6 +108,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vreallocn (),
@@ -131,11 +134,13 @@ it indicate the error, and the
and
.BR libsimple_ereallocn ()
functions terminated the process.
+
.SH ERRORS
The
-.BR libsimple_vreallocn (),
+.BR libsimple_vreallocn ()
+and
.BR libsimple_reallocn ()
-function will fail for the reasons specified for the
+functions will fail for the reasons specified for the
.BR realloc (3)
function, and if:
.TP
@@ -150,6 +155,7 @@ The
and
.BR libsimple_ereallocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -198,18 +204,25 @@ T{
.BR libsimple_ereallocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -218,6 +231,16 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vvallocn.3 b/man3/libsimple_vvallocn.3
index e21d37b..c378660 100644
--- a/man3/libsimple_vvallocn.3
+++ b/man3/libsimple_vvallocn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VVALLOCN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VVALLOCN 3 libsimple
.SH NAME
libsimple_vvallocn \- allocate memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_evallocn(size_t \fIn\fP, ..., /* (size_t)0 */);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vallocn (),
@@ -90,6 +92,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vvallocn (),
@@ -115,6 +118,7 @@ it indicate the error, and the
and
.BR libsimple_evallocn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vvallocn (),
@@ -135,6 +139,7 @@ The
and
.BR libsimple_evallocn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -183,20 +188,27 @@ T{
.BR libsimple_evallocn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR valloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -205,7 +217,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vvalloczn.3 b/man3/libsimple_vvalloczn.3
index 1b7a8e0..9a2f9e4 100644
--- a/man3/libsimple_vvalloczn.3
+++ b/man3/libsimple_vvalloczn.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VVALLOCZN 3 2018-11-03 libsimple
+.TH LIBSIMPLE_VVALLOCZN 3 libsimple
.SH NAME
libsimple_vvalloczn \- allocate optionally initialised memory with page size alignment
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -34,6 +35,7 @@ static inline void *libsimple_evalloczn(int \fIclear\fP, size_t \fIn\fP, ..., /*
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_valloczn (),
@@ -93,6 +95,7 @@ and
respectively, that use
.B va_list
instead of variadic arguments.
+
.SH RETURN VALUE
The
.BR libsimple_vvalloczn (),
@@ -118,6 +121,7 @@ it indicate the error, and the
and
.BR libsimple_evalloczn ()
functions terminated the process.
+
.SH ERRORS
The
.BR libsimple_vvalloczn (),
@@ -138,6 +142,7 @@ The
and
.BR libsimple_evalloczn ()
functions will terminate the process on failure.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -186,20 +191,27 @@ T{
.BR libsimple_evalloczn ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
The GNU implementation of
.BR valloc (3)
is \(dqMT-Unsafe init\(dq.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR libsimple_enmalloc (3),
.BR libsimple_mallocz (3),
@@ -208,7 +220,17 @@ None.
.BR libsimple_encalloc (3),
.BR libsimple_vcallocn (3),
.BR libsimple_enrealloc (3),
+.BR libsimple_reallocarray (3),
.BR libsimple_vreallocn (3),
+.BR libsimple_reallocf (3),
+.BR libsimple_reallocarrayf (3),
+.BR libsimple_vreallocfn (3),
+.BR libsimple_aligned_realloc (3),
+.BR libsimple_aligned_reallocarray (3),
+.BR libsimple_aligned_vreallocn (3),
+.BR libsimple_aligned_reallocf (3),
+.BR libsimple_aligned_reallocarrayf (3),
+.BR libsimple_aligned_vreallocfn (3),
.BR libsimple_memalign (3),
.BR libsimple_memalignz (3),
.BR libsimple_vmemalignn (3),
diff --git a/man3/libsimple_vweprintf.3 b/man3/libsimple_vweprintf.3
index 06d339d..8db6f0a 100644
--- a/man3/libsimple_vweprintf.3
+++ b/man3/libsimple_vweprintf.3
@@ -1,6 +1,7 @@
-.TH LIBSIMPLE_VWEPRINTF 3 2018-11-06 libsimple
+.TH LIBSIMPLE_VWEPRINTF 3 libsimple
.SH NAME
libsimple_vweprintf \- print an error message
+
.SH SYNOPSIS
.nf
#include <libsimple.h>
@@ -38,6 +39,7 @@ static inline void libsimple_eprintf(const char *\fIfmt\fP, ...);
.PP
Link with
.IR \-lsimple .
+
.SH DESCRIPTION
The
.BR libsimple_vweprintf ()
@@ -151,10 +153,13 @@ function called when
or
.I libsimple_eprint_postprint
is called.
+
.SH RETURN VALUE
None.
+
.SH ERRORS
None.
+
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -203,18 +208,25 @@ T{
.BR libsimple_eprintf ()
T} Async-cancel safety AC-Safe
.TE
+
.SH EXAMPLES
None.
+
.SH APPLICATION USAGE
None.
+
.SH RATIONALE
None.
+
.SH FUTURE DIRECTIONS
None.
+
.SH NOTES
None.
+
.SH BUGS
None.
+
.SH SEE ALSO
.BR perror (3),
.BR fprintf (3),
diff --git a/man3/libsimple_wcsdupa.3 b/man3/libsimple_wcsdupa.3
new file mode 120000
index 0000000..85a85a6
--- /dev/null
+++ b/man3/libsimple_wcsdupa.3
@@ -0,0 +1 @@
+libsimple_enwcsdup.3 \ No newline at end of file
diff --git a/man3/libsimple_wcsndup.3 b/man3/libsimple_wcsndup.3
new file mode 100644
index 0000000..6821d25
--- /dev/null
+++ b/man3/libsimple_wcsndup.3
@@ -0,0 +1,167 @@
+.TH LIBSIMPLE_WCSNDUP 3 libsimple
+.SH NAME
+libsimple_wcsndup \- duplicate a wide-character string
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_wcsndupa(const wchar_t *\fIs\fP, size_t \fIn\fP);
+wchar_t *libsimple_wcsndup(const wchar_t *\fIs\fP, size_t \fIn\fP);
+wchar_t *libsimple_enwcsndup(int \fIstatus\fP, const wchar_t *\fIs\fP, size_t \fIn\fP);
+static inline wchar_t *libsimple_ewcsndup(const wchar_t *\fIs\fP, size_t \fIn\fP);
+
+#ifndef wcsndupa
+# define wcsndupa libsimple_wcsndupa
+#endif
+#ifndef wcsndup
+# define wcsndup libsimple_wcsndup
+#endif
+#ifndef enwcsndup
+# define enwcsndup libsimple_enwcsndup
+#endif
+#ifndef ewcsndup
+# define ewcsndup libsimple_ewcsndup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_wcsndup ()
+function allocates memory and copies the string
+.I s
+into the new allocation, however only up to the
+.I n
+first wide-characters; a NUL wide-character will
+always be written to the end of the new
+wide-character string.
+.PP
+The
+.BR libsimple_enwcsndup ()
+and
+.BR libsimple_ewcsndup ()
+functions are versions of the
+.BR libsimple_wcsndup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wcsndupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_wcsndup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_wcsndupa (),
+.BR libsimple_wcsndup (),
+.BR libsimple_enwcsndup (),
+and
+.BR libsimple_ewcsndup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_wcsndup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enwcsndup (),
+and
+.BR libsimple_ewcsndup ()
+functions exit the process. The
+.BR libsimple_wcsndupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_wcsndupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_wcsndup ()
+function may fail for any reason specified for the
+.BR malloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_wcsndupa (),
+.br
+.BR libsimple_wcsndup (),
+.br
+.BR libsimple_enwcsndup (),
+.br
+.BR libsimple_ewcsndup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_wcsndupa (),
+.br
+.BR libsimple_wcsndup (),
+.br
+.BR libsimple_enwcsndup (),
+.br
+.BR libsimple_ewcsndup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_wcsndupa (),
+.br
+.BR libsimple_wcsndup (),
+.br
+.BR libsimple_enwcsndup (),
+.br
+.BR libsimple_ewcsndup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_wcsndup (3),
+.BR libsimple_enstrndup (3),
+.BR libsimple_enstrdup (3),
+.BR libsimple_memdup (3),
+.BR libsimple_enwcsdup (3),
+.BR libsimple_wmemdup (3),
+.BR strndup (3),
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_wcsndupa.3 b/man3/libsimple_wcsndupa.3
new file mode 120000
index 0000000..57c8250
--- /dev/null
+++ b/man3/libsimple_wcsndupa.3
@@ -0,0 +1 @@
+libsimple_wcsndup.3 \ No newline at end of file
diff --git a/man3/libsimple_wmemdup.3 b/man3/libsimple_wmemdup.3
new file mode 100644
index 0000000..1f9e9cd
--- /dev/null
+++ b/man3/libsimple_wmemdup.3
@@ -0,0 +1,167 @@
+.TH LIBSIMPLE_WMEMDUP 3 libsimple
+.SH NAME
+libsimple_wmemdup \- duplicate a wide-character array
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+wchar_t *libsimple_wmemdupa(const wchar_t *\fIs\fP, size_t \fIn\fP);
+wchar_t *libsimple_wmemdup(const wchar_t *\fIs\fP, size_t \fIn\fP);
+wchar_t *libsimple_enwmemdup(int \fIstatus\fP, const wchar_t *\fIs\fP, size_t \fIn\fP);
+static inline wchar_t *libsimple_ewmemdup(const wchar_t *\fIs\fP, size_t \fIn\fP);
+
+#ifndef wmemdupa
+# define wmemdupa libsimple_wmemdupa
+#endif
+#ifndef wmemdup
+# define wmemdup libsimple_wmemdup
+#endif
+#ifndef enwmemdup
+# define enwmemdup libsimple_enwmemdup
+#endif
+#ifndef ewmemdup
+# define ewmemdup libsimple_ewmemdup
+#endif
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_wmemdup ()
+function allocates memory and copies
+.I n
+first wide-characters
+.RB ( wchar_t )
+from
+.I s
+into the new allocation.
+.PP
+The
+.BR libsimple_enwmemdup ()
+and
+.BR libsimple_ewmemdup ()
+functions are versions of the
+.BR libsimple_wmemdup ()
+function that call the
+.BR libsimple_enprintf (3)
+function on failure, causing the process to print
+an error message and exit. See
+.BR libsimple_enprintf (3)
+for more information.
+.PP
+The
+.BR libsimple_wmemdupa ()
+function is implemented as a macro and is a version
+of the
+.BR libsimple_wmemdup ()
+function that uses allocates the memory on the stack
+rather than on the heap, causing the return pointer
+to become invalid when the calling function returns.
+It is only available when compling with GCC or Clang.
+
+.SH RETURN VALUE
+Upon successful completion, the
+.BR libsimple_wmemdupa (),
+.BR libsimple_wmemdup (),
+.BR libsimple_enwmemdup (),
+and
+.BR libsimple_ewmemdup ()
+functions return a non-null pointer, on failure the
+.BR libsimple_wmemdup ()
+function returns
+.B NULL
+and set
+.I errno
+to indicate the error, and the
+.BR libsimple_enwmemdup (),
+and
+.BR libsimple_ewmemdup ()
+functions exit the process. The
+.BR libsimple_wmemdupa ()
+function cannot fail, however the kernel
+can kill the thread, and possibly the process, with a
+.B SIGSEGV
+signal if the memory cannot be allocated.
+.PP
+The returned pointer should be deallocated when it
+is no longer needed, except for the pointer returned
+by the
+.BR libsimple_wmemdupa ()
+function, it is automatically deallocated when the
+calling function returns.
+
+.SH ERRORS
+The
+.BR libsimple_wmemdup ()
+function may fail for any reason specified for the
+.BR malloc (3)
+function.
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR libsimple_wmemdupa (),
+.br
+.BR libsimple_wmemdup (),
+.br
+.BR libsimple_enwmemdup (),
+.br
+.BR libsimple_ewmemdup (),
+T} Thread safety MT-Safe
+T{
+.BR libsimple_wmemdupa (),
+.br
+.BR libsimple_wmemdup (),
+.br
+.BR libsimple_enwmemdup (),
+.br
+.BR libsimple_ewmemdup (),
+T} Async-signal safety AS-Safe
+T{
+.BR libsimple_wmemdupa (),
+.br
+.BR libsimple_wmemdup (),
+.br
+.BR libsimple_enwmemdup (),
+.br
+.BR libsimple_ewmemdup (),
+T} Async-cancel safety AC-Safe
+.TE
+
+.SH EXAMPLES
+None.
+
+.SH APPLICATION USAGE
+None.
+
+.SH RATIONALE
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH NOTES
+None.
+
+.SH BUGS
+None.
+
+.SH SEE ALSO
+.BR libsimple_aligned_wmemdup (3),
+.BR libsimple_enstrndup (3),
+.BR libsimple_enstrdup (3),
+.BR libsimple_memdup (3),
+.BR libsimple_enwcsdup (3),
+.BR libsimple_wcsndup (3),
+.BR strndup (3),
+.BR strdup (3),
+.BR wcsdup (3)
diff --git a/man3/libsimple_wmemdupa.3 b/man3/libsimple_wmemdupa.3
new file mode 120000
index 0000000..93381ef
--- /dev/null
+++ b/man3/libsimple_wmemdupa.3
@@ -0,0 +1 @@
+libsimple_wmemdup.3 \ No newline at end of file
diff --git a/man3/reallocarray.3libsimple b/man3/reallocarray.3libsimple
new file mode 120000
index 0000000..9cb5fe4
--- /dev/null
+++ b/man3/reallocarray.3libsimple
@@ -0,0 +1 @@
+libsimple_reallocarray.3 \ No newline at end of file
diff --git a/man3/reallocarrayf.3libsimple b/man3/reallocarrayf.3libsimple
new file mode 120000
index 0000000..c0ad147
--- /dev/null
+++ b/man3/reallocarrayf.3libsimple
@@ -0,0 +1 @@
+libsimple_reallocarrayf.3 \ No newline at end of file
diff --git a/man3/reallocf.3libsimple b/man3/reallocf.3libsimple
new file mode 120000
index 0000000..e60bee6
--- /dev/null
+++ b/man3/reallocf.3libsimple
@@ -0,0 +1 @@
+libsimple_reallocf.3 \ No newline at end of file
diff --git a/man3/reallocfn.3libsimple b/man3/reallocfn.3libsimple
new file mode 120000
index 0000000..7db99ff
--- /dev/null
+++ b/man3/reallocfn.3libsimple
@@ -0,0 +1 @@
+libsimple_reallocfn.3 \ No newline at end of file
diff --git a/man3/valigned_reallocfn.3libsimple b/man3/valigned_reallocfn.3libsimple
new file mode 120000
index 0000000..1ba44a5
--- /dev/null
+++ b/man3/valigned_reallocfn.3libsimple
@@ -0,0 +1 @@
+libsimple_valigned_reallocfn.3 \ No newline at end of file
diff --git a/man3/valigned_reallocn.3libsimple b/man3/valigned_reallocn.3libsimple
new file mode 120000
index 0000000..7c3a84f
--- /dev/null
+++ b/man3/valigned_reallocn.3libsimple
@@ -0,0 +1 @@
+libsimple_valigned_reallocn.3 \ No newline at end of file
diff --git a/man3/vreallocfn.3libsimple b/man3/vreallocfn.3libsimple
new file mode 120000
index 0000000..d06b871
--- /dev/null
+++ b/man3/vreallocfn.3libsimple
@@ -0,0 +1 @@
+libsimple_vreallocfn.3 \ No newline at end of file
diff --git a/man3/wcsdupa.3libsimple b/man3/wcsdupa.3libsimple
new file mode 120000
index 0000000..4555af1
--- /dev/null
+++ b/man3/wcsdupa.3libsimple
@@ -0,0 +1 @@
+libsimple_wcsdupa.3 \ No newline at end of file
diff --git a/man3/wcsndup.3libsimple b/man3/wcsndup.3libsimple
new file mode 120000
index 0000000..57c8250
--- /dev/null
+++ b/man3/wcsndup.3libsimple
@@ -0,0 +1 @@
+libsimple_wcsndup.3 \ No newline at end of file
diff --git a/man3/wcsndupa.3libsimple b/man3/wcsndupa.3libsimple
new file mode 120000
index 0000000..ac844a1
--- /dev/null
+++ b/man3/wcsndupa.3libsimple
@@ -0,0 +1 @@
+libsimple_wcsndupa.3 \ No newline at end of file
diff --git a/man3/wmemdup.3libsimple b/man3/wmemdup.3libsimple
new file mode 120000
index 0000000..93381ef
--- /dev/null
+++ b/man3/wmemdup.3libsimple
@@ -0,0 +1 @@
+libsimple_wmemdup.3 \ No newline at end of file
diff --git a/man3/wmemdupa.3libsimple b/man3/wmemdupa.3libsimple
new file mode 120000
index 0000000..919c84e
--- /dev/null
+++ b/man3/wmemdupa.3libsimple
@@ -0,0 +1 @@
+libsimple_wmemdupa.3 \ No newline at end of file
diff --git a/memdup.c b/memdup.c
index a1d0959..5d158b0 100644
--- a/memdup.c
+++ b/memdup.c
@@ -6,7 +6,7 @@
void *
libsimple_memdup(const void *s, size_t n)
{
- void *ret = malloc(n ? n : (size_t)1);
+ void *ret = malloc(n + !n);
if (!ret)
return NULL;
return memcpy(ret, s, n);
diff --git a/test.c b/test.c
index f785483..e5ecf00 100644
--- a/test.c
+++ b/test.c
@@ -229,11 +229,43 @@ strndup(const char *s, size_t n)
}
+#if 0
void *
memdup(const void *s, size_t size)
{
return libsimple_memdup(s, size);
}
+#endif
+
+
+wchar_t *
+wcsdup(const wchar_t *s)
+{
+ wchar_t *r;
+ size_t n = wcslen(s) + 1;
+ if (n > SIZE_MAX / sizeof(wchar_t)) {
+ errno = ENOMEM;
+ return NULL;
+ }
+ r = malloc(n * sizeof(wchar_t));
+ return r ? wcscpy(r, s) : r;
+}
+
+
+#if 0
+wchar_t *
+wcsndup(const wchar_t *s, size_t n)
+{
+ return libsimple_wcsndup(s, n);
+}
+
+
+wchar_t *
+wmemdup(const wchar_t *s, size_t n)
+{
+ return libsimple_wmemdup(s, n);
+}
+#endif
void
@@ -255,7 +287,7 @@ memset(void *s, int c, size_t n)
{
char *str = s;
struct allocinfo *info;
- if (just_alloced && s == just_alloced) {
+ if (s == just_alloced && just_alloced && !c) {
info = get_allocinfo(s);
info->zeroed = MAX(info->zeroed, n);
}
diff --git a/test.h b/test.h
index fe229ef..d8ac2d4 100644
--- a/test.h
+++ b/test.h
@@ -95,3 +95,42 @@ test_fprintf(FILE *restrict stream, const char *restrict format, ...)
return test_vfprintf(stream, format, ap);
va_end(ap);
}
+
+
+
+static size_t
+gcd(size_t u, size_t v)
+{
+ size_t t;
+ int shift = 0;
+ /* Not needed because u>0, v>0: if (!(u | v)) return u + v; */
+ while (!((u | v) & 1)) u >>= 1, v >>= 1, shift++;
+ while (!(u & 1)) u >>= 1;
+ do {
+ while (!(v & 1)) v >>= 1;
+ if (u > v) t = u, u = v, v = t;
+ } while (v -= u);
+ return u << shift;
+}
+
+static inline size_t
+lcm(size_t u, size_t v)
+{
+ return u / gcd(u, v) * v;
+}
+
+#define ASSERT_ALIGNMENT(INFO, ALIGN)\
+ do {\
+ assert((INFO)->alignment <= lcm(cacheline, ALIGN));\
+ assert(!((INFO)->alignment % (ALIGN)));\
+ if ((cacheline - (ALIGN) % cacheline) % cacheline + (INFO)->size % (ALIGN) > cacheline)\
+ assert(!((INFO)->alignment % cacheline));\
+ } while (0)
+
+#define DEFINE_PAGESIZE size_t pagesize = (size_t)sysconf(_SC_PAGESIZE)
+
+#ifdef _SC_LEVEL1_DCACHE_LINESIZ
+#define DEFINE_CACHELINE size_t cacheline = (size_t)sysconf(_SC_LEVEL1_DCACHE_LINESIZE)
+#else
+#define DEFINE_CACHELINE size_t cacheline = 64
+#endif
diff --git a/wcsndup.c b/wcsndup.c
new file mode 100644
index 0000000..5621084
--- /dev/null
+++ b/wcsndup.c
@@ -0,0 +1,106 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_wcsndup(const wchar_t *s, size_t n)
+{
+ size_t size;
+ wchar_t *ret;
+ n = wcsnlen(s, n);
+ size = (n + 1) * sizeof(wchar_t);
+ ret = aligned_alloc(_Alignof(wchar_t), size);
+ if (!ret)
+ return NULL;
+ wmemcpy(ret, s, n);
+ ret[n] = 0;
+ return ret;
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ const wchar_t *s = L"test";
+ wchar_t *p;
+
+ p = libsimple_wcsndup(s, SIZE_MAX);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 5));
+ wmemset(p, 0, 5);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ p = libsimple_wcsndup(s, 10);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 5));
+ wmemset(p, 0, 5);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ p = libsimple_wcsndup(s, 5);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 5));
+ wmemset(p, 0, 5);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ p = libsimple_wcsndup(s, 4);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 5));
+ wmemset(p, 0, 5);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ p = libsimple_wcsndup(s, 2);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 3 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 2));
+ assert(!p[2]);
+ wmemset(p, 0, 3);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ return 0;
+}
+
+#endif
diff --git a/wmemdup.c b/wmemdup.c
new file mode 100644
index 0000000..2e9cc1c
--- /dev/null
+++ b/wmemdup.c
@@ -0,0 +1,52 @@
+/* See LICENSE file for copyright and license details. */
+#include "libsimple.h"
+#ifndef TEST
+
+
+wchar_t *
+libsimple_wmemdup(const wchar_t *s, size_t n)
+{
+ wchar_t *ret;
+ size_t size;
+ if (LIBSIMPLE_UMUL_OVERFLOW_NONZERO(n + !n, sizeof(wchar_t), &size, SIZE_MAX)) {
+ errno = ENOMEM;
+ return NULL;
+ }
+ ret = aligned_alloc(_Alignof(wchar_t), size);
+ if (!ret)
+ return NULL;
+ return wmemcpy(ret, s, n);
+}
+
+
+#else
+#include "test.h"
+
+int
+main(void)
+{
+ struct allocinfo *info;
+ const wchar_t *s = L"test";
+ wchar_t *p;
+
+ p = libsimple_wmemdup(s, 5);
+ assert(p);
+ assert(p != s);
+ assert(!((uintptr_t)s % _Alignof(wchar_t)));
+ if (have_custom_malloc()) {
+ assert((info = get_allocinfo(p)));
+ assert(info->size == 5 * sizeof(wchar_t));
+ assert(info->alignment == _Alignof(wchar_t));
+ }
+ assert(!wmemcmp(p, s, 5));
+ wmemset(p, 0, 5);
+ assert(!wmemcmp(s, L"test", 5));
+ free(p);
+
+ errno = 0;
+ assert(!libsimple_wmemdup(NULL, SSIZE_MAX) && errno == ENOMEM);
+
+ return 0;
+}
+
+#endif