[#BloombergLP-balber-BerUtil_StringImpUtil-getStringValue]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balber.adoc[balber]::xref:BloombergLP/balber/BerUtil_StringImpUtil.adoc[BerUtil_StringImpUtil]::getStringValue
:relfileprefix: ../../../
:mrdocs:

Read the specified `length` number of bytes from the input sequence of the specified `streamBuf` and load to the specified `value` the interpretation of those bytes as the value of the contents octets of a BER‐encoded character string (more specifically, an unrestricted character string) according to the specification, unless an alternate value is indicated by the specified `options`, in which case, the alternate value is loaded. If the `DefaultEmptyStrings` attribute of the `options` is `true` and the witnessed BER‐encoded character string represents the empty string value, the alternate value is the current `*value`, otherwise there is no alternate value. Return 0 if successful, and a non‐zero value otherwise. The operation succeeds if `length` bytes are successfully read from the input sequence of the `streamBuf` without the read position becoming unavailable, and the bytes read contain a valid representation of the contents octets of a character string value according to the specification.

== Synopsis

Declared in `<balber_berutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
getStringValue(
    xref:bsl/string.adoc[bsl::string]* value,
    std::streambuf* streamBuf,
    int length,
    xref:BloombergLP/balber/BerDecoderOptions.adoc[BerDecoderOptions] const& options);
----


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