MGunit documentation

Unit testing for IDL

single page | use frames     summary     class     fields     routine details     file attributes

cmdline_tools/

ls.pro


Equivalent to UNIX ls command.

Examples

Try: IDL> ls, /long -rw-r--r-- 1K Mar 23 14:25 COPYING -rw-r--r-- 298B May 14 14:07 Makefile drwxr-xr-x 1K May 14 14:13 api-docs/ -rw-r--r-- 259B Apr 27 15:16 mg_build_dist_tools_docs.pro drwxr-xr-x 748B May 14 14:09 src/ drwxr-xr-x 476B Apr 22 16:42 unittests/

Routines

result = ls_get_columns()

Get number of columns in display.

result = ls_permissions(files, info=array of structures)

Returns the mode line for each file in the given list.

result = ls_human_size(sizes)

Return a human readable array of sizes using bytes, kilobytes, megabytes, gigabytes, terabytes, and petabytes (in powers of two).

result = ls_modification_times(mtimes)

Convert modification times from long to normal date/time format.

ls [, pattern] [, /all] [, /long]

Substitute for UNIX ls command.

Routine details

top ls_get_columns

result = ls_get_columns()

Get number of columns in display.

Return value

long

top ls_permissions

result = ls_permissions(files, info=array of structures)

Returns the mode line for each file in the given list.

Return value

strarr

Parameters

files in required type=strarr

array of files

Keywords

info in required type=array of structures

array of structures of the type returned by FILE_INFO

top ls_human_size

result = ls_human_size(sizes)

Return a human readable array of sizes using bytes, kilobytes, megabytes, gigabytes, terabytes, and petabytes (in powers of two).

Return value

strarr

Parameters

sizes in required type=intarr

array of sizes in bytes

top ls_modification_times

result = ls_modification_times(mtimes)

Convert modification times from long to normal date/time format.

Return value

strarr

Parameters

mtimes in required type=lonarr

array of modification times

top ls

ls [, pattern] [, /all] [, /long]

Substitute for UNIX ls command. Automatically uses -hF options.

Parameters

pattern in optional type=string default='*'

pattern to match filenames against

Keywords

all in optional type=boolean

report all files (even hidden files like .*)

long in optional type=boolean

more information about each file is listed

Other attributes

Bugs:

doesn't handle directories matching pattern the same as ls does; IDL does not have a mechanism to get the owner for a file, so it is not displayed in the /LONG format

File attributes

Modification date: Tue Oct 19 18:48:10 2010
Lines: 243
Docformat: rst rst