addpath (MathScript RT Module Function)

LabVIEW 2012 MathScript RT Module Help

Edition Date: June 2012

Part Number: 373123C-01

»View Product Info
Download Help (Windows Only)

Owning Class: support

Requires: MathScript RT Module

Syntax

addpath(dir1)

addpath(dir1, dir2, ...)

addpath(dir1, dir2, ..., flag)

p = addpath(dir1)

p = addpath(dir1, dir2, ...)

p = addpath(dir1, dir2, ..., flag)

Description

Adds directories to the search path list. You can specify an unlimited number of directories to add.

Details

Examples

Inputs

Name Description
dir1 Specifies a directory you want to add. dir1 is a string.
dir2 Specifies a directory you want to add. dir2 is a string.
flag Specifies whether to add the directories to the beginning or end of the search path list. flag is a string that accepts the following values.

'-begin' (default) LabVIEW adds the directories to the beginning of the search path list.
'-end' LabVIEW adds the directories to the end of the search path list.

Outputs

Name Description
p Returns the list of all current search paths.

Details

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.

If you call this function from a MathScript Node or a user-defined function, a warning glyph appears in the MathScript Node next to the line from which you call the function. The warning glyph indicates that LabVIEW operates with reduced error checking and slower run-time performance for the MathScript Node. To improve the error checking and optimize the performance of the MathScript Node, remove this function from scripts and user-defined functions. Also, do not change the MathScript search path list at run time. Instead, use the MathScript page to configure the default search path list for MathScript Nodes in the main application instance.

The following table lists the support characteristics of this function.

Causes reduced performance (warning glyph) Yes
Supported in the LabVIEW Run-Time Engine No
Supported on RT targets No

Examples

addpath('C:\Program Files\National Instruments')

Related Topics

path
pathdefault
pathremove

WAS THIS ARTICLE HELPFUL?

Not Helpful