ALIAS: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Removed redirect to DECLARE LIBRARY)
Tag: Removed redirect
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 21: Line 21:


{{PageExamples}}
{{PageExamples}}
;Example:Instead of creating a SUB with the Library statement inside of it, just rename it.
;Example:Instead of creating a wrapper [[SUB]] with the Library statement inside of it, just rename it in the declaration.
{{CodeStart}}
{{CodeStart}}
{{Cl|DECLARE LIBRARY}}
{{Cl|DECLARE LIBRARY}}
Line 34: Line 34:
{{CodeEnd}}
{{CodeEnd}}
{{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. Saves you from creating a wrapper [[SUB]]. Just place
use '''ALIAS''' instead of creating a wrapper [[SUB]]. Just place your name for
  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}}




Line 44: Line 44:
* [[SUB]], [[FUNCTION]]
* [[SUB]], [[FUNCTION]]
* [[DECLARE LIBRARY]], [[BYVAL]]
* [[DECLARE LIBRARY]], [[BYVAL]]
* [[DECLARE DYNAMIC LIBRARY]]




{{PageNavigation}}
{{PageNavigation}}

Latest revision as of 22:59, 27 February 2024

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