Chapter 6: Calling Functions and Events

Passing arguments to functions and events

In PocketBuilder, arguments for built-in or user-defined functions and events can be passed three ways:

**Table 6-5: Passing arguments to functions and events**
Method of passing	Description
By value	A copy of the variable is available in the function or event script. Any changes to its value affect the copy only. The original variable in the calling script is not affected.
By reference	A pointer to the variable is passed to the function or event script. Changes affect the original variable in the calling script.
Read-only	The variable is available in the function or event. Its value is treated as a constant—changes to the variable are not allowed and cause a compiler error. Read-only provides a performance advantage for some datatypes because it does not create a copy of the data, as with by value. Datatypes for which read-only provides a performance advantage are string, blob, date, time, and DateTime. For other datatypes, read-only provides documentation for other developers by indicating something about the purpose of the argument.