# Function Reference

# _WinAPI_PathFindNextComponent

Parses a path and returns the portion of that path that follows the first backslash

#include <WinAPIShPath.au3>
_WinAPI_PathFindNextComponent ( $sFilePath )

## Parameters

$sFilePath | The path to parse. Path components are delimited by backslashes. For instance, the path "c:\path1\path2\file.txt" has four components: c:, path1, path2, and file.txt.

## Return Value

Success: | The truncated path.
Failure: | Empty string and sets the @error flag to non-zero.

## Remarks

This function walks a path string until it encounters a backslash ("\"), ignores everything up to that point
including the backslash, and returns the rest of the path. Therefore, if a path begins with a backslash (such as \path1\path2),
the function simply removes the initial backslash and returns the rest (path1\path2).

## See Also

Search PathFindNextComponent in MSDN Library.

## Example

    #include <WinAPIShPath.au3>

    Local $sPath = @ScriptFullPath

    While $sPath
        ConsoleWrite($sPath & @CRLF)
        $sPath = _WinAPI_PathFindNextComponent($sPath)
    WEnd
    $sPath = _WinAPI_PathFindNextComponent("")
    ConsoleWrite('Path = "' & $sPath & '" -> @error = ' & @error & @CRLF)