ALIAS: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 36: Line 36:
'''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. Saves you from creating a wrapper [[SUB]]. Just place
   use '''ALIAS''' instead of creating a wrapper [[SUB]]. Just place your
   your name for the procedure first with the actual Library name after '''ALIAS'''.
   name for the procedure first with the actual Library name after '''ALIAS'''.
{{PreEnd}}
{{PreEnd}}



Revision as of 09:03, 25 July 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