Data Format Description Language (DFDL) v1.0 Specification
OGF Proposed Recommendation GFD-P-R.174, January 31, 2011
Property Name |
Description |
---|---|
nilKind |
Enum Valid values ‘literalValue’, ‘logicalValue’, ‘literalCharacter’, Used when xs:nillable is 'true'Specifies how dfdl:nilValue is interpreted to represent the nil value in the data stream.. If ‘literalCharacter’ then dfdl:nilValue specifies a single character or a single byte that, when repeated to the length of the element, is the nil value. ‘literalCharacter’ may only be specified for fixed length elements, that is dfdl:lengthKind 'implicit' and 'explicit' when dfdl:length is not a DFDL expression, otherwise it is a schema definition error.If ‘literalValue’ then dfdl:nilValue specifies a list of DFDL literal strings that are the possible representation values for nil. If ‘logicalValue’ then dfdl:nilValue specifies a list of logical values that are the possible logical values for nil. Annotation: dfdl:element(simpleType) |
nilValue |
List of DFDL String Literals, List of Logical Values, DFDL String Literal Specifies the text strings that are the possible literal or logical nil values of the element. If dfdl:nilKind is ‘literalValue’ then nilValue specifies a white space separated list of DFDL literal strings that are the possible representation values for nil. On parsing the element value is nil if the data matches one of the literal strings in the list. On unparsing if the element value is nil the first nilValue from the list is output. Only applicable when representation is 'text' If dfdl:nilKind is ‘logicalValue’ then nilValue specifies white space separated list of logical values that are the possible logical values for nil. On parsing the element value is nil if the data, converted to its logical type, matches any of the logical values in the list. On unparsing if the element value is nil, the first nilValue from the list is converted to its physical representation and output. If dfdl:nilKind is 'literalCharacter' then nilValue specifies a single character or byte that, when repeated to the length of the element, is the nil representation value. If a character, then it can be specified using a literal character or using DFDL entities. If a character is specified when dfdl:lengthUnits='bytes' then the nilValue must be a single-byte character.If a byte, then it must be specified using a single %#r entity If a byte is specified when dfdl:lengthUnits='characters' then the encoding must be a fixed-width encoding On parsing the element value is nil if all characters in the data match the nilValue character . On unparsing if the element value is nil the nilValue character is output to the required length. Annotation: dfdl:element(simpleType) |
nilValueDelimiterPolicy |
Enum Valid values are 'none', 'initiator', 'terminator' or 'both'. Indicates that when a value is nil, an initiator (if one is defined), a terminator (if one is defined), both an initiator and a terminator (if defined) or neither must be present. Ignored if both dfdl:initiator and dfdl:terminator are "" (empty string). 'initiator' indicates that, on parsing, the dfdl:initiator followed by one of the dfdl:nilValue is the required syntax to indicate that a nil value is present. It also indicates that on unparsing when the logical value is nil that the dfdl:initiator will be output followed by the first of the dfdl:nilValue. 'terminator' indicates that, on parsing, by one of the dfdl:nilValue followed by the dfdl:terminator is the required syntax to indicate that a nil value is present. It also indicates that on unparsing when the logical value is nil the first of the dfdl:nilValue followed by the dfdl:terminator will be output. 'both' indicates that, on parsing, both the dfdl:initiator and dfdl:terminator must be present with one of the dfdl:nilValue to indicate that a nil value is present. On unparsing the dfdl:initiator followed by the first dfdl:nilValue, followed by the dfdl:terminator will be output. 'none' indicates that one of the dfdl:nilValue without any dfdl:initiator or dfdl:terminator triggers creation of a nilvalue. On unparsing the first of the dfdl:nilValue is output without the dfdl:initiator or dfdl:terminator. It is a schema definition error if dfdl:nilValueDelimiterPolicy is set to 'none' or 'terminator' when the parent xs:sequence has dfdl:initiatedContent 'yes'. Annotation: dfdl:element(simpleType) |
Copyright (C) Open Grid Forum (2005-2010). All Rights Reserved.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the OGF or other organizations, except as needed for the purpose of developing Grid Recommendations in which case the procedures for copyrights defined in the OGF Document process must be followed, or as required to translate it into languages other than English.