ansys.scade.apitools.prop.pragma.set_pragma_text
================================================

.. py:function:: ansys.scade.apitools.prop.pragma.set_pragma_text(object_: scade.model.suite.Object, id: str, text: str) -> bool

   
   Update the pragma ID of an object with a new ID.

   * Delete the pragma when the text is empty.
   * Create a new pragma when no pragma ID exists yet.
   * Return whether the model is modified.

   See the :ref:`pragma <ex__pragma>` example.

   :Parameters:

       **object\_** : :obj:`suite.Object`
           Element to search for the pragma.

       **id** : :class:`python:str`
           ID of the pragma.

       **text** : :class:`python:str`
           New ID of the pragma.



   :Returns:

       :ref:`bool <python:bltin-boolean-values>`
           ``True`` when the model is modified, ``False`` otherwise.











   ..
       !! processed by numpydoc !!