bool Revalidate();

Parameters

(None)

Return Values

• True: Successful validation.
• False: Failed validation or error.

Remarks

The Revalidate function guarantees that the currently loaded data would, if Save or Save_As were called, successfully deserialize using Load. The function determines objective validity of the deserialized file by performing the following actions:

1. Serializing to memory (ignoring pause points)
2. Deserializing this memory (ignoring pause points) using a different BAR object instance
3. Examining the result of deserialization (succeeded or failed).

If the file serializes and re-deserializes correctly, the function returns true. Otherwise, the function returns false.

This function is memory-intensive and time-intensive compared to Validate, and requires that a free BAR object instance, an adequate number of node handles, and an adequate supply of memory be available for the task. Memory and resources allocated in the course of this function are freed upon return.

The function fails if no file was loaded.

Compatibility

	All Platforms	Win32 C++ LIB
BAR version	1.1	1.1
	All Platforms	Win32
BARfly version	1.0	1.0

  See also:  [BAR type lookup functions] [BAR loading and saving functions] [BAR node navigation functions]
[BAR node information functions] [BAR data reading functions] [BAR data writing functions] [BAR miscellaneous functions]