🛑 특정 셀을 지정할 때 ‘행/열 키’를 사용할 경우, UseStringKey 함수를 먼저 호출해줘야 해요.
local MonsterSheet = Workspace.MonsterSheet
MonsterSheet:UseStringKey()
local GoblinDam = MonsterSheet.T["Goblin"]["Dam"] -- 40
-- UseSetingKey 함수를 호출해주지 않으면 Key로 데이터 가져올 수 없어요.
예시) Goblin - Dam 값 가져오기
(1) T 프로퍼티 사용
T 프로퍼티는 테이블 접근 편의를 위한 프로퍼티에요.
SpreadSheet.T[Row][Column] 구조를 사용해요.
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinDam = MonsterSheet.T[3][2] -- 40
--행/열 키 사용
SpreadSheet:UseStringKey()
local GoblinDam = SpreadSheet.T["Goblin"]["Dam"] -- 40
🛑 SpreadSheet.T[”RowKey”][”ColumnKey”] 구조에서는 Key로 사용하는 1행과 1열의 데이터는
가져올 수 없어요.
** Key를 이용해 1행 혹은 1열의 데이터를 가져올 경우에는 함수를 사용해주세요.
local SpreadSheet = Workspace.SpreadSheet
SpreadSheet:UseStringKey()
local a = SpreadSheet.T["Goblin"]["Name"] -- X
local b = SpreadSheet:GetStringData("Goblin", "Name") -- Goblin
(2) 함수 사용
Get__Data(Row, Column) 구조를 사용해요. ( * __에는 가져올 데이터의 타입이 들어가요. )
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinDam = MonsterSheet:GetNumberData(3, 2) -- 40
--행/열 키 사용
MonsterSheet:UseStringKey()
local GoblinDam = SpreadSheet:GetNumberData("Goblin", "Dam") -- 40
📜 SpreadSheet 함수 목록
함수명
설명
UseStringKey
데이터를 키 값으로 찾을 수 있도록 선언해줘요.
GetStringData
지정한 셀의 데이터를 String 타입으로 반환해요.
GetStringListData
지정한 셀의 데이터를 StringList 타입으로 반환해요.
GetNumberData
지정한 셀의 데이터를 Number 타입으로 반환해요.
GetNumberListData
지정한 셀의 데이터를 NumberList 타입으로 반환해요.
GetBoolData
지정한 셀의 데이터를 Bool 타입으로 반환해요.
GetRowCount
스프레드 시트의 행 개수를 반환해요.
GetColumnCount
스프레드 시트의 열 개수를 반환해요.
GetRow
지정한 행의 데이터를 Table 타입으로 반환해요.
GetColumn
지정한 열의 데이터를 Table 타입으로 반환해요.
| void UseStringKey()
데이터를 키 값으로 찾을 수 있도록 선언 해줘요.
local MonsterSheet = Workspace.MonsterSheet
MonsterSheet:UseStringKey()
local GoblinDam = MonsterSheet.T["Goblin"]["Dam"]
local GoblinDam = MonsterSheet:GetNumberData("Goblin", "Dam")
print(GoblinDam) -- 40
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinName = MonsterSheet:GetStringData(3, 1)
--행/열 키 사용
SpreadSheet:UseStringKey()
local GoblinName = MonsterSheet:GetStringData("Goblin", "Name")
print(GoblinName) -- Goblin
지정한 셀의 데이터를 StringList 타입으로 반환해요.** 구분문자는 쉼표( , ) 로, 쉼표를 기준으로 데이터를 나눠 테이블에 넣어요.
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinDesc = MonsterSheet:GetStringListData(3, 3)
--행/열 키 사용
MonsterSheet:UseStringKey()
local GoblinDesc = MonsterSheet:GetStringListData("Goblin", "Desc")
print(GoblinDesc[1], ", ", GoblinDesc[2]) -- 고블린 설명1, 고블린 설명2
| number GetNumberData(number Row, number Column)
| number GetNumberData(string RowKey, string ColumnKey)
지정한 셀의 데이터를 Number 타입으로 반환해요.
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinDam = MonsterSheet:GetNumberData(3, 2)
--행/열 키 사용
MonsterSheet:UseStringKey()
local GoblinDam = MonsterSheet:GetNumberData("Goblin", "Dam")
print(GoblinDam) -- 40
지정한 셀의 데이터를 NumberList 타입으로 반환해요.** 구분문자는 쉼표( , ) 로, 쉼표를 기준으로 데이터를 나눠 테이블에 넣어요.
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local GoblinWayIDList = MonsterSheet:GetNumberListData(3, 4)
--행/열 키 사용
MonsterSheet:UseStringKey()
local GoblinWayIDList = MonsterSheet:GetNumberListData("Goblin", "WayIDList")
print(GoblinWayIDList[1], ", ", GoblinWayIDList[2], ", ", GoblinWayIDList[3]) --1, 7, 3
지정한 셀의 데이터를 Bool 타입으로 반환해요.
** GetBoolData는 데이터 값이 1 일 때만 true를 반환해요.
local MonsterSheet = Workspace.MonsterSheet
--행/열 번호 사용
local OrcState1 = MonsterSheet:GetBoolData(2, 5)
local GoblinState1 = MonsterSheet:GetBoolData(3, 5)
--행/열 키 사용
SpreadSheet:UseStringKey()
local OrcState1 = MonsterSheet:GetBoolData("Orc", "State1")
local GoblinState1 = MonsterSheet:GetBoolData("Goblin", "State1")
print(OrcState1) -- true
print(GoblinState1) -- false
| number GetRowCount()
스프레드 시트의 행 개수를 반환해요.
local MonsterSheet = Workspace.MonsterSheet
local RowCount = MonsterSheet:GetRowCount()
print(RowCount) -- 5
| number GetColumnCount()
스프레드 시트의 열 개수를 반환해요.
local MonsterSheet = Workspace.MonsterSheet
local ColumnCount = MonsterSheet:GetColumnCount()
print(ColumnCount) -- 5
| Table GetRow(number Row)
지정한 행의 데이터를 Table 타입으로 반환해요.
local MonsterSheet = Workspace.MonsterSheet
local GoblinRowTable = MonsterSheet:GetRow(3) -- 3행의 데이터
local GoblinDam = GoblinRowTable[2] -- 3행의 2열 데이터
print(GoblinDam) -- 40
| Table GetColumn(number Column)
지정한 열의 데이터를 Table 타입으로 반환해요.
local MonsterSheet = Workspace.MonsterSheet
local DamColumnTable = MonsterSheet:GetColumn(2) -- 2열의 데이터
local GoblinDam = ColumnTable[3] -- 3행의 2열 데이터
print(GoblinDam) -- 40