Difference: 0LASubrFileSplitFilename (1 vs. 2)

Revision 22012-01-25 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.FILE SPLIT FILENAME

Changed:
<
<		This subroutine is called to break down a filename into it's name and extension parts.
>
>		This subroutine is called to separate a filename into it's name and extension parts.
 

Usage:

Line: 15 to 15
 

Description:

Changed:
<
<		This subroutine must be passed three fields. One to return file name part, one to return the file extension part, and one with the full filename to break apart.
>
>		This subroutine is called to separate a filename into it's name and extension parts. All parameters are required, if any are missing the subroutine will CANCEL.
 
Changed:
<
<		<filename_part> identifies the field to return the filename part. Passing this parameter is required.
>
>		<filename_part> will contain the filename part (Required). This must be PASSed with Share "Y".
 
Changed:
<
<		<extension_part> identifies the field to return the file extension part. Passing this parameter is required.
>
>		<extension_part> will contain the file extension part (Required). This must be PASSed with Share "Y".
 
Changed:
<
<		<full_filename> identifies the field that identifies the full filename to break apart. Passing this parameter is required.
>
>		<full_filename> is the full filename to separate (Required).
 
Changed:
<
<		This subroutine sets a result value in the corresponding results Token field.
>
>		The subroutine identifies the <extention_part> by locating all the characters after the last period in <full_filename>. If there are no periods in <full_filename>, then <full_filename> will be returned in <extension_part> and <filename_part> will be empty (the entire name is considered the extension). If <full_filename> contains a leading path, that will also be returned in <filename_part>. See .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.

Revision 12011-08-12 - PeteBrower

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.FILE SPLIT FILENAME

This subroutine is called to break down a filename into it's name and extension parts.


Usage: 

    PASS        <filename_part>           FIELD           SHARE? Y
    PASS        <etension_part>           FIELD           SHARE? Y
    PASS        <full_filename>           FIELD           SHARE? N
    GOSUB   --- .FILE SPLIT FILENAME
     *       check for errors
    IF      --- .FILE SPLIT FILENAME      NE

Description:

This subroutine must be passed three fields. One to return file name part, one to return the file extension part, and one with the full filename to break apart.

<filename_part> identifies the field to return the filename part. Passing this parameter is required.

<extension_part> identifies the field to return the file extension part. Passing this parameter is required.

<full_filename> identifies the field that identifies the full filename to break apart. Passing this parameter is required.

This subroutine sets a result value in the corresponding results Token field.

Comments:

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


<--/commentPlugin-->

-- PeteBrower - 2011-08-12

View topic | History: r7 < r6 < r5 < r4 | More topic actions...
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback