SAS编程:Dopen系列函数介绍

我想获取特定路径下文件的末次修改时间,例如,.sas.log的末次修改时间,两者比较判断程序更新后,是否重新Run过;例如,Source侧 (Production)的.log文件与QC侧 (Validation)的.log的末次修改时间,判断V侧程序是否在P侧程序之后Run过。

利用Dopen系列以及Fopen系列函数,可以实现上述功能

为了方便读者更好的理解,我先介绍这两个系列中的一些函数。这篇文章介绍Dopen系列函数,涉及的函数如下:

  • DOPEN
  • DCLOSE
  • DNUM
  • DREAD
  • DOPTNAME
  • DINFO

我使用以下路径文件进行演示,路径中有4个.sas文件、4个.log文件,以及1个文件夹,共9个文件

Directory

1. DOPEN(fileref)

DOPEN函数的作用是,打开一个路径,并返回一个路径标识值 (Opens a directory, and returns a directory identifier value)。

这可以理解为,在一次SAS会话中,给路径发放身份证明,这个证明与路径是一一对应的,就像人的身份证一样。人有了身份证,可以进行诸如乘高铁、坐飞机的活动;在SAS会话中,路径有了“身份证”,也可以进行一些“特定活动”。

DEOPEN函数的参数值是一个文件引用(fileref),这个文件引用必须在调用函数前与特定的路径进行关联,常用的文件关联方式有两种:

第1种,全局filename语句:

filename dirpath "E:\99_Test\Test\test1";

第2种,filename函数:

data test;
  fileres = filename("dirpath", "E:\99_Test\Test\test1");
run;

如果关联成功,filename函数会返回0;如果关联失败,filename函数会返回非0值。

文件引用关联成功后,就可以使用DOPEN函数打开,函数在该SAS会话中,返回路径对应的“身份证号”。

**dopen;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
    fileres = filename("dirpath","&dirpath"); 

    dirid = dopen("dirpath"); 
run;

Dopen

Filename函数返回0值,说明文件引用关联成功。Dopen函数返回的路径“身份证号”的值为1。

其他信息可以参考SAS文档:SAS Help Center: DOPEN Function。

2. DCLOSE(directory-id)

DCLOSE函数的作用是,关闭DOPEN函数打开的路径(Closes a directory that was opened by the DOPEN function)。

DCLOSE函数的参数为,DOPEN返回的“身份证号”。DCLOSE函数可以类比,注销身份证号。路径的“身份证号”一旦被注销,一些基于“身份证号”的活动就没办法进行。

**dclose;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
    fileres = filename("dirpath","&dirpath."); 

    dirid = dopen("dirpath"); 

    dclose = dclose(dirid);
run;

Dclose

“身份证号”注销成功,返回0值;注销不成功,返回非0值。

其他信息可以参考SAS文档:SAS Help Center: DCLOSE Function

3. DNUM(directory-id)

DNUM函数的作用是,返回路径内文件数量(Returns the number of members in a directory)。

例如,演示路径下有9个文件,DNUM函数对该路径的“身份证号”进行处理,返回值应该是9。

**dnum;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
    fileres = filename("dirpath","&dirpath."); 

    dirid = dopen("dirpath"); 
    num = dnum(dirid);
run;

dnum

其他信息可以参考SAS文档:SAS Help Center: DNUM Function

4. DREAD(directory-id, nval)

DREAD函数的作用是,读取路径下文件的名称(Returns the name of a directory member)。

DREAD函数有2个参数,一个是路径的“身份证号”,一个是路径内文件的位序,文件位序的排序为文件名的字符排序

演示路径下有9个文件,对应的,也就是可以读取到9个文件的名称。

**dread;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
    fileres = filename("dirpath","&dirpath."); 

    dirid = dopen("dirpath."); 

    length direct filename filepath $200;
    
    direct = "&dirpath";

    ord = 1;
    filename =dread(dirid, 1); 
    filepath = catx("\", direct, filename);
    output;

    ord = 2;
    filename =dread(dirid, 2); 
    filepath = catx("\", direct, filename);
    output;

    ……

    ord = 9;
    filename =dread(dirid, 9); 
    filepath = catx("\", direct, filename);
    output;
run;

Dread

一一读取文件比较繁琐,由于DNUM函数可以获取路径内文件数目,基于此可以使用Do循环进行读取文件名称,路径名称与文件名拼接可以获得文件路径

**dread;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
    fileres = filename("dirpath","&dirpath."); 

    dirid = dopen("dirpath"); 
    num = dnum(dirid);

    length direct filename filepath $200;
    
    direct = "&dirpath.";

    if dirid > 0 then do;
      do i = 1 to num;
        filename = dread(driid, i);
        filepath = catx("\", direct,filename);
        ord = i;
        output;
      end;
    end;

    drop i;
run;

循环读入结果与上面相同。

其他信息可以参考SAS文档:SAS Help Center: DREAD Function。

5. DOPTNAME(directory-id, nval)

DOPTNAME函数的作用是,返回路径的属性名称(Returns directory attribute information)。

DOPTNAME函数有2个参数,一个是路径的“身份证号”,一个是路径具体属性的次序。在不同的电脑操作系统中,SAS读取到的属性是不同的

在Windows操作系统中,路径属性只有1个:

  • Directory

在UNIX操作系统中,路径属性有5个:

  • Directory
  • Owner Name
  • Group Name
  • Access Permission
  • Last Modified

不同的SAS系统语言,返回的结果也不同。以Windows系统为例,举例如下:

**doptname;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
  fileres=filename("dirpath","&dirpath."); 
  dirid=dopen("dirpath");  

  length info_it $200;
  info_it = doptname(dirid, 1); output;
  info_it = doptname(dirid, 2); output;
run;

不同的SAS系统语言,返回的属性名称也不同:

中文环境
英文环境

因为Windows系统中,DOPTNAME函数只能返回一个路径属性。当次序值取2时,函数返回值就为空,同时Log中也会输出错误信息描述。

Log

其他信息可以参考SAS文档:SAS Help Center: DOPTNAME Function。

6. DINFO(directory-id, information-item)

DINFO函数的作用是,返回路径属性的具体信息(Returns information about a directory)。

DINFO函数有2个参数,一个是路径的“身份证号”,一个是路径的属性名称,名称因SAS系统语言的不同而不同。属性名称可以参考DOPTNAME函数的返回值。

中文环境:

**dinfo-Chinese;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
  fileres=filename("dirpath","&dirpath."); 

  dirid=dopen("dirpath");  

  length attr $200;
  attr= dinfo(dirid, "目录");
run;
Dinfo-Chinese

英文环境:

**dinfo-English;
%let dirpath = E:\99_Test\Test\test1;

data tmp;
  fileres=filename("dirpath","&dirpath."); 

  dirid=dopen("dirpath");  

  length attr $200;
  attr= dinfo(dirid, "Directory");
run;
Dinfo-English

在Windows环境下,这个函数显得很鸡肋。只能读取一个路径的“路径”信息,有点脱裤子放屁的意味。。。

其他信息可以参考SAS文档:SAS Help Center: DINFO Function。

相关阅读:
SAS编程:如何获取某路径下文件的名称?
SAS编程:Fopen系列函数介绍

感谢阅读, 欢迎关注!
若有疑问,欢迎评论交流!

你可能感兴趣的:(SAS编程:Dopen系列函数介绍)