[#BloombergLP-bdldfp-DecimalNumGet-do_get-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalNumGet.adoc[DecimalNumGet]::do&lowbar;get
:relfileprefix: ../../../
:mrdocs:

Parse a decimal value from the specified iterator range into `value`&period;

== Synopsis

Declared in `&lt;bdldfp&lowbar;decimal&period;h&gt;`

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

== Description

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

== 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]#
