[TOC]

Từ khóa, ngữ pháp, thiết lập bản tóm tắt

Cấu trúc mã

Các cấu trúc chung của mã trong Pine:

<version>
<declaration_statement>
<code>

Phản hồi

FMZ hỗ trợ các ký hiệu chú thích ngôn ngữ Pine: một dòng chú thích//Các dòng chú thích/* */Ví dụ như cách viết chú thích trong ví dụ sau:

[macdLine, signalLine, histLine] = ta.macd(close, 12, 26, 9)  // 计算MACD指标

/*
plot函数在图表上画出指标线
*/
plot(macdLine, color = color.blue, title='macdLine')
plot(signalLine, color = color.orange, title='signalLine')
plot(histLine, color = color.red, title='histLine')

Phiên bản

Các hướng dẫn trình biên dịch dưới dạng sau đây cho phép trình biên dịch biết phiên bản nào của kịch bản được viết bằng Pine:

//@version=5

Mặc định là phiên bản v5, có thể bỏ qua trong mã//@version=5。

Lời tuyên bố

• indicator()
• strategy()

Các tuyên bố xác định loại kịch bản, điều này cũng quyết định nội dung nào được cho phép trong đó, và cách sử dụng và thực hiện. Thiết lập các thuộc tính quan trọng của kịch bản, chẳng hạn như tên của nó, nơi nó sẽ xuất hiện khi nó được thêm vào biểu đồ, độ chính xác và định dạng của các giá trị nó hiển thị, và kiểm soát một số giá trị hành vi của nó khi chạy, chẳng hạn như số lượng đối tượng vẽ tối đa mà nó sẽ hiển thị trên biểu đồ. Đối với các chính sách, thuộc tính bao gồm các tham số kiểm soát xem lại, chẳng hạn như vốn ban đầu, hoa hồng, điểm trượt, vv.indicator()Hoặcstrategy()Những lời tuyên bố.

Mã

Các dòng không phải là chú thích hoặc hướng dẫn trình biên dịch trong kịch bản là câu nói, nó thực hiện các thuật toán của kịch bản. Một câu nói có thể là một trong số đó.

• Tuyên bố biến
• Đặt lại giá trị của biến
• Tuyên bố hàm
• Gọi hàm tích hợp, gọi hàm được xác định bởi người dùng
• if，for，whileHoặcswitchcấu trúc tương tự

Câu nói có thể được sắp xếp theo nhiều cách

• Một số câu nói có thể được thể hiện bằng một dòng, chẳng hạn như hầu hết các tuyên bố biến, chỉ chứa một dòng gọi hàm hoặc một dòng tuyên bố hàm; những câu khác, như cấu trúc, luôn cần nhiều dòng vì chúng cần một khối địa phương.
• Các câu nói toàn cầu của kịch bản (tức là những phần không thuộc về các phần) không thể được sử dụng để viết một câu nói toàn cầu.空格Hoặc制表符(tab key) bắt đầu. Chữ ký tự đầu tiên của chúng cũng phải là ký tự đầu tiên của dòng. Các dòng bắt đầu ở vị trí đầu tiên của dòng, theo định nghĩa là một phần của phạm vi toàn cầu của kịch bản.
• Một cấu trúc hoặc một tuyên bố chức năng nhiều dòng luôn cần mộtlocal blockMột khối địa phương phải được thu hẹp thành một biểu mẫu hoặc bốn không gian (nếu không, nó sẽ được phân tích thành dòng mã chuỗi trước đó, nghĩa là được xác định là nội dung liên tục của dòng mã trước đó), và mỗi khối địa phương xác định một phạm vi địa phương khác.
• Nhiều câu đơn hàng có thể được nối liền trong một dòng bằng cách sử dụng dấu chấm (,) làm dấu phân cách.
• Một dòng có thể bao gồm chú thích hoặc chỉ là chú thích.
• Dòng cũng có thể được gói lại (tiếp tục trên nhiều dòng).

Ví dụ, bao gồm ba phần tử, một trong tuyên bố chức năng tùy chỉnh, hai trong tuyên bố biến sử dụng cấu trúc if, mã như sau:

indicator("", "", true)             // 声明语句(全局范围)，可以省略不写

barIsUp() =>                        // 函数声明(全局范围)
    close > open                    // 本地块(本地范围)

plotColor = if barIsUp()            // 变量声明 (全局范围)
    color.green                     // 本地块 (本地范围)
else
    color.red                       // 本地块 (本地范围)

runtime.log("color", color = plotColor)  // 调用一个内置函数输出日志 (全局范围)

Đổi mã

Dòng dài có thể được chia thành nhiều dòng, hoặc được "bọc" lên. Dòng được bọc phải thu hẹp vào bất kỳ số lượng không gian nào, miễn là nó không phải là số lần của 4 (các ranh giới này được sử dụng để thu hẹp các phần tử).

a = open + high + low + close

Có thể được đóng gói như sau (lưu ý rằng không có số lượng không gian co lại cho mỗi dòng là số lần của 4):

a = open +
      high +
          low +
             close

Một cuộc gọi dài có thể được đóng gói thành một cuộc gọi dài.

close1 = request.security(syminfo.tickerid, "D", close)      // syminfo.tickerid 当前交易对的日线级别收盘价数据系列
close2 = request.security(syminfo.tickerid, "240", close)    // syminfo.tickerid 当前交易对的240分钟级别收盘价数据系列
plot(ta.correlation(close, open, 100),                       // 一行长的plot()调用可以被包装
   color = color.new(color.purple, 40),
   style = plot.style_area,
   trackprice = true)

Một câu nói trong một tuyên bố chức năng được xác định bởi người dùng cũng có thể được đóng gói. Tuy nhiên, vì một phần tử địa phương phải bắt đầu bằng cách rút ngắn (tương đương 4 không gian hoặc 1 ký tự), khi chia nó sang dòng tiếp theo, phần tiếp theo của câu nói phải bắt đầu bằng nhiều hơn một lần rút ngắn (không bằng số lần của 4 không gian). Ví dụ:

test(c, o) =>
    ret = c > o ?
       (c > o+5000 ? 
          1 :
              0):
       (c < o-5000 ? 
          -1 : 
              0)

a = test(close, open)
plot(a, title="a")

Dòng thời gian

Không phải là một kiểu dữ liệu hoặc định dạng, chuỗi thời gian là một khái niệm cơ bản trong ngôn ngữ PINE. Nó được sử dụng để lưu trữ các giá trị liên tục thay đổi theo thời gian, mỗi giá trị tương ứng với một điểm thời gian. Các biến tích hợpopenVí dụ:openCác biến cố tích hợp ghi lại giá mở của mỗi dòng KBAR, nếuopenDữ liệu của 5 phút K-line cycle.openNhững gì được ghi lại trong biến là giá mở cửa của mỗi 5 phút K-line BAR (cột). Khi chương trình chính sách của bạn đang được thực hiện, tham chiếu trong mãopenĐó là giá mở cửa của dòng K BAR ở vị trí hiện tại. Để tham khảo giá trị trước trong chuỗi thời gian, chúng ta sử dụng giá trị quá khứ.[]Chế toán lịch sử, khi một chính sách được thực hiện trên một K-line BARopen[1]Có nghĩa là tham khảo giá mở đầu của một K-Line BAR trước đó của dòng K hiện tại.

Mặc dùDòng thời gianMột cấu trúc dữ liệu dễ dàng gợi nhớ đến "các mảng", mặc dù ngôn ngữ PINE cũng có loại mảng. Nhưng chúng là một khái niệm hoàn toàn khác với chuỗi thời gian.

Các chuỗi thời gian được thiết kế như vậy trong ngôn ngữ PINE có thể dễ dàng tính toán giá trị tổng hợp của giá đóng cửa trong mã chính sách mà không cần sử dụng cấu trúc vòng lặp như for, chỉ sử dụng các hàm tích hợp của ngôn ngữ PINE.ta.cum(close)Một ví dụ khác, chúng ta cần tính toán giá trị trung bình của giá trị tối đa và chênh lệch giá trị tối thiểu của 14 dòng K cuối cùng BAR (tức là 14 dòng K gần nhất đến thời điểm thực hiện mã) có thể được viết như sau:ta.sma(high - low, 14)

