- Qt 6.7
- Qt Serial Bus
- C++ Classes
- QCanBusDeviceInfo
- Qt 6.7.0 Reference Documentation

# QCanBusDeviceInfo Class

The QCanBusDeviceInfo provides information about CAN bus interfaces. More...

Header: | #include <QCanBusDeviceInfo>
CMake: | find_package(Qt6 REQUIRED COMPONENTS SerialBus) target_link_libraries(mytarget PRIVATE Qt6::SerialBus)
qmake: | QT += serialbus

- List of all members, including inherited members

## Public Functions

| QCanBusDeviceInfo(const QCanBusDeviceInfo &other)
| ~QCanBusDeviceInfo()
QString | alias() const
int | channel() const
QString | description() const
bool | hasFlexibleDataRate() const
bool | isVirtual() const
QString | name() const
QString | plugin() const
QString | serialNumber() const
void | swap(QCanBusDeviceInfo &other)
QCanBusDeviceInfo & | operator=(const QCanBusDeviceInfo &other)
QCanBusDeviceInfo & | operator=(QCanBusDeviceInfo &&other)

## Detailed Description

Each plugin may support one or more interfaces with different capabilities. This class provides information about available functions.

## Member Function Documentation

### QCanBusDeviceInfo::QCanBusDeviceInfo(const QCanBusDeviceInfo &other)

Constructs a copy of other.

### `[noexcept]` QCanBusDeviceInfo::~QCanBusDeviceInfo()

Destroys the CAN bus device info.

### `[since 6.0]` QString QCanBusDeviceInfo::alias() const

Returns a user defineable alias associated with this CAN bus interface.

Some CAN bus interfaces can have a user defined alias associated. This is mostly done with the CAN hardware vendors tools. The alias allows to identify this hardware later, especially when multiple interfaces are connected.

Note: In contrast to serialNumber(), the alias is not guaranteed to be unique.

If this function is not supported by the CAN plugin, an empty string is returned.

This function was introduced in Qt 6.0.

See also serialNumber().

### int QCanBusDeviceInfo::channel() const

Returns the sequential channel number of the CAN bus interface, starting with zero. For example, a two channel CAN interface may have the channels 0 and 1. If the interface has only one channel or if no information about the channel is available, zero is returned.

### QString QCanBusDeviceInfo::description() const

Returns a textual description of the CAN bus interface, if available. Example output: "PCAN USB Pro FD". If no description is available, an empty string is returned.

### bool QCanBusDeviceInfo::hasFlexibleDataRate() const

Returns true, if the CAN bus interface is CAN FD (flexible data rate) capable.

If this information is not available, false is returned.

### bool QCanBusDeviceInfo::isVirtual() const

Returns true, if the CAN bus interface is virtual (i.e. not connected to real CAN hardware).

If this information is not available, false is returned.

### QString QCanBusDeviceInfo::name() const

Returns the interface name of this CAN bus interface, e.g. "can0".

This corresponds to the `interfaceName` parameter of QCanBus::createDevice().

### `[since 6.2]` QString QCanBusDeviceInfo::plugin() const

Returns the plugin name of this CAN bus interface, e.g. "peakcan".

This corresponds to the `plugin` parameter of QCanBus::createDevice().

This function was introduced in Qt 6.2.

### QString QCanBusDeviceInfo::serialNumber() const

Returns the serial number of the CAN bus interface as string, if available. Otherwise, an empty string is returned.

See also alias().

### `[noexcept]` void QCanBusDeviceInfo::swap(QCanBusDeviceInfo &other)

Swaps this CAN bus device info with other. This operation is very fast and never fails.

### QCanBusDeviceInfo &QCanBusDeviceInfo::operator=(const QCanBusDeviceInfo &other)

Assigns other to this CAN bus device info and returns a reference to this CAN bus device info.

### `[noexcept]` QCanBusDeviceInfo &QCanBusDeviceInfo::operator=(QCanBusDeviceInfo &&other)

Move-assigns other to this QCanBusDeviceInfo instance.