1720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// Copyright 2010 the V8 project authors. All rights reserved.
23484964a86451e86dcf04be9bd8c0d76ee04f081rossberg@chromium.org// Use of this source code is governed by a BSD-style license that can be
33484964a86451e86dcf04be9bd8c0d76ee04f081rossberg@chromium.org// found in the LICENSE file.
4720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org
5720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org#ifndef V8_FIXED_DTOA_H_
6720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org#define V8_FIXED_DTOA_H_
7720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org
8720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.orgnamespace v8 {
9720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.orgnamespace internal {
10720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org
11720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// Produces digits necessary to print a given number with
12720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// 'fractional_count' digits after the decimal point.
13720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// The buffer must be big enough to hold the result plus one terminating null
14720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// character.
15720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org//
16720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// The produced digits might be too short in which case the caller has to fill
17720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// the gaps with '0's.
18720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// Example: FastFixedDtoa(0.001, 5, ...) is allowed to return buffer = "1", and
19720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// decimal_point = -2.
20720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// Halfway cases are rounded towards +/-Infinity (away from 0). The call
21720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// FastFixedDtoa(0.15, 2, ...) thus returns buffer = "2", decimal_point = 0.
22720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// The returned buffer may contain digits that would be truncated from the
23720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// shortest representation of the input.
24720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org//
25720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// This method only works for some parameters. If it can't handle the input it
26720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org// returns false. The output is null-terminated when the function succeeds.
27720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.orgbool FastFixedDtoa(double v, int fractional_count,
28720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org                   Vector<char> buffer, int* length, int* decimal_point);
29720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org
30720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org} }  // namespace v8::internal
31720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org
32720dc0bc17114e33b9b2177fcb6726bda9cabd62sgjesse@chromium.org#endif  // V8_FIXED_DTOA_H_
33