mindspore.graph.register_op_wrapper
=====================================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/master/resource/_static/logo_source.svg
    :target: https://atomgit.com/mindspore/mindspore/blob/master/docs/api/api_python/mindspore/mindspore.register_op_wrapper.rst
    :alt: 查看源文件


.. py:function:: mindspore.graph.register_op_wrapper(op_name)

    注册自定义包装函数以替换算子在计算图中的节点。

    此装饰器允许用户注册自定义包装函数来替换计算图中算子的计算逻辑。当 JIT 编译器编译指定算子时，它将编译注册的包装函数而不是原始算子。

    包装函数接收与原始算子相同的参数，并且必须返回一个可调用的函数。

    .. note::
        - 每个算子只能注册一个包装函数。尝试为同一算子注册多个包装函数将抛出异常。
        - 替换影响当前进程中 JIT 编译 Cell 内指定算子的所有实例。
        - 包装函数参数应与原始算子的签名匹配。

    参数：
        - **op_name** (str) - 要注册包装函数的算子名称。必须为非空字符串。

    返回：
        callable，被装饰器的，被注册为自定义包装函数的函数。

    异常：
        - **ValueError** - 当 `op_name` 不是非空字符串时抛出。
        - **RuntimeError** - 当尝试为同一 `op_name` 注册包装函数多次时抛出。