ALIAS: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 35: Line 35:
{{PreStart}}
{{PreStart}}
'''Explanation:'''
'''Explanation:'''
  When a Library procedure is used to represent another procedure name
When a Library procedure is used to represent another procedure name
  use '''ALIAS''' instead of creating a wrapper [[SUB]]. Just place your name for
use '''ALIAS''' instead of creating a wrapper [[SUB]]. Just place your name for
  the procedure first with the actual Library name after '''ALIAS'''.
the procedure first with the actual Library name after '''ALIAS'''.
{{PreEnd}}
{{PreEnd}}



Revision as of 22:27, 7 October 2023

The ALIAS clause in a DECLARE LIBRARY statement block tells the program the name of the procedure used in the external library.


Syntax

DECLARE LIBRARY
SUB pseudoname ALIAS actualname [(parameters)]
END DECLARE


Parameters

  • The pseudoname is the name of the SUB or FUNCTION the QB64 program will use.
  • The actualname is the same procedure name as it is inside of the library code, it may optionally have a prepended namespace specification (e.g. ALIAS std::malloc).
  • QB64 must use all parameters of imported procedures including optional ones.


Description

  • The ALIAS name clause is optional as the original library procedure name can be used.
  • The procedure name does not have to be inside of quotes when using DECLARE LIBRARY.
  • QB64 does not support optional parameters.


Examples

Example
Instead of creating a wrapper SUB with the Library statement inside of it, just rename it in the declaration.
DECLARE LIBRARY
    SUB MouseMove ALIAS glutWarpPointer (BYVAL xoffset&, BYVAL yoffset&)
END DECLARE

DO UNTIL _SCREENEXISTS: LOOP
PRINT "Hit a key to move the pointer to top left corner..."
SLEEP

MouseMove 1, 1
Explanation:
 When a Library procedure is used to represent another procedure name
 use ALIAS instead of creating a wrapper SUB. Just place your name for
 the procedure first with the actual Library name after ALIAS.


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link