IsWDDX

Description

Determines whether a value is a well-formed WDDX packet.

Returns

True, if the value is a well-formed WDDX packet; False, otherwise.

Category

Decision functions, XML functions

Syntax

IsWDDX(value)

See also

Using WDDX in Using XML and WDDX in ColdFusion MX Developer's Guide

History

ColdFusion MX: Changed behavior: if the value parameter is not a WDDX packet, ColdFusion returns False. (In earlier releases, ColdFusion threw an error.)

Parameters

Parameter Description

value

A WDDX packet

Usage

This function processes a WDDX packet with a validating XML parser, which uses the WDDX Document Type Definition (DTD).

To prevent CFWDDX deserialization errors, you can use this function to validate WDDX packets from unknown sources.

Example

<cfset packet="
   <wddxPacket version='1.0'>
   <header></header>
   <data>
      <struct>
      <var name='ARRAY'>
         <array length='3'>
            <string>one</string>
         <string>two</string>
         </array>
      </var>
      <var name='NUMBER'>
         <string>5</string>
      </var>
      <var name='STRING'>
         <string>hello</string>
      </var>
      </struct>
   </data>
   </wddxPacket>"
   >
<hr>
<xmp>
<cfoutput>#packet#
</xmp>
IsWDDX() returns #IsWDDX(packet)#<br>
</cfoutput>

View comments in LiveDocs