Technical References - [listpath]

Breaks a path into separate foldernames and a filename.

numero = 263
interpreted = N
texte = [listpath Path]Path Tags[/listpath] To display a list of all the separate folder names in a path (text separated by "/"), use a [listpath] context. You may optionally specify that only the filename will be displayed (subtracting any path leading to it), or only the folder names (subtracting the filename from the end). ListPath is only used for text-manipulation -- it does not actually look at your hard disk. If you want to find all the files in a folder on your hard disk, use [listfiles] instead. Example:
[listpath path=/folder1/folder2/folder3/filename.txt]Path part #[index]: [name]
[/listpath]
The example above yields: Path part #1: folder1 Path part #2: folder2 Path part #3: folder3 Path part #4: filename.txt
[listpath path=/folder1/folder2/folder3/filename.txt&FileOnly=T]Path part #[index]: [name]
[/listpath]
The example above yields: Path part #1: filename.txt
[listpath path=/folder1/folder2/folder3/filename.txt&PathOnly=T]Path part #[index]: [name]
[/listpath]
The example above yields: Path part #1: folder1 Path part #2: folder2 Path part #3: folder3 The following parameters are used in the [listpath] context:
ParameterDescription
path(Required) Path text to break apart.
FileOnly(Optional) Set to "T" if you only want to display the filename at the end of the path.
PathOnly(Optional) Set to "T" if you want to display only the folder names, but not the filename at the end of the path.
The following tags are available inside a [listpath] context:
TagDescription
 [index]A number from 1 to the total number of names in the path text indicating the item's index position in the list.
[name]Text of the path piece currently being displayed. This can either be a folder name or a filename, depending on the placement of the text in the path (the text after the last "/" is considered to be the filename).
[filename]Text of the filename, leaving off the folder names leading to it.
[break]From version 8.1, if the [listpath] context sees the [break] tag while executing a loop, it will stop looping, once it finishes the current loop. Thus the [break] tag should only appear in a [showif] statement that is evaluated at the end (bottom) of the loop.
[listpath Path]Path Tags[/listpath]

To display a list of all the separate folder names in a path (text separated by "/"), use a [listpath] context. You may optionally specify that only the filename will be displayed (subtracting any path leading to it), or only the folder names (subtracting the filename from the end).

ListPath is only used for text-manipulation -- it does not actually look at your hard disk. If you want to find all the files in a folder on your hard disk, use [listfiles] instead.

Example:

[listpath path=/folder1/folder2/folder3/filename.txt]
Path part #[index]: [name]

[/listpath]

The example above yields:

Path part #1: folder1
Path part #2: folder2
Path part #3: folder3
Path part #4: filename.txt

[listpath path=/folder1/folder2/folder3/filename.txt&FileOnly=T]
Path part #[index]: [name]

[/listpath]

The example above yields:

Path part #1: filename.txt
[listpath path=/folder1/folder2/folder3/filename.txt&PathOnly=T]
Path part #[index]: [name]

[/listpath]

The example above yields:

Path part #1: folder1
Path part #2: folder2
Path part #3: folder3

The following parameters are used in the [listpath] context:
ParameterDescription
path(Required) Path text to break apart.
FileOnly(Optional) Set to "T" if you only want to display the filename at the end of the path.
PathOnly(Optional) Set to "T" if you want to display only the folder names, but not the filename at the end of the path.


The following tags are available inside a [listpath] context:
TagDescription
 [index]A number from 1 to the total number of names in the path text indicating the item's index position in the list.
[name]Text of the path piece currently being displayed. This can either be a folder name or a filename, depending on the placement of the text in the path (the text after the last "/" is considered to be the filename).
[filename]Text of the filename, leaving off the folder names leading to it.
[break]From version 8.1, if the [listpath] context sees the [break] tag while executing a loop, it will stop looping, once it finishes the current loop. Thus the [break] tag should only appear in a [showif] statement that is evaluated at the end (bottom) of the loop.

DOWNLOAD WEBDNA NOW!

Top Articles:

Tips and Tricks

A list of user-submitted tips ...

WebDNA Modules

A list of the currently available modules...

Download WebDNA Applications

WebDNA applications...

F.A.Q

A compilation of some user's questions...

WebDNA Libraries

A list of available libraries for WebDNA...

Technical Change History

This Technical Change History provides a reverse chronological list of WebDNA changes...

Related Readings:

[listfields]

Lists all the fields in the specified database...

[shownext]

[shownext] is a special context used to create links (or more accurately...

[getchars]

Extracts a portion of the text (also known as substring or Mid$)...

[sendmail]

There is hardly a website that doesn't at some point need to send an email...

[protect]

...

[function]

This context enables the WebDNA programmer to call a previously defined block of WebDNA code...