⚡ C++ POO· Lección 9.2

9.2 Colecciones de Objetos: Inventario con std::vector (1 a N) 🎒

Evoluciona tu arquitectura: haz que un objeto contenga una lista dinámica de otros objetos. Aprende a crear un inventario de pociones que alteran atributos (subir vida, veneno y mejoras de poder).

📺Ver Presentación Interactiva (PPT)←Volver

En la lección anterior vimos cómo un Jugador se vincula con un único objeto (su Espada). Sin embargo, en sistemas reales casi siempre necesitamos manejar colecciones dinámicas de objetos: un carrito de compras con múltiples productos, una biblioteca con cientos de libros, o un Jugador con un inventario de múltiples ítems consumibles.

1. Composición de Uno a Muchos (1 a N)

Para almacenar un número variable de objetos en C++ moderno, utilizamos el contenedor canónico de la STL: std::vector<Tipo>.

📦 Relación de Pertenencia

El Jugador es el dueño del vector. Cuando el jugador recoge una poción, se añade al vector con push_back(). Al consumirla, sus efectos se aplican a los atributos del jugador (subiendo o bajando estadísticas) y el ítem se destruye de la lista con erase().

2. Paso 1: La Clase Ítem (`Pocion`)

Definimos la clase de los objetos individuales que poblarán el inventario. Cada poción tendrá un nombre, un tipo de efecto y un valor numérico de impacto:

Pocion.h - Clase del elemento individual

CPP

class Pocion {
private:
    string nombre;
    string tipo; // "CURACION", "VENENO", "FUERZA"
    int valorEfecto;
 
public:
    Pocion(string nombre, string tipo, int valorEfecto)
        : nombre(nombre), tipo(tipo), valorEfecto(valorEfecto) {}
 
    // Getters para consultar propiedades desde el Jugador
    string getNombre() const { return nombre; }
    string getTipo() const { return tipo; }
    int getValorEfecto() const { return valorEfecto; }
 
    void mostrarInfo() const {
        cout << "[" << tipo << "] " << nombre 
             << " (" << (valorEfecto >= 0 ? "+" : "") << valorEfecto << " pts)\n";
    }
};

3. Paso 2: La Clase `Jugador` con `std::vector<Pocion>`

Incluimos la librería #include <vector> y declaramos el vector como atributo privado dentro de Jugador:

Incorporación de vector<Pocion> como atributo interno

CPP

#include <vector>
 
class Jugador {
private:
    string nombre;
    int salud;
    int saludMaxima;
    int fuerza;
    vector<Pocion> inventario; // <- Colección 1 a N de objetos
 
public:
    Jugador(string nombre, int saludMax, int fuerzaBase)
        : nombre(nombre), salud(saludMax), saludMaxima(saludMax), fuerza(fuerzaBase) {}
 
    // 1. Añadir un objeto a la colección
    void recogerPocion(const Pocion &pocion) {
        inventario.push_back(pocion);
        cout << "🎒 " << nombre << " guardó en su mochila: " << pocion.getNombre() << "\n";
    }
 
    // 2. Iterar sobre todos los objetos del vector
    void mostrarInventario() const {
        cout << "\n--- 🎒 Mochila de " << nombre << " (" << inventario.size() << " ítems) ---\n";
        if (inventario.empty()) {
            cout << "  (Tu mochila está vacía)\n";
            return;
        }
 
        for (size_t i = 0; i < inventario.size(); i++) {
            cout << "  " << i + 1 << ". ";
            inventario[i].mostrarInfo();
        }
    }
};

4. Consumir Ítems: Modificando Atributos y Eliminando del Vector

Al usar una poción ocurren tres eventos fundamentales de POO:

Validación de límites: Comprobamos que el índice solicitado por el usuario exista realmente en el vector (indice >= 0 && indice < inventario.size()).
Alteración del estado interno del Jugador: Según el tipo de poción, se modifican los atributos salud o fuerza:
- CURACIÓN (+Vida): Aumenta la salud sin exceder saludMaxima.
- VENENO (-Vida): Disminuye la salud; si llega a 0, el jugador queda derrotado.
- FUERZA (+Ataque): Aumenta permanentemente el atributo de fuerza física.
Eliminación del vector: Usamos inventario.erase(inventario.begin() + indice) para remover el ítem consumido y reorganizar el contenedor.

Lógica de consumo, modificación de atributos y eliminación con erase()

CPP

