CreateDouble()

Purpose:

FCJSon::CreateDouble() creates a new initialized json double object and returns it's ident.

Usage:

jsonident = FCJSon::CreateDouble(<fval> [, <dpyval>]);

Arguments:

float or alpha <fval or dpyval> - The value to assign to the double value in the new object.
See notes below about this argument and 4csrvr versions.

alpha <dpyval> - An optional string to use when outputting. This value will usually be contructed from a sys.fmt_float() call.

Returns:

integer <jsonident> - The ident of the new json object

Where Used:

FCJSon::CreateDouble() can be called from anywhere.

Example:

Example

Description:

FCJSon::CreateDouble() creates a new initialized json double object and returns it's ident.

If the only reason for creating the double object is to immediately add it to another object and then never use if for anything else, you should use one of FCJSon::ArrayAddDouble(), FCJSonArrayPutDouble(), or FCJSon::AddDouble() instead. Those functions will create, initialize, and add it the other object using only one call.

Bugs/Features/Comments:

4csrvr version 6.7.3-01 and later allow the <fval or dpyval> argument to be an alpha represenation of the double value and it is interpreted as both the value to store into the double object and the value to display when the json object is output to a file or 4c field. In this case, it is not necessary to specify the <dpyval> as a separate argument since both the double value and the display value are set with this single argument

Versions earlier than 6.7.3-01 must pass a float type for this argument and must specify the <dpyval> argument if the display value when outputting should be different than the default formatting used by the json-c library.

See Also:

FCJSon Function List