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
专用方法
事件声明
事件循环
使用保留字作为标识符
内置数组
内置集合
变量声明
复数
外部函数声明
外部函数管理
字符串操作
局部变量声明
属性声明
常量声明
常量表达式
数据类型
数据类型的二进制表示形式
数组声明
方法声明
本地化和翻译函数
枚举声明
算术运算
结构体声明
行标号
语言常量
赋值
赋值操作
运算符优先级
逻辑运算
说明
错误消息

Dir

FilenameArray = Dir ( Directory AS String [ , Pattern AS String , Filter AS Integer ] ) AS String[]

返回位于 Directory 目录中与 PatternFilter 条件匹配的文件名,并存储于一个字符串数组中。

Pattern可以包含与 LIKE 操作一样的通配符。如果没有指定Pattern,会返回任何文件名。

过滤器指定将返回的文件类型。

过滤器可以是以下值之一:
  • gb.File 用于仅返回文件。

  • gb.Directory 用于仅返回目录。

  • gb.File + gb.Directory 用于返回两者。

If Options is not specified, all files and directories are returned.

The file names returned are relative to the directory searched. They do not contain the path to the searched directory.

Since 3.20

If you add the gb.FullPath constant to the Options argument, the Directory path is added to each returned file.

Note that the pattern does not apply to the directory part in that case.

示例

' 以字母顺序打印directory目录中的png图像文件文件名

SUB PrintDirectory(Directory AS String)

  DIM File AS String

  FOR EACH File IN Dir(Directory, "*.png").Sort()
    PRINT File
  NEXT

END

' 打印用户主目录中所有非隐藏文件

DIM fileName AS String

FOR EACH fileName IN Dir(User.Home, "[^.]*")
  PRINT fileName
NEXT

' 打印用户主目录中的png和jpeg图像文件名

DIM Directory AS String
DIM Files AS String[]
DIM FileName AS String

Directory = System.User.Home
Files = Dir(Directory, "*.png")
Files.Insert(Dir(Directory, "*.jpg"))
Files.Insert(Dir(Directory, "*.jpeg"))

FOR EACH FileName IN Files
  PRINT FileName
NEXT

'仅仅打印用户主目录中的文件名

DIM fileName AS String

FOR EACH fileName IN Dir(User.Home, "*", gb.File)
  PRINT fileName
NEXT

' 仅仅打印用户主目录中的子目录名

DIM directoryName AS String

FOR EACH directoryName IN Dir(User.Home, "*", gb.Directory)
  PRINT directoryName
NEXT

'打印用户主目录中的非隐藏目录名

DIM directoryName AS String

FOR EACH directoryName IN Dir(User.Home, "[^.]*", gb.Directory)
  PRINT directoryName
NEXT

' 列出系统设备清单

DIM deviceName AS String

FOR EACH deviceName IN Dir("/dev", "*", gb.Device)
  PRINT deviceName
NEXT

参见