diff --git a/xml/System/Double.xml b/xml/System/Double.xml index 98ac2684559..e89d33fd3ed 100644 --- a/xml/System/Double.xml +++ b/xml/System/Double.xml @@ -64,7 +64,7 @@ value type represents a double-precision 64-bit number with values ranging from negative 1.79769313486232e308 to positive 1.79769313486232e308, as well as positive or negative zero, , , and not a number (). It is intended to represent values that are extremely large (such as distances between planets or galaxies) or extremely small (the molecular mass of a substance in kilograms) and that often are imprecise (such as the distance from earth to another solar system), The type complies with the IEC 60559:1989 (IEEE 754) standard for binary floating-point arithmetic. + The value type represents a double-precision 64-bit number with values ranging from negative 1.79769313486232e308 to positive 1.79769313486232e308, as well as positive or negative zero, , , and not a number (). It is intended to represent values that are extremely large (such as distances between planets or galaxies) or extremely small (such as the molecular mass of a substance in kilograms) and that often are imprecise (such as the distance from earth to another solar system). The type complies with the IEC 60559:1989 (IEEE 754) standard for binary floating-point arithmetic. This topic consists of the following sections: @@ -1815,6 +1815,7 @@ Converts the string representation of a number to its double-precision floating-point number equivalent. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -1861,6 +1862,8 @@ or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `s` parameter can contain the current culture's , , , or a string of the form: [*ws*][*sign*][*integral-digits*[*,*]]*integral-digits*[*.*[*fractional-digits*]][E[*sign*]*exponential-digits*][*ws*] @@ -1959,6 +1962,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `style` parameter defines the style elements (such as white space, thousands separators, and currency symbols) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: - @@ -2089,6 +2094,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + This overload of the method is typically used to convert text that can be formatted in a variety of ways to a value. For example, it can be used to convert the text that is entered by a user into an HTML text box to a numeric value. The `s` parameter is interpreted using a combination of the and flags. The `s` parameter can contain , , or for the culture specified by `provider`, or it can contain a string of the form: @@ -2177,6 +2184,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + If `s` is out of range of the data type, the method returns if `s` is less than and if `s` is greater than . ]]> @@ -2239,6 +2248,8 @@ If `s` is out of range of the data type, the method returns or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `style` parameter defines the style elements (such as white space, thousands separators, and currency symbols) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: - @@ -3690,6 +3701,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts the string representation of a number to its double-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3726,7 +3738,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts the span representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. if was converted successfully; otherwise, . - To be added. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3780,6 +3792,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + This overload differs from the method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. It eliminates the need to use exception handling to test for a in the event that `s` is invalid and cannot be successfully parsed. The `s` parameter can contain the current culture's , , (the string comparison is case-sensitive), or a string of the form: @@ -3868,7 +3882,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts a character span containing the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. if was converted successfully; otherwise, . - To be added. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3927,6 +3941,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The method is like the method, except this method does not throw an exception if the conversion fails. If the conversion succeeds, the return value is `true` and the `result` parameter is set to the outcome of the conversion. If the conversion fails, the return value is `false` and the `result` parameter is set to zero. This eliminates the need to use exception handling to test for a in the event that `s` is invalid and cannot be successfully parsed. The `style` parameter defines the allowable format of the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: diff --git a/xml/System/Single.xml b/xml/System/Single.xml index bf16f458c44..6421dd8dd2f 100644 --- a/xml/System/Single.xml +++ b/xml/System/Single.xml @@ -1830,6 +1830,7 @@ Converts the string representation of a number to its single-precision floating-point number equivalent. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -1876,6 +1877,8 @@ or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `s` parameter can contain the current culture's , , , or a string of the form: [*ws*][*sign*] [*integral-digits*[*,*]]*integral-digits*[*.*[*fractional-digits*]][e[*sign*]*exponential-digits*][*ws*] @@ -1967,6 +1970,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `style` parameter defines the style elements (such as white space, thousands separators, and currency symbols) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: - @@ -2109,6 +2114,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + This overload is typically used to convert text that can be formatted in a variety of ways to a value. For example, it can be used to convert the text entered by a user into an HTML text box to a numeric value. The `s` parameter is interpreted using a combination of the and flags. The `s` parameter can contain , , or for the culture specified by `provider`, or it can contain a string of the form: @@ -2200,6 +2207,8 @@ Some examples of `s` are "100", "-123,456,789", "123.45e+6", "+500", "5e2", "3.1 or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + If `s` is out of range of the data type, the method returns if `s` is less than and if `s` is greater than . ]]> @@ -2262,6 +2271,8 @@ If `s` is out of range of the data type, the method returns or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + The `style` parameter defines the style elements (such as white space, thousands separators, and currency symbols) that are allowed in the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: - @@ -3685,6 +3696,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts the string representation of a number to its single-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3720,7 +3732,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts the string representation of a number in a character span to its single-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. if was converted successfully; otherwise, . - To be added. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3774,6 +3786,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + This overload differs from the method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. It eliminates the need to use exception handling to test for a in the event that `s` is invalid and cannot be successfully parsed. The `s` parameter can contain , , (the string comparison is case-sensitive), or a string of the form: @@ -3855,7 +3869,7 @@ If a separator is encountered in the `s` parameter during a parse operation, and Converts the span representation of a number in a specified style and culture-specific format to its single-precision floating-point number equivalent. A return value indicates whether the conversion succeeded or failed. if was converted successfully; otherwise, . - To be added. + In .NET Core 3.0 and later, values that are too large to represent are rounded to or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. @@ -3913,6 +3927,8 @@ If a separator is encountered in the `s` parameter during a parse operation, and or as required by the IEEE 754 specification. In prior versions, including .NET Framework, parsing a value that was too large to represent resulted in failure. + This overload differs from the method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed numeric value. It eliminates the need to use exception handling to test for a in the event that `s` is invalid and cannot be successfully parsed. The `style` parameter defines the allowable format of the `s` parameter for the parse operation to succeed. It must be a combination of bit flags from the enumeration. The following members are not supported: