Leaning toothpick syndrome

In computer programming, leaning toothpick syndrome (LTS) is the situation in which a quoted expression becomes unreadable because it contains a large number of escape characters, usually backslashes ("\"), to avoid delimiter collision.[1][2]

The official Perl documentation[3] introduced the term to wider usage; there, the phrase is used to describe regular expressions that match Unix-style paths in which the elements are separated by slashes /. The slash is also used as the default regular expression delimiter which must be escaped with a backslash, \, leading to frequent escaped slashes represented as \/. If doubled, as in URLs, this yields \/\/ for an escaped //. A similar phenomenon occurs for DOS/Windows paths, where the backslash is used as a path separator, requiring a doubled backslash \\ – this can then be re-escaped for a regular expression inside an escaped string, requiring \\\\ to match a single backslash. In extreme cases, such as a regular expression in escaped string, matching a Uniform Naming Convention path (which begins \\) this requires 8 backslashes \\\\\\\\ due to 2 backslashes each being double-escaped.

LTS appears in many programming languages and in many situations, including in patterns that match Uniform Resource Identifiers (URIs) and in programs that output quoted text. Many quines fall into the latter category.

Pattern example

Consider the following Perl regular expression intended to match URIs which identify files under the pub directory of an FTP site:

  m/ftp:\/\/[^\/]*\/pub\//

Perl, like sed before it, solves this problem by allowing many other characters to be delimiters for a regular expression. For example, the following three examples are equivalent to the expression given above:

 m{ftp://[^/]*/pub/}
 m#ftp://[^/]*/pub/#
 m!ftp://[^/]*/pub/!

Quoted text example

A Perl program to print an HTML link tag, where the URL and link text are stored in variables $url and $text respectively, might look like this. Notice the use of backslashes to escape the quoted double-quote characters:

  print "<a href=\"$url\">$text</a>";

Using single quotes to delimit the string is not feasible, as Perl does not expand variables inside single-quoted strings. The code below, for example, would not work as intended.

print '<a href="$url">$text</a>'

Using the printf function is a viable solution in many languages (Perl, C, PHP):

printf('<a href="%s">%s</a>', $url, $text);

The qq operator in Perl allows for any delimiter:

 print qq{<a href="$url">$text</a>};
 print qq|<a href="$url">$text</a>|;
 print qq(<a href="$url">$text</a>);

Here documents are especially well suited for multi-line strings; however, here documents do not allow for proper indentation. This example shows the Perl syntax:

print <<HERE_IT_ENDS;
<a href="$url">$text</a>
HERE_IT_ENDS

Other languages

C#

The C# programming language handles LTS by the use of the '@' symbol at the start of string literals, before the initial quotation marks e.g.

 string filePath = @"C:\Foo\Bar.txt"

rather than otherwise requiring:

 string filePath = "C:\\Foo\\Bar.txt"

C++

The C++11 standard adds raw strings:

 std::string filePath = R"(C:\Foo\Bar.txt)";

If the string contains the characters )" an optional delimiter can be used, such as d in the following example:

 std::regex re{ R"d(s/"\([^"]*\)"/'\1'/g)d" };

Go

Go indicates that a string is raw by using the backtick as a delimiter:

s := `C:\Foo\Bar.txt`

Raw strings may contain any character except backticks; there is no escape code for a backtick in a raw string. Raw strings may also span multiple lines, as in this example where the strings s and t are equivalent:

s := `A string that
spans multiple
lines.`
t := "A string that\nspans multiple\nlines."

Python

Python has a similar construct using 'r':

  filePath = r"C:\Foo\Bar.txt"

One can also use them together with triple quotes:

  example = r"""First line : "C:\Foo\Bar.txt"
  Second line : nothing"""

Scala

Scala allows usage of triple quotes in order to prevent escaping confusion:

 val filePath = """C:\Foo\Bar.txt"""
 val pubPattern = """ftp://[^/]*/pub/"""r

The triple quotes also allow for multi line strings, as shown here:

 val text = """First line,
 second line."""

Sed

Sed regular expressions, particularly those using the "s" operator, are much similar to Perl (sed is a predecessor to Perl). The default delimiter is "/", but any delimiter can be used; the default is "s/regexp/replacement/", but "s:regexp:replacement:" is also a valid form. For example, to match a "pub" directory (as in the Perl example) and replace it with "foo", the default (escaping the slashes) is:

 s/ftp:\/\/[^\/]*\/pub\//foo/

Using an exclamation point ("!") as delimiter instead yields:

 s!ftp://[^/]*/pub/!foo!

See also

References

  1. Andy Lester,Richard Foley (2005). Pro Perl Debugging. Andy Lester,Richard Foley. p. 176. ISBN 1-59059-454-1.
  2. Daniel Goldman (February 2013). Definitive Guide to sed. EHDP Press. ISBN 978-1-939824-00-4.
  3. perlop - perldoc.perl.org
This article is issued from Wikipedia - version of the 11/27/2016. The text is available under the Creative Commons Attribution/Share Alike but additional terms may apply for the media files.