## description du programme :

**sa** : swap a - intervertit les 2 premiers éléments au sommet de la pile a. Ne fait rien s’il n’y en a qu’un ou aucun.
**sb** : swap b - intervertit les 2 premiers éléments au sommet de la pile b. Ne fait rien s’il n’y en a qu’un ou aucun.
**ss** : sa et sb en même temps.
**pa** : push a - prend le premier élément au sommet de b et le met sur a. Ne fait rien si b est vide.
**pb** : push b - prend le premier élément au sommet de a et le met sur b. Ne fait rien si a est vide.
**ra** : rotate a - décale d’une position vers le haut tous les élements de la pile a. Le premier élément devient le dernier.
**rb** : rotate b - décale d’une position vers le haut tous les élements de la pile b. Le premier élément devient le dernier.
**rr** : ra et rb en même temps.
**rra** : reverse rotate a - décale d’une position vers le bas tous les élements de la pile a. Le dernier élément devient le premier.
**rrb** : reverse rotate b - décale d’une position vers le bas tous les élements de la pile b. Le dernier élément devient le premier.
**rrr** : rra et rrb en même temps.

## pour utiliser l'algorithme de tris de ce programme dans votre propre programme, il faut :

1. copier le fichier algo.c

2. mettre son prototype dans votre header.h : `void hugo_sort(t_stack **a, t_stack **b, t_list **solution)`

3. mettre le fichier dans vos srcs dans Makefile (`algo.c`)

4. et verifier que vos functions d'actions (push, swap, rotate) ont bien les memes prototypes :
	- `t_list *sa(t_stack **a, t_list **lst);`
	- `t_list *ss(t_stack **a, t_stack **b, t_list **lst);`
	- `t_list *pa(t_stack **dst, t_stack **src, t_list **lst);`
	- `t_list *pb(t_stack **dst, t_stack **src, t_list **lst);`
	- `t_list *ra(t_stack **stack, t_list **lst);`
	- `t_list *rb(t_stack **stack, t_list **lst);`
	- `t_list *rr(t_stack **a, t_stack **b, t_list **lst);`
	- `t_list *rra(t_stack **stack, t_list **lst);`
	- `t_list *rrb(t_stack **stack, t_list **lst);`
	- `t_list *rrr(t_stack **a, t_stack **b, t_list **lst);`

## points particuliers :

- les fonctions d'actions (puches, swapes, rotates) recoivent une ou les deux piles a et b, et la liste chainee *solution* qui doit accueillir les noms des actions successives
- mais pour pouvoir imprimer l'état des deux piles a et b a chaque etape il faudrait que chaques fonctions recoivent les deux piles, ce qui n'est pas le cas : sa() par exemple ne recoit pas la pile b
- donc j'ai stocké les deux piles dans les deux premiers maillons de la chaine solution, car toutes les fonctions d'actions la recoivent

## ce programme push_swap.c s'organise de la facon suivante :

1. des fonctions pour faire fonctionner l'algorithme de tris (principalement parsing des donnees, et les actions utilisees par l'algorithme de tris : push, swap, rotate et reverse rotate) :

- **push_swap.c** : contient la fonction main et 4 autres fonctions :
	- **is_valid** : verification d'erreur dans les arguments données, si aucun argument affiche l'usage
	- **check_flag** : regarde la presence des flags, pour l'instant uniquement -p pour print les etapes du tri
	- **init_stack** : parse la pile a trier dans une liste chainee
	- **launch_algo** : lance l'algorithme de tri, en lui envoyant ce qui est necessaire (les deux piles a et b et la liste de solutions)

- **stop.c** : qui gere les erreurs, l'usage, mais aussi qui free avant de fermer le programme
	- **ps_stop** : recoit toutes les listes chainees du programme, envoyer NULL si on ne veut pas free la liste, et le dernier int permet de savoir si on veut juste free sans arreter le programme (= -1), et si on veut signaler une erreur (>= 1)
	- **ps_error** : la gestion des erreurs
	- **ps_usage** : en cas d'erreur = 1, affiche l'usage du programme

