今回はライブラリの作成です。

【Pine エディタ】画面で［開く］から［ライブラリ］を選択します。

ライブラリの雛形が表示されます。

001　// This source code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
002　// © Tommy_Rich
003　
004　//@version=5
005　
006　// @description TODO: add library description here
007　library("MyLibrary")
008　
009　// @function TODO: add function description here
010　// @param x TODO: add parameter x description here
011　// @returns TODO: add what function returns
012　export fun(float x) =>
013　    //TODO : add function body and return value here
014　    x

雛形の解説

　　　　７行目　ライブラリの名前を指定します。
　９～１１行目　//　スラッシュ２つ続けると、その行はコメント行に
　　　　　　　　なります。
　　　　　　　　// @function　関数の説明を記述します。
　　　　　　　　// @param x　パラメーター「x」の説明を記述します。
　　　　　　　　// @returns　関数の戻り値を記述します。
　　　１２行目　export：ライブラリをインポートしたスクリプト
　　　　　　　　から呼び出す関数の前に記述します。

テスト用の関数作成

さて、実際に関数を記述していきましょう。
今回は「数値を渡すと色を返す」関数と「文字列を渡すと、テーブル位置の定数を返す」関数を作成します。

001　// This source code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
002　// c Tommy_Rich
003　
004　//@version=5
005　
006　// @description TODO: add library description here
007　library("Base_Test")
008　
009　// @function TODO: Function to take out 12 colors in order
010　// @param _Index TODO: color number.
011　// @returns TODO: color code
012　export GetColor(
013　  int _Index) =>
014　
015　    int count =_Index % 12
016　    color ret =switch count
017　        0  =>#ffbf7f
018　        1  =>#bf7fff
019　        2  =>#7fffbf
020　        3  =>#ff7f7f
021　        4  =>#7f7fff
022　        5  =>#7fff7f
023　        6  =>#ff7fbf
024　        7  =>#7fbfff
025　        8  =>#bfff7f
026　        9  =>#ff7fff
027　        10 =>#7fffff
028　        11 =>#ffff7f
029　
030　// @function TODO: Table display position function
031　// @param _Pos TODO: position.
032　// @returns TODO: Table position
033　export Tbl_position(
034　  string _Pos) =>
035　
036　    string ret =switch _Pos
037　        "top_left" => position.top_left
038　        "top_center" => position.top_center
039　        "top_right" => position.top_right
040　        "middle_left" => position.middle_left
041　        "middle_center" => position.middle_center
042　        "middle_right" => position.middle_right
043　        "bottom_left" => position.bottom_left
044　        "bottom_center" => position.bottom_center
045　        "bottom_right" => position.bottom_right

ライブラリ名の変更
　　　　７行目　Base_Testに変更します。

GetColor関数
　（「数値を渡すと色を返す」関数を作成します）
　　　１２行目　GetColor関数 exportを付けて宣言し、外部のスクリプト
　　　　　　　　から参照できるようにします。
　　　１３行目　引数　_Index：int型の数値を指定します。
　　　１５行目　int型の「_count」変数の宣言
　　　　　　　　初期値に、_Indexを12で割った余りを代入します。
１６～２８行目　color型の変数「ret」に、「_count」変数によって、
　　　　　　　　12色のうちのどれか1色がセットされます。

Tbl_position関数
　（文字列を渡すと、テーブル位置の定数を返す」関数を作成します）
　　　３３行目　Tbl_position関数 exportを付けて宣言し、外部の
　　　　　　　　スクリプトから参照できるようにします。
　　　３４行目　引数　_Pos：string型の数値を指定します。
３６～４５行目　string型の変数「ret」に、「_Pos」引数によって、
　　　　　　　　テーブル位置定数がセットされます。

【保存】をクリックして、スクリプトを保存します。
エラーが発生した場合は画面下部にメッセージが表示されますので、
修正してから再度【保存】をクリックしてください。

【チャートに追加】をクリックしてチャート上にスクリプトを追加します。

チャートの下半分の位置に追加されます。ライブラリなので、何も表示はされません。右下の【スクリプト公開】をクリックします。

【タイトルと説明】

ライブラリの投稿画面が開きます。タイトルにはライブラリ名がデフォルトで入力されていると思います。説明の部分にも自動で関数の説明が入力されます。今回はこのまま投稿してみます。

【プライバシー設定】

右側のプライバシー設定で【公開】を選択すると、TradingViewを利用している全ての人が参照可能な状態になります。【プライベート】を選択すると、自分とこのライブラリのリンクを知っている人だけが参照可能なライブラリとして投稿されます。今回は【プライベート】で投稿します。

【カテゴリ】

投稿するライブラリのカテゴリを選択します。クリックすると、あらかじめ設定してあるカテゴリーの一覧が表示されます

今回はこの中から、「カラー」と「ディスプレイ」を選択しました。

【ライブラリを投稿】

【プライベートライブラリを投稿】をクリックして、ライブラリを公開します。

公開直後の画面です。下の方にスクロールします。

【このライブラリを使用したいですか？】の部分に注目します。

以下の行をコピーして、スクリプト内に貼り付けてください。
　import Tommy_Rich/Base_Test/1

と書かれています。これを利用する側のスクリプトに記述することでライブラリが利用出来るようになります。

「import Tommy_Rich/Base_Test/1」の右のボタンをクリックすると、この文字列がクリップボードにコピーされます。

次回、「Pineスクリプトv5 練習④-2」で実際にライブラリを利用してみます。