Boogle/De.cs at main · RomThpt/Boogle · GitHub

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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
using System;

namespace boogle
{
    /// <summary>
    /// Classe représentant un dé dans le jeu Boogle.
    /// Chaque dé possède 6 faces et une face visible après un lancer.
    /// </summary>
    public class De
    {
        #region Instance
        /// <summary>
        /// Tableau des caractères représentant les faces du dé.
        /// </summary>
        private char[] faces;

        /// <summary>
        /// Caractère représentant la face visible actuelle du dé.
        /// </summary>
        private char visibleFace;
        #endregion

        #region Attributs
        /// <summary>
        /// Obtient la face visible actuelle du dé.
        /// </summary>
        public char VisibleFace
        {
            get { return visibleFace; }
        }

        /// <summary>
        /// Obtient les faces du dé.
        /// </summary>
        public char[] Faces
        {
            get { return faces; }
        }
        #endregion

        #region Constructeur
        /// <summary>
        /// Initialise un nouveau dé avec les faces spécifiées.
        /// </summary>
        /// <param name="faces">Tableau de caractères représentant les faces du dé (doit contenir exactement 6 faces).</param>
        /// <exception cref="ArgumentException">Lance une exception si le tableau ne contient pas exactement 6 faces.</exception>
        public De(char[] faces)
        {
            if (faces.Length != 6)
                throw new ArgumentException("Un dé doit avoir exactement 6 faces.");
            this.faces = faces;
            Lance(new Random());
        }
        #endregion

        #region Méthodes d'instance
        /// <summary>
        /// Lance le dé pour définir une nouvelle face visible aléatoire.
        /// </summary>
        /// <param name="r">Instance de Random utilisée pour générer un nombre aléatoire.</param>
        public void Lance(Random r)
        {
            visibleFace = faces[r.Next(6)];
        }

        /// <summary>
        /// Retourne une représentation textuelle des faces du dé et de la face visible actuelle.
        /// </summary>
        /// <returns>Une chaîne décrivant les faces du dé et la face visible.</returns>
        public string toString()
        {
            return $"Dé: {string.Join(", ", faces)}, Face visible: {visibleFace}";
        }
        #endregion

    }
}