mirror of
https://github.com/alfishe/amiga-bootcamp.git
synced 2026-06-12 16:16:28 +00:00
21751c0025
Comprehensive technical documentation covering: - Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives - Boot sequence: cold boot through startup-sequence - Binary format: HUNK executable spec, relocation, debug info - Linking & ABI: .fd files, LVO tables, register calling conventions - Exec kernel: tasks, interrupts, memory, signals, semaphores - AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting - Graphics: planar bitmaps, Copper programming, HAM/EHB modes - Intuition: screens, windows, IDCMP, BOOPSI - Devices: trackdisk, SCSI, serial, timer, audio, keyboard - Libraries: utility, expansion, IFFParse, locale, ARexx - Networking: bsdsocket API, SANA-II, TCP/IP stack comparison - Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging - Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies - CPU & MMU: 68040/060 emulation libs, PMMU, cache management - Driver development: SANA-II, Picasso96/RTG, AHI audio All files include breadcrumb navigation. No local paths or proprietary content.
77 lines
2 KiB
Markdown
77 lines
2 KiB
Markdown
[← Home](../README.md) · [AmigaDOS](README.md)
|
|
|
|
# Pattern Matching — ParsePattern, MatchPattern
|
|
|
|
## Overview
|
|
|
|
AmigaDOS provides built-in wildcard/pattern matching for file operations. Patterns are compiled into token streams via `ParsePattern` and matched via `MatchPattern`.
|
|
|
|
---
|
|
|
|
## Wildcard Syntax
|
|
|
|
| Pattern | Meaning | Example |
|
|
|---|---|---|
|
|
| `?` | Match exactly one character | `file?.txt` matches `file1.txt` |
|
|
| `#` | Match zero or more of the following | `#?.info` matches anything ending in `.info` |
|
|
| `#?` | Match any string (equivalent to `*`) | `#?` matches everything |
|
|
| `(a\|b)` | Alternation — match a or b | `(read\|write)` |
|
|
| `~` | Negation — match if NOT | `~(#?.info)` matches non-info files |
|
|
| `[abc]` | Character class | `[abc]` matches a, b, or c |
|
|
| `[a-z]` | Character range | `[0-9]` matches digits |
|
|
| `'` | Quote next character literally | `'#` matches literal `#` |
|
|
|
|
---
|
|
|
|
## API
|
|
|
|
```c
|
|
/* dos/dos.h — NDK39 */
|
|
|
|
/* Compile a pattern into tokenised form: */
|
|
LONG ParsePattern(STRPTR pat, STRPTR buf, LONG buflen);
|
|
/* Returns: 1 = pattern has wildcards, 0 = plain string, -1 = error */
|
|
|
|
/* Test a name against a compiled pattern: */
|
|
BOOL MatchPattern(STRPTR pat_compiled, STRPTR name);
|
|
|
|
/* Case-insensitive variants: */
|
|
LONG ParsePatternNoCase(STRPTR pat, STRPTR buf, LONG buflen);
|
|
BOOL MatchPatternNoCase(STRPTR pat_compiled, STRPTR name);
|
|
```
|
|
|
|
---
|
|
|
|
## Usage Example
|
|
|
|
```c
|
|
char pat[256], buf[256];
|
|
LONG is_wild;
|
|
|
|
is_wild = ParsePatternNoCase("#?.txt", pat, sizeof(pat));
|
|
if (is_wild >= 0) {
|
|
if (MatchPatternNoCase(pat, "readme.txt"))
|
|
Printf("Match!\n");
|
|
if (!MatchPatternNoCase(pat, "readme.doc"))
|
|
Printf("No match\n");
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Common Patterns
|
|
|
|
| Pattern | Matches |
|
|
|---|---|
|
|
| `#?` | Everything (wildcard all) |
|
|
| `#?.info` | All `.info` icon files |
|
|
| `~(#?.info)` | Everything except `.info` files |
|
|
| `(#?.c\|#?.h)` | All C source and header files |
|
|
| `file[0-9]` | `file0` through `file9` |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- NDK39: `dos/dos.h`
|
|
- ADCD 2.1: `ParsePattern`, `MatchPattern`
|