137 lines
8.0 KiB
Markdown
137 lines
8.0 KiB
Markdown
# 第一题 出门检查器
|
||
|
||
- **类型**：基础语法与代码题（必做）
|
||
- **基础要求**：Swift 基础语法
|
||
- **提交材料**：源码和真实运行截图
|
||
- **AI 规则**：仅可辅助学习和讲解基础知识，解题、编码与排错须独立完成
|
||
|
||
## 任务背景与概述
|
||
|
||
出门前，你有一份“需要带的物品”清单，也知道哪些物品已经放进包里。请写一个程序，对照两份清单，告诉你还缺什么。
|
||
|
||
本题是一道 Swift 基础练习：定义数组，编写并调用函数，再根据结果输出信息。输入数据直接写在代码中，不需要实现键盘输入或图形界面。
|
||
|
||
## 任务详细要求
|
||
|
||
### 1. 输入数据与命名规则
|
||
|
||
使用下面两个字符串数组作为初始数据：
|
||
|
||
```swift
|
||
let requiredItems = ["校园卡", "钥匙", "水杯", "耳机"]
|
||
var packedItems = ["手机", "校园卡", "钥匙"]
|
||
```
|
||
|
||
- `requiredItems` 是本次需要带的物品。
|
||
- `packedItems` 是已经放进包里的物品，可能包含本次清单之外的东西。
|
||
- 初始数组使用上述变量名。`packedItems` 后续需要修改，因此使用 `var`；其他自定义变量的名称清楚即可。
|
||
- 本题保证每个数组内部没有重复名称，也没有空名称。名称按字符串完全相同判断，无需处理错别字、空格清理或模糊匹配。
|
||
- 缺少的物品应按 `requiredItems` 中的先后顺序返回。
|
||
- 本题只判断物品是否存在，不处理数量。
|
||
|
||
### 2. 函数要求
|
||
|
||
编写函数，接收需要清单和已装入清单，返回缺少物品的数组。请使用以下函数名称、参数标签和类型：
|
||
|
||
```swift
|
||
func findMissingItems(required: [String], packed: [String]) -> [String]
|
||
```
|
||
|
||
上面只是接口说明，函数体由你编写。没有缺少物品时返回空数组。函数应适用于符合规则的其他清单，不能把示例答案直接写死。
|
||
|
||
### 3. 输出要求
|
||
|
||
调用函数，每次检查都输出：
|
||
|
||
- 案例名称、需要带的物品、已装入的物品；
|
||
- 缺少物品的名称和数量；没有缺少物品时明确显示“无”或空数组，数量为 0；
|
||
- 需要清单非空且没有缺少物品时，输出“已经准备好了，可以出发”；
|
||
- 需要清单为空时，输出“本次没有必带物品，无需检查”。
|
||
|
||
初始数据的一种输出形式如下：
|
||
|
||
```text
|
||
案例 A：初次检查
|
||
需要带的物品：校园卡、钥匙、水杯、耳机
|
||
已装入的物品：手机、校园卡、钥匙
|
||
缺少的物品：水杯、耳机
|
||
缺少数量：2
|
||
```
|
||
|
||
输出排版可以自行安排，只要信息清楚。标点、空格和数组的显示样式不要求与示例逐字一致。手机不在需要清单里，不影响结果。
|
||
|
||
### 4. 数据修改与运行案例
|
||
|
||
在同一个程序中完成 A–F：先检查初始数据，再向 `packedItems` 依次添加“水杯”和“耳机”，每次添加后重新调用函数并输出结果，得到 A、B、C。然后使用 D、E、F 的数据继续调用函数并输出。
|
||
|
||
| 案例 | 需要带的物品 | 已装入的物品 | 函数应返回 |
|
||
| --- | --- | --- | --- |
|
||
| A 初次检查 | 校园卡、钥匙、水杯、耳机 | 手机、校园卡、钥匙 | 水杯、耳机 |
|
||
| B 添加水杯后 | 校园卡、钥匙、水杯、耳机 | 手机、校园卡、钥匙、水杯 | 耳机 |
|
||
| C 再添加耳机后 | 校园卡、钥匙、水杯、耳机 | 手机、校园卡、钥匙、水杯、耳机 | 空数组 |
|
||
| D 包里什么都没有 | 钥匙、水杯 | 空数组 | 钥匙、水杯 |
|
||
| E 本次没有必带物品 | 空数组 | 手机 | 空数组 |
|
||
| F 两份清单都为空 | 空数组 | 空数组 | 空数组 |
|
||
|
||
C 输出准备齐全的提示；E、F 输出无需检查的提示。
|
||
|
||
## 提交材料、方式与格式规范
|
||
|
||
### 提交材料与格式
|
||
|
||
| 材料 | 格式与要求 |
|
||
| --- | --- |
|
||
| 源码 | 文件名为 `main.swift`，使用 UTF-8 编码，包含函数、调用和 A–F 案例；保持缩进和命名清楚，必要处添加注释 |
|
||
| 运行截图 | 使用 PNG 或 JPG，文字清晰，能辨认案例名称与实际输出，覆盖 A–F；可分多张，按 `run-01.png`、`run-02.png` 等顺序命名，JPG 使用相应扩展名 |
|
||
|
||
源码和截图应来自同一个最终版本。允许裁去无关窗口，不得修改运行结果文字、拼造结果或用 AI 生成截图。未全部完成时可提交当前源码与实际结果，标注未完成处。
|
||
|
||
### 提交方式
|
||
|
||
第一题与第二题一起放入 `submissions/年级姓名/`，个人文件夹例如 `25刁泓宁`。本题源码放在 `01-basics/main.swift`，运行截图放在 `01-basics/screenshots/`。
|
||
|
||
在本仓库的个人分支提交这份文件夹，再发起指向 `main` 的 PR，由干部审核合并。完整目录示例与步骤见[前两题提交说明](../submissions/README.md)。当前仍在筹备，正式开放时间和截止时刻以[仓库首页](../README.md)通知为准。
|
||
|
||
不需要额外提交设计文档、学习笔记或调试报告。
|
||
|
||
## 学习范围与资源
|
||
|
||
学习到能使用下面这些内容即可：
|
||
|
||
- `let`、`var`，字符串与布尔值；
|
||
- 数组的创建、遍历、添加、数量和空数组；
|
||
- `if/else`、`for-in`；
|
||
- 函数参数、返回值和调用；
|
||
- `print` 输出及字符串插值。
|
||
|
||
可从[菜鸟教程 Swift 目录](https://www.runoob.com/swift/swift-tutorial.html)按以上主题阅读。无需通读可选类型、结构体、类、闭包、泛型或 SwiftUI。遇到教程样例与所用版本不一致，可参考下列 Swift 官方说明或询问授课干部。
|
||
|
||
- [基础语法](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/thebasics/)
|
||
- [数组与集合](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/collectiontypes/)
|
||
- [条件与循环](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/controlflow/)
|
||
- [函数](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/functions/)
|
||
|
||
可以用循环判断，也可以使用自己理解的标准库方法。不以代码行数、运行速度排名或使用高级语法的数量评判本题。
|
||
|
||
## 独立完成规则
|
||
|
||
**允许用 AI 辅助学习基础知识。** 例如，询问 `let` 和 `var` 的区别、函数参数标签的含义，或请 AI 讲解教程中看不懂的语法和通用示例。理解之后，本题的思路、代码与检查过程由自己完成。
|
||
|
||
**不得用 AI 完成本题。** 包括分析题目并给出解题思路或伪代码，生成、补全、修改或优化本题代码，以及检查、解释或调试待提交的代码。不要把本题题面、自己的解法、源码或报错交给 AI 分析；运行证据也必须由自己实际运行获得。
|
||
|
||
可以阅读教程和官方文档，使用编辑器的非 AI 语法提示，向干部询问环境问题或基础概念；不能让他人代写。
|
||
|
||
请亲自运行，比较预期与实际结果，必要时自己定位问题、修改后重试。不要求必须遇到或制造某个错误。
|
||
|
||
## 考察重点
|
||
|
||
完成后，可以用下面的问题检查自己是否真正理解：
|
||
|
||
- **变量与数据**：哪些数据会改变？为什么需要区分 `let` 和 `var`？数组怎样表示一份清单？
|
||
- **条件与循环**：自己用到的判断和遍历在做什么？为什么能找出缺少的物品，并保留原清单的顺序？若用了标准库方法，能否说明它的作用？
|
||
- **函数与调用**：参数和返回值分别是什么？返回结果与打印结果有什么区别？换一组输入，函数为什么还能工作？
|
||
- **边界情形**：包为空、需要清单为空、全部带齐时分别会发生什么？为什么“全部带齐”和“本次无需检查”要区分？
|
||
- **运行与检查**：能否运行自己的源码、对照案例检查输出；修改数据后，能否先预测结果，再运行验证？发现不一致时，能否说明自己的检查过程？
|
||
|
||
二面会结合源码与真实运行结果交流上述内容，可能请你解释一段代码，或预测输入变化后的输出。重点是基础知识与本人完成过程，不以代码行数、装饰性排版或高级语法数量判断能力。
|