[C++] Harden decimal parsing against invalid strings

[asfimport]

Reporter: Phillip Cloud / @cpcloud
Assignee: Phillip Cloud / @cpcloud

_{Note: This issue was originally created as ARROW-1061. Please see the migration documentation for further details.}

[asfimport]

Wes McKinney / @wesm:
Issue resolved by pull request 708
#708