bool usarPocion(int slotUsuario) {
    int idx = slotUsuario - 1; // Convertimos de 1-based (usuario) a 0-based (C++)
 
    // 1. Verificación defensiva de rango
    if (idx < 0 || idx >= static_cast<int>(inventario.size())) {
        cout << "❌ No existe ningún ítem en la posición #" << slotUsuario << ".\n";
        return false;
    }
 
    Pocion consumida = inventario[idx];
    cout << "\n🧪 " << nombre << " consume " << consumida.getNombre() << "...\n";
 
    // 2. Modificación de atributos según el efecto
    if (consumida.getTipo() == "CURACION") {
        salud += consumida.getValorEfecto();
        if (salud > saludMaxima) salud = saludMaxima;
        cout << "💚 ¡Salud restaurada! Ahora tienes: " << salud << "/" << saludMaxima << " HP\n";
    } 
    else if (consumida.getTipo() == "VENENO") {
        salud -= consumida.getValorEfecto();
        if (salud < 0) salud = 0;
        cout << "🤢 ¡El frasco contenía veneno vil! Pierdes " << consumida.getValorEfecto() << " de vida.\n";
        cout << "   Salud actual: " << salud << "/" << saludMaxima << " HP\n";
        if (salud == 0) cout << "💀 ¡" << nombre << " ha caído derrotado por envenenamiento!\n";
    } 
    else if (consumida.getTipo() == "FUERZA") {
        fuerza += consumida.getValorEfecto();
        cout << "💪 ¡Tus músculos arden de poder! Fuerza incrementada a: " << fuerza << "\n";
    }
 
    // 3. Removemos la poción gastada del inventario
    inventario.erase(inventario.begin() + idx);
    return true;
}

5. Ejemplo Completo y Ejecutable

Este programa interactivo muestra la creación del jugador, la recolección de múltiples pociones con distintos efectos, y cómo sus atributos cambian dinámicamente al consumirlas:

Inventario de objetos con std::vector y modificación de atributos

CPP

#include <iostream>
#include <string>
#include <vector>
 
using namespace std;
 
// --- CLASE POCION ---
class Pocion {
private:
    string nombre;
    string tipo; // "CURACION", "VENENO", "FUERZA"
    int valorEfecto;
 
public:
    Pocion(string nombre, string tipo, int valorEfecto)
        : nombre(nombre), tipo(tipo), valorEfecto(valorEfecto) {}
 
    string getNombre() const { return nombre; }
    string getTipo() const { return tipo; }
    int getValorEfecto() const { return valorEfecto; }
 
    void mostrarInfo() const {
        cout << "[" << tipo << "] " << nombre 
             << " (" << (valorEfecto >= 0 ? "+" : "") << valorEfecto << " pts)\n";
    }
};
 
// --- CLASE JUGADOR CON INVENTARIO ---
class Jugador {
private:
    string nombre;
    int salud;
    int saludMaxima;
    int fuerza;
    vector<Pocion> inventario;
 
public:
    Jugador(string nombre, int saludMax, int fuerzaBase)
        : nombre(nombre), salud(saludMax), saludMaxima(saludMax), fuerza(fuerzaBase) {}
 
    string getNombre() const { return nombre; }
    int getSalud() const { return salud; }
    int getFuerza() const { return fuerza; }
 
    void recogerPocion(const Pocion &pocion) {
        inventario.push_back(pocion);
        cout << "🎒 " << nombre << " recogió: " << pocion.getNombre() << "\n";
    }
 
    void mostrarInventario() const {
        cout << "\n=== 🎒 INVENTARIO DE " << nombre << " (" << inventario.size() << " ítems) ===\n";
        if (inventario.empty()) {
            cout << "  (Mochila vacía)\n";
            return;
        }
 
        for (size_t i = 0; i < inventario.size(); i++) {
            cout << "  " << i + 1 << ". ";
            inventario[i].mostrarInfo();
        }
    }
 
