# wc-project

**Repository Path**: dragon111q/wc-project

## Basic Information

- **Project Name**: wc-project
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-01
- **Last Updated**: 2026-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 命令行文本计数统计程序 (wc.exe)

## a. 项目简介与用法

### 简介
这是一个基于 C 语言开发的命令行文本统计工具。可以统计纯英文 txt 文本的字符数、单词数、句子数，并扩展支持统计 C 语言代码文件的总行数、空行、注释行、代码行。

### 编译与运行方法
在项目根目录下打开终端，输入编译命令：
`gcc src/main.c src/counter.c -I src -o wc.exe`

### 参数说明
- `-c`：统计字符数（包含所有字符，含空格、换行）
- `-w`：统计单词数（以空白字符为分隔）
- `-s`：统计句子数（以 `.` `!` `?` 结尾）
- `-a`：统计代码文件行数（总行数/空行/注释行/代码行）

## b. 文件列表及说明
- `src/main.c`：命令行入口与参数解析
- `src/counter.c`：核心统计函数实现
- `src/counter.h`：函数声明与数据结构定义
- `tests/test_counter.c`：单元测试代码
- `testdata/basic.txt`：用于测试基础功能的英文文本
- `testdata/code_sample.c`：用于测试扩展功能的代码文件

## c. 例程运行及其结果

### 1. 基础功能运行结果
运行命令：`wc.exe -w testdata/basic.txt`
运行截图：
[在此处拖入截图：展示 wc.exe -w 和 -s 的输出]

### 2. 扩展功能运行结果
运行命令：`wc.exe -a testdata/code_sample.c`
运行截图：
[在此处拖入截图：展示 total:10, blank:1, comment:4, code:5 的输出]

### 3. 单元测试运行结果
运行命令：`test_runner.exe`
运行截图：
[在此处拖入截图：展示 All unit tests passed successfully!]

## 版本历史
- v0.1 空项目初始化
- v0.2 项目完成基础功能
- v0.3 项目完成扩展功能（包含单元测试）