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    }