Split path name

Command group Flag affected Reversible Execute on client Platform(s)
External commands YES NO NO Windows,Linux

Syntax

Split path name (pathdrive-namedirectory-namefile-namefile-extensionReturns err-code

Description

Note: The flag is set according to whether Omnis was able to make a call to this external command.

This command splits a full path name into its component parts: the drive name, directory and file name, and file extension. It returns an error code (See Error Codes), or zero if no error occurs. The following examples show how Split path name operates.

Windows

Path Drive Directory Filename Extension
C:\TESTDIR\TESTSDIR\TESTFILE C: \TESTDIR\TESTSDIR\ TESTFILE
C:\TESTDIR\TESTFILE.EXT C: \TESTDIR\ TESTFILE .EXT
C:\TESTFILE C: \ TESTFILE

Linux

Path Drive Directory Filename Extension
/TESTDIR/TESTSDIR/TESTFILE /TESTDIR/TESTSDIR/ TESTFILE
/TESTDIR/TESTFILE.EXT /TESTDIR TESTFILE .EXT
/TESTFILE / TESTFILE

Example

; split the path name lPathname
Calculate lPathname as 'c:\desktop\myfolder\mylibrary.lbs' ;; Windows example using ‘\’
Split path name (lPathname,lDrive,lDirectory,lFileName,lExtension)
; lDrive= 'c:'
; lDirectory = '\desktop\myfolder\'
; lFileName = 'mylibrary'
; lExtension ='.lbs'