TOC PREV NEXT INDEX


XML Numeric Values Format Specification



These qualifiers are used to customize the encoding format of numeric values (XSD double, decimal, or float types). It is sometimes necessary to have numbers formatted in a certain way (for example, a decimal value format such as"+0012.00"). By default, all leading and trailing zeros are omitted, as well as the positive sign, so the value above will be encoded as "12". It is possible using these qualifiers to specify the exact required format of such values. This can be done at any scope - global, schema or node. To customize the format of all decimal, double or float values at the global or schema level, use the <decimalFormat>, <doubleFormat> and <floatFormat> configuration elements respectively. For the node scope, use <numericFormat> element.

Usage

<decimalFormat | doubleFormat | floatFormat | numericFormat
 
	[totalDigits="xs:byte"]
 
	[fractionDigits="xs:byte"]
 
	[fractionMinDigits="xs:byte"]
 
	[integerMaxDigits="xs:byte"]
 
	[integerMinDigits="xs:byte"]
 
	[expSymbol="xs:token"]
 
	[expMinValue="xs:short"]
 
	[expMaxValue="xs:short"]
 
	[expDigits="xs:byte"]
 
	[signPresent="xs:boolean"]
 
	[pointPresent="xs:boolean"]
 
	[expSignPresent="xs:boolean"]
 
	[expPresent="xs:boolean"]
 
>
 

All attr
Attribute name
Applicable
types
Description
totalDigits
double
float
decimal
Number of total significiant digits. Trailing and leading zeros are not counted by this parameter.
fractionDigits
double
float
decimal
Number of maximum signficiant digits in fraction part, precision.
fractionMinDigits
double
float
decimal
Number of minimum digits in the fraction part. If the fraction part has less digits than this parameter then trailing zeros will be added.
integerMaxDigits
double
float
decimal
Maximum digits in integer part; if it is 0 and integer part is 0 then integer part will be omitted, for example .3, or -.3.
integerMinDigits
double
float
decimal
Minimum digits in integer part, leading zeros will be added if necessary.
expSymbol
double
float
Exponent symbol. 'E' or 'e' only; 0 if no exponent is expected.
expMinValue
double
float
Minimum exponent value. By default, -infinity.
expMaxValue
double
float
Maximum exponent value. By default, infinity.
expDigits
double
float
Number of digits in exponent part; if exponent's value is not enough, trailing zeros will be added.
 
signPresent
double
float
decimal
Indicates ("true" or "false"), sign must be present, even if value is positive.
pointPresent
double
float
decimal
Indicates ("true" or "false"), decimal point must be present, even if value's fraction is 0
expPresent
double
float
Indicates ("true" or "false"), exponent must be present, even if its value is 0.
 
expSignPresent
double
float
Indicates ("true" or "false"), exponent sign must be present, even if its value is positive.
ibutes are optional, the order is not important.

So, to format a decimal value "12" as "+0012.00" the configuration element for node should look as follows:

<numericFormat fractionMinDigits="2" integerMinDigits="4" signPresent="true"/>

Copyright © Objective Systems 2002-2008
This document may be distributed in any form, electronic or otherwise, provided that it is distributed in its entirety and that the copyright and this notice are included.

Objective Systems, Inc.

55 Dowlin Forge Road
Exton, Pennsylvania 19341
http://www.obj-sys.com
Phone: (484) 875-9841
Toll-free: (877) 307-6855 (US only)
Fax: (484) 875-9830
info@obj-sys.com

TOC PREV NEXT INDEX