20

有什么方法可以配置该clang-format工具以跳过我的Qt::connect函数调用？我的构造函数中有几个连接，如下所示：

connect( m_Job, SIGNAL( error( const QString&, const QString& ) ),  this, SLOT( onError( const QString&, const QString& ) ) );
connect( m_Job, SIGNAL( message( const QString& ) ),                this, SLOT( onMessage( const QString& ) ) );
connect( m_Job, SIGNAL( progress( int, int ) ),                     this, SLOT( onProgress( int, int ) ) );

但是在我运行格式化工具之后，它的可读性会降低：

connect( m_Job, SIGNAL( error(const QString&, const QString&)), this, SLOT( onError(const QString&, const QString&)) );
connect( m_Job, SIGNAL( message(const QString&)), this, SLOT( onMessage(const QString&)) );
connect( m_Job, SIGNAL( progress(int, int)), this, SLOT( onProgress(int, int)) );
4

3 回答 3

39

使用// clang-format offand// clang-format on使其跳过代码部分。

// clang-format off
// Don't touch this!
connect( m_Job, SIGNAL( error( const QString&, const QString& ) ),  this, SLOT( onError( const QString&, const QString& ) ) );
connect( m_Job, SIGNAL( message( const QString& ) ),                this, SLOT( onMessage( const QString& ) ) );
connect( m_Job, SIGNAL( progress( int, int ) ),                     this, SLOT( onProgress( int, int ) ) );
// clang-format on
// Carry on formatting
于 2015-10-21T11:52:33.243 回答
1

顺便说一句：您应该规范化信号/插槽签名。因此，不需要引用和常量引用，Qt 中的签名规范化代码只是将它们删除。如果它是，您也不需要第三个参数this。

您的代码应如下所示：

connect(m_Job, SIGNAL(error(QString,QString)), SLOT(onError(QString,QString)));
connect(m_Job, SIGNAL(message(QString)), SLOT(onMessage(QString)));
connect(m_Job, SIGNAL(progress(int,int)), SLOT(onProgress(int,int)));

如果您坚持，参数类型之间肯定可以有空格，当然会以一些运行时成本为代价，因为规范化代码不再是空操作。

您还可以利用QMetaObject::connectSlotsByName来摆脱显式连接。这要求 thatm_Job是 的孩子this，并且有一个名字。例如：

class Foo : public Q_OBJECT {
  Job m_job;
  Q_SLOT void on_job_error(const QString&, const QString&);
  Q_SLOT void on_job_message(const QString&);
  Q_SLOT void on_job_progress(int, int);
public:
  Foo(QObject * parent = 0) :
    QObject(parent),
    m_job(this)
  {
    m_job.setObjectName("job");
    QMetaObject::connectSlotsByName(this);
  }
};

具有该模式名称的插槽on_name_signal将由 自动连接connectSlotsByName。name是发送者对象的名称，并且是signal信号的名称。

最后，过多的空格会使您的代码更难阅读，而不是更容易阅读。这不是风格问题，而是简单的生理学问题。中央凹的直径约为 2 度角。一个角度的视觉角度大约是拇指在手臂长度处的宽度。阅读带有过多空白的代码需要更多的扫视/注视来沿着代码行重新定位您的中心视觉。图 0.15-0.2s 需要处理每个注视值的数据并将其与您正在阅读的代码的心理模型集成。这都是可以衡量的。

作为轶事，而不是医疗建议：如果我的鼻子上没有 +0.5 眼镜，我无法阅读密集的乐谱。我的视力在其他方面完全正常。YMMV。

于 2015-10-21T14:53:21.013 回答
0

您可以使用新的信号槽语法以获得更好的可读性。它看起来更简单

connect(sender, &Sender::valueChanged, receiver, &Receiver::updateValue);

于 2015-10-21T11:35:10.997 回答