Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ (2) — Plan9 3rd Edition (Vita Nuova)

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sys-tokenize(2)

readdir(2)

regex(2)

FILEPAT(2)

NAME

filepat: expand, match − file pattern matching

SYNOPSIS

include "filepat.m";
filepat := load Filepat Filepat->PATH;
 expand:  fn(pat: string): list of string;
match:   fn(pat, name: string): int;

DESCRIPTION

­Expand builds a list of file names in alphabetical order that match the pattern pat. The pattern is tokenized using ­/ as a delimiter. 

­Match returns 1 if ­name matches the pattern pat, and 0 otherwise.

The ­pat passed to ­match and ­expand may include combinations of the special characters ∗, ?, [, and ]. 

The asterisk ­∗ matches a string of zero or more characters. 

The query ­?  matches any single character. 

The notation [s], where ­s is a nonempty string, matches any single character in s. The notation [^s], where s is a nonempty string, matches any single character not in s. The characters ∗, ?, and [ have no special meaning within s. 

If any character is preceded by the character \, that character loses any special meaning and is interpreted literally. 

SOURCE

­/appl/lib/filepat.b

SEE ALSO

sys-tokenize(2), readdir(2) regex(2)

Plan 9  —  June 29, 2000

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026