Initializing help system before first use

fixdst

Purpose
Construct or validate a destination file name.
Synopsis
function fixdst(src:string, dst:string, extn:string):string
Arguments
src 
Path to the source file.
dst 
Path to the destination file (can be a directory).
extn 
Expected extension for the destination file name.
Return value
Updated destination file name.
Example 
 ! Replace the file extension in a given file name
 dst:=fixdst("toto.mos",".",".bim")
 writeln(dst)                                  ! Output: ./toto.bim

 ! Replace file extension and basename
 dst:=fixdst("toto.mos","tutu",".bim")
 writeln(dst)                                  ! Output: tutu.bim

 ! Add extension and generate full path
 dst:=fixdst("toto", "there/", ".bim")
 writeln(dst)                                  ! Output: there/toto.bim
Further information
1. This function serves to construct filenames of a specific format. It just operates on filenames, without trying to access any files.
2. If the destination file name is empty or is a directory, the full path is generated by replacing the extension of the source file name by the provided extension. This extension is also appended to the destination file name if it is missing.

Parent Topic Subroutines

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.