Tag Archives: HB_FNameMerge()

File Name Manipulation

Posted on by vivaclipper

File Name Manipulation Functions

HB_FNameDir Extract Folder name from file specification
HB_FNameName Extract File name from file specification
HB_FNameNameExt Extract File name and extention from file specification
HB_FNameExt Extract File extention from full file specification
HB_FNameExtSet Returns changed file extension from file specification
HB_FNameMerge Composes a full file specification from individual components
HB_FNameSplit Extract folder, file, extension from full file specification

HB_FNameNameExt

Posted on by vivaclipper

HB_FNameNameExt

Extracts file name and extension portion of a file specification

Syntax

      HB_FNameNameExt( <cFileSpec>  --> <cFileNameExt>

Arguments

<cFileSpec> : a character string to extract file name and extension

Returns

<cFileNameExt> : file name and extension portion of <cFileSpec>

Note

<cFileSpec> may or may not include an ordinary file name at end. Function returns simply last element of <cFileSpec>

Description

This function is used to extract file name and extension portion of a file specification string. <cFileSpec> doesn’t require include an existing file / path info.

This info can be optained by :

        cFName := ''
        cFNExt := ''
        HB_FNameSplit( cFileSpec, , @cFName, @cFNExt )
        ? cFName + cFNExt
      OR
        ? SUBSTR( cFileSpec, RAT( "\", cFileSpec ) +1 )

Example

      ? HB_FNameNameExt( "c:\temp\NewDirDB" )          // NewDirDB
      ? HB_FNameNameExt( "c:\temp\NewDirDB\test.bat" ) // test

Seealso

HB_FNameDir(), HB_FNameName(), HB_FNameExt(), HB_FNameExtSetDef(), HB_FNameMerge(), HB_FNameSplit()

HB_FNameName

Posted on by vivaclipper

HB_FNameName

Extracts file name portion of a file specification

Syntax

      HB_FNameName( <cFileSpec>  --> <cFileName>

Arguments

<cFileSpec> : a character string to extract file name

Returns

<cFileName> : file name ( without extension ) portion of <cFileSpec>

Note

<cFileSpec> may or may not include an ordinary file name at end. Function returns simply last element of <cFileSpec>

Description

This function is used to extract only file name from a qualified file specification string <cFileSpec> doesn’t require include an existing file / path info. This info can be optained by :

        cFName  := ''
        HB_FNameSplit( cFileSpec, , @cFName )
          ? cFName
      OR
        cNamExt := SUBSTR( cFileSpec, RAT( "\", cFileSpec ) + 1 )
         ? IF( "." $ cNamExt, LEFT( cNamExt,  RAT( ".", cNamExt ) -1 ), cNamExt )

Example

      ? HB_FNameName( "c:\temp\NewDirDB" )          // NewDirDB
      ? HB_FNameName( "c:\temp\NewDirDB\test.bat" ) // test

Seealso

HB_FNameDir(), HB_FNameNameExt(), HB_FNameExt(), HB_FNameExtSetDef(), HB_FNameMerge(), HB_FNameSplit()

<

HB_FNameDir

Posted on by vivaclipper

HB_FNameDir

Extracts path portion of a file specification string

Syntax

      HB_FNameDir( <cFileSpec>  --> <cFilePath>

Arguments

<cFileSpec> : a character string to extract file path

Returns

<cFilePath> : path portion of <cFileSpec>

Note

<cFileSpec> may or may not include an ordinary file name at end. Function returns simply <cFileSpec> except last element <cFilePath> always include trailing OS path separator ( “\” )

Description

This function is used to extract path / dir portion of a full qualified file specification string. <cFileSpec> doesn’t require include an existing file / path info. This info can be optained by :

         HB_FNameSplit( cFileSpec, @cPath )
       OR
          ? IF( "\" $ cFileSpec, LEFT( cFileSpec, RAT( "\", cFileSpec ), 
               cFileSpec

Example

      ? HB_FNameDir( "c:\temp\NewDirDB" )          // c:\temp\
      ? HB_FNameDir( "c:\temp\NewDirDB\test.bat" ) // c:\temp\NewDirDB\

Seealso

HB_FNameName(), HB_FNameNameExt(), HB_FNameExt(), HB_FNameExtSetDef(), HB_FNameMerge(), HB_FNameSplit()

HB_FNameSplit

Posted on by vivaclipper

HB_FNameSplit()

Splits a full file specification into individual components.

Syntax

      HB_FNameSplit( <cString>      , ;
                     [@<cPath>]     , ;
                     [@<cFileName>] , ;
                     [@<cExtension>]  ) --> NIL

Arguments

<cString> : a character string to split into different components of a file name.

@<cPath> : If specified, <cPath> must be passed by reference. It receives the path component for a file as a character string.

@<cFileName> : If specified, <cFileName> must be passed by reference. It receives the name component for a file as a character string.

@<cExtension> : If specified, <cExtension> must be passed by reference. It receives the file extension as a character string.

Return

This function returns always NIL. The components of a file name are assigned to the parameters passed by reference.

Description

HB_FNameSplit() is used to split a full qualified file name into individual components. They can be merged later with function HB_FNameMerge().

Seealso

CurDir(), CurDrive(), Directory(), File(), HB_FNameMerge()