mirror of
https://github.com/alfishe/amiga-bootcamp.git
synced 2026-06-13 00:26:28 +00:00
docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections
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.
This commit is contained in:
parent
f07a368bf1
commit
21751c0025
172 changed files with 19701 additions and 0 deletions
77
07_dos/pattern_matching.md
Normal file
77
07_dos/pattern_matching.md
Normal file
|
|
@ -0,0 +1,77 @@
|
|||
[← 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`
|
||||
Loading…
Add table
Add a link
Reference in a new issue