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

This component‐private utility `struct` provides a namespace for a suite of functions used by `BerUtil` to implement BER encoding and decoding operations for byte values. Within the definition of this `struct`:

== Synopsis

Declared in `<balber_berutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct BerUtil_CharacterImpUtil;
----

== Description

* *the specification*: > Refers to the August 2015 revision of the ITU‐T Recommendation X.690.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/IntegerUtil.adoc[`IntegerUtil`] 
| `IntegerUtil` is an alias to a namespace for a suite of functions used to implement BER encoding and decoding operations for integer values.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/LengthUtil.adoc[`LengthUtil`] 
| `LengthUtil` is an alias to a namespace for a suite of functions used to implement BER encoding and decoding operations for length quantities.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/getCharValue.adoc[`getCharValue`] 
| 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 integer according to the specification. 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 an integer value according to the specification. Note that the signedness of the interpreted integer value is the same as the signedness of `char` according to the current platform.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/getSignedCharValue.adoc[`getSignedCharValue`] 
| 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 integer according to the specification. 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 an integer value according to the specification.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/getUnsignedCharValue.adoc[`getUnsignedCharValue`] 
| 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 integer according to the specification. 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 an integer value according to the specification.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/putCharValue.adoc[`putCharValue`] 
| Write the length and contents octets of the BER encoding of the specified integer `value` (as defined in the specification) to the output sequence of the specified `streamBuf`. Return 0 if successful, and a non‐zero value otherwise. The operation succeeds if all bytes corresponding to the length and contents octets are written to the `streamBuf` without the write position becoming unavailable.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/putSignedCharValue.adoc[`putSignedCharValue`] 
| Write the length and contents octets of the BER encoding of the specified integer `value` (as defined in the specification) to the output sequence of the specified `streamBuf`. Return 0 if successful, and a non‐zero value otherwise. The operation succeeds if all bytes corresponding to the length and contents octets are written to the `streamBuf` without the write position becoming unavailable.
| xref:BloombergLP/balber/BerUtil_CharacterImpUtil/putUnsignedCharValue.adoc[`putUnsignedCharValue`] 
| Write the length and contents octets of the BER encoding of the specified integer `value` (as defined in the specification) to the output sequence of the specified `streamBuf`. Return 0 if successful, and a non‐zero value otherwise. The operation succeeds if all bytes corresponding to the length and contents octets are written to the `streamBuf` without the write position becoming unavailable.
|===



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