dir

List folder contents on device

collapse all in page

Syntax

dir(device,folder)
clist = dir(device,folder)

Description

dir(device,folder) lists the files in a folder on the ROS or ROS 2 device. Wildcards are supported.

example

clist = dir(device,folder) stores the list of files as a structure.

Examples

collapse all

Open Live Script

Connect to a ROS device and list the contents of a folder.

Connect to a ROS device. Specify the device address, user name, and password of your ROS device.

d = rosdevice('192.168.17.129','user','password');

Get the folder list of a Catkin workspace on your ROS device. View the folder as a table.

flist = dir(d,'/home/user/Documents/mw_catkin_ws/');
ftable = struct2table(flist)
ftable=6×4 table
                    '.'    '/home/user/Documents/mw_catkin_ws'    1     0
                   '..'    '/home/user/Documents/mw_catkin_ws'    1     0
    '.catkin_workspace'    '/home/user/Documents/mw_catkin_ws'    0    98
                'build'    '/home/user/Documents/mw_catkin_ws'    1     0
                'devel'    '/home/user/Documents/mw_catkin_ws'    1     0
                  'src'    '/home/user/Documents/mw_catkin_ws'    1     0

Input Arguments

collapse all

ROS or ROS 2 device, specified as a rosdevice or ros2device object, respectively.

Name of the folder to list the contents of, specified as a character vector.

Output Arguments

collapse all

Contents list, returned as a structure. The structure contains these fields:

  • name — File name (char)

  • folder — Absolute path (char)

  • bytes — Size of the file in bytes (double)

  • isdir — Indicator of whether name is a folder (logical)

Version History

Introduced in R2019b

See Also

| | | | | |