[#BloombergLP-bslim-FuzzUtil-consumeRandomLengthAsciiString-00]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslim.adoc[bslim]::xref:BloombergLP/bslim/FuzzUtil.adoc[FuzzUtil]::consumeRandomLengthAsciiString
:relfileprefix: ../../../
:mrdocs:

Load into `output` a printable ASCII string of length at most `maxLength`.

== Synopsis

Declared in `<bslim_fuzzutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
consumeRandomLengthAsciiString(
    xref:bsl/string.adoc[bsl::string]* output,
    xref:BloombergLP/bslim/FuzzDataView.adoc[FuzzDataView]* fuzzDataView,
    std::size_t maxLength);
----

== Description

Load into the specified `output` a string consisting of printable ASCII characters of length from 0 to the specified `maxLength`. If the specified `fuzzDataView` has fewer bytes than `maxLength`, load at most `fuzzDataView‐>length()` bytes into `output`. If the buffer in `fuzzDataView` contains two successive backslash characters, then in `output` they will be converted to a single backslash () character; if a single backslash character is encountered, the consumption of bytes is terminated. Note that because double backslashes are mapped to single backslashes, more than `maxLength` bytes may be consumed from the buffer to produce the `output`. Also note that the generated string is also a valid UTF‐8 string.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *output*
| destination for the generated string
| *fuzzDataView*
| view providing fuzz input bytes
| *maxLength*
| maximum number of characters to load into `output`
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#