- **print.c** : contient les fonctions necessaires pour afficher le resultat
	- **print_result** : affiche le resultat, et si presence du flag -p affiche aussi les etapes de tris
	- **fill_solution** : remplit la liste chainee solution au fur et a mesure de l'appel des fonctions push swap et rotate (pas optimisé pour raison de compatibilité avec l'appel des fonctions du programme de luke : les actions (push, swap, etc) ne recoivent pas de flag en argument, donc fill_solution remplis toutes les infos necessaires pour le flag, meme s'il n'y a pas de flag)

- toutes les fonctions d'action (push, swap, rotate, et reverse rotate)


2. les fonctions d'algorithme, qui sont appellees par launch_solution()

- **algo.c** : le fichier qui contient les fonctions d'algorithme de tri
	- **hugo_sort** : pour l'instant une fonction test qui utilise toutes les actions (push, swap, rotate)

## exemples de listes de nombres

ligne de commande pour generer une liste de nombres melangee :
```
shuf -i 0-RANGE -n SIZE))
```
avec RANGE a remplacer par la valeure maximum
et SIZE par la taille de la liste

**liste de 20 nbr  :** 64 77 54 61 6 15 47 35 66 13 1 45 26 27 74 53 14 22 60 95
**liste de 50 nbr  :** 37 100 75 78 22 33 32 35 29 95 52 34 54 26 74 87 93 23 18 19 42 7 67 72 77 21 55 45 98 17 66 1 3 40 38 81 99 31 47 6 30 82 80 50 94 60 97 86 13 14
**liste de 100 nbr :** 109 799 165 500 175 243 551 577 265 298 99 141 397 335 221 802 53 129 505 701 184 895 130 540 383 706 73 611 930 536 659 333 212 980 624 487 671 25 151 189 738 498 28 975 628 595 856 876 819 916 818 90 328 596 617 643 987 398 582 678 425 631 914 962 881 542 897 782 685 737 840 83 443 817 786 547 287 285 789 732 87 998 632 496 576 486 300 896 571 841 562 603 255 720 447 44 951 407 152 616
**liste de 500 nbr :** 361 115 599 394 615 743 268 962 638 329 910 902 144 611 332 509 675 761 337 640 656 577 10 610 956 496 487 770 922 188 620 595 653 194 31 752 746 875 906 951 939 908 575 831 790 233 316 529 476 720 835 926 249 673 717 701 966 150 520 503 505 974 535 959 364 424 317 81 146 17 11 735 56 580 296 996 258 614 887 489 672 461 191 425 138 712 187 774 166 148 502 945 862 176 74 878 884 937 99 691 346 1 751 85 437 648 282 88 706 958 578 73 507 864 221 300 654 669 398 465 234 353 236 517 475 50 110 960 206 18 5 941 519 557 275 443 738 175 196 832 41 183 880 757 779 484 681 419 428 471 326 230 632 515 729 834 723 379 909 106 998 679 886 278 427 226 639 287 933 778 586 340 314 293 991 283 621 916 593 444 762 342 802 362 401 707 137 104 934 402 145 852 392 714 44 38 211 238 395 467 606 716 806 229 596 613 590 583 585 869 47 178 845 928 967 256 383 136 920 659 988 19 219 602 399 302 544 202 170 622 652 151 993 376 763 855 997 90 133 430 829 837 452 549 828 725 808 588 435 348 385 235 693 879 121 687 709 872 526 560 343 381 551 818 324 568 421 321 309 840 685 310 209 990 741 422 69 594 719 214 528 981 269 164 677 950 753 836 119 618 442 860 143 491 791 373 455 83 616 768 420 504 2 149 853 62 347 160 686 59 894 506 696 391 546 159 497 436 129 94 155 257 867 777 372 630 537 199 555 0 634 174 727 771 409 345 885 237 434 212 6 695 388 400 48 456 58 769 550 350 117 123 856 352 915 245 812 227 882 803 463 408 53 558 315 919 404 977 75 370 579 13 458 201 587 331 20 292 470 591 795 87 368 128 39 108 334 747 453 135 473 239 629 570 440 874 246 905 973 365 327 358 516 42 82 431 16 78 43 454 932 833 892 203 204 930 177 589 147 968 390 607 67 699 794 641 299 670 952 623 338 250 448 222 866 782 758 731 957 617 161 356 786 841 609 823 192 469 157 697 15 953 940 328 772 797 76 359 244 198 992 405 562 335 601 107 851 403 923 433 597 271 415 498 384 666 495 721 745 32 989 947 702 105 270 954 36 750 903 488 374 354 994 481 713 306 213 805 896 259

