15.8 输出值

输出有三种不同类型：

• 始终为单一值，例如： read_image
  在这种情况下，Python 版本的算子将返回列表的元素类型的单个值。
• 始终为列表，例如： quat_normalize
  在这种情况下，Python 版本的算子将始终返回一个列表。
• 可以是单个值，也可以是列表，例如： get_image_size
  在这种情况下，Python 版本的算子也会返回一个列表。然而，在许多情况下，例如，从输入参数的数量来看，我们可以预先知道只需要一个值。为方便起见，我们提供了后缀为 _s 的算子第二变体。它将始终返回单个值，或者在算子不返回单个值时引发异常。

总是返回列表的算子与有时返回列表的算子之间的区别只是概念上的。它们的优势主要在于，在处理单个值的常见情况下，访问更加方便。

img = ha.read_image('pcb')

width, height = ha.get_image_size_s(img)
assert width == 1109
assert height == 871

width, height = ha.get_image_size(img)
assert width == [1109]
assert height == [871]

img_seq = ha.concat_obj(img, ha.read_image('fuse'))
width, height = ha.get_image_size(img_seq)
assert width == [1109, 768]
assert height == [871, 576]

询问单幅图像的大小，得到的列表只有一个元素，这并不是特别有用。_s 版本明确而方便地表达了一种期望，即答案应始终只有一个，既不是零，也不是多。

有关哪些算子有此类版本的信息，请参阅 HALCON 算子参考。