CompleteDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / String functions

Spaces
CompleteDir and UNICODE

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CompleteDir (Function)

In french: ComplèteRep

Adds a directory separator ("\" or "/" according to the runtime platform) to the end of a string, if necessary.

This function is useful for building full file names when the path format is unknown (e.g., if the user types a file path).

It is also possible to construct file paths directly with the / (slash) operator between components: the path will be automatically built dynamically with the expected format. Example:

Disque is string = "c:"
Répertoire is string = "Mes documents"
NomFichier is string = "SortieDeStock.xlsx"
CheminComplet is string
// La lisibilité du code est accrue
CheminComplet = Disque / Répertoire / NomFichier

Example

Res = CompleteDir(CheminFichier) + "Document.Doc"
Res = CompleteDir("c:\temp")           // Renvoie "c:\temp\"
Res = CompleteDir("c:\temp\")          // Renvoie "c:\temp\"
Res = CompleteDir("\CCS\\Rep2\user\")  // Renvoie "\CCS\\Rep2\user\"
Res = CompleteDir("")                  // Renvoie ""

Res = CompleteDir(" /root/file ")      // Renvoie "/root/file/"
Res = CompleteDir("")                  // Renvoie ""

Syntax

<Result> = CompleteDir(<String to check>)

<Result>: Character string

String that ends in a directory separator.
Empty string if <String to check> corresponds to an empty string ("").

<String to check>: Character string

String to check and complete, if necessary. This character string is not modified.

Remarks

Spaces

Caution: The leading and trailing spaces in <String to check> are removed (identical to NoSpace).

CompleteDir and UNICODE

If the string passed as a parameter is an ANSI string, the result will be an ANSI string.

If the string passed as a parameter is a UNICODE string, the result will be a UNICODE string.

Remark: If the result of CompleteDir on an ANSI string is assigned to a UNICODE string (and vice versa), the conversion will be implicitly performed.

For more details, see Managing UNICODE.

Related Examples:

Unit examples (WINDEV): Handling text files

[ + ] Handling "text" files with WINDEV:
- Create a text file
- Write into a text file
- Read in a text file

Unit examples (WEBDEV): Handling text files

[ + ] This example explains how to handle "non HFSQL" files with WEBDEV and it allows you to:
- Create a text file
- Write into a text file
- Read in a text file

Unit examples (WINDEV Mobile): Handling text files

[ + ] Handling external "text" files:
- Create a text file
- Write into a text file
- Read in a text file

Component: wd300vm.dll