dir

List folder contents on device

Since R2019b

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.

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

Examples

View Folder Contents on ROS Device

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
            name                            folder                    isdir    bytes
    _____________________    _____________________________________    _____    _____

    {'.'                }    {'/home/user/Documents/mw_catkin_ws'}    true       0  
    {'..'               }    {'/home/user/Documents/mw_catkin_ws'}    true       0  
    {'.catkin_workspace'}    {'/home/user/Documents/mw_catkin_ws'}    false     98  
    {'build'            }    {'/home/user/Documents/mw_catkin_ws'}    true       0  
    {'devel'            }    {'/home/user/Documents/mw_catkin_ws'}    true       0  
    {'src'              }    {'/home/user/Documents/mw_catkin_ws'}    true       0  

Input Arguments

device — ROS or ROS 2 device

rosdevice object | ros2device object

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

folder — Folder name

character vector

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

Output Arguments

clist — Contents list

structure

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