[#BloombergLP-bdldfp-DecimalNumGet-do_get-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalNumGet.adoc[DecimalNumGet]::do_get
:relfileprefix: ../../../
:mrdocs:

Parse a decimal value from the specified iterator range into `value`.

== Synopsis

Declared in `<bdldfp_decimal.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
xref:BloombergLP/bdldfp/DecimalNumGet/iter_type.adoc[iter_type]
do_get(
    xref:BloombergLP/bdldfp/DecimalNumGet/iter_type.adoc[iter_type] begin,
    xref:BloombergLP/bdldfp/DecimalNumGet/iter_type.adoc[iter_type] end,
    std::ios_base& str,
    std::ios_base::iostate& err,
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32]& value) const;
----

== Description

Interpret characters from the half‐open iterator range denoted by the specified `begin` and `end`, generate a decimal floating‐point number and store it into the specified `value`. During conversion the formatting flags of the specified `str` (`str.flags()`) are obeyed; character classifications are determined by the `bsl::ctype` while punctuation characters are determined by the `bsl::numpunct` facet imbued to the `str` stream‐base. Use the specified `err` to report back failure or EOF streams states. For further, more detailed information please consult the section [lib.facet.num.get.virtuals]of the C++ Standard. Note that for the conversions to the `Decimal32`, 64 and 128 types the conversion specifiers are %Hg, %Dg and %DDg, respectively. Also note that these (possibly overridden) `do_get` virtual function are used by every formatted C++ stream input operator call (`in >> aDecNumber`).

== Return Value

an iterator positioned after the last character consumed

== Parameters

[cols="1,4"]
|===
| Name| Description
| *begin*
| start of the input iterator range
| *end*
| end of the input iterator range
| *str*
| character sequence to parse
| *err*
| stream error state to update
| *value*
| object to receive the parsed value
|===


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