0LASubrFileSplitFilename < Main

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

_This subroutine is called to separate a filename into it's name and extension parts._

<br />%TOC%
---++ Usage:
<pre><verbatim>      PASS         <filename_part>            FIELD            SHARE? Y
      PASS         <extension_part>           FIELD            SHARE? Y
      PASS         <full_filename>            FIELD            SHARE? N
      GOSUB    --- .FILE SPLIT FILENAME
      *        check for errors
      IF       --- .FILE SPLIT FILENAME      NE</verbatim>
</pre>
---++ Description:

This subroutine is called to separate a filename into its name and extension parts. All parameters are required, if any are missing the subroutine will CANCEL.

&lt;filename_part&gt; will contain the filename part (Required). This must be PASSed with Share "Y".

&lt;extension_part&gt; will contain the file extension part, including its leading period (Required). This must be PASSed with Share "Y".

&lt;full_filename&gt; is the full filename to separate (Required).

The subroutine identifies the &lt;extension_part&gt; by locating all the characters after the last period in &lt;full_filename&gt;. If there are no periods in &lt;full_filename&gt;, then &lt;full_filename&gt; will be returned in &lt;extension_part&gt; and &lt;filename_part&gt; will be empty (the entire name is considered the extension). If &lt;full_filename&gt; contains a leading path, that will also be returned in &lt;filename_part&gt;. See [[0LASubrFileSplitPathname][.FILE SPLIT PATHNAME]] to split the pathname from the base file name.

A 'Data was truncated' error will be returned in .FILE SPLIT FILENAME if the fields you pass are too short to contain either the file name or file extension.
---++ 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