// [引用: code_examples/functions/ex1_lifecycle.c]
#include <stdio.h>

// 1. 函数声明 (Declaration)
// 告诉编译器：有一个叫 calculate_unit_price 的函数
// 它需要两个数字（价格和容量），返回一个小数（单价）。
// 就像是给编译器一张"名片"。
double calculate_unit_price(double price, int volume);

// 2. 函数调用 (Calling)
// 在 main 函数里使用它
int main() {
    // 场景：苏打水比价
    double price_a = 2.0;
    int volume_a = 300;

    double price_b = 3.0;
    int volume_b = 500;

    printf("正在比较苏打水：\n");
    printf("方案 A: %.1f 元 / %d 毫升\n", price_a, volume_a);
    printf("方案 B: %.1f 元 / %d 毫升\n", price_b, volume_b);

    // 调用函数计算单价
    double unit_price_a = calculate_unit_price(price_a, volume_a);
    double unit_price_b = calculate_unit_price(price_b, volume_b);

    printf("\n方案 A 单价: %.4f 元/毫升\n", unit_price_a);
    printf("方案 B 单价: %.4f 元/毫升\n", unit_price_b);

    if (unit_price_b < unit_price_a) {
        printf("结论：方案 B 更便宜！\n");
    } else {
        printf("结论：方案 A 更便宜！\n");
    }
    return 0;
}

// 3. 函数定义 (Definition)
// 具体的计算过程
double calculate_unit_price(double price, int volume) {
    // 核心逻辑：价格除以容量
    return price / volume;
}

正在比较苏打水：
方案 A: 2.0 元 / 300 毫升
方案 B: 3.0 元 / 500 毫升

方案 A 单价: 0.0067 元/毫升
方案 B 单价: 0.0060 元/毫升
结论：方案 B 更便宜！

// [引用: code_examples/functions/ex2_params.c]
#include <stdio.h>

// 演示：值传递 (Pass by Value)
void modify_value(int v) {
    printf("  [函数内] 接收到的值: %d\n", v);
    v = 999; // 修改的是局部变量 v (复印件)
    printf("  [函数内] 已将值修改为: %d\n", v);
}

// 演示：返回值 (Return Value)
int square(int n) {
    return n * n; // 计算结果并送回
}

int main() {
    int my_num = 5;

    printf("main函数里的原始数值: %d\n", my_num);

    // 1. 尝试修改
    printf("正在调用 modify_value...\n");
    modify_value(my_num);

    // my_num 不会变，因为传给函数的是复印件
    printf("回到 main 函数，数值依然是: %d\n", my_num);

    // 2. 接收返回值
    printf("正在调用 square (平方计算)...\n");
    int sq = square(my_num);
    printf("%d 的平方是 %d\n", my_num, sq);

    return 0;
}

main函数里的原始数值: 5
正在调用 modify_value...
  [函数内] 接收到的值: 5
  [函数内] 已将值修改为: 999
回到 main 函数，数值依然是: 5
正在调用 square (平方计算)...
5 的平方是 25

// [引用: code_examples/functions/ex3_address.c]
#include <stdio.h>

int main() {
    int house_a = 100;
    int house_b = 200;

    printf("变量的值 (住在房间里的人):\n");
    printf("house_a = %d\n", house_a);
    printf("house_b = %d\n", house_b);

    printf("\n变量的地址 (房间的门牌号):\n");
    // & 操作符用于获取变量的地址
    // %p 是打印地址的专用格式符
    printf("house_a 的地址: %p\n", &house_a);
    printf("house_b 的地址: %p\n", &house_b);

    printf("\n比喻总结:\n");
    printf("数值 (100) 是住在房间里的客人。\n");
    printf("地址 (%p) 是挂在门上的门牌号。\n", &house_a);

    return 0;
}

变量的值 (住在房间里的人):
house_a = 100
house_b = 200

变量的地址 (房间的门牌号):
house_a 的地址: 0000004476BEF750
house_b 的地址: 0000004476BEF74C

比喻总结:
数值 (100) 是住在房间里的客人。
地址 (0000004476BEF750) 是挂在门上的门牌号。

// [引用: code_examples/functions/ex4_callback.c]
#include <stdio.h>

// 定义两个简单的数学函数
int add(int a, int b) { return a + b; }
int sub(int a, int b) { return a - b; }

// 定义一个函数指针类型，名字叫 OperationFunc
// 它代表：接收两个 int，返回一个 int 的函数
typedef int (*OperationFunc)(int, int);

// 这是一个"万能计算器"函数
// 它的第三个参数是一个函数！
// 这意味着你可以把具体的计算逻辑传进来
void calculator(int x, int y, OperationFunc op) {
    int result = op(x, y); // 调用传进来的函数
    printf("计算器结果: %d\n", result);
}

int main() {
    int a = 10, b = 5;

    printf("正在将 'add' (加法) 函数作为参数传递:\n");
    // 把 add 函数像变量一样传进去
    calculator(a, b, add); 

    printf("\n正在将 'sub' (减法) 函数作为参数传递:\n");
    // 把 sub 函数传进去
    calculator(a, b, sub);

    return 0;
}

正在将 'add' (加法) 函数作为参数传递:
计算器结果: 15

正在将 'sub' (减法) 函数作为参数传递:
计算器结果: 5

// [引用: code_examples/functions/ex5_return_func.c]
#include <stdio.h>

int add(int a, int b) { return a + b; }
int mul(int a, int b) { return a * b; }

// 定义函数指针类型
typedef int (*OperationFunc)(int, int);

// 这个函数返回一个函数指针！
// 根据输入的模式字符，决定返回加法函数还是乘法函数
OperationFunc get_operation(char mode) {
    if (mode == '+') {
        printf("  [选择器] 你选择了加法模式。\n");
        return add; // 返回加法函数的地址
    } else if (mode == '*') {
        printf("  [选择器] 你选择了乘法模式。\n");
        return mul; // 返回乘法函数的地址
    }
    return NULL;
}

int main() {
    int x = 6, y = 7;
    char mode = '+';

    printf("正在请求操作模式 '%c'...\n", mode);

    // 1. 获取对应的函数
    OperationFunc my_func = get_operation(mode);

    // 2. 调用获取到的函数
    if (my_func != NULL) {
        int result = my_func(x, y);
        printf("计算结果: %d\n", result);
    }

    mode = '*';
    printf("\n正在请求操作模式 '%c'...\n", mode);
    my_func = get_operation(mode);
    if (my_func != NULL) {
        printf("计算结果: %d\n", my_func(x, y));
    }

    return 0;
}

正在请求操作模式 '+'...
  [选择器] 你选择了加法模式。
计算结果: 13

正在请求操作模式 '*'...
  [选择器] 你选择了乘法模式。
计算结果: 42