isValidUtf8ByteString :: ByteString -> Bool
Is the ByteString a valid UTF-8 byte sequence?
Test whether or not a sequence of bytes is a valid UTF-8 byte sequence.
In the GHC Haskell ecosystem, there are several representations of byte
sequences. The only one that the stable text API concerns itself with is
ByteString. Part of bytestring-to-text decoding is isValidUtf8ByteString,
a high-performance UTF-8 validation routine written in C++ with fallbacks
for various platforms. The C++ code backing this routine is nontrivial,
so in the interest of reuse, this module additionally exports functions
for working with the GC-managed ByteArray type. These ByteArray
functions are not used anywhere else in text. They are for the benefit
of library and application authors who do not use ByteString but still
need to interoperate with text.
isValidUtf8ByteString :: ByteString -> BoolIs the ByteString a valid UTF-8 byte sequence?
isValidUtf8ByteArray :: ByteArray -> Int -> Int -> BoolFor pinned byte arrays larger than 128KiB, this switches to the safe FFI so that it does not prevent GC. This threshold (128KiB) was chosen somewhat arbitrarily and may change in the future.
ByteArrayBytes
IntOffset
IntLength
isValidUtf8ByteArrayUnpinned :: ByteArray -> Int -> Int -> BoolThis uses the unsafe FFI. GC waits for all unsafe FFI calls
to complete before starting. Consequently, an unsafe FFI call does not
run concurrently with GC and is not interrupted by GC. Since relocation
cannot happen concurrently with an unsafe FFI call, it is safe
to call this function with an unpinned byte array argument.
It is also safe to call this with a pinned ByteArray argument.
ByteArrayBytes
IntOffset
IntLength
isValidUtf8ByteArrayPinned :: ByteArray -> Int -> Int -> BoolThis uses the safe FFI. GC may run concurrently with safe
FFI calls. Consequently, unpinned objects may be relocated while a
safe FFI call is executing. The byte array argument must be pinned,
and the calling context is responsible for enforcing this. If the
byte array is not pinned, this function's behavior is undefined.
ByteArrayBytes
IntOffset
IntLength
Community contribution. The service has not verified this documentation. The generator reported 2 diagnostics.
Target: Linux on x86-64. Some inferred types and resolved links are not available.
Generator: aihc-haddock-858b1951-web-1
Metadata snapshot: 0b0724abd14577f7a6c8172d62e3e1c0808feb114d4d379402e17f37e3c7801e
Open the dependency plan · Download the documentation model