Typedefs | Functions | Variables
ros::package Namespace Reference

Typedefs

typedef std::map< std::string, std::string > M_string
 
typedef std::vector< std::string > V_string
 

Functions

ROSLIB_DECL std::string command (const std::string &cmd)
 Runs a rospack command of the form 'rospack <cmd>', returning the output as a single string. More...
 
ROSLIB_DECL void command (const std::string &cmd, V_string &output)
 Runs a rospack command of the form 'rospack <cmd>', returning the output as a vector of strings, split by newlines. More...
 
ROSLIB_DECL bool getAll (V_string &packages)
 Gets a list of all packages. Returns false if it could not run the command. More...
 
ROSLIB_DECL std::string getPath (const std::string &package_name)
 Returns the fully-qualified path to a package, or an empty string if the package is not found. More...
 
ROSLIB_DECL void getPlugins (const std::string &name, const std::string &attribute, std::vector< std::pair< std::string, std::string > > &exports, bool force_recrawl=false)
 Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <name>". Return a vector of string pairs which are package names and exported values respectively. Note that there can be multiple values for any single package. More...
 
ROS_DEPRECATED ROSLIB_DECL void getPlugins (const std::string &package, const std::string &attribute, M_string &plugins, bool force_recrawl=false)
 Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <package>". Return a map of package name to export value. More...
 
static void getPlugins (const std::string &package, const std::string &attribute, V_string &packages, V_string &plugins, bool force_recrawl)
 
ROSLIB_DECL void getPlugins (const std::string &package, const std::string &attribute, V_string &plugins, bool force_recrawl=false)
 Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <package>". Returns a vector of strings which are export values. More...
 

Variables

static boost::mutex librospack_mutex
 

Typedef Documentation

◆ M_string

typedef std::map<std::string, std::string> ros::package::M_string

Definition at line 85 of file package.h.

◆ V_string

typedef std::vector<std::string> ros::package::V_string

Definition at line 84 of file package.h.

Function Documentation

◆ command() [1/2]

std::string ros::package::command ( const std::string &  cmd)

Runs a rospack command of the form 'rospack <cmd>', returning the output as a single string.

Definition at line 47 of file src/package.cpp.

◆ command() [2/2]

void ros::package::command ( const std::string &  cmd,
V_string output 
)

Runs a rospack command of the form 'rospack <cmd>', returning the output as a vector of strings, split by newlines.

Definition at line 71 of file src/package.cpp.

◆ getAll()

bool ros::package::getAll ( V_string packages)

Gets a list of all packages. Returns false if it could not run the command.

Definition at line 103 of file src/package.cpp.

◆ getPath()

std::string ros::package::getPath ( const std::string &  package_name)

Returns the fully-qualified path to a package, or an empty string if the package is not found.

Definition at line 89 of file src/package.cpp.

◆ getPlugins() [1/4]

void ros::package::getPlugins ( const std::string &  name,
const std::string &  attribute,
std::vector< std::pair< std::string, std::string > > &  exports,
bool  force_recrawl = false 
)

Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <name>". Return a vector of string pairs which are package names and exported values respectively. Note that there can be multiple values for any single package.

Note that while this uses the original rospack 'plugin' terminology, this effectively works for any exported tag with attributes in the catkin package.xml export list. Typical examples include:

<export>
<nav_core plugin="${prefix}/blp_plugin.xml" /> <!-- name="nav_core", attribute="plugin" -->
<rosdoc config="rosdoc.yaml" /> <!-- name="rosdoc", attribute="config" -->
</export>
Parameters
name: name of the package export tag (has to be a package name) [in]
attribute: name of the attribute inside the export tag with which to filter results [in]
exports: package/value export pairs resulting from the search [out]
force_recrawl: force rospack to rediscover everything on the system before running the search [in]

Definition at line 137 of file src/package.cpp.

◆ getPlugins() [2/4]

void ros::package::getPlugins ( const std::string &  package,
const std::string &  attribute,
M_string plugins,
bool  force_recrawl = false 
)

Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <package>". Return a map of package name to export value.

Warning
If there are multiple export values, only the last one is saved in the map.
Deprecated:
Prefer the ::getPlugins(const std::string&, const std::string&, std::vector<std::pair<std::string, std::string>>&, bool) api instead.

Definition at line 158 of file src/package.cpp.

◆ getPlugins() [3/4]

static void ros::package::getPlugins ( const std::string &  package,
const std::string &  attribute,
V_string packages,
V_string plugins,
bool  force_recrawl 
)
static

Definition at line 110 of file src/package.cpp.

◆ getPlugins() [4/4]

void ros::package::getPlugins ( const std::string &  package,
const std::string &  attribute,
V_string plugins,
bool  force_recrawl = false 
)

Call the "rospack plugins" command, eg. "rospack plugins --attrib=<attribute> <package>". Returns a vector of strings which are export values.

Definition at line 152 of file src/package.cpp.

Variable Documentation

◆ librospack_mutex

boost::mutex ros::package::librospack_mutex
static

Definition at line 45 of file src/package.cpp.



roslib
Author(s): Ken Conley , Josh Faust , Morgan Quigley , Dirk Thomas
autogenerated on Wed Mar 2 2022 00:52:18