Gambas文档
编译和安装
错误消息
代码片段
翻译
废弃的组件
教程
开发环境文档
开发文档
名词解释
如何操作
说明
维基手册
维基搜索
维基许可协议
文档
应用程序仓库
语言概览
语言索引
#Else
#Endif
#If
+INF
-INF
Abs
Access
ACos
ACosh
Alloc
AND
AND IF
Ang
APPEND
AS
Asc
ASin
ASinh
Asl
Asr
ASSERT
ATan
ATan2
ATanh
Base$
Base64$
BChg
BClr
BEGINS
Bin$
Boolean@
BREAK
BSet
BTst
BYREF
Byte@
CASE
CATCH
CBool
Cbr
CByte
CDate
Ceil
CFloat
CHGRP
CHMOD
Choose
CHOWN
Chr$
CInt
CLASS
CLong
CLOSE
Comp
CONST
CONTINUE
Conv$
COPY
Cos
Cosh
CPointer
CREATE
CREATE PRIVATE
CREATE STATIC
CShort
CSingle
CStr
CString
CVariant
Date
Date@
DateAdd
DateDiff
Day
DConv$
DEBUG
DEC
Dec
DEFAULT
Deg
DFree
DIM
Dir
DIV
DO
DOWNTO
EACH
ELSE
END
ENDIF
ENDS
END SELECT
END STRUCT
END WITH
ENUM
Eof
ERROR
ERROR TO
Eval
Even
EVENT
EXEC
Exist
Exp
Exp2
Exp10
Expm
EXPORT
EXTERN
FALSE
FAST
FAST UNSAFE
FINALLY
Fix
Float@
Floor
FLUSH
FOR
FOR EACH
Format$
Frac
Free
FromBase
FromBase64$
FromUrl$
FUNCTION
GOSUB
GOTO
Hex$
Hour
Html$
Hyp
IF
IIf
IN
INC
INCLUDE or #INCLUDE
INHERITS
INPUT
INPUT FROM
InStr
Int
Int@
Integer@
IS
IsAlnum
IsAscii
IsBlank
IsBoolean
IsDate
IsDigit
IsDir
IsFloat
IsHexa
IsInf
IsInteger
IsLCase
IsLetter
IsLong
IsLower
IsMissing
IsNaN
IsNull
IsNumber
IsPunct
IsSpace
IsUCase
IsUpper
KILL
LAST
LCase$
Left$
Len
LET
LIBRARY
LIKE
LINE INPUT
LINK
LOCK
Lof
Log
Log2
Log10
Logp
Long@
LOOP
Lsl
Lsr
LTrim$
Mag
MATCH
Max
ME
Mid$
Min
Minute
MkBool$
MkBoolean$
MkByte$
MkDate$
MKDIR
MkFloat$
MkInt$
MkInteger$
MkLong$
MkPointer$
MkShort$
MkSingle$
MOD
Month
MOVE
NEW
NEXT
NOT
Now
NULL
Oct$
Odd
ON GOSUB
ON GOTO
OPEN
OPEN MEMORY
OPEN MEMORY
OPEN NULL
OPEN PIPE
OPEN PIPE
OPEN STRING
OPTIONAL
OR
OR IF
OUTPUT
OUTPUT TO
PEEK
Pi
Pointer@
PRINT
PRIVATE
PROCEDURE
PROPERTY
PUBLIC
QUIT
Quote$
Rad
RAISE
Rand
RANDOMIZE
RDir
READ
Realloc
REPEAT
Replace$
RETURN
Right$
RInStr
RMDIR
Rnd
Rol
Ror
Round
RTrim$
Scan
SConv$
Second
SEEK
Seek
SELECT
Sgn
SHELL
Shell$
Shl
Short@
Shr
Sin
Single@
Sinh
SizeOf
SLEEP
Space$
Split
Sqr
Stat
STATIC
STEP
STOP
STOP EVENT
Str$
Str@
String$
String@
StrPtr
STRUCT
SUB
Subst$
SUPER
SWAP
Tan
Tanh
Temp$
THEN
Time
Timer
TO
Tr$
Trim$
TRUE
TRY
TypeOf
UCase$
UnBase64$
UNLOCK
Unquote$
UNTIL
Url$
USE
Val
VarPtr
WAIT
WATCH
Week
WeekDay
WEND
WHILE
WITH
WRITE
XOR
Year
本地化和翻译函数
变量声明
常量表达式
常量声明
方法声明
复数
赋值
赋值操作
行标号
结构体声明
局部变量声明
逻辑运算
枚举声明
内置集合
内置数组
使用保留字作为标识符
事件声明
事件循环
属性声明
数据类型
数据类型的二进制表示形式
数组声明
算术运算
外部函数管理
外部函数声明
语言常量
运算符优先级
专用方法
字符串操作
主题
组件
最近的修改

