p1.aplic.cartas
Class Carta

java.lang.Object
  |
  +--p1.aplic.cartas.Carta

Direct Known Subclasses:

CartaPoquer, CartaTarot

public class Carta

extends java.lang.Object

Uma carta de um baralho comum. Num baralho comum, tem 52 cartas: 13 valores (AS, 2, 3, ..., 10, valete, dama, rei) de 4 naipes (ouros, espadas, copas, paus). Cartas podem ser criadas, comparadas (quanto a seu valor), etc.

Version:

1.1
Copyright (C) 1999 Universidade Federal da Paraíba.

Author:

Jacques Philippe Sauvé, jacques@dsc.ufpb.br

Field Summary

static int	AS Valor da carta AS.
static int	COPAS Valor do naipe de COPAS.
static int	DAMA Valor da carta DAMA.
static int	ESPADAS Valor do naipe de ESPADAS.
static int	OUROS Valor do naipe de OUROS.
static int	PAUS Valor do naipe de PAUS.
static int	REI Valor da carta REI.
static int	VALETE Valor da carta VALETE.

Constructor Summary

Carta(int valor, int naipe)
Construtor de uma carta comum.

Method Summary

int	compareTo(Carta outra) Compare esta carta a outra.
boolean	equals(java.lang.Object objeto) Testa a igualdade de um objeto com esta carta.
int	getNaipe() Recupera o naipe da carta.
int	getValor() Recupera o valor da carta.
static int	maiorValor() Recupera o valor da maior carta deste tipo que pode ser criada.
static int	menorValor() Recupera o valor da menor carta deste tipo que pode ser criada.
static int	primeiroNaipe() Recupera o "primeiro naipe" das cartas deste tipo.
java.lang.String	toString() Representa a carta como String.
static int	últimoNaipe() Recupera o "último naipe" das cartas deste tipo.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

AS

public static final int AS

Valor da carta AS. Usado para construir uma carta: new Carta(Carta.AS, Carta.PAUS)

VALETE

public static final int VALETE

Valor da carta VALETE. Usado para construir uma carta: new Carta(Carta.VALETE, Carta.PAUS)

DAMA

public static final int DAMA

Valor da carta DAMA. Usado para construir uma carta: new Carta(Carta.DAMA, Carta.PAUS)

REI

public static final int REI

Valor da carta REI. Usado para construir uma carta: new Carta(Carta.REI, Carta.PAUS)

PAUS

public static final int PAUS

Valor do naipe de PAUS. Usado para construir uma carta: new Carta(Carta.AS, Carta.PAUS)

OUROS

public static final int OUROS

Valor do naipe de OUROS. Usado para construir uma carta: new Carta(Carta.AS, Carta.OUROS)

COPAS

public static final int COPAS

Valor do naipe de COPAS. Usado para construir uma carta: new Carta(Carta.AS, Carta.COPAS)

ESPADAS

public static final int ESPADAS

Valor do naipe de ESPADAS. Usado para construir uma carta: new Carta(Carta.AS, Carta.ESPADAS)

Constructor Detail

Carta

public Carta(int valor,
             int naipe)

Construtor de uma carta comum.

Parameters:

valor - O valor da carta (AS, 2, 3, ..., 10, VALETE, DAMA, REI).

naipe - O naipe da carta (PAUS, OUROS, COPAS, ESPADAS).

Method Detail

getValor

public int getValor()

Recupera o valor da carta.

Returns:

O valor da carta.

getNaipe

public int getNaipe()

Recupera o naipe da carta.

Returns:

O naipe da carta.

menorValor

public static int menorValor()

Recupera o valor da menor carta deste tipo que pode ser criada. É possível fazer um laço de menorValor() até maiorValor() para varrer todos os valores possíveis de cartas.

Returns:

O menor valor.

maiorValor

public static int maiorValor()

Recupera o valor da maior carta deste tipo que pode ser criada. É possível fazer um laço de menorValor() até maiorValor() para varrer todos os valores possíveis de cartas.

Returns:

O maior valor.

primeiroNaipe

public static int primeiroNaipe()

Recupera o "primeiro naipe" das cartas deste tipo. Ser "primeiro naipe" não significa muita coisa, já que naipes não tem valor (um naipe não é menor ou maior que o outro). Fala-se de "primeiro naipe" e "último naipe" para poder fazer um laço de primeiroNaipe() até últimoNaipe() para varrer todos os naipes possíveis de cartas.

Returns:

O primeiro naipe.

últimoNaipe

public static int últimoNaipe()

Recupera o "último naipe" das cartas deste tipo. Ser "último naipe" não significa muita coisa, já que naipes não tem valor (um naipe não é menor ou maior que o outro). Fala-se de "primeiro naipe" e "último naipe" para poder fazer um laço de primeiroNaipe() até últimoNaipe() para varrer todos os naipes possíveis de cartas.

Returns:

O primeiro naipe.

compareTo

public int compareTo(Carta outra)

Compare esta carta a outra.

Parameters:

outra - A carta a comparar a esta.

Returns:

Zero se forem iguais. Um valor < 0 se a carta for menor que a outra carta. Um valor > 0 se a carta for maior que a outra carta.

equals

public boolean equals(java.lang.Object objeto)

Testa a igualdade de um objeto com esta carta.

Overrides:

equals in class java.lang.Object

Parameters:

objeto - O objeto a comparar com esta carta.

Returns:

true se o objeto for igual a esta carta, false caso contrário.

toString

public java.lang.String toString()

Representa a carta como String.

Overrides:

toString in class java.lang.Object

Returns:

Um string representando a carta.