get_normal_form

Gets a Variant instance that has the same value as this and is trusted to be in normal form.

If this is already trusted to be in normal form then a new reference to this is returned.

If this is not already trusted, then it is scanned to check if it is in normal form. If it is found to be in normal form then it is marked as trusted and a new reference to it is returned.

If this is found not to be in normal form then a new trusted Variant is created with the same value as this.

It makes sense to call this function if you've received Variant data from untrusted sources and you want to ensure your serialised output is definitely in normal form.

Parameters:

this

a Variant

Returns:

a trusted Variant