方法声明

过程

[ FAST ] [ STATIC ] { PUBLIC | PRIVATE } { PROCEDURE | SUB } Identifier ( [ [ BYREF ] Parameter AS Datatype [ , … ] ] [ , ] [ OPTIONAL [ BYREF ] Optional Parameter AS Datatype [ , … ] ] [ , ] [ ... ] ) ... END

声明一个过程,也就是一个没有任何返回值的方法。

END 关键字用来表示过程的结尾。

函数

[ FAST ] [ STATIC ] { PUBLIC | PRIVATE } { FUNCTION | PROCEDURE | SUB } Identifier ( [ [ BYREF ] Parameter AS Datatype [ , … ] ] [ , ] [ OPTIONAL [ BYREF ] Optional Parameter AS Datatype [ , … ] ] [ , ] [ ... ] ) AS Datatype ... END

声明一个函数,也就是一个有返回值的方法。

END关键字用来表示函数的结尾。

必须指定返回值的数据类型。

这些声明必须写作单独的一行。像语法描述中那样写,是为了方便阅读。

RETURN 关键字用于结束函数,并且传递返回值给调用程序。

示例

Public Sub Main()
  Print Calc(0);; Calc(0.5);; Calc(1)
End
 
Function Calc(fX As Float) As Float
  Return Sin(fX) * Exp(- fX)
End
0 0.290786288213 0.309559875653

方法的使用

方法可以使用在其声明所在的类中任意位置。

  • 如果指定 PUBLIC 关键字,也可以在其它类中通过引用这个类的对象来使用。

  • 如果指定 STATIC 关键字,方法仅能访问该类的静态变量。

方法的参数

方法的所有参数使用“,”分隔开。

  • 如果指定 OPTIONAL 关键字,其后的所有参数是可选参数。可以在参数声明后面使用等号为其指定缺省值。

  • 如果参数列表以 ... 结束,那么方法可以接收附加参数。每一个附加参数用Param类传递给方法。

示例

STATIC PUBLIC PROCEDURE Main()
...
PUBLIC FUNCTION Calc(fA AS Float, fB AS Float) AS Float
...
PRIVATE SUB DoIt(sCommand AS String, OPTIONAL bSaveIt AS Boolean = TRUE)
...
STATIC PRIVATE FUNCTION MyPrintf(sFormat AS String, ...) AS Integer

使用"..."传递额外参数

自从 3.6

我们可以使用 ... 通过 Function1()Function2() 传递已知数量的参数关键字

或者,它可以用作 可变表达式 ,使用Param类传递任意数量的任何数据类型。

... 关键字用于将所有额外的参数传输给接受它们的函数。

示例 1

将已知数量的参数传递给另一个函数。
Sub Main()

  PassSomeArgs("warning", "format description" , "info")
  
End


Sub PassSomeArgs(sType As String, ...)

  ' Do something with sType and pass all the other args to the next function.

  Print "Got message type " & sType

  PrintMessage(sType, ...)

End

Sub PrintMessage(sType as String, sFormat as String, sInfo as String)

  ' Do some stuff with the known number of arguments passed.

End

示例2

使用 Param 类传递任意数据类型的任意数量的参数(可变)

Sub Main()

  ProcessVariadic("warning", "format description" , "info", -1)

End

Sub ProcessVariadic(...)

' Here we use the Param class to access and print all arguments supplied via "..." (you must take care of variable types if they are unknown)

Print "There are " & Param.Count & " arguments"

 Dim iType As Integer

  For Each vVar As Variant In Param.All

  iType = TypeOf(vVar)

    If iType = gb.String then 
     Print "Arg is a String: " & vVar

    Else If iType = gb.Integer then 
     Print "Arg is Integer: " & Str(vVar)

    Endif

  Next

End

通过引用传递参数

指定 BYREF 关键字时,参数必须是可以被赋值的表达式,被调用的函数或过程可以修改的内容。

示例

SUB ConvPixelToCentimeter(BYREF Value as Float, Dpi AS Integer)

  Value = Value / Dpi * 2.54

END

PUBLIC SUB Main()

  DIM Size AS Float

  Size = 256
  ConvPixelToCentimeter(BYREF Size, 96)
  PRINT Size

END
6.773333333333

即使在声明函数时使用了BYREF关键字,如果在调用函数时不使用BYREF关键字,参数仍将是值传递。

换句话说:被调用的函数 允许 参数通过引用传递,然而由调用程序 决定 参数传递方式。

实时编译

自从 3.2

如果使用了 FAST 关键字,那么及时编译器会优化该方法。

参见