Web Vuser Functions (WEB) > Alphabetical List of Web Vuser Functions > web_convert_from_formatted

web_convert_from_formatted

Converts a string created with one or more data format extensions back to the source format.

C Language

int web_convert_from_formatted("FormattedData=<formatted_data_string>", "TargetParam=<parameter_name>", ["Extensions=<comma_seperated_list_of_extensions>",] LAST );

Java Language

int object.convert_from_formatted( const char *FormattedData, const char *TargetParam, String [] {"Extensions=<name>", "LAST"} );    
Argument
Description
FormattedData
The data to convert. If the Extensions argument is omitted, include the wrapping XML tags that specify the extensions. Additional information about the formatted data can be provided with Data Format Qualifiers.
TargetParam
The name of a parameter. The converted string will be saved in this parameter.
Extensions
A comma separated list of the names of the data format extensions that generated the formatted data. The extensions are listed in the reverse order to the order used to create the formatted string.
The extension names are the values of the ExtensionName parameter from the extension INI files.
For example, if the formatted data was generated by applying extension B on the output of extension A, the extension list is "A,B".
LAST
A marker indicating the end of the argument list.

Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.

Parameterization

You cannot use standard parameterization for any arguments in this function.

General Information

The web_convert_from_formatted function converts a string created with one or more data format extensions back to the source format.

This function can be used if Data Format Extensions are enabled in the Run-Time Settings.

For details of the data format extensions provided, and of the settings required to use this feature, see the VuGen User Guide.

Data Format Qualifiers

Formatted data can be qualified. Only one qualifier can be used. For formatted text, no qualifier is used. The qualifiers are:

FormattedData/EscapedBinary - The data is a null-terminated string containing binary code represented with escaped characters. This data is converted to binary before being passed to the first data format extension. See Using Binary Code.

FormattedData/BinaryParam - The data is the name of a parameter containing the formatted data in binary format.