symm_differencesymm_differenceSymmDifferenceSymmDifferencesymm_difference (算子名称)

名称

symm_differencesymm_differenceSymmDifferenceSymmDifferencesymm_difference — Calculate the symmetric difference of two regions.

参数签名

描述

symm_differencesymm_differenceSymmDifferenceSymmDifferenceSymmDifferencesymm_difference calculates the symmetric difference of two regions. Note that, internally, all regions of Region2Region2Region2Region2region2region_2 are united to a single region before the symmetric differences between the individual regions of Region1Region1Region1Region1region1region_1 and the united region are calculated. Two possible definitions of the symmetric difference can be seen in the example below. A third definition is to regard the exclusive or of the two regions.

注意

Empty regions are valid for both parameters. On output, empty regions may result. The value of the system flag 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region" determines the behavior in this case.

运行信息

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

参数表

例程 (HDevelop)

* Simulate the symmetric difference of Region1 and Region2 with
* difference and union:
difference(Region1, Region2, Diff1)
difference(Region2, Region1, Diff2)
union2(Diff1, Diff2, Difference)

* Simulate the symmetric difference of Region1 and Region2 with
* union, intersection, and difference:
union2(Region1, Region2, Union)
intersection(Region1, Region2, Intersection)
difference(Union, Intersection, Difference)

结果

symm_differencesymm_differenceSymmDifferenceSymmDifferenceSymmDifferencesymm_difference always returns the value 2 ( H_MSG_TRUE) . The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). If necessary, an exception is raised.

可能的后置算子

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

参考其它

intersectionintersectionIntersectionIntersectionIntersectionintersection, union1union1Union1Union1Union1union1, union2union2Union2Union2Union2union2, complementcomplementComplementComplementComplementcomplement, differencedifferenceDifferenceDifferenceDifferencedifference

模块

Foundation

---