【215】◀▶ IDL 文件操作说明 (黑底)

参考：I/O - General File Access Routines —— 基本文件操作函数

---

01		CD	修改当前的工作空间路径。
02		FILE_SEARCH	对文件名进行特定的查找。返回字符串数组。
03		FILE_COPY	复制文件或者文件夹。
04		FILE_DELETE	删除文件或者文件夹。
05		FILE_MOVE	移动文件或文件夹。
06		FILE_MKDIR	新建文件夹。
07		FILE_TEST	判断文件是否存在，返回布尔值。
08		FILE_BASENAME	返回文件路径中的文件/文件夹名称。
09		FILE_DIRNAME	返回文件路径所在的文件夹路径。
10		FILE_EXPAND_PATH	返回给定文件/文件夹的完整路径。
11		FILE_INFO	返回给定文件/文件夹的属性信息。
12		FILE_LINES	返回指定文件的行数。
13		ROUTINE_FILEPATH	返回当前编译过程或函数的完整路径。

---

序号

名称

功能说明

 语法 & 举例

01

CD

修改当前的工作空间路径。
CD [, Directory] [, CURRENT=variable]

?

1 2 3 4 5 6 7 8 9 10 11

◈ 指定一个完整的路径：   CD, 'D:\home\data\'   CD, 'D:/home/data/'   ◈ 改变为当前路径的子路径：   CD, 'january'    CD, './january'   ◈ 回到上一级路径：   CD, '..'           CD, '../february'

 02

FILE_SEARCH

====<<<< Description >>>>====

对文件名进行特定的查找。返回字符串数组。
相当于 shell 里面的 ls，显示当前文件夹内的所有文件夹和文件。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Result = FILE_SEARCH(Path_Specification)

or for recursive searching,

Result = FILE_SEARCH(Dir_Specification, Recur_Pattern)

Keywords: [, COUNT=variable ] [, /EXPAND_ENVIRONMENT ] [, /EXPAND_TILDE ] [, /FOLD_CASE ] [, /FULLY_QUALIFY_PATH ] [, /ISSUE_ACCESS_ERROR ] [, /MARK_DIRECTORY ] [, /MATCH_ALL_INITIAL_DOT | /MATCH_INITIAL_DOT ] [, /NOSORT ] [, /QUOTE ] [, /TEST_DIRECTORY ] [, /TEST_EXECUTABLE ] [, /TEST_READ ] [, /TEST_REGULAR ] [, /TEST_WRITE ] [, /TEST_ZERO_LENGTH ] [, /WINDOWS_SHORT_NAMES ]

----------------------------------------------------------------------------------

====<<<< Return Value >>>>====

返回值为匹配的字符串数组。
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

 

◈  Path_Specification：路径字符串，可以包含通配符，如果为空则会默认为"*"；如果指定绝对路径，结果也是绝对路径，如果是相对路径，结果只有文件名。
◈  Dir_Specification：文件夹路径字符串，执行递归查询。
◈  Recur_Pattern：递归查询内容，允许通配符，空相当于"*"。

◈  TEST_REGULAR：仅包括文件。
◈  TEST_DIRECTORY：仅包括文件夹。
◈  COUNT：文件总数。
◈  FULLY_QUALIFY_PATH：添加完整路径
◈  MARK_DIRECTORY：会在文件夹路径后面添加"/"。
◈  TEST_ZERO_LENGTH：仅返回0长度的文件，文件夹会被返回。
----------------------------------------------------------------------------------

====<<<< References >>>>====

参考：IDL中File_Search函数用法详解

?

1 2 3 4 5 6 7 8 9 10 11

◈ 获取当前路径下的所有文件/文件夹：   FILE_SEARCH()　　# 空相当于"*"，相对路径   FILE_SEARCH('*')　　# 查找全部，相对路径   FILE_SEARCH('F:\TestPath\*')　　# 绝对路径   ◈ 获取当前路径下的所有文件：   FILE_SEARCH('*.*')          FILE_SEARCH(/TEST_REGULAR)   ◈ 获取当前路径下的所有文件夹：   FILE_SEARCH(/TEST_DIRECTORY)

递归查询如下，如果不存在二级文件夹则相当于普通查询

?

1 2	MyRootDir='D:\CODES\IDL\GUI_test\data' files = FILE_SEARCH(MyRootDir, 'A2017*.nc', count=num)

 

 03

FILE_COPY

复制文件或者文件夹。
FILE_COPY, SourcePath, DestPath
◈ SourcePath：想要复制的文件夹或文件的路径
◈ DestPath：目的地文件夹
◈ OVERWRITE：覆盖文件

?

1 2 3 4 5 6 7 8

◈ 当前路径内部建立副本：   FILE_COPY, '1.nc', '2.nc'   ◈ 复制到 sub 文件夹中：   FILE_COPY, '1.nc', 'sub'   ◈ 复制多个文件/文件夹：   FILE_COPY, ['*.pro', 'makefile', 'mydata.dat'], 'BACKUP'

 04

FILE_DELETE

删除文件或者文件夹。
FILE_DELETE, File1[,... Filen] [, /ALLOW_NONEXISTENT] [, /NOEXPAND_PATH] [, /QUIET] [, /RECURSIVE] [, /RECYCLE] [, /VERBOSE]
◈ RECURSIVE：默认情况下只能删除空文件夹，设置此参数能够删除非空文件夹
◈ RECYCLE：默认情况下永久删除，设置此参数可以将删除的文件放在回收站里面

?

1 2 3 4 5

◈ 删除当前路径下的 moose 文件夹：   FILE_DELETE, 'moose'   ◈ 删除多个文件/文件夹   FILE_DELETE, '2.jpg', '3.jpg'

 05

FILE_MOVE

移动文件或文件夹。
FILE_MOVE, SourcePath, DestPath [, /ALLOW_SAME] [, /NOEXPAND_PATH] [, /OVERWRITE] [, /REQUIRE_DIRECTORY] [, /VERBOSE]
◈ OVERWRITE：覆盖文件

?

1 2 3 4 5

◈ 文件重命名：   FILE_MOVE, 'backup.dat', 'primary.dat'   ◈ 移动多个文件/文件夹到另一路径下：   FILE_MOVE, ['*.pro', 'makefile', 'mydata.dat'], 'BACKUP'

 06

FILE_MKDIR

新建文件夹。
FILE_MKDIR, File1 [,... FileN] [, /NOEXPAND_PATH]

?

1 2	FILE_MKDIR, 'moose'       FILE_MKDIR, 'moose', 'abc'

 07

FILE_TEST

判断文件是否存在，返回布尔值。（1-true、0-false）
FILE_TEST(File [, /DIRECTORY | ,  /EXECUTABLE | , /READ | , /REGULAR | ,  /WRITE | , /ZERO_LENGTH] [, GET_MODE=variable] [, /NOEXPAND_PATH])
◈ DIRECTORY：存在且是文件夹，返回值为 1 (true)

?

1 2	FILE_TEST('tsm')              FILE_TEST('1.jpg', /DIRECTORY)

 08

FILE_BASENAME

返回文件路径中的文件/文件夹名称。
FILE_BASENAME(Path [, RemoveSuffix])
◈ RemoveSuffix：删除的后缀部分，可以用来删除文件的扩展名

?

1 2 3 4 5

◈ 返回值：dist.pro   FILE_BASENAME('C:\idl\lib\dist.pro')   ◈ 返回值：dist   FILE_BASENAME('C:\idl\lib\dist.pro', '.pro')

 09

FILE_DIRNAME

返回文件路径所在的文件夹路径。
FILE_DIRNAME(Path [, /MARK_DIRECTORY])
◈ MARK_DIRECTORY：是否在末尾添加“\”等分隔符

?

1 2 3 4 5

◈ 返回值：D:\Mc\IDL   FILE_DIRNAME('D:\Mc\IDL\1.jpg')   ◈ 返回值：D:\Mc\IDL\   FILE_DIRNAME('D:\Mc\IDL\1.jpg', /MARK_DIRECTORY)

 10

FILE_EXPAND_PATH

返回给定文件/文件夹的完整路径。
FILE_EXPAND_PATH(Path)

 

?

1 2	◈ 返回值：D:\Mc\IDL\1.jpg   FILE_EXPAND_PATH('1.jpg')

 11

FILE_INFO

返回给定文件/文件夹的属性信息。（路径、大小等）
FILE_INFO(Path [, /NOEXPAND_PATH] )
◈ NOEXPAND_PATH：不显示路径，只显示文件名称

 12

FILE_LINES

返回指定文件的行数。（文本文件）
FILE_LINES(Path [, /COMPRESS] [, /NOEXPAND_PATH])

 13

ROUTINE_FILEPATH

返回当前编译过程或函数的完整路径。
ROUTINE_FILEPATH([Routine] [, /EITHER] [, /IS_FUNCTION])

14

PATH_SEP

====<<<< Description >>>>====

返回当前操作系统分隔符。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

Result = PATH_SEP( [, /PARENT_DIRECTORY] [, /SEARCH_PATH] )

----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  PARENT_DIRECTORY：设置的话返回当前系统父路径符号。

?

1 2 3 4 5 6

IDL> path_sep() \ IDL> path_sep(/PARENT_DIRECTORY) .. IDL> path_sep(/SEARCH_PATH) ;

15

CD

====<<<< Description >>>>====

用来设置或者改变当前的工作空间。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

CD [, Directory] [, CURRENT=variable]

----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  Directory：指定为新工作空间的字符串。
　　如果路径为空字符串，则变为默认路径；
　　如果参数未设置，则工作路径不变。
◈  CURRENT：将修改前的工作路径存储在此变量中。

?

1 2 3 4 5 6 7 8 9 10 11 12 13

IDL> ;指定完整路径 IDL> CD, 'D:\CODES\IDL' IDL> ;改变为当前目录的子文件夹 IDL> CD, 'GUI_test' IDL> CD, 'D:\CODES\IDL' IDL> CD, './GUI_test' IDL> ;回到父目录中 IDL> CD, '..' IDL> ;返回父目录下的另一个文件夹 IDL> CD, '../folder2' IDL> ;模仿 UNIX 系统 pwd 命令 IDL> CD, CURRENT=c & PRINT, c D:\CODES\IDL

CLIPBOARD

获取和设置剪切板内容。

GET_SCREEN_SIZE

获取主显示器的长宽像素值。

IDLsysMonitorInfo

首先需要实例化，如示例所示。

?

1 2 3 4 5 6 7 8 9 10 11 12

IDL> obj = obj_new('IDLsysMonitorInfo') IDL> print, obj.GetNumberOfMonitors()        2 IDL> print, obj.GETMONITORNAMES()   IDL> print, obj.GETRESOLUTIONS()      0.015119048     0.015119048      0.015119048     0.015119048 IDL> print, obj.ISEXTENDEDDESKTOP()        1 IDL> print, obj.ISEXTENDEDDESKTOP()        1

-------------------------------------------------------------------------------