PathRemoveExtension function

Removes the file name extension from a path, if one is present.

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

Syntax


void PathRemoveExtension(
  _Inout_  LPTSTR pszPath
);

Parameters

pszPath [in, out]

Type: LPTSTR

A pointer to a null-terminated string of length MAX_PATH from which to remove the extension.

Return value

This function does not return a value.

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 extension.
cout << "The path with extension is          : " << lpStr1 << endl;

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

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

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

The path without extension is       : C:\TEST\sample

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

PathRemoveExtensionW (Unicode) and PathRemoveExtensionA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft