在XS語法入門內，我們有提到XS執行時的觀念是類似K線圖一樣，由左往右一筆一筆的執行。

而資料讀取範圍的這個參數，就是用來設定腳本要從哪裡開始執行起。如果你指定10筆的話，那系統就會提供最近10筆的K棒，然後從這10筆的第一根K棒(編號1)開始往右執行：

在上圖內藍色這個區塊就是資料讀取範圍，這個數值的定義根據不同腳本類型而異：

那我們設定資料讀取範圍時，到底該用什麼樣子的數值才對呢？這個問題沒有一個標準答案，必須依照腳本的內容來判斷。有一些指標，例如EMA均線，或是MACD指標，由於計算時會不斷的引用前一筆計算的數值做累計的平均，像這樣子的腳本，就會需要一個比較大的資料讀取筆數。反之，如果一個腳本內只會使用到最近固定期別的數字的話，那資料讀取筆數就不用設的很大。

資料讀取參數除了可以指定最近筆數之外，也可以指定一個固定的起始日期，這樣子可以方便使用者有更精準的控制。另外如果實際上這個商品並沒有那麼多筆資料的話，系統就會自動調整資料讀取筆數，以商品有的資料為基準。

最大引用範圍

執行腳本時，除了資料讀取筆數這個參數會影響腳本執行的筆數之外，另外由於腳本內常常需要讀取之前的資料來做計算，例如要計算3日收盤價平均值時，會引用到上一根K棒的收盤價以及上上一根K棒的收盤價：

1Value1 = (Close + Close[1] + Close[2]) / 3;

所以在腳本要執行之前，系統除了要準備資料讀取範圍內的K棒資料之外，另外也需要往前多準備一些K棒資料：

在上面圖示內，資料讀取範圍左邊的這一個黃色區塊，就叫做最大引用範圍。這個範圍的目的是為了讓腳本可以正確的參考到目前執行的這根K棒往前的資料。同樣的，這個範圍的大小，會跟腳本內會參考到幾期前的資料有關。系統在開始執行時會提供一個預設值，如果在執行過程內腳本參考到了範圍之外的資料而發生錯誤的話，系統還是會繼續執行，改由下一根K棒開始重新計算。

在下面這張圖內，假如腳本的內容是

1Value1 = Close - Close[5]; {計算５日漲幅}

由於最大引用筆數只有4筆，所以腳本要去讀取Close[5]的時候會發生錯誤。這時候系統就會重新調整執行的範圍，從發生錯誤的下一筆開始重新執行。

發生錯誤之後系統自動重新調整最大引用範圍

注意到系統會往右一筆重新執行，讓最大引用範圍變大，這樣子一來，執行的筆數會變少，可是就不會發生錯誤了。由於系統執行時會自動處理這種情形，使用者在大部分的情形底下可以完全忽略最大引用範圍這個參數。可是如果腳本的引用範圍很大的話，那則可以從腳本內透過函數的呼叫來告訴系統這個參數，已減少執行時發生錯誤的機會。這部分在底下會有範例說明。

講完了基本的觀念之後，接下來我們來看不同類型的腳本的設定方式。

XS自訂指標

在技術分析圖形上面放入XS自訂指標時，目前系統預設指標腳本的資料讀取筆數就是這個商品的全部歷史資料，技術分析的設定畫面上也就不提供指定資料讀取範圍的參數，你只要把指標放到技術分析圖上面就對了！！

針對特殊的情境，可以在屬性設定的視窗，直接指定計算資料的長度或起始日。

或是可以透過以下的函數從腳本內控制指標資料的長度：

1SetTotalBar(300);

如果在指標腳本內引用SetTotalBar(300)的話，那這個指標就只會畫最新的300筆資料(不包含當日即時的資料)。如果你希望可以從某個指定日期開始畫圖，可以使用這一版新提供的SetFirstBarDate函數：

1SetFirstBarDate(20150101);

這樣子的話指標就會從20150101日開始畫圖。

至於最大引用範圍這個參數，系統會根據使用者指定的資料範圍來推算一個預設值。使用者也在腳本內透過SetBackBar這個函數來做控制：

1SetBackBar(50);

另外還有一個 SetBarBack函數，他的用途跟SetBackBar是一模一樣的。

XS策略雷達

設定警示畫面內可以指定資料讀取筆數或是第一筆資料的日期：

進階的使用者也可以從腳本內直接透過 SetTotalBar 或是 SetFirstBarDate 這兩個函數來控制資料讀取筆數。同樣的，在腳本內也可以透過 SetBackBar函數來控制最大引用筆數。

XS選股

設定選股策略時可以指定資料讀取筆數或是第一筆資料的日期：

進階的使用者也可以從腳本內直接透過 SetTotalBar 或是 SetFirstBarDate 這兩個函數來控制資料讀取筆數。

至於最大引用筆數這個參數，在XS選股系統內由於執行時已經事先讀取了全部的資料，所以使用者不需要再做設定。

以上為大家介紹了資料讀取筆數的觀念，以及設定的方式。相關的函數請參考函數說明文件。有任何問題或是建議的話，也歡迎您隨時跟我們說喔。