0LASubrFileSplitPathname < Main

Tags: view all tags
---+ .FILE SPLIT PATHNAME

_This subroutine is called to separate a full pathname into its path and name parts._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;path_part&gt;                FIELD            SHARE? Y
      PASS         &lt;file_part&gt;                FIELD            SHARE? Y
      PASS         &lt;full_pathname&gt;            FIELD            SHARE? N
      GOSUB    --- .FILE SPLIT PATHNAME
      *        check for errors
      IF       --- .FILE SPLIT PATHNAME       NE

</pre>
---++ Description:

This subroutine is called to separate a full pathname into it's path and file name parts. All parameters are required, if any are missing the subroutine will CANCEL.

&lt;path_part&gt; will contain the path portion of the full file and path name, including the trailing slash (/ or \). (Required). This must be PASSed with Share "Y".

&lt;file_part&gt; will contain the file name portion of the full file and path name (Required). This must be PASSed with Share "Y".

&lt;full_pathname&gt; is the full path and file name to separate (Required).

The subroutine identifies the &lt;file_part&gt; by locating all the characters after the last / or \ in &lt;full_filename&gt;. If there aren't any in &lt;full_pathname&gt;, then &lt;full_pathname&gt; will be returned in &lt;file_part&gt; and &lt;path_part&gt; will be empty. See [[0LASubrFileSplitFilename][.FILE SPLIT FILENAME]] to split a file name and extension. Note that results may not be accurate if &lt;full_pathname&gt; contains both \ and / (ie, a Linux path that includes \ to escape characters). A Linux path like "/usr/local/\$money" will correctly return "$money", but a path like "/usr/local/\$mon\*ey" will only return "*ey".

A 'Data was truncated' error will be returned in .FILE SPLIT PATHNAME if the fields you pass are too short to contain either the file name or path.
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.PeteBrower - 2011-08-12
Topic revision: r7 - 2021-05-07 - MisaghKarimi