5-1　配列の概要

配列とは？

配列とは、複数の値をグループ化する方法です。１つの数字や文字列を格納できる変数と比較して、配列には大きさがなく、複数の値を含めることができます。配列を使えば、ゲーム内アイテムのステータスをグループ化したり、数千人のプレイヤー名のリストを作成したりすることができます。
スプレッドシートの「表」を思い描いていただくと分かりやすいでしょう。

配列は下記のように作成できます。「local 変数名=」とし、その後に中括弧 { } を使用します。この中に様々な値をカンマで区切って入れていきます。
下記の例では、「アイテム１」と「アイテム２」が文字列、「10」が数値、「workplace.Part」がオブジェクト、「myVariable」が他の変数の値ということになります。このように、多種類のデータを混在させることはあまりありませんが、配列には複数の様々なデータが格納できるということを覚えておきましょう。

local myArray = { “アイテム１”, “アイテム２”, 10, workplace.Part, myVariable }

テーブルとは？

この章では、今から学ぶ「配列」と、もう１つ「辞書」と呼ばれるものを解説します。順番に格納されるのが配列で、順不同で保管場所に名称を付けて格納するのが辞書ということになります。この配列と辞書をまとめて、「テーブル」という呼ぶことがありますので覚えておきましょう。

話すキャラクターの作成

それでは早速、配列について学びます。
例として、NPC をクリックすると、配列に保存しているセリフを次々と表示するというプログラムを作成してみます。

プロジェクトの設定

あらかじめ作成してあるNPCモデルを使用して学習します。DialogueScript というスクリプトが入っていますが未完成です。まだセリフは発しません。

1. 既製の NPC をダウンロードします。こちらはNPCのモデルデータになります。

2. エクスプローラーで、Workspace を右クリックし、「Insert From File…（ファイルから挿入）」 をクリックして先ほどダウンロードしたファイルを選択します。

3. テスト実行してみましょう。NPCをクリックすると「This is dialogue!」というセリフを発すると思います。

dialogueArrayのコーディング

キャラクターが発するすべてのセリフは、個々の文字列として配列に格納します。NPCをクリックすると、フレーズを表示する吹き出しが表示されます。

1. Explorerで、NPC を展開し、DialogueScript を開きます。

2. 「local dialogArray = {}」 と入力してください。これで何も入っていない空の配列ができました。

local Chat = game:GetService("Chat")

local npc = script.Parent
local characterParts = npc.CharacterParts
local head = characterParts.Head
local clickDetector = npc.ClickDetector

--Add table below
local dialogueArray= {}

local function speak()
    local dialogue = "This is dialogue!"
    Chat:Chat(head, dialogue)
end

clickDetector.MouseClick:Connect(speak)

3. 今作成した配列の中括弧の間に、カンマで区切られた少なくとも 3 つのセリフを文字列で入力します。

local dialogueArray = { "Hi!", "Do I know you?", "Good bye!" }

配列の内容を取得する

配列を作成したところで、その中に入れた個々の値を取得したいと思います。
この表のように「Hi!」は１番目、「Do I know you?」は２番目、「Good bye!」は３番目になります。この番号をインデックス（要素番号）と呼びます。今回の例では、「Hi!」はインデックス 1 で、「Good bye!」はインデックス 3ということになります。

インデックス	値
1	Hi!
2	Do I know you?
3	Good bye!

他のプログラミング言語では、インデックスが０から始まるものもありますが、Lha は１から始まります。

セリフの取得

配列から値を取得するには、このインデックスを使用します。dialogArray[1] のように、配列名の後ろに角カッコを付け、その中で取得したいインデックス番号を指定します。

1. 「local dialogue = dialogueArray[2]」としてみましょう。インデックス２の文字列を取得するという意味です。

local dialogueArray= { "Hi!", "Do I know you?", "Good bye!" }

local function speak()
    local dialogue = dialogueArray[2]
    Chat:Chat(head, dialogue)
end

インデックスが存在しない場合は、nil エラーが発生します。今回の例では配列の中身は３つです。よってdialogueArray[4] と、インデックス４で値を取得しようとするとエラーが発生するということです。

2. プロジェクトを再生し、NPC をクリックして「Do I know you?」と表示されると思います。コードを変更して、他のインデックスもテストしてみてください。

配列と変数

コードをより柔軟にするために、インデックス番号の代わりに変数が使用できます。たとえば、変数を使用してランダムなインデックス番号を取得したり、関数が呼び出されるたびに値を増やして配列内の次の値を取得したりできます。

セリフの変更

現在、プレイヤーがNPCと対話するときは、いつも同じセリフを言います。セリフをより動的にするために、変数を使って現在のインデックスを追跡し、プレーヤーが対話するたびに、その変数を操作して次のセリフを話すようにしたいと思います。

1. 現在のインデックスを追跡するには、dialogIndex という名前の新しい変数を追加します。配列のインデックスは１から始まりますので変数に１を代入しておきます。

local dialogueArray= { "Hi!", "Do I know you?", "Good bye!" }
local dialogueIndex = 1

2. speak()で、dialogArray[2] の部分の２を、dialogueIndex に置き換えます。現在、dialogueIndex には１が入っていますので、dialogArray[1] とするのと同じ意味になります。

 local function speak()
     local dialogue = dialogueArray[dialogueIndex]
     Chat:Chat(head, dialogue)
 end

3. 関数の最後で、dialogIndex に 1 を加算します。そうすれば、次に speak() が呼び出されたときに、配列内の次の文字列が表示されます。

 local function speak()
     local dialogue = dialogueArray[dialogueIndex]
     Chat:Chat(head, dialogue)

     dialogueIndex = dialogueIndex + 1
 end

4. NPC をクリックし、セリフの変化を確認してください。

最後のセリフ「Good bye!」を発したあと、再度NPCをクリックすると、出力ウィンドウにエラーが表示されると思います。

プログラムを修正して、「Good bye!」を表示した後に再び最初のセリフを話すようにしたいと思います。

配列サイズ

今回は３つのセリフなので、加算したインデックスが４になったら１に戻すという処理を加えれば完成となりますが、セリフはたくさん追加したいものです。数が多くなるとセリフの数を数えるのも大変になります。そこで、配列のサイズを簡単に取得する方法を教えます。
配列名の前にスペースを入れずに「#」と指定すれば、それは配列の要素数になります。

例: #dialogArray

これを使用すれば、配列にセリフをたくさん追加しても、条件式の数字を変更する必要はなくなります。

対話の再開

最初のセリフに戻すには、dialogIndex の値が、配列の最後のインデックスになっているかどうかを調べ、最初に戻るかどうかを判断すれば良いわけです。if/else ステートメントを使用すれば簡単です。

1. dialogIndex が #dialogueArray (この配列の合計サイズ) と等しいかどうかを確認するため、if ステートメントを追加します。もし、dialogIndex が最後のインデックスだった場合は、dialogIndex に1 を代入し、最初のセリフに戻します。

local function speak()
    local dialogue = dialogueArray[dialogueIndex]
    Chat:Chat(head, dialogue)

    if dialogueIndex == #dialogueArray then
        dialogueIndex = 1
    end

    dialogueIndex = dialogueIndex + 1
 end

2. ２．１に戻した後、さらに dialogIndex に１を加算してしまうと２になってしまいます。また、インデックスが最後にない場合は dialogIndex に１を追加する必要があります。
   else ステートメントを追加すれば完成です。

local function speak()
    local dialogue = dialogueArray[dialogueIndex]
    Chat:Chat(head, dialogue)

    if dialogueIndex == #dialogueArray then
       dialogueIndex = 1
    else
       dialogueIndex = dialogueIndex + 1
    end
 end

3. プロジェクトを再生します。今度はエラーにならず、最後の「Good bye!」を表示した後、最初の「Hi!」に戻るのが確認できると思います。

トラブルシューティング 

NPCが一連のダイアログを表示しない場合は、次の点を確認してください。

• dialogIndex が1 に戻されていることを if ステートメントで確認します。else ステートメントで、dialogIndex 変数に1 が加算されていることを確認します。
• 配列のサイズを取得するときは、 #dialogueArray の「#」の後にスペースがないことを確認してください。

チャレンジ

さらに学習したい方は、以下の課題に挑戦しましょう。

• NPC のダイアログが配列を逆方向に進むように変更してみます。dialogIndex は配列から開始し、加算する代わりに毎回減算する必要があります。
• セリフを順番に表示する代わりに、 Random.new()を使用して NPC に毎回ランダムなセリフを表示させます。このサンプルは下記のようになります。

local randomGenerator = Random.new()

-- NPCがクリックされるたびに新しいダイアログを表示します
local function speak()
   local randomIndex = randomGenerator:NextInteger(1, #dialogueArray)
   local dialogue = dialogueArray[randomIndex]
   Chat:Chat(head, dialogue)
end