Help Center

AfxPathAppendfunction

Appends one path to the end of another.

String ManagementfunctionAfxPath.incdocumented

Syntax

FUNCTION AfxPathAppend (BYREF wszPath AS CONST WSTRING, BYREF wszMore AS CONST WSTRING) AS DWSTRING

Parameters

NameDescription
wszPathA string that represents a path.
wszMoreA string that contains the path to be appended.

Return value

The changed path.

Description

Appends one path to the end of another.

Remarks

This function automatically inserts a backslash between the two strings, if one is not already present.

The path supplied in wszPath cannot begin with "..\\" or ".\\" to produce a relative path string. If present, those periods are stripped from the output string. For example, appending "path3" to "..\\path1\\path2" results in an output of "\\path1\\path2\\path3" rather than "..\\path1\\path2\\path3".

Example

DIM dws AS DWSTRING = AfxPathAppend("name_1\name_2", "name_3")

Reference

  • Include file AfxPath.inc
  • Defined in AfxNova/AfxPath.inc:156
  • Documented in String Management/Path and Url Procedures.md
  • Topic: Path and Url procedures