// 處理用戶信息
void processUserInfo(const string& name);     // ?? name可能很長,用const引用
void processUserInfo(string name);            // ?? 每次都要拷貝name

// 處理坐標
void movePoint(int x, int y);                // ?? 坐標是簡單的int,直接傳值
void movePoint(const int& x, const int& y);  // ?? 引用反而增加了開銷

// 處理配置
void updateConfig(const vector<int>& config); // ?? vector可能很大,用const引用
void updateConfig(vector<int> config);        // ?? 拷貝整個vector開銷太大

// 處理ID
void processId(int id);                      // ?? ID就是個數字,傳值
void processId(const int& id);               // ?? 完全沒必要用引用

// 糟糕:result像個謎一樣,不知道是輸入還是輸出
void calculate_sum(int values[], int count, int* result); 

// 完美:sum像個告示牌,一看就知道會被修改
void calculate_sum(const int values[], int count, int& sum);

// 糟糕:str像個間諜,不知道會不會被暗中修改
void parse_name(char* str);

// 完美:str像個實習生,明確表示要被指導和修改
void parse_name(string& str);

class Widget {
    vector<int> data;
public:
    void add(int x) { data.push_back(x); }
};

void process(shared_ptr<Widget> w) 
{
    w->add(42);  // 看似人畜無害的按值傳遞,實際是個"內鬼"!
}

void update_iterator(vector<int>::iterator it)
{
    *it = 100;  // 迭代器雖然是按值傳遞,但有"穿墻"特技!
}

class Person {
    string name_;
    int age_;
public:
    // 糟糕:這簡直是"奪舍"!完全替換了原對象
    void update(Person& p) { 
        *this = p;  // 危險!像換了個人似的
    }
    
    // 完美:像個溫柔的美容師,只改變你想改的部分
    void set_name(const string& new_name) { name_ = new_name; }
    void set_age(int new_age) { 
        if (new_age < 0) throw invalid_argument("年齡不能為負,你想穿越嗎?");
        age_ = new_age; 
    }
};

string make_greeting(string&& name)  // name說:"請盡管移動我!"
{
    string result = "Hello, ";
    result += std::move(name);      // 直接把name的內容"偷"過來
    return result;                  // result也會被移動返回,超高效!
}

// 使用示例
string name = "Alice";
string greeting = make_greeting(std::move(name)); 
// 現在name變空了,greeting里面有完整的問候語

string str = "Hello";
process_string(std::move(str));  // str的內容被移走了
cout << str;          

// ?? 干凈利落的返回值方式
vector<Pizza*> find_pizzas(const vector<Pizza>&, Topping t); 

// ?? 麻煩的輸出參數方式
void find_pizzas(const vector<Pizza>&, vector<Pizza*>& out, Topping t);

// 鋼琴太重了,還是用引用吧
void move_piano(Piano& destination); 

string message;
for(int i = 0; i < 100; i++) {
  // 重復使用message,避免創建新的
  append_to_message(message, i); 
}

Matrix operator+(const Matrix& a, const Matrix& b) {
    Matrix result;
    // 編譯器:放心,我會幫你優化掉不必要的拷貝~
    return result; 
}

// 糟糕的寫法 ??
void calculate_stats(const vector<int>& data, 
                    double& mean,    // 輸出參數:平均值
                    double& std_dev) // 輸出參數:標準差
{
    // 計算平均值
    mean = /* ... */;
    // 計算標準差
    std_dev = /* ... */;
}

// 使用時:
double avg, dev;
calculate_stats(numbers, avg, dev); // 不清楚哪個是輸入哪個是輸出

// 優雅的寫法 ?
struct Stats {
    double mean;    // 平均值
    double std_dev; // 標準差
};

Stats calculate_stats(const vector<int>& data)
{
    double mean = /* ... */;
    double std_dev = /* ... */;
    return {mean, std_dev}; // 清晰地返回所有結果
}

// 使用時:
auto stats = calculate_stats(numbers); // 一目了然!
cout << "平均值:" << stats.mean << "\n";

auto [mean, std_dev] = calculate_stats(numbers);
cout << "平均值:" << mean << "\n";

// 這樣寫是合適的 ??
bool read_record(istream& in,      // 輸入輸出流
                Record& record)    // 輸出:讀取的記錄
{
    // 讀取記錄...
    return true; // 返回是否成功
}

// 使用示例:
Record r;
while (read_record(file, r)) {
    process(r);
}

// 表示地理位置
struct Location {
    double latitude;   // 緯度
    double longitude;  // 經度
    double altitude;   // 海拔(米)
    
    string toString() const {
        return fmt::format("({:.2f}, {:.2f}, {:.2f}m)", 
                          latitude, longitude, altitude);
    }
};

// 使用示例
Location get_current_location() {
    // ... 獲取GPS數據 ...
    return {37.7749, -122.4194, 0}; // 舊金山
}

// 不好的寫法 ??
tuple<double,double,double> get_position() {
    return {37.7749, -122.4194, 0};
}

// 使用時不知道各個值的含義
auto [x, y, z] = get_position(); 

struct QueryResult {
    int status_code;     // HTTP狀態碼
    bool has_data;       // 是否找到數據
    string error_msg;    // 錯誤信息
};

struct HugeResult {
    vector<double> data;  // 可能很大的數據
    string metadata;
};

HugeResult process_data(const string& input) 
{
    HugeResult result;
    result.data = /* ... 大量計算 ... */;
    result.metadata = /* ... */;
    return result;  // 編譯器會自動使用移動語義
}

// 相親角色: 顧客類
class Customer { /*...*/ };

// 場景1: 處理VIP折扣
class Order {
    // 錯誤寫法: 用引用妹,顯得太強勢了!
    void process_discount(Customer& vip) { /*...*/ }
    
    // 正確寫法: 用指針君,比較隨意自然
    void process_discount(Customer* maybe_vip) {
        if(maybe_vip) {  // 有VIP就打折
            give_discount();
        } else {         // 沒VIP就原價
            normal_price(); 
        }
    }
};

void process_order(not_null<Customer*> customer) {
    // 這位指針君保證有對象,超級可靠!
    customer->validate();
}