Kết quả của việc gọi hàm trên chuỗi thời gian cũng sẽ có dấu vết trên chuỗi thời gian, cũng có thể được sử dụng[]Các toán tử lịch sử đề cập đến các giá trị trước đó. Ví dụ, để kiểm tra giá đóng cửa của dòng K BAR hiện tại có vượt quá giá tối đa của giá cao nhất trong 10 dòng K BAR cuối cùng (không bao gồm dòng K BAR hiện tại)? Chúng ta có thể viết làbreach = close > ta.highest(close, 10)[1]Và cũng có thể viết như sau:breach = close > ta.highest(close[1], 10)Vì vậy.ta.highest(close, 10)[1]vàta.highest(close[1], 10)Có một số người nói rằng:

Bạn có thể xác minh bằng mã sau:

strategy("test pine", "test", true) 

a = ta.highest(close, 10)[1]
b = ta.highest(close[1], 10)

plotchar(true, title="a", char=str.tostring(a), location=location.abovebar, color=color.red)
plotchar(true, title="b", char=str.tostring(b), location=location.belowbar, color=color.green)

Mã kiểm tra trên sẽ xuất ra giá trị của a và b trên chuỗi thời gian tương ứng của chúng trên mỗi BAR, bạn có thể thấy giá trị của a và b luôn bằng nhau, vì vậy cả hai phương pháp biểu diễn đều tương đương.

Các tham số mẫu thư viện giao dịch ngôn ngữ Pine

Phương pháp xây dựng mô hình của chính sách PINE "Pine language transaction library"

Thiết lập giao dịch

• Cách thực hiện Mô hình giá đóng cửa: Mô hình chỉ được thực hiện sau khi BAR hiện tại kết thúc, thực hiện giao dịch khi BAR dưới bắt đầu. Mô hình giá thời gian thực: Mô hình được thực hiện mỗi khi giá thay đổi, có tín hiệu thực hiện giao dịch ngay lập tức.
• Số lượng giao dịch mặc định: Nếu lệnh giao dịch không chỉ định số lượng giao dịch, giao dịch sẽ được thực hiện theo số lượng đó.
• Số lượng đặt hàng tối đa một lần: Theo giao dịch thực tế, kết hợp với cài đặt tham số này, xác định số lượng đặt hàng tối đa mỗi lần, tránh tác động đến mặt bàn.
• Số điểm giá trượt:定价货币精度Các tham số và tham số này xác định giá trượt khi đặt hàng; ví dụ, đặt giá chính xác tiền tệ là 2 chính xác đến vị trí thứ hai của số nhỏ, chính xác đến 0.01; sau đó, số điểm trượt cho mỗi điểm đại diện cho 0.01 đơn vị định giá. Tại đây, đặt số điểm trượt là 5, giá trượt khi đặt hàng là 0.05 ((giá trượt chỉ số khi đặt hàng để tốt hơn và thanh toán phần giá quá mức giao dịch).
• Số chu kỳ dài nhất của biến: ảnh hưởng đến số lượng BAR của đường K trên biểu đồ, vớijavascriptGọi trong chiến lượcSetMaxBarLenChức năng tương tự.

Các lựa chọn tương lai

• Mã giống: Mã hợp đồng, chỉ cần thiết lập khi đối tượng giao dịch là đối tượng giao dịch không trực tiếp.
• Số lượng giao dịch tối thiểu: Số lượng giao dịch tối thiểu khi đặt hàng.

Tùy chọn ổ đĩa thực

• Tự động khôi phục tiến độ: Tự động khôi phục lại trạng thái trước khi chính sách cuối cùng bị dừng.
• Số lần thử lại lệnh: lệnh không giao dịch sẽ hủy lệnh, đặt lại lệnh thử giao dịch, tham số này được sử dụng để giới hạn số lần thử lại tối đa.
• Khoảng thời gian truy vấn mạng (millisecond): Chỉ có hiệu lực đối với giao thức REST, kiểm soát khoảng thời gian yêu cầu mạng, tránh yêu cầu quá thường xuyên, vượt quá giới hạn của sàn giao dịch.
• Thời gian đồng bộ hóa tài khoản: Thời gian đồng bộ hóa dữ liệu tài khoản.
• Thời gian đồng bộ hóa vị trí sau khi bắt đầu giao dịch: chỉ đối với một số giao dịch bị chậm dữ liệu, việc đặt thời gian đồng bộ hóa lớn hơn có thể giảm thiểu các vấn đề như vậy.
• Tỷ lệ đòn bẩy: Đặt tỷ lệ đòn bẩy.

Giao dịch trực tiếp, thiết lập khác

• Số lượng giao dịch một tay: Số lượng giao dịch một tay mặc định, chỉ có hiệu lực đối với hiện tại.
• Số lượng giao dịch nhỏ nhất: Số lượng giao dịch nhỏ nhất.
• Định giá chính xác tiền tệ: chính xác giá, tức là số chữ số nhỏ của giá.
• Độ chính xác của các loại giao dịch: độ chính xác của đơn vị sau, nghĩa là số lượng nhỏ của đơn vị sau.
• Chi phí: tính toán một số dữ liệu theo cài đặt này, 0.002 là 2 phần nghìn.
• Khoảng thời gian thống kê lợi nhuận và lỗ: chỉ sử dụng thống kê lợi nhuận và lỗ trên đĩa thực.
• Thử lại thất bại (millisecond): Khoảng thời gian thử lại khi yêu cầu mạng thất bại.
• Người dùng đại diện: Chỉ có hiệu quả đối với giao thức REST.
• Hide Common Network Errors: Hide Common Error Logs in the Log Area (Tạm dịch: ẩn những lỗi phổ biến trên mạng: ẩn những lỗi phổ biến trong khu vực nhật ký)
• Chuyển địa chỉ cơ sở: Chỉ có hiệu lực đối với giao thức REST.
• Thông báo đẩy: Đẩy tin nhắn đến hộp thư, v.v.

Giao dịch

Mở cửa

strategy(title = "open long example", pyramiding = 3)                                // pyramiding 允许的同方向下单的次数
strategy.entry("long1", strategy.long, 0.01)                                         // 市价开多仓，指定分组标签为long1
strategy.entry("long2", strategy.long, 0.02, when = close > ta.ema(close, 10))       // 条件触发，执行下单，市价开多仓
strategy.entry("long3", strategy.long, 0.03, limit = 30000)                          // 指定（较低的）价格，计划下买单订单，等待成交开仓，限价开仓

Cửa hàng

strategy(title = "close long example", pyramiding = 2)                              // pyramiding 允许的同方向下单的次数
strategy.entry("long1", strategy.long, 0.1)                                         // 市价开多仓，指定分组标签为long1
strategy.entry("long2", strategy.long, 0.1)                                         // 市价开多仓，指定分组标签为long2
strategy.close("long1", when = strategy.position_size > 0.1, qty_percent = 50, comment = "close buy entry for 50%")   // 平仓，指定平掉分组标签为long1的仓位的50%持仓
strategy.close("long2", when = strategy.position_size > 0.1, qty_percent = 80, comment = "close buy entry for 80%")   // 平仓，指定平掉分组标签为long2的仓位的80%持仓

Cơ chế giao dịch

Phương pháp nắm giữ của ngôn ngữ PINE tương tự như nắm giữ một chiều. Ví dụ, khi nắm giữ nhiều vị trí, nếu có lệnh bán, danh sách kế hoạch, v.v. (đối với hướng ngược lại với hướng nắm giữ), lệnh sẽ được kích hoạt trước khi thực hiện lệnh kích hoạt đối với hướng ngược lại với hướng nắm giữ trước khi nắm giữ.

Danh sách kế hoạch

Khi sử dụng lệnh đặt hàng, nếu không chỉ định bất kỳ mức giá nào, mặc định đặt hàng theo giá thị trường. Ngoài giá thị trường, bạn cũng có thể đặt hàng bằng đơn đặt hàng theo kế hoạch, đơn đặt hàng sẽ không hoạt động ngay lập tức.Đĩa thực / kiểm tra lạiThông tin trạng thái thời gian (tức là thanh trạng thái khi chính sách đang chạy) được nhìn thấy trong bảng phân trang "lệnh dự kiến"; hệ thống sẽ thực sự đặt các đơn đặt hàng này khi giá thị trường thực tế đáp ứng các điều kiện kích hoạt các đơn đặt hàng này. Vì vậy, các đơn đặt hàng này có sự chênh lệch nhỏ trong giá giao dịch là điều bình thường. Sử dụngstrategy.entryKhi chúng ta sắp xếp các hàm, chúng ta có thể chỉ địnhlimit、stopCác tham số.

var isTrade = false 
if not barstate.ishistory and not isTrade
    isTrade := true 
    strategy.entry("test 1", strategy.long, 0.1, stop=close*1.3, comment="test 1 order")                     // stop
    strategy.entry("test 2", strategy.long, 0.2, limit=close*0.7, comment="test 2 order")                    // limit
    strategy.entry("test 3", strategy.short, 0.3, stop=close*0.6, limit=close*1.4, comment="test 3 order")   // stop-limit    

• Đặt hàng giới hạn

  Đặt giá giới hạn cho đơn đặt hàng, khi đơn đặt hàng là thanh toán (tức làdirectionCác tham số làstrategy.long), chỉ khi giá hiện tại trên thị trường thấp hơn, lệnh sẽ được kích hoạt. Khi đơn đặt hàng là bán hàngdirectionCác tham số làstrategy.short), chỉ khi giá hiện tại trên thị trường cao hơn, lệnh sẽ được kích hoạt.

