- Qt 6.12
- Qt Bluetooth
- C++ Classes
- QLowEnergyServiceData
- Qt 6.12.0 Reference Documentation

# QLowEnergyServiceData Class

The QLowEnergyServiceData class is used to set up GATT service data. More...

Header: | `#include <QLowEnergyServiceData>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS Bluetooth)` `target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)`
qmake: | `QT += bluetooth`

- List of all members, including inherited members
- QLowEnergyServiceData is part of Implicitly Shared Classes.

## Public Types

enum | ServiceType { ServiceTypePrimary, ServiceTypeSecondary }

## Public Functions

| QLowEnergyServiceData()
| QLowEnergyServiceData(const QLowEnergyServiceData &other)
| ~QLowEnergyServiceData()
void | addCharacteristic(const QLowEnergyCharacteristicData &characteristic)
void | addIncludedService(QLowEnergyService *service)
QList<QLowEnergyCharacteristicData> | characteristics() const
QList<QLowEnergyService *> | includedServices() const
bool | isValid() const
void | setCharacteristics(const QList<QLowEnergyCharacteristicData> &characteristics)
void | setIncludedServices(const QList<QLowEnergyService *> &services)
void | setType(QLowEnergyServiceData::ServiceType type)
void | setUuid(const QBluetoothUuid &uuid)
void | swap(QLowEnergyServiceData &other)
QLowEnergyServiceData::ServiceType | type() const
QBluetoothUuid | uuid() const
QLowEnergyServiceData & | operator=(const QLowEnergyServiceData &other)

## Related Non-Members

bool | operator!=(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)
bool | operator==(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

## Detailed Description

An Object of this class provides a service to be added to a GATT server via QLowEnergyController::addService().

## Member Type Documentation

### enum QLowEnergyServiceData::ServiceType

The type of GATT service.

Constant | Value | Description
--- | --- | ---
`QLowEnergyServiceData::ServiceTypePrimary` | `0x2800` | The service is a primary service.
`QLowEnergyServiceData::ServiceTypeSecondary` | `0x2801` | The service is a secondary service. Secondary services are included by other services to implement some higher-level functionality.

## Member Function Documentation

### QLowEnergyServiceData::QLowEnergyServiceData()

Creates a new invalid object of this class.

### QLowEnergyServiceData::QLowEnergyServiceData(const QLowEnergyServiceData &other)

Constructs a new object of this class that is a copy of other.

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

Destroys this object.

### void QLowEnergyServiceData::addCharacteristic(const QLowEnergyCharacteristicData &characteristic)

Adds characteristic to the list of characteristics, if it is valid.

See also setCharacteristics().

### void QLowEnergyServiceData::addIncludedService(QLowEnergyService *service)

Adds service to the list of included services. The service object must have been returned from a call to QLowEnergyController::addService. This requirement prevents circular includes (which are forbidden by the Bluetooth specification), and also helps to support the use case of including more than one service of the same type.

See also setIncludedServices().

### QList<QLowEnergyCharacteristicData> QLowEnergyServiceData::characteristics() const

Returns the list of characteristics.

See also setCharacteristics().

### QList<QLowEnergyService *> QLowEnergyServiceData::includedServices() const

Returns the list of included services.

See also setIncludedServices().

### bool QLowEnergyServiceData::isValid() const

Returns `true` if this service is has a non-null UUID.

### void QLowEnergyServiceData::setCharacteristics(const QList<QLowEnergyCharacteristicData> &characteristics)

Sets the list of characteristics to characteristics. Only valid characteristics are considered.

See also characteristics() and addCharacteristic().

### void QLowEnergyServiceData::setIncludedServices(const QList<QLowEnergyService *> &services)

Sets the list of included services to services. All objects in this list must have been returned from a call to QLowEnergyController::addService.

See also includedServices() and addIncludedService().

### void QLowEnergyServiceData::setType(QLowEnergyServiceData::ServiceType type)

Sets the type of this service to type.

See also type().

### void QLowEnergyServiceData::setUuid(const QBluetoothUuid &uuid)

Sets the UUID of this service to uuid.

See also uuid().

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

Swaps this object with other.

### QLowEnergyServiceData::ServiceType QLowEnergyServiceData::type() const

Returns the type of this service.

See also setType().

### QBluetoothUuid QLowEnergyServiceData::uuid() const

Returns the UUID of this service.

See also setUuid().

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

Makes this object a copy of other and returns the new value of this object.

## Related Non-Members

### bool operator!=(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

Returns `true` if a and b are unequal with respect to their public state, otherwise returns `false`.

### bool operator==(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

Returns `true` if a and b are equal with respect to their public state, otherwise returns `false`.