    bool usarPocion(int slot) {
        int idx = slot - 1;
        if (idx < 0 || idx >= static_cast<int>(inventario.size())) {
            cout << "❌ Número de ítem inválido: #" << slot << "\n";
            return false;
        }
 
        Pocion p = inventario[idx];
        cout << "\n🧪 " << nombre << " bebe " << p.getNombre() << "...\n";
 
        if (p.getTipo() == "CURACION") {
            salud += p.getValorEfecto();
            if (salud > saludMaxima) salud = saludMaxima;
            cout << "💚 ¡Te has curado! HP actual: " << salud << "/" << saludMaxima << "\n";
        } 
        else if (p.getTipo() == "VENENO") {
            salud -= p.getValorEfecto();
            if (salud < 0) salud = 0;
            cout << "🤢 ¡Cuidado! Era veneno puro. Pierdes " << p.getValorEfecto() << " de vida.\n";
            cout << "   HP actual: " << salud << "/" << saludMaxima << "\n";
            if (salud == 0) cout << "💀 ¡" << nombre << " se desploma sin vida!\n";
        } 
        else if (p.getTipo() == "FUERZA") {
            fuerza += p.getValorEfecto();
            cout << "💪 ¡Tu fuerza física aumenta en " << p.getValorEfecto() << " pts! Total: " << fuerza << "\n";
        }
 
        // Se retira el ítem usado de la lista
        inventario.erase(inventario.begin() + idx);
        return true;
    }
 
    void mostrarFicha() const {
        cout << "┌───────────────────────────────────────────────┐\n";
        cout << "  Héroe: " << nombre << " | HP: " << salud << "/" << saludMaxima 
             << " | Fuerza: " << fuerza << " | Pociones: " << inventario.size() << "\n";
        cout << "└───────────────────────────────────────────────┘\n";
    }
};
 
// --- SIMULACIÓN EN MAIN ---
int main() {
    Jugador valiente("Link", 100, 20);
 
    // Creamos pociones con diversos efectos
    Pocion elixirVida("Elixir Rojo de Vida", "CURACION", 35);
    Pocion pocionPoder("Extracto de Fuerza de Dragón", "FUERZA", 15);
    Pocion frascoVeneno("Brebaje Sospechoso de la Bruja", "VENENO", 40);
 
    // Llenamos el inventario
    valiente.recogerPocion(elixirVida);
    valiente.recogerPocion(pocionPoder);
    valiente.recogerPocion(frascoVeneno);
 
    valiente.mostrarFicha();
    valiente.mostrarInventario();
 
    // 1. Consumir la poción de Fuerza (slot 2)
    valiente.usarPocion(2);
 
    // 2. Beber por error el frasco de veneno (que ahora quedó en el slot 2)
    valiente.usarPocion(2);
 
    // 3. Beber la poción de curación para recuperarse del veneno (slot 1)
    valiente.usarPocion(1);
 
    // Estado final
    cout << "\n=== ESTADO FINAL DEL HÉROE ===\n";
    valiente.mostrarFicha();
    valiente.mostrarInventario();
 
    return 0;
}
 

Continúa tu aprendizaje

10. Herencia y Polimorfismo ⚡

Ahora que dominas la composición ("Tiene-un"), adéntrate en la herencia ("Es-un"): clases base, clases derivadas y métodos virtuales.

Ir a Herencia y Polimorfismo →

Ejercicio de Práctica

1. Agrega a la clase Jugador un límite máximo de capacidad para la mochila (por ejemplo, máximo 4 pociones). Si el inventario ya está lleno, el método recogerPocion() debe mostrar un mensaje advirtiendo que no cabe más peso y no debe agregar la poción.
2. Agrega un nuevo tipo de poción: "MANA" con su correspondiente atributo mana en la clase Jugador.

Contenido

📚 Cursos de Café y Código

9.2 Colecciones de Objetos: Inventario con std::vector (1 a N) 🎒

1. Composición de Uno a Muchos (1 a N)

📦 Relación de Pertenencia

2. Paso 1: La Clase Ítem (`Pocion`)

3. Paso 2: La Clase `Jugador` con `std::vector<Pocion>`

4. Consumir Ítems: Modificando Atributos y Eliminando del Vector

5. Ejemplo Completo y Ejecutable

10. Herencia y Polimorfismo ⚡

Ejercicio de Práctica

Comprueba lo que Has Aprendido 🧠

¡Hecho con mucho cariño! ☕

9.2 Colecciones de Objetos: Inventario con std::vector (1 a N) 🎒

1. Composición de Uno a Muchos (1 a N)

📦 Relación de Pertenencia

2. Paso 1: La Clase Ítem (Pocion)

3. Paso 2: La Clase Jugador con std::vector<Pocion>

4. Consumir Ítems: Modificando Atributos y Eliminando del Vector

5. Ejemplo Completo y Ejecutable

10. Herencia y Polimorfismo ⚡

Ejercicio de Práctica

Comprueba lo que Has Aprendido 🧠

2. Paso 1: La Clase Ítem (`Pocion`)

3. Paso 2: La Clase `Jugador` con `std::vector<Pocion>`