Function Coerce Make Class

CoerceToLongFast

"Coerce String To Long (Fast)" Return the Long value whose in-memory representation is the same as the first 4 (four) characters in string vString. Similar to the CVL function in earlier versions of Microsoft Basic. Faster version of the CoerceToLong function which has restrictive argument types (to avoid argument fix-up overhead).

Signature (Visual Basic / VBA)

Public Function CoerceToLongFast( _
    ByVal vString As String _
    ) As Long

Code Example

    CoerceToLongFast(String$(4, 0)) = 0&
    CoerceToLongFast(Chr$(1) + Chr$(0) + Chr$(0) + Chr$(0)) = 1&
    CoerceToLongFast(Chr$(0) + Chr$(1) + Chr$(0) + Chr$(0)) = 256&
    CoerceToLongFast(String$(4, 255)) = -1&
    CoerceToLongFast(String$(4, 254)) = -16843010&

Parameters

Parameter Description
vString The string whose first four characters are to be interpreted as a Long value.

Notes & Version History

Note Function does NOT generate an error if vString less than or greater than four characters long.
Note If vString is more than four characters long, the leftmost four characters are coerced to a Long value.
Note This function first converts the string from Unicode to the default code page of the system.
v1.3 Change Removed 16-bit support from this function.