-
Notifications
You must be signed in to change notification settings - Fork 1.6k
/
double.dart
184 lines (161 loc) · 6.53 KB
/
double.dart
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
part of dart.core;
/// A double-precision floating point number.
///
/// Representation of Dart doubles containing double specific constants
/// and operations and specializations of operations inherited from
/// [num]. Dart doubles are 64-bit floating-point numbers as specified in the
/// IEEE 754 standard.
///
/// The [double] type is contagious. Operations on [double]s return
/// [double] results.
///
/// It is a compile-time error for a class to attempt to extend or implement
/// double.
abstract class double extends num {
static const double nan = 0.0 / 0.0;
static const double infinity = 1.0 / 0.0;
static const double negativeInfinity = -infinity;
static const double minPositive = 5e-324;
static const double maxFinite = 1.7976931348623157e+308;
double remainder(num other);
double operator +(num other);
double operator -(num other);
double operator *(num other);
double operator %(num other);
double operator /(num other);
int operator ~/(num other);
double operator -();
double abs();
/// Returns the sign of the double's numerical value.
///
/// Returns -1.0 if the value is less than zero,
/// +1.0 if the value is greater than zero,
/// and the value itself if it is -0.0, 0.0 or NaN.
double get sign;
/// Returns the integer closest to this number.
///
/// Rounds away from zero when there is no closest integer:
/// `(3.5).round() == 4` and `(-3.5).round() == -4`.
///
/// Throws an [UnsupportedError] if this number is not finite
/// (NaN or an infinity), .
int round();
/// Returns the greatest integer no greater than this number.
///
/// Rounds the number towards negative infinity.
///
/// Throws an [UnsupportedError] if this number is not finite
/// (NaN or infinity), .
int floor();
/// Returns the least integer which is not smaller than this number.
///
/// Rounds the number towards infinity.
///
/// Throws an [UnsupportedError] if this number is not finite
/// (NaN or an infinity), .
int ceil();
/// Returns the integer obtained by discarding any fractional
/// part of this number.
///
/// Rounds the number towards zero.
///
/// Throws an [UnsupportedError] if this number is not finite
/// (NaN or an infinity), .
int truncate();
/// Returns the integer double value closest to `this`.
///
/// Rounds away from zero when there is no closest integer:
/// `(3.5).roundToDouble() == 4` and `(-3.5).roundToDouble() == -4`.
///
/// If this is already an integer valued double, including `-0.0`, or it is not
/// a finite value, the value is returned unmodified.
///
/// For the purpose of rounding, `-0.0` is considered to be below `0.0`,
/// and `-0.0` is therefore considered closer to negative numbers than `0.0`.
/// This means that for a value, `d` in the range `-0.5 < d < 0.0`,
/// the result is `-0.0`.
double roundToDouble();
/// Returns the greatest integer double value no greater than `this`.
///
/// If this is already an integer valued double, including `-0.0`, or it is not
/// a finite value, the value is returned unmodified.
///
/// For the purpose of rounding, `-0.0` is considered to be below `0.0`.
/// A number `d` in the range `0.0 < d < 1.0` will return `0.0`.
double floorToDouble();
/// Returns the least integer double value no smaller than `this`.
///
/// If this is already an integer valued double, including `-0.0`, or it is not
/// a finite value, the value is returned unmodified.
///
/// For the purpose of rounding, `-0.0` is considered to be below `0.0`.
/// A number `d` in the range `-1.0 < d < 0.0` will return `-0.0`.
double ceilToDouble();
/// Returns the integer double value obtained by discarding any fractional
/// digits from `this`.
///
/// If this is already an integer valued double, including `-0.0`, or it is not
/// a finite value, the value is returned unmodified.
///
/// For the purpose of rounding, `-0.0` is considered to be below `0.0`.
/// A number `d` in the range `-1.0 < d < 0.0` will return `-0.0`, and
/// in the range `0.0 < d < 1.0` it will return 0.0.
double truncateToDouble();
/// Provide a representation of this [double] value.
///
/// The representation is a number literal such that the closest double value
/// to the representation's mathematical value is this [double].
///
/// Returns "NaN" for the Not-a-Number value.
/// Returns "Infinity" and "-Infinity" for positive and negative Infinity.
/// Returns "-0.0" for negative zero.
///
/// For all doubles, `d`, converting to a string and parsing the string back
/// gives the same value again: `d == double.parse(d.toString())` (except when
/// `d` is NaN).
String toString();
/// Parse [source] as an double literal and return its value.
///
/// Accepts an optional sign (`+` or `-`) followed by either the characters
/// "Infinity", the characters "NaN" or a floating-point representation.
/// A floating-point representation is composed of a mantissa and an optional
/// exponent part. The mantissa is either a decimal point (`.`) followed by a
/// sequence of (decimal) digits, or a sequence of digits
/// optionally followed by a decimal point and optionally more digits. The
/// (optional) exponent part consists of the character "e" or "E", an optional
/// sign, and one or more digits.
/// The [source] must not be `null`.
///
/// Leading and trailing whitespace is ignored.
///
/// If the [source] string is not a valid double literal, the [onError]
/// is called with the [source] as argument, and its return value is
/// used instead.
/// Throws a [FormatException] if the [source] string is not valid
/// and no `onError` is provided.
///
/// Examples of accepted strings:
/// ```dart
/// "3.14"
/// " 3.14 \xA0"
/// "0."
/// ".0"
/// "-1.e3"
/// "1234E+7"
/// "+.12e-9"
/// "-NaN"
/// ```
/// The [onError] parameter is deprecated and will be removed.
/// Instead of `double.parse(string, (string) { ... })`,
/// you should use `double.tryParse(string) ?? (...)`.
external static double parse(String source,
[@deprecated double onError(String source)?]);
/// Parse [source] as an double literal and return its value.
///
/// Like [parse] except that this function returns `null` for invalid inputs
/// instead of throwing.
external static double? tryParse(String source);
}