## comparaison des algorithmes de tris :

source des comparaisons ci-dessous : [https://www.youtube.com/watch?v=xoR-1KwQh2k](https://www.youtube.com/watch?v=xoR-1KwQh2k)


    numbers  comparisons  array-access  name
        200       19 900        18 448  Bubble Sort
        200       20 000        20 384  Cocktail Shaker Sort
        200       19 501        19 306  Gnome Sort
        200        9 568        18 752  Optimized Gnome Sort
       2000       18 308        18 498  Odd-Even Sort
       2000    1 999 000         3 998  Selection Sort
       2000    2 002 000         4 000  Double Selection Sort
       2000      965 671    19 273 364  Insertion Sort
       2000       19 201     1 890 122  Binary Insertion Sort
       2000       53 378        20 574  Comb Sort
       2000       31 948        32 789  Shell Sort
       2000       19 423        43 904  Merge Sort
       2000       31 048        59 938  Binary Merge
       2000      100 955     2 156 938  Weave Merge Sort
       2000       19 496        43 039  TimSort
       2000    1 993 119     1 930 836  Merge Sort In-Place
       2000       31 022       111 758  WikiSort (Block Merge Sort)
       2000       22 193        85 044  GrailSort (Block Merge Sort)
       2000       30 905        10 510  Quick Sort
       2000       26 160        27 488  Stable Quick Sort
       2000       24 482        18 852  Dual Pivot Quick Sort
       2000       37 841        40 490  Max Heap Sort
       2000       37 714        42 206  Min Heap Sort
       2000       21 021        26 756  Weak Heap Sort
       2000       24 996        27 926  Ternary Heap Sort
       2000       50 078        27 803  Smooth Sort
       2000       19 410         2 000  Tournament Sort
       2000    5 935 671         3 996  Cycle Sort
       2000       25 711        16 616  std::sort (Introsort)
       2048       33 352        25 109  Quick Shell Sort (Introsort with Shellsort)
       2048       19 821        31 652  std::stable sort (Insert/Bottom-up Merge)
       2000       58 367        66 296  Batcher's Odd-Even Mergesort
       2000       64 832        66 118  Batcher's Bitonic Sort
        200       20 099        30 684  Pancake Sort
       2000       54 989         2 000  Patience Sort
       2000            0     3 973 224  Gravity Sort
       2000            0         6 000  Counting Sort
       2000            0         4 000  Pigeonhole Sort
       2000            0        12 000  Radix LSD Sort (Base 4)
       2000            0         4 220  American Flag Sort (128 Buckets)
       2048            0    19 207 376  Radix LSD In-Place Sort (Base 10)
       2000            0    34 562 144  Radix LSD In-Place Sort (Base 2)
       2000            0        26 000  Radix MSD Sort (Base 4)
       2000            0        46 000  Radix MSD Sort (Base 2)
       2000            0        80 048  Shatter Sort
       2000            0        12 000  Simple Shatter Sort
       2000        5 044         6 098  Flash Sort
       2000       28 868        55 742  Time Sort (Mul 4) + Insertion Sort
        200      797 161        19 928  Stooge Sort
        200       50 783           400  Bad Sort
        200  114 006 565        19 276  Silly Sort
        200  114 006 565        20 716  Slow Sort
        200      100 437     4 771 028  Less Bogo Sort
        200      131 994     2 472 298  Cocktail Bogo Sort
         10    4 875 249    56 784 400  Bogo Sort


---

autre source de comparaison : [https://www.toptal.com/developers/sorting-algorithms](https://www.toptal.com/developers/sorting-algorithms)
push_swap_visalizer : [https://github.com/o-reo/push_swap_visualizer](https://github.com/o-reo/push_swap_visualizer)

---

