unixshellstring(
unixshellstring(
TEXT
)

The unixshellstring( function encodes text for use as a parameter to a unix shell command.

Parameters

This function has one parameter:

text – text to be encoded.

Description

This function encodes text for use as a parameter to a unix shell command. Any special characters in the text are “escaped” by putting a backslash () in front of the special character.

    unixshellstring("Panorama's $Shell /Test Strin#g!?")
        ☞ Panorama\'s\ \$Shell\ /Test\ Strin\#g\!\?

Note: This function has special treatment for the tilde (~) character. If the tilde is the first character of the text, it is not escaped. A tilde in another other position is escaped.

See Also

- applescriptconstant( -- converts an expression into an AppleScript literal.
- applescriptstring( -- converts text into an AppleScript string literal.
- arraytopythonlist( -- converts a Panorama array into a Python list.
- hideotherapplications -- hides all other applications, leaving only Panorama visible.
- jsonscriptstring( -- converts text into a JSON string literal
- loadcustomfunctions -- reloads all ProVUE defined custom functions.
- openanything -- opens a document or application.
- openurl -- opens a URL (usually a web page or to create an e-mail message).
- openurlinbackground -- opens a URL (usually a web page or to create an e-mail message) without bringing forward the app that handles the URL (in other words, Panorama remains the frontmost application).
- openwith -- opens a document with a specific application.
- openwithterminal -- opens an application in a new Terminal.app window (useful for debugging).
- perlconstant( -- encodes text for use as a constant in a Perl program.
- perlscriptstring( -- converts text into a Perl string literal.
- phpconstant( -- encodes text for use as a contant in a php program.
- posixpath( -- converts a path and filename into a POSIX path that can be used as a parameter to a shell command.
- pythonconstant( -- encodes text for use as a constant in a python program.
- registercustomfunction -- defines a new custom function.
- revealinfinder -- reveals a file or folder in the Finder.
- revealmultipleinfinder -- reveals one or more files or folders in the Finder.
- rubyconstant( -- encodes a value for use as a constant in a Ruby program.
- runningappinfo( -- returns information about applications that are currently running on this computer.
- Scripting Panorama X with AppleScript -- embedding Panorama code into AppleScript (allowing Panorama to be controlled from other programs).
- setappleeventvalue -- may be used in a procedure that responds to an AppleEvent (this includes AppleScript programs), the statement specifies the value to be returned by the event.
- unixshellpath( -- converts a path and filename into a POSIX path that can be embedded within the shellscript statement.

History

Version | Status | Notes
10.2 | Updated | This function doesn't escape the ~ symbol if it is the first character in the string.
10.0 | No Change | Carried over from Panorama 6.0.