maths.derangement
=================

.. py:module:: maths.derangement

.. autoapi-nested-parse::

   A Python implementation for finding number of
   derangements possible for k objects
   https://en.wikipedia.org/wiki/Derangement



Functions
---------

.. autoapisummary::

   maths.derangement.derangement


Module Contents
---------------

.. py:function:: derangement(objects: int) -> int

   Calculates the number of derangements of k objects.
   :param objects:the number of objects ( -1 < objects < 1560 )
   :return :the number of derangements
   :raises :ValueError: If objects is negative.

   Examples:
   >>> derangement(3)
   2
   >>> derangement(5)
   44
   >>> derangement(10)
   1334961