001    package ps0.optional;
002    
003    
004    /**
005     * Represents one of the four suits (Hearts, Spades, Diamonds, Clubs) that appear
006     * on a playing card.  This class is immutable.
007     */
008    public enum CardSuit {
009    
010        // The 4 acceptable card suits, in ascending order.
011    
012        /**
013         * The suit of clubs.
014         */
015        CLUBS,
016    
017        /**
018         * The suit of diamonds.
019         */
020        DIAMONDS,
021    
022    
023        /**
024         * The suit of hearts.
025         */
026        HEARTS,
027    
028        /**
029         * The suit of spades.
030         */
031        SPADES;
032    
033    }