| n | - a non-negative integer (see note about limits below) | |
| perm | - the permuted list of the integers [0, ..., n-1] |
| k | - an integer in [0, n!) | |
| isOdd | - if not NULL, returns wether the permutation used an even or odd number of swaps. |
Note: this is limited to n such that n! can be represented by PetscInt, which is 12 if PetscInt is a signed 32-bit integer and 20 if PetscInt is a signed 64-bit integer.