Syntax

   @Reformat(<direction>,<structId>,<attribute>) 
   
Arguments

   <direction> 
   
      Range: DestEncodeSrcDecode | DestDecodeSrcEncode   
      
      Indicates the direction of the Reformat.
      
      DestEncodeSrcDecode means that the Reformat will write data from the 
      fields defined by structId and store them in the attribute specified by 
      <attribute> when it is invoked on a destination transfer specification 
      line (or on a factory input or output clause).
      
      It will decode the data when it is specified on a source line.
      
      DestDecodeSrcEncode performs the opposite.
   
   <structId>  
   
      Range: Must Be Defined  
      
      Identifies the reformat structure definition to use for the Reformat 
      function. These are defined on configuration lines.
   
   <attribute> 
   
      Range: Character String 
      
      This specifies the attribute into which the stored (encode operation) or 
      retrieved (decode operation) is written. 

Configuration

   Reformat STRUCT_DEF <structId> [<fieldName> <fieldType>]+

   <structId>  
   
      The name of the structure defined by the configuration line. This name is 
      then referred to in @Reformat() statements to encode or decode data in the 
      defined structure.
   
      Range: Character String 
      
   <fieldName> 
   
      The name of the field in the structure being defined.
   
      Range: Character String 
      
   <fieldType> 
   
      The type of the field being defined. The field defined here can be any 
      defined for the CAT type. See the FME Readers and Writers manual: 
      Relational Table chapter, Description of CAT Field Types.
   
      Range: Character String 
      
Description

   This function is used to encode and decode data in attributes. One obvious 
   use for this function is to pack and unpack attribute information into binary 
   structures.

   Before an encode operation can be performed, the target structure for the 
   decoding or encoding must first be defined on a configuration line. There is 
   no limit to the number of configuration lines that can be defined in a single 
   mapping file.

   When specified on a transfer specification destination line or on a factory 
   input or output line, this function encodes data into the specified attribute 
   when DestEncodeSrcDecode is specified. When DestDecodeSrcEncode is specified 
   on the destination line or specification line of a factory, then @Reformat() 
   decodes the value of the specified attribute and stores the results in 
   attributes as defined in the structure definition.

   The function also returns the encoded value.