• Đặt lệnh dừng

  Thiết lập giá dừng lỗ cho lệnh, khi lệnh là thanh toán, lệnh chỉ được kích hoạt khi giá hiện tại trên thị trường cao hơn giá đó. Khi lệnh bán, lệnh chỉ được kích hoạt khi giá hiện tại trên thị trường thấp hơn giá đó.

• Stop-limit đặt hàng

  Có thể được thiết lập cùng một lúclimit、stopCác tham số, các đơn đặt hàng được kích hoạt ở mức giá phù hợp với điều kiện đầu tiên.

Tỷ lệ quyền lợi

//@version=5
strategy("Percent of Equity Order", overlay=true, default_qty_type=strategy.percent_of_equity, default_qty_value=100)  

// 简单的均线交叉策略
longCondition = ta.crossover(ta.sma(close, 14), ta.sma(close, 28))
shortCondition = ta.crossunder(ta.sma(close, 14), ta.sma(close, 28))  

// 如果均线交叉条件满足，则买入或卖出
if (longCondition)
    strategy.entry("Long", strategy.long)  

if (shortCondition)
    strategy.entry("Short", strategy.short)
  

Đặtdefault_qty_type=strategy.percent_of_equitySau đó, cài đặtdefault_qty_valueSố phần trăm ((0 đến 100), 1 là 1%;; số đơn được tính theo số tiền được tính trong tài khoản;; ví dụ: tài khoản hiện tại có 10000 USDT, đặt đơn đặt hàng 1%, tức là sử dụng đơn đặt hàng quy mô 100 USDT (được tính theo giá hiện tại khi bán).

Tuyên bố, từ khóa cấu trúc logic

var

var là từ khóa được sử dụng để phân bổ và khởi tạo một lần các biến. Thông thường, ngữ pháp gán biến mà không bao gồm từ khóa var sẽ dẫn đến việc giá trị của biến sẽ được phủ lên mỗi khi dữ liệu được cập nhật. Ngược lại, khi sử dụng từ khóa var để phân bổ biến, chúng vẫn có thể giữ trạng thái mặc dù dữ liệu được cập nhật, chỉ thay đổi nó khi đáp ứng các điều kiện trong if-expressions.

var variable_name = expression

Điều này có nghĩa:

• variable_name- Bất kỳ tên biến đổi người dùng nào được cho phép trong Pine Script (có thể bao gồm các ký tự Latin chữ viết lớn và chữ viết nhỏ, số và dấu gạch dưới, nhưng không thể bắt đầu bằng số).
• expression- Bất kỳ biểu thức toán học nào cũng giống như định nghĩa một biến thông thường.

Ví dụ

// Var keyword example
var a = close
var b = 0.0
var c = 0.0
var green_bars_count = 0
if close > open
    var x = close
    b := x
    green_bars_count := green_bars_count + 1
    if green_bars_count >= 10
        var y = close
        c := y
plot(a, title = "a")
plot(b, title = "b")
plot(c, title = "c")

Các biến a giữ giá đóng cửa của hàng đầu của mỗi hàng trong chuỗi. Các biến số b giữ giá đóng cửa của thanh giá n màu xanh lá cây n đầu tiên trong loạt n. Các biến c giữ giá đóng cửa của con số 10 trong loạt các con số.

Trên FMZ, các mô hình giá thực tế, mô hình giá đóng cửa, mô hình giá bán, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực, mô hình giá bán trong thời gian thực.var、varipCác biến được tuyên bố chúng tôi thử nghiệm bằng mã sau đây.

strategy("test pine", "test 1", true) 

// 测试 var varip
var i = 0
varip ii = 0

// 将策略逻辑每轮改变的i、ii打印在图上
plotchar(true, title="ii", char=str.tostring(ii), location=location.abovebar, color=color.red)
plotchar(true, title="i", char=str.tostring(i), location=location.belowbar, color=color.green)

// 每轮逻辑执行都给i、ii递增1
if true
    i := i + 1
    ii := ii + 1

• Mô hình giá thời gian thực Mã thử nghiệm trên được phân chia thành hai giai đoạn khi thực hiện: 1, giai đoạn đường K lịch sử. 2, giai đoạn đường K thời gian thực.var、varipCác biến i, ii được tuyên bố sẽ thực hiện các thao tác tăng dần mỗi lần thực hiện mã chính sách vìif trueVì vậy, chắc chắn sẽ thực hiện các phần mã điều kiện tương ứng). Vì vậy, bạn có thể thấy rằng các số hiển thị trên kết quả K-line BAR đều tăng lên 1. Khi giai đoạn K-line lịch sử kết thúc, bắt đầu giai đoạn K-line thời gian thực.var、varipCác biến được tuyên bố bắt đầu thay đổi khác nhau. Bởi vì đó là mô hình giá thực tế, mỗi lần thay đổi giá trong một dòng KBAR sẽ được thực hiện một lần mã chiến lược.i := i + 1vàii := ii + 1Chỉ có một sự khác biệt là i được thay đổi mỗi lần. i vẫn được thay đổi, nhưng giá trị trước đó sẽ được khôi phục lại khi logic chính sách được thực hiện lần tiếp theo, và sẽ không được cập nhật cho đến khi dòng K BAR hiện tại kết thúc (có nghĩa là giá trị trước đó sẽ không được khôi phục lại khi logic chính sách được thực hiện lần tiếp theo). Vì vậy, chúng ta có thể thấy biến i vẫn là BAR1 mỗi lần; nhưng biến ii được thêm nhiều lần mỗi BAR.

• Mô hình giá đóng cửa Vì mô hình giá đóng là thực hiện một chiến lược logic mỗi khi mỗi K-line BAR đi qua. Vì vậy, trong mô hình giá đóng, giai đoạn K-line lịch sử và giai đoạn K-line thời gian thực sẽ được sử dụng để xác định giá của các dòng.var、varipCác biến được tuyên bố diễn ra hoàn toàn đồng bộ trong các ví dụ trên, tăng dần, mỗi K-line BAR tăng lên 1.

khác nhau

varip (var intrabar persist) là một từ khóa dùng để phân bổ và khởi tạo một lần các biến. Nó tương tự như từ khóa var, nhưng các biến được sử dụng trong tuyên bố varip giữ giá trị giữa các bản cập nhật dòng K trong thời gian thực.

varip variable_name = expression

Điều này có nghĩa:

• variable_name- Bất kỳ tên nào cho biến đổi người dùng được cho phép trong kịch bản Pine (có thể bao gồm chữ cái Latin chữ cái, số và dấu phẩy, nhưng không thể bắt đầu bằng số)
• expression- Bất kỳ biểu thức toán học nào, giống như khi xác định các biến thông thường. Trên đường K đầu tiên, biểu thức chỉ tính một lần và gán cho các biến một lần.

Ví dụ

// varip
varip int v = -1
v := v + 1
plot(v)

Khi sử dụng var, biểu đồ sẽ trả về giá trị của bar_index. Sử dụng varip, hành vi tương tự sẽ xảy ra trên đường K lịch sử, nhưng trên đường K thời gian thực, biểu đồ sẽ trả về một giá trị, tăng một cho mỗi dấu chấm.

Nhận xétChỉ được sử dụng với các kiểu đơn giản như float, int, boolean, string, và các mảng của kiểu này.

đúng

Định giá trị của một biến dạng Boolean, hoặc khi biểu thức được sử dụngSo sánhHoặcLý thuyếtGiá trị mà các toán tử có thể tính toán.

Nhận xétXem thêmSo sánhCác toán tử vàLý thuyếtMô tả các toán tử.

Hẹn gặp lại bool

sai

Chỉ ra giá trị của một biến kiểu Boolean, và kết quả của các hoạt động so sánh, các hoạt động logic.

Nhận xétXem thêmSo sánhCác toán tử vàLý thuyếtMô tả các toán tử.

Hẹn gặp lại bool

nếu

Một câu nói if định nghĩa các đoạn câu phải được thực hiện khi đáp ứng các điều kiện biểu thức. Ngôn ngữ kịch bản Pine phiên bản 4 cho phép bạn sử dụng ngữ pháp ifelse if.

Các mã thông thường được lấy từ:

var_declarationX = if condition
    var_decl_then0
    var_decl_then1
    ...
    var_decl_thenN
    return_expression_then
else if [optional block]
    var_decl_else0
    var_decl_else1
    ...
    var_decl_elseN
    return_expression_else
else
    var_decl_else0
    var_decl_else1
    ...
    var_decl_elseN
    return_expression_else

Nhận xét var_declarationX- Điều này lấy giá trị của câu ifcondition- Nếu điều kiện là true, thì sử dụng đoạn vănthenĐiều này có nghĩa làvar_decl_then0，var_decl_then1V.v.) ⇒ Nếu điều kiện là false, sử dụng đoạn câuelse ifHoặcelseĐiều này có nghĩa làvar_decl_else0，var_decl_else1Vâng.return_expression_then , return_expression_else- biểu thức cuối cùng trong module hoặc biểu thức từ khốielse sẽ trả về giá trị cuối của câu lệnh. Nếu biến được tuyên bố ở cuối, giá trị của nó sẽ là giá trị kết quả.

Các giá trị được trả về của câu if phụ thuộc vàoreturn_expression_thenvàreturn_expression_elseCác kiểu này. Khi chạy trên TradingView, các kiểu của chúng phải phù hợp: không thể trả về một giá trị nguyên từ khối câu then khi bạn có một giá trị chuỗi trong khốielse. Khi chạy trên FMZ, các ví dụ sau không trả về lỗi, khi giá trị y được lấy là "open", giá trị khi vẽ đồ họa phác thảo là n/a.

Ví dụ

// This code compiles
x = if close > open
    close
else
    open  

// This code doesn’t compile by trading view
// y = if close > open
//     close
// else
//     "open"
plot(x)

Có thể bỏ quaelseTrong trường hợp này, nếu điều kiện là false, thì sẽ gán một threshold empty (na,false hoặc) cho biến var_declarationX:

Ví dụ

// if
x = if close > open
    close
// If current close > current open, then x = close.
// Otherwise the x = na.
plot(x)

Có thể sử dụng nhiều khối if hoặc không sử dụng. Các khối then, if, if được di chuyển qua bốn không gian:

Ví dụ

// if
x = if open > close
    5
else if high > low
    close
else
    open
plot(x)

Có thể bỏ quaifGiá trị kết quả của câu nói ((var_declarationX= có thể bỏ qua) ). Nó có thể hữu ích nếu bạn cần một tác dụng phụ của biểu thức, ví dụ như trong giao dịch chiến lược:

Ví dụ

if (ta.crossover(high, low))
    strategy.entry("BBandLE", strategy.long, stop=low)
else
    strategy.cancel(id="BBandLE")

Các câu if có thể chứa lẫn nhau:

Ví dụ

// if
float x = na
if close > open
    if close > close[1]
        x := close
    else
        x := close[1]
else
    x := open
plot(x)

cho

'for' cấu trúc cho phép lặp lại nhiều câu:

[var_declaration =] for counter = from_num to to_num [by step_num]
    statements | continue | break
    return_expression

var_declaration- Một biến thể tùy chọn được tuyên bố, nó sẽ được chỉ định là giá trị của return_expression trong vòng quay.counter- Lưu lượng các biến của giá trị của bộ đếm vòng quay, tăng/giảm 1 hoặc step_num giá trị trong mỗi lần lặp của vòng quay.from_num- Giá trị khởi đầu của bộ đếm. Cho phép sử dụng các hàm int/float threshold/expression.to_num- Giá trị cuối cùng của bộ đếm; vòng xoay bị ngắt khi bộ đếm lớn hơn to_num (hoặc nhỏ hơn to_num trong trường hợp from_num > to_num); phép sử dụng hàm int/float thresholds/expressions, nhưng chúng chỉ được đánh giá trong lần lặp đầu tiên của vòng xoay;step_num- Giá trị tăng/giảm của bộ đếm. Nó là tùy chọn. Giá trị mặc định là +1 hoặc-1, tùy thuộc vào số lớn nhất trong số from_num hoặc to_num. Khi sử dụng giá trị, bộ đếm cũng tăng/giảm theo số lớn nhất trong số from_num hoặc to_num, do đó ký hiệu +/- của step_num là tùy chọn.statements | continue | break- Bất kỳ số câu nào, hoặc các từ khóa liên tục hoặc phá vỡ, thu hẹp 4 không gian hoặc một tab.return_expression- Giá trị trả về của vòng lặp, nếu có, được gán cho các biến trong var_declaration. Nếu vòng lặp thoát ra do từ khóa continuous loop hoặc break loop, giá trị trả về của vòng lặp là giá trị của biến cuối cùng được gán giá trị trước khi thoát ra vòng lặp.continue- Từ khóa chỉ được sử dụng trong vòng quay. Nó dẫn đến việc lặp lại vòng quay tiếp theo được thực hiện.break- Từ khóa để thoát khỏi vòng tròn.

Ví dụ

// Here, we count the quantity of bars in a given 'lookback' length which closed above the current bar's close
qtyOfHigherCloses(lookback) =>
    int result = 0
    for i = 1 to lookback
        if close[i] > close
            result += 1
    result
plot(qtyOfHigherCloses(14))

Hẹn gặp lại for...in while

cho... trong

for...inCấu trúc cho phép thực hiện nhiều câu nói lặp lại cho mỗi phần tử trong mảng. Nó có thể được sử dụng cùng với bất kỳ tham số nào:array_element, hoặc sử dụng cùng với hai tham số:[index, array_element]❏ Hình thức thứ hai không ảnh hưởng đến chức năng của vòng lặp. ❏ Nó theo dõi chỉ mục lặp hiện tại trong biến đầu tiên của tập hợp.

[var_declaration =] for array_element in array_id
    statements | continue | break
    return_expression

[var_declaration =] for [index, array_element] in array_id
    statements | continue | break
    return_expression

var_declaration- Một tuyên bố biến tùy chọn sẽ được gán cho vòng lặpreturn_expressionGiá trị của.index- Theo dõi các biến tùy chọn của chỉ mục lặp hiện tại. ̧ chỉ mục bắt đầu từ 0. ̧ biến là không thể thay đổi trong vòng lặp. ̧ khi sử dụng, nó phải được bao gồm trong một cũng bao gồmarray_elementTrong các tập hợp của.array_element- Bao gồm các biến cho mỗi phần tử hàng loạt liên tục được xử lý trong vòng lặp. Các biến này không thể thay đổi trong vòng lặp.array_id- ID mảng lặp lại vòng tròn.statements | continue | break- Bất kỳ số câu nào, hoặc các từ khóa liên tục hoặc phá vỡ, thu hẹp 4 không gian hoặc một tab.return_expression- giá trị trả về của vòng lặp được phân bổ chovar_declarationCác biến trong vòng, nếu có. Nếu vòng tròn thoát ra do các từ khóa "continue" hoặc "break", giá trị trả về của vòng tròn là biến được gán cuối cùng trước khi vòng tròn thoát ra.continue- Từ khóa chỉ được sử dụng trong vòng quay. Nó dẫn đến việc lặp lại vòng quay tiếp theo được thực hiện.break- Từ khóa để thoát khỏi vòng tròn.

Cho phép thay đổi các phần tử hoặc kích thước của mảng trong vòng lặp. Ở đây, chúng ta sử dụngfor...inMột dạng đơn tham số để xác định trên mỗi đường K, bao nhiêu đường K có giá trị OHLC lớn hơn giá trị SMA của giá trị thâm cận:

Ví dụ

// Here we determine on each bar how many of the bar's OHLC values are greater than the SMA of 'close' values
float[] ohlcValues = array.from(open, high, low, close)
qtyGreaterThan(value, array) =>
    int result = 0
    for currentElement in array
        if currentElement > value
            result += 1
        result
plot(qtyGreaterThan(ta.sma(close, 20), ohlcValues))

Ở đây, chúng ta sử dụng hai dạng đối số for...in để tạo ra chúng taisPosCác giá trị của mảng được đặt làtrueKhi chúng ở trong nhà chúng tôi,valuesArrayCác giá trị tương ứng trong các tập hợp là:

Ví dụ

// for...in
var valuesArray = array.from(4, -8, 11, 78, -16, 34, 7, 99, 0, 55)
var isPos = array.new_bool(10, false)  

for [index, value] in valuesArray
    if value > 0
        array.set(isPos, index, true)  

if barstate.islastconfirmedhistory
    runtime.log(str.tostring(isPos))

Hẹn gặp lại for while array.sum array.min array.max

trong khi

whileCác câu lệnh cho phép các điều kiện lặp lại trong các khối mã cục bộ.

variable_declaration = while boolean_expression
    ...
    continue
    ...
    break
    ...
    return_expression

Điều này có nghĩa:variable_declaration- Các thông báo biến tùy chọn.return expressionBạn có thể cung cấp giá trị khởi tạo cho biến này.boolean_expression- Nếu là true, thực hiệnwhileNếu là false, thì ởwhileSau câu nói, tiếp tục thực hiện kịch bản.continue - continueTừ khóa dẫn đến nhánh vòng lặp đến lần lặp tiếp theo.break - breakTừ khóa dẫn đến chấm dứt vòng lặp.whileSau khi nói, hãy tiếp tục.return_expression- Cung cấpwhileCác câu trả về các giá trị tùy chọn.

Ví dụ

// This is a simple example of calculating a factorial using a while loop.
int i_n = input.int(10, "Factorial Size", minval=0)
int counter   = i_n
int factorial = 1
while counter > 0
    factorial := factorial * counter
    counter   := counter - 1

plot(factorial)

Nhận xétĐầu tiênwhileCác khối mã địa phương sau hàng phải được thu nhỏ thành bốn không gian hoặc một ký tự.whileVòng tròn.whileCác biểu thức Boole sau phải trở thành false hoặc phải thực hiệnbreak。

chuyển đổi

Switch chuyển quyền kiểm soát sang một trong vài câu nói dựa trên giá trị của điều kiện và biểu thức.

[variable_declaration = ] switch expression
    value1 => local_block
    value2 => local_block
    ...
    => default_local_block

[variable_declaration = ] switch
    boolean_expression1 => local_block
    boolean_expression2 => local_block
    ...
    => default_local_block

Một số người nói rằng, "Điều này không phải là điều tốt".

Ví dụ

// Switch using an expression

string i_maType = input.string("EMA", "MA type", options = ["EMA", "SMA", "RMA", "WMA"])

float ma = switch i_maType
    "EMA" => ta.ema(close, 10)
    "SMA" => ta.sma(close, 10)
    "RMA" => ta.rma(close, 10)
    // Default used when the three first cases do not match.
    => ta.wma(close, 10)

plot(ma)

Một số người đã viết bài viết trên trang web của mình.

Ví dụ

strategy("Switch without an expression", overlay = true)

bool longCondition  = ta.crossover( ta.sma(close, 14), ta.sma(close, 28))
bool shortCondition = ta.crossunder(ta.sma(close, 14), ta.sma(close, 28))

switch
    longCondition  => strategy.entry("Long ID", strategy.long)
    shortCondition => strategy.entry("Short ID", strategy.short)

Trả về giá trịGiá trị của biểu thức cuối cùng trong khối câu lệnh địa phương được thực hiện.

Nhận xétChỉ có thể thực hiệnlocal_blockví dụ hoặcdefault_local_blockMột trong số đó.default_local_blockChỉ với=>Chữ đánh dấu được giới thiệu cùng với nhau và chỉ được thực hiện khi không thực hiện khối trước đó; nếuswitchKết quả của câu nói được gán cho một biến và không được chỉ địnhdefault_local_blockNếu không thực hiệnlocal_blockVà sau đó, câu trả lời sẽ trở lại.na◎ sẽswitchKhi kết quả của câu nói được gán cho một biến, tất cảlocal_blockCác trường hợp phải trả về cùng một kiểu giá trị.

Hẹn gặp lại if ?:

loạt

series là một từ khóa cho loại chuỗi dữ liệu.seriesTừ khóa thường không cần thiết.

Các toán tử

=

Sử dụng để gán cho biến, nhưng chỉ khi tuyên bố biến (được sử dụng lần đầu tiên).

:=

Các toán tử gán, gán cho các biến bên trái.

!=

Không bằng với. áp dụng cho bất kỳ loại biểu thức nào.

expr1 != expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

%

Định số (đơn vị tổng số dư) ⇒ áp dụng cho các biểu thức số.

expr1 % expr2

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

Nhận xétTrong kịch bản Pine, khi tính số dư của một số nguyên, giao dịch sẽ được cắt đứt; nghĩa là, đặt 4/5 của nó vào giá trị tuyệt đối nhỏ nhất; giá trị thu được sẽ có cùng ký hiệu như cổ tức.

Ví dụ: -1 % 9 = -1 - 9 * truncate ((-1/9) = -1 - 9 * truncate ((-0.111) = -1 - 9 * 0 = -1.

%=

Định nghĩa mô-đun.

expr1 %= expr2

Ví dụ

// Equals to expr1 = expr1 % expr2.
a = 3
b = 3
a %= b
// Result: a = 0.
plot(a)

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

*

Xét nhân... áp dụng cho biểu thức số.

expr1 * expr2

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

*=

Định nghĩa nhân.

expr1 *= expr2

Ví dụ

// Equals to expr1 = expr1 * expr2.
a = 2
b = 3
a *= b
// Result: a = 6.
plot(a)

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

+

Thêm hoặc đơn vị chính thức.

expr1 + expr2

+ expr

Trả về giá trịHệ thống nhị phân của chuỗi+Trả về sự kết hợp của express1 và express2 Số trả về một số nguyên hoặc một giá trị dấu phẩy, hoặc một chuỗi các giá trị: Chế độ nhị phân +'trả về express1 cộng với express2. Một đơn vị + một đơn vị trả về expres (không thêm bất kỳ nội dung nào vào đối xứng của một đơn vị).

Nhận xétBạn có thể sử dụng các toán tử toán học với số và số lượng các biến. Trong trường hợp sử dụng các số lượng, các toán tử được áp dụng cho các phần tử.

+=

Định nghĩa gia hạn... được sử dụng cho biểu thức số hoặc chuỗi...

expr1 += expr2

Ví dụ

// Equals to expr1 = expr1 + expr2.
a = 2
b = 3
a += b
// Result: a = 5.
plot(a)

Trả về giá trịĐối với các chuỗi, trả về chuỗi express1 và express2; đối với các số, trả về số nguyên hoặc giá trị dấu phẩy, hoặc một chuỗi các giá trị.

Nhận xétBạn có thể sử dụng các toán tử toán học với số và số lượng các biến. Trong trường hợp sử dụng các số lượng, các toán tử được áp dụng cho các phần tử.

-

Phân trừ hoặc số âm đơn.

expr1 - expr2

- expr

Trả về giá trịTrả về một số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị: Binomial x +'trả về express1 trừ express2. Một đồng-Trả lại từ chối của expres.

Nhận xétBạn có thể sử dụng các toán tử toán học với số và số lượng các biến. Trong trường hợp sử dụng các số lượng, các toán tử được áp dụng cho các phần tử.

-=

Định nghĩa trừu tượng.

expr1 -= expr2

Ví dụ

// Equals to expr1 = expr1 - expr2.
a = 2
b = 3
a -= b
// Result: a = -1.
plot(a)

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

/

Ngoại trừ. áp dụng cho biểu thức số.

expr1 / expr2

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

/=

Trừ khi chỉ định.

expr1 /= expr2

Ví dụ

// Equals to expr1 = expr1 / expr2.
a = 3
b = 3
a /= b
// Result: a = 1.
plot(a)

Trả về giá trịMột số nguyên hoặc một giá trị trôi, hoặc một chuỗi các giá trị.

<

Ít hơn. Đối với các biểu thức số.

expr1 < expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

<=

Ít hơn hoặc bằng.

expr1 <= expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

==

Có thể sử dụng cho bất kỳ loại biểu thức nào.

expr1 == expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

=>

Các toán tử '=>' được sử dụng cho các tuyên bố hàm được xác định bởi người dùng vàswitchTrong câu nói.

Phương pháp lập trình của function declaration là:

<identifier>([<parameter_name>[=<default_value>]], ...) =>
    <local_block>
    <function_result>

Một<local_block>Một số câu nói của Pine là 0 hoặc nhiều hơn.<function_result>là một biến, một biểu thức hoặc một nhóm.

Ví dụ

// single-line function
f1(x, y) => x + y
// multi-line function
f2(x, y) => 
    sum = x + y
    sumChange = ta.change(sum, 10)
    // Function automatically returns the last expression used in it
plot(f1(30, 8) + f2(1, 3))

Nhận xétBạn có thể tìm hiểu thêm về các hàm được định nghĩa bởi người dùng trên trang tuyên bố hàm và thư mục kịch bản trong hướng dẫn người dùng.

>

lớn hơn. áp dụng cho các biểu thức số.

expr1 > expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

>=

lớn hơn hoặc bằng.

expr1 >= expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

?:

Các toán tử điều kiện ba nguyên tắc.

expr1 ? expr2 : expr3

Ví dụ

// Draw circles at the bars where open crosses close
s2 = ta.cross(open, close) ? math.avg(open,close) : na
plot(s2, style=plot.style_circles, linewidth=2, color=color.red)  

// Combination of ?: operators for 'switch'-like logic
c = timeframe.isintraday ? color.red : timeframe.isdaily ? color.green : timeframe.isweekly ? color.blue : color.gray
plot(hl2, color=c)

Trả về giá trịNếu expres1 được đánh giá là true, expres2 sẽ được đánh giá là true, nếu không thì expres3 sẽ được đánh giá là true.

Nhận xétNếu bạn không cần, hãy sử dụng na như là một nhánh của nhánh Else. Bạn có thể sử dụng hai hoặc nhiều hơn: các ký hiệu để thực hiện các câu tương tự như các dấu hiệu chuyển đổi (xem ví dụ trên). Bạn có thể sử dụng các toán tử toán học với số và số lượng các biến. Trong trường hợp sử dụng các số lượng, các toán tử được áp dụng cho các phần tử.

Hẹn gặp lại na

[]

Chữ con số của chuỗi. Cung cấp quyền truy cập vào các giá trị trước của chuỗi expr1. Expr2 là số của dòng k trong quá khứ và phải là giá trị.

expr1[expr2]

Ví dụ

// [] can be used to "save" variable value between bars
a = 0.0 // declare `a`
a := a[1] // immediately set current value to the same as previous. `na` in the beginning of history
if high == low // if some condition - change `a` value to another
    a := low
plot(a)

Trả về giá trịMột loạt các giá trị.

Hẹn gặp lại math.floor

và

Logic AND;; áp dụng cho biểu thức Boolean;;

expr1 and expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

hoặc

Logic OR↑ áp dụng cho biểu thức Boolean↑

expr1 or expr2

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

không

Logical inverse ((NOT) ⇒ áp dụng cho biểu thức Boolean.

not expr1

Trả về giá trịGiá trị Boolean, hoặc một chuỗi giá trị Boolean.

Mẫu dữ liệu từ khóa

bool

Từ khóa dùng cho các biến hoặc tham số được tuyên bố rõ ràng. Các giá trị của biến "Bool" có thể là true, false hoặc na.

Ví dụ

// bool
bool b = true    // Same as `b = true`
b := na
plot(b ? open : close)

Nhận xétViệc đề cập rõ ràng đến kiểu trong tuyên bố biến là tùy chọn, trừ khi nó được khởi tạo bằng na. Tìm hiểu thêm về kiểu Pine trên trang hướng dẫn người dùng của hệ thống kiểu.

Hẹn gặp lại var varip int float color string true false

int

Từ khóa kiểu int (đơn vị nguyên) được sử dụng để tuyên bố rõ ràng các biến hoặc tham số.

Ví dụ

// int
int i = 14    // Same as `i = 14`
i := na
plot(i)

Nhận xétViệc đề cập rõ ràng đến kiểu trong tuyên bố biến là tùy chọn, trừ khi nó được khởi tạo bằng na. Tìm hiểu thêm về kiểu Pine trên trang hướng dẫn người dùng của hệ thống kiểu.

Hẹn gặp lại var varip float bool color string

trôi

Từ khóa dùng cho các biến hoặc tham số được tuyên bố rõ ràng.

Ví dụ

// float
float f = 3.14    // Same as `f = 3.14`
f := na
plot(f)

Nhận xétViệc đề cập rõ ràng đến kiểu trong tuyên bố biến là tùy chọn, trừ khi nó được khởi tạo bằng na.

Hẹn gặp lại var varip int bool color string

chuỗi

Từ khóa dùng cho kiểu "string" để tuyên bố rõ ràng các biến hoặc tham số.

Ví dụ

// string
string s = "Hello World!"    // Same as `s = "Hello world!"`
// string s = na // same as "" 
plot(na, title=s)

Nhận xétViệc đề cập rõ ràng đến kiểu trong tuyên bố biến là tùy chọn, trừ khi nó được khởi tạo bằng na. Tìm hiểu thêm về kiểu Pine trên trang hướng dẫn người dùng của hệ thống kiểu.

Hẹn gặp lại var varip int float bool str.tostring str.format

màu sắc

Từ khóa dùng cho kiểu "color" để tuyên bố rõ ràng các biến hoặc tham số.

Ví dụ

// color
color textColor = color.green
if barstate.islastconfirmedhistory
    runtime.log("test", textcolor = textColor)

Nhận xétChữ màu có định dạng như sau: #RRGGBB hoặc #RRGGBBAA. Các chữ cái đại diện cho giá trị mười sáu chữ số từ 00 đến FF (từ 0 đến 255 chữ số), trong đó RR,GG và BB là các giá trị của các phân số màu đỏ, xanh lá cây và xanh dương. AA là các giá trị tùy chọn cho độ minh bạch màu (hoặc phân số alpha), trong đó 00 không nhìn thấy được, FF không minh bạch. Việc đề cập rõ ràng đến kiểu trong tuyên bố biến là tùy chọn, trừ khi nó được khởi tạo bằng na. Tìm hiểu thêm về kiểu Pine trên trang hướng dẫn người dùng của hệ thống kiểu.

Hẹn gặp lại var varip int float string color.rgb color.new

mảng

Từ khóa dùng cho các kiểu hàm của mảng hàm để tuyên bố rõ ràng các biến hoặc tham số.array.new<type>,array.fromChức năng tạo đối tượng mảng (hoặc ID) ⇒

Ví dụ

// array
array<float> a = na
a := array.new<float>(1, close)
plot(array.get(a, 0))

Nhận xétCác đối tượng trong mảng luôn có hình thức mảng của chuỗi.

Hẹn gặp lại var array.new array.from

Các đối tượng

Đối tượng Object của ngôn ngữ PINE là một ví dụ về kiểu định nghĩa người dùng (UDT), được hiểu là một lớp không có phương pháp, cho phép người dùng tạo các kiểu tùy chỉnh trong chính sách để tổ chức các giá trị khác nhau trong một thực thể.

Định nghĩa kiểu

Chúng ta hãy định nghĩa một loại lệnh để lưu thông tin lệnh:

type order
    float price
    float amount
    string symbol

• Sử dụngtypeCác loại tuyên bố từ khóa.
• type sau từ khóa type là tên kiểu.
• Dòng đầu tiên type xác định tên kiểu, sau đó thu hẹp bốn không gian để xác định trường chứa kiểu.
• Mỗi trường cần phải xác định kiểu dữ liệu của nó, chẳng hạn như int, float, string.

Tạo đối tượng

Sử dụng kiểu được tuyên bố tốt, gọinew()Các chức năng tạo đối tượng:

order1 = order.new()

order1 = order.new(100, 0.1, "BTC_USDT")

order1 = order.new(amount = 0.1, symbol = "BTC_USDT", price = 100)

Bạn cũng có thể tạo các đối tượng trống:

order order1 = na

Dưới đây là một ví dụ thực tế:

type order
    float price
    float amount
    string symbol

if strategy.position_size == 0 and open > close
    strategy.entry("long", strategy.long, 1)

order1 = order.new(strategy.opentrades.entry_price(strategy.opentrades - 1), strategy.opentrades.size(strategy.opentrades - 1), syminfo.ticker)
// runtime.log(order1)   // 输出 {"data":{"price":46002.8,"amount":1,"symbol":"swap"},"_meta":0,"_type":"order"}

Ví dụ:

order1 = order.new(strategy.opentrades.entry_price(strategy.opentrades - 1), strategy.opentrades.size(strategy.opentrades - 1), syminfo.ticker)

Bạn có thể viết theo các hình thức sau:

order order1 = na
order1 := order.new(strategy.opentrades.entry_price(strategy.opentrades - 1), strategy.opentrades.size(strategy.opentrades - 1), syminfo.ticker)

Loại đối tượng được sử dụng cho từ khóa var

//@version=5
indicator("Objects using `var` demo")

//@type A custom type to hold index, price, and volume information.
type BarInfo
    int   index = bar_index
    float price = close
    float vol   = volume

//@variable A `BarInfo` instance whose fields persist through all iterations, starting from the first bar.
var BarInfo firstBar = BarInfo.new()
//@variable A `BarInfo` instance declared on every bar.
BarInfo currentBar = BarInfo.new()

// Plot the `index` fields of both instances to compare the difference.
plot(firstBar.index, "firstBar")
plot(currentBar.index, "currentBar")

Khi sử dụng tuyên bố từ khóa var để gán một biến đối tượng với kiểu xác định của người dùng, từ khóa này sẽ tự động được áp dụng cho tất cả các trường của đối tượng đó. Điều này có nghĩa là đối tượng được tuyên bố bằng từ khóa var sẽ giữ trạng thái của nó giữa mỗi lần lặp mà không cần phải khởi tạo lại giá trị trường của nó trong mỗi lần lặp.

• Đối tượng firstBar được tuyên bố bằng từ khóa var, vì vậy các trường của nó (index, price, vol) sẽ giữ giá trị của nó trong mỗi lần lặp, từ đầu tiên đến cuối cùng.
• Đối tượng currentBar không sử dụng tuyên bố từ khóa var, vì vậy các trường của nó sẽ được khởi tạo lại trên mỗi mục và sẽ có một đối tượng mới trong mỗi lần lặp.

Bạn có thể so sánh sự khác biệt giữa hai đối tượng bằng cách vẽ các trường index. firstBar.index sẽ giữ giá trị được đặt trước đó trong mỗi lần lặp, trong khi currentBar.index sẽ được khởi tạo lại với giá trị bar_index của mục hiện tại trong mỗi lần lặp.

Loại đối tượng được sử dụng cho từ khóa varip

//@version=5
indicator("Objects using `varip` fields demo")

//@type A custom type that counts the bars and ticks in the script's execution.
type Counter
    int       bars  = 0
    varip int ticks = 0

//@variable A `Counter` object whose reference persists throughout all bars.
var Counter counter = Counter.new()

// Add 1 to the `bars` and `ticks` fields. The `ticks` field is not subject to rollback on unconfirmed bars.
counter.bars  += 1
counter.ticks += 1

// Plot both fields for comparison.
plot(counter.bars, "Bar counter", color.blue, 3)
plot(counter.ticks, "Tick counter", color.purple, 3)

Trong Pine, sử dụng từ khóa varip để chỉ ra một trường đối tượng tồn tại liên tục trong suốt quá trình thực thi kịch bản, thay vì quay lại trong các cột chưa xác định. Trong tuyên bố kiểu Counter, trường bars không sử dụng từ khóa varip và do đó sẽ quay lại trong mỗi cột không xác nhận; trong khi trường ticks sử dụng từ khóa varip và do đó nó sẽ không quay lại trong cột không xác nhận. Đối tượng counter được tuyên bố bằng từ khóa var, do đó nó sẽ tồn tại suốt quá trình thực hiện kịch bản. Trong mỗi lần lặp lại, các trường bars và ticks sẽ được thêm một. Các trường bars sẽ quay lại trong mỗi cột chưa xác định, trong khi các trường ticks sẽ không quay lại. Cuối cùng, bằng cách vẽ các trường counter.bars và counter.ticks, bạn có thể so sánh sự khác biệt giữa chúng. Giá trị của counter.bars sẽ được lật ngược trong mỗi cột chưa xác định, trong khi giá trị của counter.ticks sẽ tiếp tục tăng lên cho đến khi kịch bản hoàn thành.

Thay đổi giá trị trường

type order
    float price
    float amount
    string symbol

if strategy.position_size == 0 and open > close
    strategy.entry("long", strategy.long, 1)
    
order1 = order.new(strategy.opentrades.entry_price(strategy.opentrades - 1), strategy.opentrades.size(strategy.opentrades - 1), syminfo.ticker)

if strategy.position_size != 0
    runtime.log(order1)
    order1.price := 999
    order1.amount := 100
    runtime.log(order1)
    runtime.error("stop")

Có thể sử dụng:=Chế toán tái gán thay đổi giá trị của trường đối tượng.

Tập hợp đối tượng

Ví dụ: khai một Array trống, mà sẽ lưu các đối tượng với loại order được xác định bởi người dùng:

type order
    float price
    float amount
    string symbol

arrOrder = array.new<order>()

order1 = order.new(99, 1, "BTC_USDT")
order2 = order.new(100, 2, "ETH_USDT")

array.push(arrOrder, order1)
array.push(arrOrder, order2)

runtime.log(arrOrder)
runtime.error("stop")

Hoặc

type order
    float price
    float amount
    string symbol

var array<order> arrOrder = na
arrOrder := array.new<order>()

order1 = order.new(99, 1, "BTC_USDT")
order2 = order.new(100, 2, "ETH_USDT")

array.push(arrOrder, order1)
array.push(arrOrder, order2)

runtime.log(arrOrder)
runtime.error("stop")

Các đối tượng sao chép

Trong Pine, các đối tượng được gán bằng cách tham chiếu. Khi các đối tượng hiện có được gán cho các biến mới, cả hai đều trỏ đến cùng một đối tượng.

//@version=5
indicator("")
type pivotPoint
    int x
    float y
pivot1 = pivotPoint.new()
pivot1.x := 1000
pivot2 = pivot1
pivot2.x := 2000
// Both plot the value 2000.
plot(pivot1.x)
plot(pivot2.x)

Trong ví dụ dưới đây, chúng ta tạo một đối tượng pivot1 và đặt trường x của nó là 1000. Sau đó, chúng ta tuyên bố một pivot2 chứa một biến có tham chiếu đến đối tượng pivot1 đó, do đó, cả hai đều trỏ đến cùng một trường hợp. Do đó, thay đổi pivot2.x cũng sẽ thay đổi pivot1.x, vì cả hai đều tham chiếu đến trường x của cùng một đối tượng.

Để tạo ra một bản sao độc lập với đối tượng gốc, trong trường hợp này chúng ta có thể sử dụng phương pháp copy ((()) được xây dựng. Trong ví dụ này, chúng ta tuyên bố pivot2 tham chiếu đến một biến của một trường hợp sao chép đối tượng pivot1. Bây giờ, thay đổi pivot2.x sẽ không thay đổi pivot1.x vì nó chỉ ra một trường x của một đối tượng riêng biệt:

//@version=5
indicator("")
type pivotPoint
    int x
    float y
pivot1 = pivotPoint.new()
pivot1.x := 1000
pivot2 = pivotPoint.copy(pivot1)
pivot2.x := 2000
// Plots 1000 and 2000.
plot(pivot1.x)
plot(pivot2.x)

Lưu ý rằng phương pháp sao chép của TradingView là sao chép cơ bản. Nếu một đối tượng có một loại trường đặc biệt (như array, v.v.), thì các trường trong bản sao cơ bản của đối tượng đó sẽ trỏ đến cùng một trường hợp với đối tượng đó. FMZ thực hiện bản sao sâu trực tiếp mà không cần xử lý thêm.

Sao chép sâu

//@version=5

indicator("test deepCopy")

type orderInfo
    float price
    float amount

type labelInfo
    orderInfo order
    string labelMsg

labelInfo1 = labelInfo.new(orderInfo.new(100, 0.1), "test labelInfo1")
labelInfo2 = labelInfo.copy(labelInfo1)

labelInfo1.labelMsg := "labelInfo1->2"    // 修改 labelInfo1 的基础类型字段，看是否影响 labelInfo2
labelInfo1.order.price := 999             // 修改 labelInfo1 的复合类型字段，看是否影响 labelInfo2

runtime.log(labelInfo1)
runtime.log(labelInfo2)
runtime.error("stop")

Kết quả thử nghiệm, labelInfo.copy ((labelInfo1) được thực hiện để sao chép sâu, thay đổi labelInfo1 không ảnh hưởng đến labelInfo2.

Phương pháp

Các phương thức của ngôn ngữ Pine là các hàm chuyên dụng liên quan đến kiểu tích hợp hoặc kiểu xác định của người dùng trong một trường hợp cụ thể. Trong hầu hết các khía cạnh, chúng tương tự như các hàm thông thường, nhưng cung cấp một ngữ pháp ngắn hơn và thuận tiện hơn. Người dùng có thể trực tiếp sử dụng dấu chấm để truy cập các phương thức trên biến, giống như truy cập các trường đối tượng Pine.

Phương pháp xây dựng

Ví dụ, một đoạn mã như thế này:

//@version=5
indicator("Custom Sample BB", overlay = true)

float sourceInput  = input.source(close, "Source")
int   samplesInput = input.int(20, "Samples")
int   n            = input.int(10, "Bars")
float multiplier   = input.float(2.0, "StdDev")

var array<float> sourceArray = array.new<float>(samplesInput)
var float        sampleMean  = na
var float        sampleDev   = na

// Identify if `n` bars have passed.
if bar_index % n == 0
    // Update the queue.
    array.push(sourceArray, sourceInput)
    array.shift(sourceArray)
    // Update the mean and standard deviaiton values.
    sampleMean := array.avg(sourceArray)
    sampleDev  := array.stdev(sourceArray) * multiplier

// Calculate bands.
float highBand = sampleMean + sampleDev
float lowBand  = sampleMean - sampleDev

plot(sampleMean, "Basis", color.orange)
plot(highBand, "Upper", color.lime)
plot(lowBand, "Lower", color.red)

Có thể viết là:

//@version=5
indicator("Custom Sample BB", overlay = true)

float sourceInput  = input.source(close, "Source")
int   samplesInput = input.int(20, "Samples")
int   n            = input.int(10, "Bars")
float multiplier   = input.float(2.0, "StdDev")

var array<float> sourceArray = array.new<float>(samplesInput)
var float        sampleMean  = na
var float        sampleDev   = na

// Identify if `n` bars have passed.
if bar_index % n == 0
    // Update the queue.
    sourceArray.push(sourceInput)
    sourceArray.shift()
    // Update the mean and standard deviaiton values.
    sampleMean := sourceArray.avg()
    sampleDev  := sourceArray.stdev() * multiplier

// Calculate band values.
float highBand = sampleMean + sampleDev
float lowBand  = sampleMean - sampleDev

plot(sampleMean, "Basis", color.orange)
plot(highBand, "Upper", color.lime)
plot(lowBand, "Lower", color.red)

Bạn có thể thấy sự hỗ trợ của PINE.MethodsSau đó, mãarray.avg(sourceArray)Bạn có thể viết theo hình thức phương pháp của người dùng:sourceArray.avg()❖ Lưu ý FMZ không hỗ trợarray.avgNhững lời kêu gọi như vậy.

Phương pháp được xác định bởi người dùng

Pine cho phép người dùng xác định một phương thức tùy chỉnh để sử dụng cùng với bất kỳ đối tượng kiểu được xây dựng hoặc xác định bởi người dùng nào.

1, phương thức từ khóa phải được bao gồm trước tên của hàm. 2, một tham số của method, trong đó kiểu của parameter đầu tiên phải được tuyên bố rõ ràng vì nó cho biết kiểu đối tượng mà method sẽ liên kết với nó.

Ví dụ, cách gói mã tính toán chỉ số Brinh thành một phương pháp tùy chỉnh của người dùng trong các mã sau:

//@version=5
indicator("Custom Sample BB", overlay = true)

float sourceInput  = input.source(close, "Source")
int   samplesInput = input.int(20, "Samples")
int   n            = input.int(10, "Bars")
float multiplier   = input.float(2.0, "StdDev")

var array<float> sourceArray = array.new<float>(samplesInput)
var float        sampleMean  = na
var float        sampleDev   = na

// Identify if `n` bars have passed.
if bar_index % n == 0
    // Update the queue.
    sourceArray.push(sourceInput)
    sourceArray.shift()
    // Update the mean and standard deviaiton values.
    sampleMean := sourceArray.avg()
    sampleDev  := sourceArray.stdev() * multiplier

// Calculate band values.
float highBand = sampleMean + sampleDev
float lowBand  = sampleMean - sampleDev

plot(sampleMean, "Basis", color.orange)
plot(highBand, "Upper", color.lime)
plot(lowBand, "Lower", color.red)

Đổi thành:

//@version=5
indicator("Custom Sample BB", overlay = true)

float sourceInput  = input.source(close, "Source")
int   samplesInput = input.int(20, "Samples")
int   n            = input.int(10, "Bars")
float multiplier   = input.float(2.0, "StdDev")

var array<float> sour

Thêm nữa