class_docstr: A coroutine wrapped in a Future.
docstr: Request that this task cancel itself.
  
  This arranges for a CancelledError to be thrown into the
  wrapped coroutine on the next cycle through the event loop.
  The coroutine then has a chance to clean up or even deny
  the request using try/except/finally.
  
  Unlike Future.cancel, this does not guarantee that the
  task will be cancelled: the exception might be caught and
  acted upon, delaying cancellation of the task or preventing
  cancellation completely.  The task may also return a value or
  raise a different exception.
  
  Immediately after this method is called, Task.cancelled() will
  not return True (unless the task was already cancelled).  A
  task will be marked as cancelled when the wrapped coroutine
  terminates with a CancelledError exception (even if cancel()
  was not called).
  
  This also increases the task's count of cancellation requests.
docstr_tok: ["Request","that","this","task","cancel","itself",".","This","arranges","for","a","CancelledError","to","be","thrown","into","the","wrapped","coroutine","on","the","next","cycle","through","the","event","loop",".","The","coroutine","then","has","a","chance","to","clean","up","or","even","deny","the","request","using","try\/except\/finally",".","Unlike","Future.cancel",",","this","does","not","guarantee","that","the","task","will","be","cancelled",":","the","exception","might","be","caught","and","acted","upon",",","delaying","cancellation","of","the","task","or","preventing","cancellation","completely",".","The","task","may","also","return","a","value","or","raise","a","different","exception",".","Immediately","after","this","method","is","called",",","Task.cancelled","(",")","will","not","return","True","(","unless","the","task","was","already","cancelled",")",".","A","task","will","be","marked","as","cancelled","when","the","wrapped","coroutine","terminates","with","a","CancelledError","exception","(","even","if","cancel","(",")","was","not","called",")",".","This","also","increases","the","task","'s","count","of","cancellation","requests","."]
code: def cancel(self, msg=None):
      """Request that this task cancel itself.
  
      This arranges for a CancelledError to be thrown into the
      wrapped coroutine on the next cycle through the event loop.
      The coroutine then has a chance to clean up or even deny
      the request using try/except/finally.
  
      Unlike Future.cancel, this does not guarantee that the
      task will be cancelled: the exception might be caught and
      acted upon, delaying cancellation of the task or preventing
      cancellation completely.  The task may also return a value or
      raise a different exception.
  
      Immediately after this method is called, Task.cancelled() will
      not return True (unless the task was already cancelled).  A
      task will be marked as cancelled when the wrapped coroutine
      terminates with a CancelledError exception (even if cancel()
      was not called).
  
      This also increases the task's count of cancellation requests.
      """
      self._log_traceback = False
      if self.done():
          return False
      self._num_cancels_requested += 1
      # These two lines are controversial.  See discussion starting at
      # https://github.com/python/cpython/pull/31394#issuecomment-1053545331
      # Also remember that this is duplicated in _asynciomodule.c.
      # if self._num_cancels_requested > 1:
      #     return False
      if self._fut_waiter is not None:
          if self._fut_waiter.cancel(msg=msg):
              # Leave self._fut_waiter; it may be a Task that
              # catches and ignores the cancellation so we may have
              # to cancel it again later.
              return True
      # It must be the case that self.__step is already scheduled.
      self._must_cancel = True
      self._cancel_message = msg
      return True
  
imports: import concurrent.futures
  import contextvars
  import functools
  import inspect
  import itertools
  import types
  import warnings
  import weakref
  from types import GenericAlias
  from .None import base_tasks
  from .None import coroutines
  from .None import events
  from .None import exceptions
  from .None import futures
  from .coroutines import _is_coroutine
label_desc: Use image node_id 11 for calling the Task obj's underlying member method code with example usage: obj.cancel(msg) and returns: True, False, True