From d57d9737d712ea0c72795f03013d76503635f278 Mon Sep 17 00:00:00 2001 From: Aleksey Tsalolikhin Date: Thu, 6 Aug 2020 15:27:39 -0700 Subject: Remove decimal number text from v1.6 manual --- docs/content/manual/v1.6/manual.yml | 47 ------------------------------------- 1 file changed, 47 deletions(-) diff --git a/docs/content/manual/v1.6/manual.yml b/docs/content/manual/v1.6/manual.yml index c6490682..7a14c89e 100644 --- a/docs/content/manual/v1.6/manual.yml +++ b/docs/content/manual/v1.6/manual.yml @@ -292,36 +292,11 @@ sections: program can be a useful way of formatting JSON output from, say, `curl`. - An important point about the identity filter is that it - guarantees to preserve the literal decimal representation - of values. This is particularly important when dealing with numbers - which can't be losslessly converted to an IEEE754 double precision - representation. - - jq doesn't truncate the literal numbers to double unless there - is a need to make arithmetic operations with the number. - Comparisons are carried out over the untruncated big decimal - representation of the number. - - jq will also try to maintain the original decimal precision of the provided - number literal. See below for examples. - examples: - program: '.' input: '"Hello, world!"' output: ['"Hello, world!"'] - - program: '. | tojson' - input: '12345678909876543212345' - output: ['"12345678909876543212345"'] - - - program: 'map([., . == 1]) | tojson' - input: '[1, 1.000, 1.0, 100e-2]' - output: ['"[[1,true],[1.000,true],[1.0,true],[1.00,true]]"'] - - - program: '. as $big | [$big, $big + 1] | map(. > 10000000000000000000000000000000)' - input: '10000000000000000000000000000001' - output: ['[true, false]'] - title: "Object Identifier-Index: `.foo`, `.foo.bar`" body: | @@ -538,16 +513,6 @@ sections: expression that takes an input, ignores it, and returns 42 instead. - Numbers in jq are internally represented by their IEEE754 double - precision approximation. Any arithmetic operation with numbers, - whether they are literals or results of previous filters, will - produce a double precision floating point result. - - However, when parsing a literal jq will store the original literal - string. If no mutation is applied to this value then it will make - to the output in its original form, even if conversion to double - would result in a loss. - entries: - title: "Array construction: `[]`" body: | @@ -666,18 +631,6 @@ sections: try to add a string to an object you'll get an error message and no result. - Please note that all numbers are converted to IEEE754 double precision - floating point representation. Arithmetic and logical operators are working - with these converted doubles. Results of all such operations are also limited - to the double precision. - - The only exception to this behaviour of number is a snapshot of original number - literal. When a number which originally was provided as a literal is never - mutated until the end of the program then it is printed to the output in its - original literal form. This also includes cases when the original literal - would be truncated when converted to the IEEE754 double precision floating point - number. - entries: - title: "Addition: `+`" body: | -- cgit v1.2.3