User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cl:functions:pathname-match-p [2019/06/15 02:00]
cl:functions:pathname-match-p [2019/06/16 07:00] (current)
Line 1: Line 1:
 +====== Function PATHNAME-MATCH-P ======
 +
 +====Syntax====
 +  * **pathname-match-p** //pathname wildcard// → //​generalized-boolean//​
 +
 +====Arguments and Values====
 +  * //​pathname//​ - a //​[[CL:​Glossary:​pathname designator]]//​.
 +  * //​wildcard//​ - a //​[[CL:​Glossary:​designator]]//​ for a //​[[CL:​Glossary:​wild]]//​ //​[[CL:​Glossary:​pathname]]//​.
 +  * //​generalized-boolean//​ - a //​[[CL:​Glossary:​generalized boolean]]//​.
 +
 +====Description====
 +**pathname-match-p** returns //​[[CL:​Glossary:​true]]//​ if //​pathname//​ matches //​wildcard//,​ otherwise **[[CL:​Constant Variables:​nil]]**. The matching rules are //​[[CL:​Glossary:​implementation-defined]]//​ but should be consistent with **[[CL:​Functions:​directory]]**. Missing components of //​wildcard//​ default to **'':​wild''​**.
 +
 +It is valid for //​pathname//​ to be a wild //​[[CL:​Glossary:​pathname]]//;​ a wildcard field in //​pathname//​ only matches a wildcard field in //​wildcard//​ (i.e. **pathname-match-p** is not commutative). It is valid for //​wildcard//​ to be a non-wild //​[[CL:​Glossary:​pathname]]//​.
 +
 +====Examples====
 +None.
 +
 +====Affected By====
 +None.
 +
 +====Exceptional Situations====
 +If //​pathname//​ or //​wildcard//​ is not a //​[[CL:​Glossary:​pathname]]//,​ //​[[CL:​Glossary:​string]]//,​ or //​[[CL:​Glossary:​stream associated with a file]]// an error of type **[[CL:​Types:​type-error]]** is signaled.
 +
 +====See Also====
 +  * **[[CL:​Functions:​directory|Function DIRECTORY]]**
 +  * **[[CL:​Types:​pathname|System Class PATHNAME]]**
 +  * **[[CL:​Types:​logical-pathname|System Class LOGICAL-PATHNAME]]**
 +  * {\secref\FileSystemConcepts}
 +  * {\secref\PathnamesAsFilenames}
 +
 +====Notes====
 +None.
 +
 +\issue{PATHNAME-WILD:​NEW-FUNCTIONS} \issue{PATHNAME-STREAM} \issue{PATHNAME-LOGICAL:​ADD} \issue{FILE-OPEN-ERROR:​SIGNAL-FILE-ERROR}