path (MathScript RT Module Function)

Owning Class: support

Requires: MathScript RT Module

Syntax

path(a)

path(a, b)

path(a, path)

path(path, b)

c = path

Description

Returns the current search path list. LabVIEW searches the path list from top to bottom. If you define a function to use in the LabVIEW MathScript Window or in the MathScript Node, you must add the directory in which that function resides to the search path list.

path(a) changes the current path to a. path(a, b) changes the current path to the concatenation of the two input paths. path(a, path) adds a to the beginning of the search path list. path(path, b) adds b to the end of the search path list.

Details

Examples

Inputs

Name	Description
a	Specifies a path. a is a string.
path	Specifies the existing path list.
b	Specifies a path. b is a string.

Outputs

Name	Description
c	Returns the list of all current paths. c is a string.

Details

If you use this function in a stand-alone application or shared library, LabVIEW returns the path where you installed the application or shared library. (Real-Time Module) If you deploy this function to an RT target, LabVIEW returns the path given by the Default Data Directory VI.

Changes you make to the search path list using this function apply only to the current instance of the LabVIEW MathScript Window or the MathScript Node from which you call the function. Changes to the search path list for one MathScript Node do not apply to any other MathScript Nodes. LabVIEW resets the search path list to the default when you close the LabVIEW MathScript Window or when the MathScript Node stops executing. Use the MathScript: Search Paths page of the LabVIEW MathScript Properties dialog box to change the default search path list for the LabVIEW MathScript Window. Use the MathScript page of the Options dialog box to change the default search path list for MathScript Nodes in the main application instance.

This function is not supported in the LabVIEW Run-Time Engine if you specify an input for the function. Either do not specify an input or remove these functions from your scripts before you build a stand-alone application or shared library.

The following table lists the support characteristics of this function.

Causes reduced performance ()	Yes (if you supply input)
Supported in the LabVIEW Run-Time Engine	Other
Supported on RT targets	No

Examples

path(path,'C:\Program Files\National Instruments')

%Make sure the folder test's subfolder exists in the test folder on the C drive
path('C:\test\test''s subfolder', path)

Related Topics

addpath
path
pathdefault
pathremove