Export (0) Print
Expand All

PathRemoveFileSpec function

Removes the trailing file name and backslash from a path, if they are present.

Note  This function is deprecated. We recommend the use of the PathCchRemoveFileSpec function in its place.

Syntax


BOOL PathRemoveFileSpec(
  _Inout_  LPTSTR pszPath
);

Parameters

pszPath [in, out]

Type: LPTSTR

A pointer to a null-terminated string of length MAX_PATH that contains the path from which to remove the file name.

Return value

Type: BOOL

Returns nonzero if something was removed, or zero otherwise.

Examples


#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"

void main( void )
{
// Path to include file spec.
char buffer_1[ ] = "C:\\TEST\\sample.txt"; 
char *lpStr1;
lpStr1 = buffer_1;

// Print the path with the file spec.
cout << "The path with file spec is          : " << lpStr1 << endl;

// Call to "PathRemoveFileSpec".
PathRemoveFileSpec(lpStr1);

// Print the path without the file spec.
cout << "\nThe path without file spec is       : " << lpStr1 << endl;
}

OUTPUT:
==================
The path with file spec is          : C:\TEST\sample.txt

The path without file spec is       : C:\TEST

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 4.71 or later)

Unicode and ANSI names

PathRemoveFileSpecW (Unicode) and PathRemoveFileSpecA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft