Home » Pinescript Syntax » Understanding Line Wrapping in Pine Script

Understanding Line Wrapping in Pine Script

Photo of author
Published on

Line wrapping in Pine Script is a useful technique to enhance the readability of your code by splitting long lines of code across multiple lines. This practice is particularly beneficial in complex scripts where maintaining readability can significantly impact the ease of maintenance and understanding of the code. In this guide, we delve into the essentials of line wrapping in Pine Script and provide examples to demonstrate how it can be applied effectively.

Basics of Line Wrapping

In Pine Script, a line can be extended, or “wrapped,” onto subsequent lines to avoid excessively long single lines of code. The key to effective line wrapping is the indentation rule: wrapped lines must be indented with any number of spaces, as long as it’s not a multiple of four. This is because multiples of four spaces are reserved for indenting local blocks.

Simple Variable Assignment Example

Consider a variable assignment that sums up open, high, low, and close prices:

a = open + high + low + close

This can be wrapped for better readability as follows:

a = open +
      high +
          low +

Long Function Call Example

For a complex plot() function call:

plot(ta.correlation(src, ovr, length), color = color.new(color.purple, 40), style = plot.style_area, trackprice = true)

Wrapping can make it clearer:

plot(ta.correlation(src, ovr, length),
   color = color.new(color.purple, 40),
   style = plot.style_area,
   trackprice = true)

User-Defined Functions and Wrapping

User-defined functions in Pine Script can also benefit from line wrapping, especially when dealing with multiple conditions or complex logic. The indentation rule applies here as well, with the requirement that the continuation of a statement must start with an indentation greater than four spaces to avoid confusion with block indentation.

updown(s) =>
    isEqual = s == s[1]
    isGrowing = s > s[1]
    ud = isEqual ?
           0 :
           isGrowing ?
               (nz(ud[1]) <= 0 ?
                     1 :
                   nz(ud[1])+1) :
               (nz(ud[1]) >= 0 ?
                   -1 :

Incorporating Comments in Wrapped Lines

Comments can be seamlessly integrated into wrapped lines, allowing for explanations or notes right next to the relevant code, without breaking the wrapping pattern:

c = open > close ? color.red :
  high > high[1] ? color.lime : // A comment
  low < low[1] ? color.blue : color.black

Key Takeaways

  • Line wrapping enhances readability by allowing long lines of code to be split across multiple lines.
  • Indentation rules are crucial; wrapped lines must not be indented with multiples of four spaces to differentiate from local block indentation.
  • Function calls and user-defined functions can greatly benefit from wrapping for clarity, especially when dealing with complex logic.
  • Comments can be included in wrapped lines, providing context or explanations without compromising the structure.

Adopting line wrapping in your Pine Script coding practices not only makes your code more readable but also facilitates easier debugging and maintenance. By following the guidelines provided, you can ensure that your scripts are both functional and accessible to others or your future self.

Leave a Comment