Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsSee Also• $ORDER function• $ZNEXT function• $ZREFERENCE special variable$ZSEARCHReturns the full file specification, pathname and filename, of a specified file.$ZSEARCH(target)$ZSE(target)ParametertargetA filename, a pathname, or a null string. May contain one or more * or ?wildcard characters.Description$ZSEARCH returns the full file specification (pathname and filename) of a specified targetfile. The file name may contain wild cards so that $ZSEARCH can return a series of fullyqualified pathnames that satisfy the wild carding.If the target parameter does not specify a pathname, $ZSEARCH searches the currentworking directory. $ZSEARCH applies the rules in its matching process in the followingorder:1. $ZSEARCH scans the target to see if it is surrounded with percent characters (%). If$ZSEARCH finds such text, it treats the string as an environment variable. $ZSEARCHperforms name translation on the string.2. $ZSEARCH scans the string that results from the previous step to find the final slashcharacter. If $ZSEARCH finds a final slash, it uses the string up to, but not including,the final slash as the path or directory to be searched. If $ZSEARCH does not find afinal slash, it searches the current working directory, which is determined by the currentnamespace.3. If $ZSEARCH found a final slash in the previous step, it uses the portion of the targetstring following the final slash as the file name search pattern. If $ZSEARCH did not556 Caché ObjectScript Reference