ucReturn

ucReturnStr

See Also: ucDefineFunction, ucDefineOperator, ucParam, ucParamHandle

Sets the return value for a Native callback routine.

ucReturn(ExpressionHandle, NumericValue)

- or -

ucReturnStr(ExpressionHandle, StringValue)

Parameters

ExpressionHandle

All native callback routines receive one argument, which is ExpressionHandle. This handle is required as the first argument of ucReturn() or ucReturnStr().

NumericValue or StringValue

This is the return value.

Remarks

• Native callback routines (which are significantly faster than non-native callbacks) are intended for Standard License customers (though you can still test it, just like all other features, with the demo).
• ucReturn is merely a wrapper which looks like this in PowerBASIC:

Sub ucReturnExt Alias "ucReturnExt" (ByVal Expr As ExpressionType Ptr, ByVal ReturnValue As Extended) Export

@Expr.@ResultExt = ReturnValue

End Sub

Details for using pointers with native callback routines are beyond the scope of this help file.

Examples:

Example 1: Returning a numeric value

Example 2: Returning a string value

New or enhanced in version 2.96

• ucReturn was optimized for speed. Use ucReturn instead of ucReturnDbl or ucReturnExt.