Caché ObjectScript Reference - InterSystems Documentation

find a final slash in the previous step, it uses the whole string that results from Step 1 asthe file name search pattern.The file name search pattern can be any legal file name string or a file name wildcardexpression. The first file name that matches the search pattern is returned as the $ZSEARCHfunction value. Which is the first matching file is platform-dependent (as described in theNotes section).If the next invocation of $ZSEARCH specifies the null string as the target, $ZSEARCHcontinues with the previous target and returns the next file name that matches the searchpattern. When there are no more files that match the search pattern, $ZSEARCH returns anull string.The $ZSEARCH function returns the full pathname of an existing file or directory. The$ZUTIL(12) function returns the full pathname of a specified file or directory; dependingon options selected, it can optionally verify the existence of the file, and either preserveuppercase letters in the pathname or convert all letters to lowercase. $ZUTIL(12) cannot usewildcards.Wildcards$ZSEARCH$ZSEARCH allows the use of the following wildcard expressions within the quoted targetstring.Wildcard*?MatchMatches any string of zero or more characters.Matches any single character. On VMS systems, this wildcard is the %character.These wildcards follow the host platform's usage rules. On Windows, $ZSEARCH performsa case-independent search, then returns the actual case of the located file or directory. Forexample, “j*” can match “JOURNAL”, “journal”, or “Journal”; the actual directory name is“Journal”, which is what is returned.On Windows and UNIX systems you can also use the following standard pathname symbols:a single dot (.) to specify the current directory, or a double dot (..) to specify its parent directory.These symbols can be used in combination with wildcard characters.Caché ObjectScript Reference 557