71 lines
1.8 KiB
C++
71 lines
1.8 KiB
C++
#ifndef MALL_SHOPPING_CART_HPP
|
||
#define MALL_SHOPPING_CART_HPP
|
||
|
||
#include "product.hpp"
|
||
#include <vector>
|
||
#include <utility>
|
||
|
||
/**
|
||
* @brief 购物车条目，记录商品和购买数量。
|
||
*/
|
||
struct CartItem {
|
||
Product product; ///< 商品副本
|
||
int quantity = 0; ///< 购买数量
|
||
|
||
/** @brief 小计金额 = 单价 × 数量 */
|
||
double subtotal() const noexcept { return product.getPrice() * quantity; }
|
||
};
|
||
|
||
/**
|
||
* @brief 购物车类，管理用户选中的商品。
|
||
*/
|
||
class ShoppingCart {
|
||
public:
|
||
ShoppingCart() = default;
|
||
|
||
/**
|
||
* @brief 向购物车添加商品（若已存在则累加数量）。
|
||
* @param product 商品
|
||
* @param quantity 数量
|
||
*/
|
||
void addItem(const Product& product, int quantity);
|
||
|
||
/**
|
||
* @brief 从购物车移除指定商品（完全移除）。
|
||
* @param productId 商品编号
|
||
* @return true 移除成功，false 未找到
|
||
*/
|
||
bool removeItem(uint64_t productId);
|
||
|
||
/**
|
||
* @brief 修改某商品的数量。
|
||
* @param productId 商品编号
|
||
* @param quantity 新数量（≤0 则移除）
|
||
* @return true 修改成功
|
||
*/
|
||
bool updateQuantity(uint64_t productId, int quantity);
|
||
|
||
/** @brief 清空购物车 */
|
||
void clear();
|
||
|
||
/** @brief 获取所有条目 */
|
||
const std::vector<CartItem>& getItems() const noexcept { return items_; }
|
||
|
||
/**
|
||
* @brief 计算购物车总金额。
|
||
* @return 所有条目小计之和
|
||
*/
|
||
double totalPrice() const;
|
||
|
||
/** @brief 购物车是否为空 */
|
||
bool isEmpty() const noexcept { return items_.empty(); }
|
||
|
||
/** @brief 条目数量 */
|
||
size_t itemCount() const noexcept { return items_.size(); }
|
||
|
||
private:
|
||
std::vector<CartItem> items_; ///< 购物车条目列表
|
||
};
|
||
|
||
#endif // MALL_SHOPPING_CART_HPP
|