Changeset 81926 in vbox for trunk/include

Timestamp:

Nov 18, 2019 12:30:01 AM (5 years ago)

Author:

vboxsync

Message:

IPRT: Added 32-bit memchr variant. Prepared 16 and 64 bit ones too.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• string.h (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -2119 +2119 @@
 # define RTStrIsUpperCased                              RT_MANGLER(RTStrIsUpperCased)
 # define RTStrIsValidEncoding                           RT_MANGLER(RTStrIsValidEncoding)
+# define RTStrMemFind16                                 RT_MANGLER(RTStrMemFind16)
+# define RTStrMemFind32                                 RT_MANGLER(RTStrMemFind32)
+# define RTStrMemFind64                                 RT_MANGLER(RTStrMemFind64)
 # define RTStrmClearError                               RT_MANGLER(RTStrmClearError)
 # define RTStrmClose                                    RT_MANGLER(RTStrmClose)

trunk/include/iprt/string.h

@@ -3396 +3396 @@
 /** @}  */
 
+
+/** @defgroup rt_str_mem       Raw memory operations.
+ *
+ * @note Following the memchr/memcpy/memcmp/memset tradition and putting these
+ *       in the string.h header rather than in the mem.h one.
+ *
+ * @{ */
+
+/**
+ * Searches @a pvHaystack for a 16-bit sized and aligned @a uNeedle.
+ *
+ * @returns Pointer to the first hit if found, NULL if not found.
+ * @param   pvHaystack      The memory to search.
+ * @param   uNeedle         The 16-bit value to find.
+ * @param   cbHaystack      Size of the memory to search.
+ * @sa      memchr, RTStrMemFind32, RTStrMemFind64
+ */
+RTDECL(uint16_t *) RTStrMemFind16(const void *pvHaystack, uint16_t uNeedle, size_t cbHaystack);
+
+/**
+ * Searches @a pvHaystack for a 32-bit sized and aligned @a uNeedle.
+ *
+ * @returns Pointer to the first hit if found, NULL if not found.
+ * @param   pvHaystack      The memory to search.
+ * @param   uNeedle         The 32-bit value to find.
+ * @param   cbHaystack      Size of the memory to search.
+ * @sa      memchr, RTStrMemFind16, RTStrMemFind64
+ */
+RTDECL(uint32_t *) RTStrMemFind32(const void *pvHaystack, uint32_t uNeedle, size_t cbHaystack);
+
+/**
+ * Searches @a pvHaystack for a 64-bit sized and aligned @a uNeedle.
+ *
+ * @returns Pointer to the first hit if found, NULL if not found.
+ * @param   pvHaystack      The memory to search.
+ * @param   uNeedle         The 64-bit value to find.
+ * @param   cbHaystack      Size of the memory to search.
+ * @sa      memchr, RTStrMemFind16, RTStrMemFind32
+ */
+RTDECL(uint64_t *) RTStrMemFind64(const void *pvHaystack, uint64_t uNeedle, size_t cbHaystack);
+
+/** @}  */
+
+
 /** @} */