switch_case¶
- api_attr
-
声明式编程模式（静态图)
该OP的运行方式类似于c++的switch/case。
- 参数：
-
branch_index (Tensor)- 形状为[1]的Tensor，指定将要执行的分支。数据类型是
int32,int64或uint8。branch_fns (dict|list|tuple) - 如果
branch_fns是一个list或tuple，它的元素可以是 (int, callable) 二元组，即由整数和可调用对象构成的二元组，整数表示对应的可调用对象的键；也可以仅仅是可调用对象，它在list或者tuple中的实际索引值将作为该可调用对象的键。如果branch_fns是一个字典，那么它的键是整数，它的值是可调用对象。所有的可调用对象都返回相同结构的Tensor。default (callable，可选) - 可调用对象，返回一个或多个张量。
name (str，可选) – 具体用法请参见 Name ，一般无需设置，默认值：None。
返回：如果 branch_fns 中存在与 branch_index 匹配的可调用对象，则返回该可调用对象的返回结果；如果 branch_fns 中不存在与 branch_index 匹配的可调用对象且 default 不是None，则返回调用 default 的返回结果； 如果 branch_fns 中不存在与 branch_index 匹配的可调用对象且 default 是None，则返回 branch_fns 中键值最大的可调用对象的返回结果。
返回类型：Tensor|list(Tensor)
- 抛出异常：
-
TypeError- 如果branch_index的类型不是list或tuple。TypeError- 如果branch_index的数据类型不是int32，int64或uint8。TypeError- 如果branch_fns的类型不是dict，list或tuple。TypeError- 如果branch_fns的元素不是2-tuple。TypeError- 如果branch_fns中的2-tuple的第一个元素的类型不是整数。ValueError- 如果branch_fns中的2-tuple的第一个元素值不唯一。TypeError- 如果branch_fns中的2-tuple的第二个元素不是可调用对象。TypeError- 当default不是None又不是可调用对象时。
代码示例：
import paddle
paddle.enable_static()
def fn_1():
return paddle.full(shape=[1, 2], dtype='float32', fill_value=1)
def fn_2():
return paddle.full(shape=[2, 2], dtype='int32', fill_value=2)
def fn_3():
return paddle.full(shape=[3], dtype='int32', fill_value=3)
main_program = paddle.static.default_startup_program()
startup_program = paddle.static.default_main_program()
with paddle.static.program_guard(main_program, startup_program):
index_1 = paddle.full(shape=[1], dtype='int32', fill_value=1)
index_2 = paddle.full(shape=[1], dtype='int32', fill_value=2)
out_1 = paddle.static.nn.switch_case(
branch_index=index_1,
branch_fns={1: fn_1, 2: fn_2},
default=fn_3)
out_2 = paddle.static.nn.switch_case(
branch_index=index_2,
branch_fns=[(1, fn_1), (2, fn_2)],
default=fn_3)
# Argument default is None and no index matches. fn_3 will be called because of the max index 7.
out_3 = paddle.static.nn.switch_case(
branch_index=index_2,
branch_fns=[(0, fn_1), (4, fn_2), (7, fn_3)])
exe = paddle.static.Executor(paddle.CPUPlace())
res_1, res_2, res_3 = exe.run(main_program, fetch_list=[out_1, out_2, out_3])
print(res_1) # [[1. 1.]]
print(res_2) # [[2 2] [2 2]]
print(res_3) # [3 3 3]