QCanMessageDescription Class
QCanMessageDescription 클래스는 CAN 메시지를 처리하고 이를 애플리케이션에서 정의한 형식으로 표현하는 규칙을 설명합니다. 더 보기...
| 헤더: | #include <QCanMessageDescription> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SerialBus) target_link_libraries(mytarget PRIVATE Qt6::SerialBus) |
| qmake: | QT += serialbus |
| 다음부터: | Qt 6.5 |
| 상태: | 기술 미리보기 |
이 클래스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.
공개 함수
| QCanMessageDescription() | |
| QCanMessageDescription(const QCanMessageDescription &other) | |
| QCanMessageDescription(QCanMessageDescription &&other) | |
| ~QCanMessageDescription() | |
| void | addSignalDescription(const QCanSignalDescription &description) |
| void | clearSignalDescriptions() |
| QString | comment() const |
| bool | isValid() const |
| QString | name() const |
| void | setComment(const QString &text) |
| void | setName(const QString &name) |
| void | setSignalDescriptions(const QList<QCanSignalDescription> &descriptions) |
| void | setSize(quint8 size) |
| void | setTransmitter(const QString &transmitter) |
| void | setUniqueId(QtCanBus::UniqueId id) |
| QCanSignalDescription | signalDescriptionForName(const QString &name) const |
| QList<QCanSignalDescription> | signalDescriptions() const |
| quint8 | size() const |
| QString | transmitter() const |
| QtCanBus::UniqueId | uniqueId() const |
| QCanMessageDescription & | operator=(QCanMessageDescription &&other) |
| QCanMessageDescription & | operator=(const QCanMessageDescription &other) |
상세 설명
CAN 메시지는 기본적으로 CAN 데이터 패킷( QCanBusFrame)입니다. CAN 메시지에 대한 설명에는 다음이 포함됩니다.
- 메시지 ID.
- 메시지 이름.
- 바이트 단위의 메시지 길이.
- 메시지의 발신원(송신기).
- 메시지 내 신호에 대한 설명.
QCanMessageDescription 클래스는 이러한 모든 매개 변수를 제어하는 메서드를 제공합니다.
메시지 ID
메시지 ID는 고유 식별자로, 수신된 QCanBusFrame 를 디코딩하거나 제공된 데이터를 기반으로 QCanBusFrame 를 인코딩할 때 적절한 메시지 설명을 선택하는 데 사용됩니다.
고유 식별자에 대한 자세한 내용은 QCanUniqueIdDescription 문서를 참조하십시오.
신호 설명
신호 설명은 QCanSignalDescription 클래스로 표현됩니다. QCanMessageDescription 클래스는 해당 메시지에 속한 신호 목록만 제공합니다.
QCanSignalDescription 및 QCanUniqueIdDescription도 참조하십시오 .
멤버 함수 설명
QCanMessageDescription::QCanMessageDescription()
빈 메시지 설명을 생성합니다.
QCanMessageDescription::QCanMessageDescription(const QCanMessageDescription &other)
other 에서 복사한 값을 사용하여 메시지 설명을 생성합니다.
[constexpr noexcept default] QCanMessageDescription::QCanMessageDescription(QCanMessageDescription &&other)
other 에서 이동하여 메시지 설명을 생성합니다.
참고: 이동된 QCanMessageDescription객체는 소멸되거나 할당될 수만 있습니다. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우의 결과는 정의되지 않습니다.
[constexpr noexcept default] QCanMessageDescription::~QCanMessageDescription()
이 메시지 설명을 삭제합니다.
void QCanMessageDescription::addSignalDescription(const QCanSignalDescription &description)
이 메시지 설명에 새로운 신호 설명 description 을 추가합니다.
메시지 설명에 이미 동일한 이름의 신호에 대한 신호 설명이 있는 경우, 해당 설명은 덮어쓰게 됩니다.
signalDescriptions(), signalDescriptionForName(), setSignalDescriptions(), clearSignalDescriptions()도 참조하십시오 .
void QCanMessageDescription::clearSignalDescriptions()
이 메시지의 모든 신호 설명을 지웁니다.
signalDescriptions(), signalDescriptionForName(), addSignalDescription(), setSignalDescriptions()도 참조하십시오 .
QString QCanMessageDescription::comment() const
메시지에 대한 주석을 반환합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩이나 디코딩 과정에서는 사용되지 않습니다.
setComment()도 참조하십시오 .
bool QCanMessageDescription::isValid() const
메시지 설명이 유효한 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false `를 반환합니다.
유효한 메시지 설명에는 적어도 하나의 신호 설명이 포함되어야 합니다. 모든 신호 설명 또한 유효해야 합니다.
signalDescriptions() 및 QCanSignalDescription::isValid()도 참조하십시오 .
QString QCanMessageDescription::name() const
CAN 메시지의 이름을 반환합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩 또는 디코딩 과정에서는 사용되지 않습니다.
setName()도 참조하십시오 .
void QCanMessageDescription::setComment(const QString &text)
메시지의 주석을 “ text ”로 설정합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩이나 디코딩 과정에서는 사용되지 않습니다.
comment()도 참조하십시오 .
void QCanMessageDescription::setName(const QString &name)
CAN 메시지의 이름을 ‘ name ’로 설정합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩이나 디코딩 과정에서는 사용되지 않습니다.
name()도 참조하십시오 .
void QCanMessageDescription::setSignalDescriptions(const QList<QCanSignalDescription> &descriptions)
이 메시지 설명에 속하는 신호의 설명을 descriptions 로 설정합니다.
참고: 메시지 설명에는 고유한 신호 이름을 가진 신호 설명이 포함되어야 하므로, descriptions 목록에 이름이 중복된 항목이 있는 경우 마지막 항목만 추가됩니다.
signalDescriptions(), signalDescriptionForName(), addSignalDescription(), clearSignalDescriptions()도 참조하십시오 .
void QCanMessageDescription::setSize(quint8 size)
CAN 메시지의 크기를 바이트 단위로 size 로 설정합니다.
size()도 참조하십시오 .
void QCanMessageDescription::setTransmitter(const QString &transmitter)
메시지의 송신 노드를 transmitter 로 설정합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩이나 디코딩 과정에서는 사용되지 않습니다.
transmitter()도 참조하십시오 .
void QCanMessageDescription::setUniqueId(QtCanBus::UniqueId id)
CAN 메시지의 고유 식별자를 id 로 설정합니다.
고유 식별자에 대한 자세한 내용은 Message ID 섹션을 참조하십시오.
uniqueId()도 참조하십시오 .
QCanSignalDescription QCanMessageDescription::signalDescriptionForName(const QString &name) const
name 라는 이름의 신호에 대한 신호 설명을 반환합니다.
메시지 설명에 해당 신호 설명이 없는 경우, 기본 생성된 QCanSignalDescription 객체가 반환됩니다.
signalDescriptions(), addSignalDescription(), setSignalDescriptions(), clearSignalDescriptions()도 참조하십시오 .
QList<QCanSignalDescription> QCanMessageDescription::signalDescriptions() const
이 메시지 설명에 속하는 신호 설명 목록을 반환합니다.
signalDescriptionForName(), addSignalDescription(), setSignalDescriptions() 및 clearSignalDescriptions()도 참조하십시오 .
quint8 QCanMessageDescription::size() const
CAN 메시지의 크기를 바이트 단위로 반환합니다.
setSize()도 참조하십시오 .
QString QCanMessageDescription::transmitter() const
메시지의 송신 노드를 반환합니다.
이 매개변수는 추가 설명을 위해 도입된 것입니다. 메시지 인코딩이나 디코딩 과정에서는 사용되지 않습니다.
setTransmitter()도 참조하십시오 .
QtCanBus::UniqueId QCanMessageDescription::uniqueId() const
CAN 메시지의 고유 식별자를 반환합니다.
고유 식별자에 대한 자세한 내용은 ‘ Message ID ’ 섹션을 참조하십시오.
setUniqueId()도 참조하십시오 .
[noexcept] QCanMessageDescription &QCanMessageDescription::operator=(QCanMessageDescription &&other)
other 의 값을 이 메시지 설명에 이동 할당합니다.
참고: 이동된원본 ` QCanMessageDescription `객체는 소멸되거나 할당될 수만 있습니다. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우의 결과는 정의되지 않습니다.
QCanMessageDescription &QCanMessageDescription::operator=(const QCanMessageDescription &other)
other 의 값을 이 메시지 설명에 할당합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.