pkr 0.1.0

A library for evaluating poker hands
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

use crate::card::Rank;

/// Finds in a given descending sorted `Vec<Rank>` a full house or returns None.
///
/// A full house in poker is a hand consisting of a three-of-a-kind and a pair.
/// If the length of `ranks_desc` is less than 5, it immediately returns `None`.
///
/// If a full house is found, it returns a `Vec<Rank>` where the first rank is
/// that of the three-of-a-kind, and the second rank is that of the pair
///
/// # Arguments
///
/// * `ranks_desc` - A vector of ranks sorted in descending order.
///
/// # Returns
///
/// * An `Option<Vec<Rank>>` which is `Some(Vec<Rank>)` containing the rank of
/// the three of a kind and the rank of the pair if a full house is found, or
/// `None` if no full house is found.
pub fn find_full_house(ranks_desc: &Vec<Rank>) -> Option<Vec<Rank>> {
    if ranks_desc.len() < 5 {
        return None;
    }

    let mut three_of_a_kind_rank = None;

    for i in 0..ranks_desc.len() - 2 {
        if ranks_desc[i] == ranks_desc[i + 2] {
            three_of_a_kind_rank = Some(ranks_desc[i]);
            break;
        }
    }

    if three_of_a_kind_rank.is_none() {
        return None;
    }

    for i in 0..ranks_desc.len() - 1 {
        if ranks_desc[i] == ranks_desc[i + 1] && ranks_desc[i] != three_of_a_kind_rank.unwrap() {
            return Some(vec![three_of_a_kind_rank.unwrap(), ranks_desc[i]]);
        }
    }

    return None;
}