문자열 라이브러리는 부분 문자열을 추출하거나 패턴을 일치시키는 등의 문자열을 조작하는 일반적인 기능을 제공합니다. 전역 `Library.string` 라이브러리를 통해 문자열 라이브러리에 접근할 수 있습니다.

`Library.string.match()`, `Library.string.gmatch()`, 및 `Library.string.gsub()` 사용에 대한 세부정보는
[String pattern reference](/luau/strings#string-pattern-reference)를 참조하십시오.

문자열 `s[i], s[i+1], ..., s[j]`의 내부 숫자 코드를 반환합니다. `i`의 기본값은 1이고, `j`의 기본값은 `i`입니다. 이러한 인덱스는 함수 `Library.string.sub()`의 동일한 규칙에 따라 수정됩니다.

숫자 코드는 단일 바이트 문자 값(`0`-`255`)에 해당합니다. 이 함수는 지정된 범위의 각 문자에 대해 하나의 숫자를 반환하므로, 다중 문자 슬라이스에서 호출하면 여러 반환 값을 생성합니다. 해결된 범위가 비어 있으면(시작 인덱스가 조정 후 종료 인덱스보다 큰 경우) 값이 반환되지 않습니다.

```lua
-- 단일 문자
print(string.byte("A")) -- 65

-- 문자 범위
print(string.byte("hello", 1, 3)) -- 104 101 108

-- 음수 인덱스 (끝에서부터 계산)
print(string.byte("abc", -1)) -- 99 (문자 'c'의 바이트 값)

-- string.char와의 왕복
local a, b, c = string.byte("ABC", 1, 3)
print(string.char(a, b, c)) -- ABC
```


string.byte

바이트 값을 추출할 문자열입니다.


변환할 문자 범위의 시작 인덱스입니다.


변환할 문자 범위의 종료 인덱스입니다.


문자열 `s[i], s[i+1], ..., s[j]`의 내부 숫자 코드를 반환합니다. `i`의 기본값은 `1`이고, `j`의 기본값은 `i`입니다. 이러한 인덱스는 함수 string.sub의 동일한 규칙에 따라 수정됩니다.


0개 이상의 정수를 받아들이고, 각 문자가 해당 인수와 같은 내부 숫자 코드를 가지는 길이가 인수의 수와 같은 문자열을 반환합니다.

각 정수는 `[0, 255]` 범위 내에 있어야 하며, 이 범위를 벗어난 값은 오류를 발생시킵니다. 이는 `Library.string.byte()`의 역입니다.

```lua
-- 기본 사용법
print(string.char(72, 101, 108, 108, 111)) -- Hello

-- 단일 문자
print(string.char(65)) -- A

-- 바이트 값으로 구성 (예: null 바이트)
local s = string.char(0)
print(#s) -- 1

-- string.byte와의 왕복
local code = string.byte("Z")
print(string.char(code)) -- Z
```


string.char

각각 바이트 값을 나타내는 `[0, 255]` 범위 내의 0개 이상의 정수입니다.


0개 이상의 정수를 받아들여 각 문자가 해당하는 인수와 같은 내부 숫자 코드를 갖는 길이가 인수 개수와 같은 문자열을 반환합니다.

문자열에서 패턴의 첫 번째 발생을 검색하고 일치하는 시작 및 종료 인덱스를 반환합니다. 일치하는 항목이 없으면 `nil`을 반환합니다. 선택적 `init` 매개변수를 사용하여 검색을 시작할 위치를 지정할 수 있으며, 기본값은 `1`이고 음수일 수 있습니다. 선택적 `plain` 매개변수는 패턴 매칭을 끄고 일반적인 부분 문자열 검색을 수행합니다. `plain`을 사용하는 경우 `init`도 제공해야 합니다.

```lua
-- 예제 1: 기본 사용법
local s = "Hello, world!"
local pattern = "world"
local start_index, end_index = string.find(s, pattern)
print(start_index, end_index)  -- 출력: 8 12
```

```lua
-- 예제 2: init 매개변수 사용
local s = "Hello, world! Hello, Roblox!"
local pattern = "Hello"
local start_index, end_index = string.find(s, pattern, 10)
print(start_index, end_index)  -- 출력: 15 19
```

```lua
-- 예제 3: plain 매개변수 사용
local s = "Hello, world! (Hello)"
local pattern = "(Hello)"
local start_index, end_index = string.find(s, pattern, 1, true)
print(start_index, end_index)  -- 출력: 14 20
```

```lua
-- 예제 4: 패턴을 찾지 못한 경우
local s = "Hello, world!"
local pattern = "Roblox"
local start_index, end_index = string.find(s, pattern)
print(start_index, end_index)  -- 출력: nil
```


string.find

pattern

주어진 문자열에서 검색할 패턴입니다.

init

plain

true인 경우 패턴 매칭을 끄고 일반적인 부분 문자열 검색을 수행합니다.


문자열 `s`에서 패턴의 첫 번째 일치를 찾아 발생이 시작되고 끝나는 `s`의 인덱스를 반환합니다.

가변 개수의 인수를 첫 번째 인수에 주어진 설명에 따라 형식화된 버전을 반환합니다. 첫 번째 인수는 문자열이어야 합니다.

변수를 사용자 친화적인 문자열로 변환하려면 `Library.string.format()` 함수를 사용할 수 있습니다. 이 함수는 다음 형식을 요구합니다:

`%[flags][width].[precision][specifier]`.

#### 지정자

문자열 형식화에서 가장 중요한 부분은 **지정자**입니다.

<table>
  <thead>
    <tr>
      <th>지정자</th>
      <th>허용 값</th>
      <th>출력</th>
      <th>예제 출력</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>c</code></td>
      <td>정수</td>
      <td></td>
      <td><code>3</code></td>
    </tr>
    <tr>
      <td><code>d</code> 또는 <code>i</code></td>
      <td>정수</td>
      <td>십진수 표현.</td>
      <td><code>321</code></td>
    </tr>
    <tr>
      <td><code>e</code> 또는 <code>E</code></td>
      <td>부동 소수점</td>
      <td><code>e</code> 또는 <code>E</code>를 사용한 과학적 표기법.</td>
      <td><code>3.296e2</code><br><code>3.296E2</code></td>
    </tr>
    <tr>
      <td><code>f</code></td>
      <td>부동 소수점</td>
      <td></td>
      <td><code>3231.1231</code></td>
    </tr>
    <tr>
      <td><code>g</code> 또는 <code>G</code></td>
      <td>부동 소수점</td>
      <td><code>e</code>/<code>E</code>와 <code>f</code> 중 짧은 쪽.</td>
      <td><code>3E14</code><br><code>3e14</code></td>
    </tr>
    <tr>
      <td><code>o</code></td>
      <td>정수</td>
      <td>8진수 표현.</td>
      <td><code>610</code></td>
    </tr>
    <tr>
      <td><code>q</code></td>
      <td>문자열</td>
      <td>Luau 인터프리터가 안전하게 다시 읽을 수 있는 형태의 문자열. 문자열은 큰따옴표로 작성되며 모든 큰따옴표, 줄 바꿈, 내장된 0 및 백슬래시는 올바르게 이스케이프됩니다.</td>
      <td><code>"print(\"Hi\")"</code></td>
    </tr>
    <tr>
      <td><code>s</code></td>
      <td>문자열</td>
      <td></td>
      <td><code>Hello world!</code></td>
    </tr>
    <tr>
      <td><code>u</code></td>
      <td>정수</td>
      <td>십진수 표현.</td>
      <td><code>3131</code></td>
    </tr>
    <tr>
      <td><code>x</code> 또는 <code>X</code></td>
      <td>정수</td>
      <td>16진수 표현.</td>
      <td><code>7fa</code><br><code>7FA</code></td>
    </tr>
    <tr>
      <td><code>*</code></td>
      <td>임의의</td>
      <td><code>s</code>와 동일하지만 <code>Global.LuaGlobals.tostring()</code>를 사용하여 문자열로 변환하여 모든 변수를 허용합니다.</td>
      <td><code>table: 0x0123456789abcdef</code></td>
    </tr>
    <tr>
      <td><code>%</code></td>
      <td></td>
      <td><code>%</code> 다음에 또 다른 <code>%</code>가 오면 <code>%</code> 기호 자체를 반환합니다.</td>
      <td><code>%</code></td>
    </tr>
  </tbody>
</table>

```lua
local str = "The magic word is %s"
print(string.format(str, "Roblox"))
-- The magic word is Roblox

local str = "The magic word is %q"
print(string.format(str, "Roblox"))
-- The magic word is "Roblox"

local str = "Skip to \na new line and \nanother new line!"
print(string.format(str, "%q"))
--[[ 출력:
Skip to
a new line and
another new line!
]]
```

#### 플래그

<table>
<thead>
  <tr>
    <th>플래그</th>
    <th>설명</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>-</code></td>
    <td>주어진 필드 너비를 왼쪽 정렬합니다(아래의 <b>너비</b> 참조). 기본값은 오른쪽 정렬입니다.</td>
  </tr>
  <tr>
    <td><code>+</code></td>
    <td>숫자 앞에 <code>+</code> 기호를 강제로 추가합니다. 음수에는 영향을 미치지 않습니다.</td>
  </tr>
  <tr>
    <td>(공백)</td>
    <td>양수 숫자 앞에 공백이 삽입되며, 음수 숫자는 영향을 받지 않습니다. 이는 양수와 음수 숫자가 시각적으로 정렬되도록 하는 데 유용합니다.</td>
  </tr>
  <tr>
    <td><code>#</code></td>
    <td><code>o</code> 및 <code>x</code>/<code>X</code>와 함께 사용하면 0이 아닌 값 앞에 <code>0</code>(8진수) 또는 <code>0x</code>/<code>0X</code>(16진수)를 씁니다.<br><code>e</code>/<code>E</code> 및 <code>f</code>와 함께 사용하면, 후속 숫자가 없더라도 소수점을 포함하도록 강제합니다(기본적으로 후속 숫자가 없으면 소수점이 작성되지 않습니다).<br><code>g</code> 또는 <code>G</code>와 함께 사용하면 결과는 <code>e</code> 또는 <code>E</code>와 동일하지만 후행 0은 제거되지 않습니다.</td>
  </tr>
  <tr>
    <td><code>0</code></td>
    <td>빈 공간 대신 숫자를 0으로 왼쪽 패딩합니다(아래의 <b>너비</b> 참조).</td>
  </tr>
</tbody>
</table>

```lua
local str = "%-10d"
print(string.format(str, 300) .. "]")
-- 300       ]
-- '300'과 ']' 사이에 7개의 공백이 있습니다.

local str = "%+i versus %+i"
print(string.format(str, 300, -300)) -- +300 versus -300

local str = "There is a% i%% chance of rain in Seattle today."
print(string.format(str, 100))
-- 오늘 시애틀에서 비가 올 확률은 100%입니다.
```

#### 너비

<table>
  <thead>
    <tr>
      <th>너비</th>
      <th>설명</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>(숫자)</td>
      <td>반환할 최소 문자 수입니다. 형식화할 문자의 수가 이 숫자보다 적으면 결과는 공백으로 패딩됩니다.</td>
    </tr>
  </tbody>
</table>

```lua
local str = "%012i"
print("Score: " .. string.format(str, 15000))
-- 출력: Score: 000000015000
-- 출력은 총 12자리이며, 0으로 왼쪽 패딩됩니다.
```

#### 정밀도

기본 정밀도는 <code>1</code>입니다. 값 없이 마침표를 주면 기본값은 <code>0</code>입니다.

<table>
  <thead>
    <tr>
      <th>정밀도</th>
      <th>설명</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>.</code>(숫자)</td>
      <td>정수 지정자(<code>d</code>, <code>i</code>, <code>o</code>, <code>u</code>, <code>x</code>/<code>X</code>)의 경우, 정밀도는 반환될 최소 자리 수를 지정합니다. 형식화할 값이 이 숫자보다 짧으면 결과는 선행 0으로 패딩됩니다. 정밀도 <code>0</code>은 값 <code>0</code>에 대해 문자가 작성되지 않음을 의미합니다.<br><code>e</code>/<code>E</code> 및 <code>f</code> 지정자의 경우, 이는 소수점 뒤에 인쇄될 자리 수입니다.<br><code>g</code>/<code>G</code> 지정자의 경우, 이는 최대 자리 수입니다(존재하는 경우 <code>e</code>/<code>E</code> 앞).
<br><code>s</code>의 경우, 이는 반환될 최대 문자 수입니다.<br><code>c</code> 및 <code>q</code>의 경우, 이는 영향을 미치지 않습니다.</td>
    </tr>
  </tbody>
</table>

```lua
-- 통화 출력을 위한 정밀도 2로 소수 추가
local str = "$%.2f"
print(string.format(str, 300)) -- 출력: $300.00

-- 문자열의 첫 6글자 반환
local str = "%.6s"
print(string.format(str, "Robloxian")) -- 출력: Roblox

local str = "Once upon a time, there was a dragon named %s and it had %.8f horns."
print(string.format(str, "Pi", math.pi))
-- 출력: Once upon a time, there was a dragon named Pi and it had 3.14159265 horns.
```


string.format

formatstring

후속 인수가 형식화되는 방식을 제어하는 형식 지정자가 포함된 문자열입니다.


형식 문자열의 지정자에 따라 형식화될 값입니다.


첫 번째 인수에 주어진 설명에 따라 가변 개수의 인수에 대한 형식화된 버전을 반환합니다. 첫 번째 인수는 문자열이어야 합니다.

각 호출 시 `s` 문자열에서 `pattern`의 다음 캡처를 반환하는 반복기 함수를 반환합니다. 패턴에 캡처가 없으면 각 호출 시 전체 일치가 반환됩니다.

반복기는 일반적으로 일반 `for` 루프에서 사용됩니다. 패턴에 캡처 그룹이 포함된 경우 각 호출은 캡처된 하위 문자열을 별도의 값으로 반환합니다. 빈 일치(제로 너비)는 무한 루프를 피하기 위해 현재 위치에서 한 문자만큼 진행합니다.

```lua
-- 문장에서 모든 단어 반복
for word in string.gmatch("Hello Roblox world", "%a+") do
    print(word)
end
-- Hello
-- Roblox
-- world

-- 캡처를 사용하여 키-값 쌍 추출
local t = {}
for key, value in string.gmatch("name=Roblox, version=1.0", "(%w+)=(%w[%w.]*)") do
    t[key] = value
end
print(t.name, t.version) -- Roblox 1.0

-- 모든 숫자 수집
local digits = {}
for d in string.gmatch("abc123def456", "%d+") do
    table.insert(digits, d)
end
print(table.concat(digits, ", ")) -- 123, 456
```


string.gmatch

패턴 일치를 검색할 문자열입니다.


문자열에 대해 반복적으로 일치할 패턴입니다.


패턴의 다음 캡처를 반환하는 반복자 함수를 반환합니다. `s` 문자열에 대해 호출할 때마다 호출됩니다.

전역 치환의 약자입니다. 패턴의 모든(또는 주어진 경우 첫 번째 `n`) 발생을 주어진 `replacement`로 대체한 `s`의 복사본을 반환합니다. 두 번째로 반환된 값은 수행된 총 치환 수입니다.

`replacement`는 여러 유형 중 하나일 수 있으며, 각 유형은 실제 문자열을 결정하는 데 다르게 사용됩니다:

- 문자열: 패턴이 문자열로 직접 대체됩니다.
- 테이블: 패턴과 일치하는 문자열이 테이블에서 키로 조회되며, 값(문자열)이 존재하는 경우 그것으로 대체됩니다.
- 함수: 패턴과 일치하는 문자열로 호출되며, 일치하는 패턴을 대체할 문자열을 반환해야 합니다.

선택적 최종 인수를 제공할 수 있으며, 이는 수행할 최대 치환 수를 지정합니다(예: 2회 대체 후 중지).

#### 다양한 예제

```lua
-- 기본 대체
string.gsub("I love tacos!", "tacos", "Roblox") --> I love Roblox! 1
-- 패턴으로 대체
string.gsub("I like red!", "%w+", "word") --> word word word! 3
-- 대체 테이블
string.gsub("I play Roblox.", "%w+", {I="Je", play="joue à"}) --> "Je joue à Roblox." 3
-- 대체 함수
string.gsub("I have 2 cats.", "%d+", function(n) return tonumber(n) * 12 end) --> "I have 24 cats." 1
-- 두 번만 대체
string.gsub("aaa", "a", "b", 2) --> "bba" 2
-- 캡처 그룹으로 대체(최대 아홉 개)
string.gsub("love2play Roblox", "(%w+)(%d+)(%w+)%s+(%w+)", "I %1 %2 %3 %4!") --> "I love 2 play Roblox!" 1
```


string.gsub

주어진 패턴의 발생을 대체할 문자열입니다.

replacement

주어진 패턴의 발생을 대체할 내용을 결정합니다.

replacements

`s`의 복사본을 반환하며, 여기서 주어진 대체 문자열로 패턴의 모든 또는 첫 번째 `n` 발생이 대체됩니다. 두 번째 반환값은 수행된 총 대체 수입니다.

문자열 `s`의 바이트 수를 반환합니다. Luau 문자열은 바이트 시퀀스이므로, 이는 유니코드 문자나 그래프렘 클러스터가 아닌 바이트를 계산합니다. 빈 문자열은 `0`을 반환합니다. 내장된 null 바이트(`\\0`)는 계산에 포함됩니다.

```lua
print(string.len("Hello")) -- 5
print(string.len(""))      -- 0

-- 내장된 null 바이트가 계산됩니다
local s = "ab\\0cd"
print(string.len(s)) -- 5

-- # 길이 연산자와 동등합니다
local str = "Roblox"
print(string.len(str) == #str) -- true
```


string.len

모든 대문자 ASCII 문자(`A`-`Z`)를 소문자(`a`-`z`)로 변경한 문자열 `s`의 복사본을 반환합니다. ASCII 문자 범위를 벗어난 문자, 즉 악센트가 있는 문자나 다중 바이트 문자는 변경되지 않습니다.

```lua
print(string.lower("HELLO")) -- hello
print(string.lower("Hello World!")) -- hello world!

-- 비문자 문자는 영향을 받지 않습니다
print(string.lower("Roblox 123!")) -- roblox 123!

-- 오직 ASCII 문자만 변환됩니다
print(string.lower("ABC abc")) -- abc abc
```


string.lower

소문자로 변환할 문자열입니다.


모든 대문자가 소문자로 변경된 문자열의 복사본을 반환합니다.

`s` 문자열에서 `pattern`의 첫 번째 일치를 찾습니다. 패턴에 캡처가 포함된 경우, 캡처된 하위 문자열이 별도의 값으로 반환됩니다. 그렇지 않으면 전체 일치가 반환됩니다. 일치하는 항목이 없으면 함수는 `nil`을 반환합니다.

선택적 세 번째 인수 `init`은 검색을 시작할 바이트 위치를 지정합니다(기본값 `1`). 음수 `init`은 문자열의 끝에서부터 계산합니다. `Library.string.find()`와 달리 이 함수는 일치 인덱스가 아닌 캡처된 값을 직접 반환합니다.

```lua
-- 일치하는 하위 문자열 추출
print(string.match("I have 42 cats", "%d+")) -- 42

-- 다중 캡처
local year, month, day = string.match("2024-03-15", "(%d+)-(%d+)-(%d+)")
print(year, month, day) -- 2024 03 15

-- 일치하지 않으면 nil 반환
print(string.match("hello", "%d+")) -- nil

-- init을 사용하여 건너뛰기
print(string.match("foo123bar456", "%d+", 7)) -- 456

-- 고정된 패턴
print(string.match("hello", "^%a+")) -- hello
```


string.match

문자열에 대해 일치할 패턴입니다.


검색을 시작할 바이트 위치입니다.


`s` 문자열에서 `pattern`의 첫 번째 일치를 찾습니다.


제공된 인수를 포함하는 이진 문자열을 반환합니다. 첫 번째 인수인 `format`은 나머지 인수가 포장되는 방식을 결정합니다.
자세한 내용은 [여기](https://www.lua.org/manual/5.3/manual.html#6.4.2)를 참조하십시오.

string.pack

format

패킹할 값의 레이아웃과 유형을 설명하는 형식 문자열입니다.


형식 문자열에 따라 이진 형태로 직렬화할 값입니다.


제공된 인수를 포함하는 이진 문자열을 반환합니다.

주어진 설명으로 포장된 문자열의 바이트 크기를 반환합니다. 유일한 인수인 `format`은 나머지 인수가 포장되는 방식을 결정하지만, 길이가 가변적인 `s`와 `z`는 사용할 수 없습니다.
자세한 내용은 [여기](https://www.lua.org/manual/5.3/manual.html#6.4.2)를 참조하십시오.

string.packsize

패킹 레이아웃을 설명하는 형식 문자열(가변 길이 옵션 `s` 또는 `z`를 포함해서는 안 됨)입니다.


주어진 설명으로 포장된 문자열의 바이트 크기를 반환합니다.

문자열 `s`의 `n` 복사본을 연결한 문자열을 반환합니다. `n`이 0 또는 음수인 경우 함수는 빈 문자열을 반환합니다. 결과 문자열이 최대 문자열 크기를 초과하면 오류가 발생합니다.

```lua
print(string.rep("ab", 3))  -- ababab
print(string.rep("Go! ", 2)) -- Go! Go!

-- 0 또는 음수 반복은 빈 문자열을 반환합니다
print(string.rep("x", 0))  -- (빈 문자열)
print(string.rep("x", -1)) -- (빈 문자열)

-- 패딩 또는 구분 기호에 유용합니다
local separator = string.rep("-", 20)
print(separator) -- --------------------
```


string.rep

문자열 `s`의 `n` 복사본을 연결하여 반환합니다.

문자열 `s`를 바이트 단위로 역순으로 한 문자열을 반환합니다. 역순은 개별 바이트에서 작동하므로, 다중 바이트 UTF-8 시퀀스는 역순 후 유효한 문자로 유지되지 않습니다.

```lua
print(string.reverse("hello"))  -- olleh
print(string.reverse("Roblox")) -- xolboR

-- 단일 문자 또는 빈 문자열
print(string.reverse("a")) -- a
print(string.reverse(""))  -- (빈 문자열)

-- 회문 확인
local function isPalindrome(s)
    local lower = string.lower(s)
    return lower == string.reverse(lower)
end
print(isPalindrome("racecar")) -- true
print(isPalindrome("hello"))   -- false
```


string.reverse

역순으로 변환할 문자열입니다.


문자열 `s`를 뒤집은 문자열을 반환합니다.

정의된 구분 기호를 기준으로 문자열을 부분으로 나누어 정렬된 결과의 테이블을 반환합니다.

빈 "슬라이스"가 발견되면 해당 부분은 빈 문자열로 반환됩니다. 예를 들어 `string.split("abc||def", "|")`는 세 개의 문자열을 포함하는 테이블을 반환합니다: `"abc"`, `""`, 및 `"def"`.

```lua
local input = "a,b,c"
local values = input:split(",")
print(values[1], values[2], values[3]) --> "a" "b" "c"
```
원래 문자열의 공백은 보존됩니다. 예를 들어 `string.split("abc _ def", "_")`는 `_` 구분 기호 양쪽의 공백을 존중합니다. 기본적으로 구분 기호는 `,`이지만 대체 문자 또는 문자 시퀀스를 지정할 수 있습니다.

**모서리 사례**

#### 빈 문자열

```lua
local result = string.split("", ",")
print(#result) --> 1
print(result[1]) --> ""
```

#### 빈 슬라이스

```lua
local result = string.split("foo,,bar", ",")
print(result[1], result[2], result[3]) --> "foo" "" "bar"

local result2 = string.split(",foo", ",")
print(result2[1], result2[2]) --> "" "foo"

local result3 = string.split("foo,", ",")
print(result3[1], result3[2]) --> "foo" ""

local result4 = string.split(",", ",")
print(result4[1], result4[2]) --> "" ""

local result5 = string.split(",,", ",")
print(result5[1], result5[2], result5[3]) --> "" "" ""
```

#### 공백 보존

```lua
local result = string.split("   whitespace   ", ",")
print(result[1]) --> "   whitespace   "

local result2 = string.split("foo , bar", ",")
print(result2[1], result2[2]) --> "foo " " bar"
```

#### 잘못된 UTF-8

```lua
local result = string.split("\\xFF", ",")
print(result[1]) --> "\\xFF"

local result = string.split("\\xFF,\\xFE", ",")
print(result[1], result[2]) --> "\\xFF" "\\xFE"
```

#### 유니코드

```lua
local result = string.split("我很高兴，你呢？", "，")
print(result[1], result[2]) --> "我很高兴" "你呢？"

local result2 = string.split("hello•world", "•")
print(result2[1], result2[2]) --> "hello" "world"
```

string.split

separator

문자열을 분할하는 데 사용할 구분 기호(character)입니다.

정의된 구분 기호(character) 기반으로 문자열을 여러 부분으로 나누어 정렬 결과 테이블을 반환합니다.

`s`의 부분 문자열을 반환하며, 바이트 위치 `i`에서 시작하여 바이트 위치 `j`까지 계속합니다. `i`와 `j`는 모두 음수일 수 있습니다: `-1`은 마지막 바이트를, `-2`는 끝에서 두 번째 바이트를 나타냅니다. `i`의 기본값은 `1`(시작)이고, `j`의 기본값은 `-1`(끝)입니다.

해결된 `i`가 `1`보다 작으면 `1`로 수정됩니다. `j`가 문자열 길이를 초과하면 문자열 길이로 수정됩니다. 이러한 수정 후 `i`가 `j`보다 크면 함수는 빈 문자열을 반환합니다.

```lua
local s = "Hello, world!"
print(string.sub(s, 1, 5))   -- Hello
print(string.sub(s, 8))      -- world!
print(string.sub(s, -6))     -- orld!
print(string.sub(s, -6, -2)) -- orld

-- 파일 확장자 추출
local filename = "script.lua"
local dot = string.find(filename, "%.")
print(string.sub(filename, dot + 1)) -- lua

-- 시작 > 종료 시 빈 결과
print(string.sub("abc", 3, 1)) -- (빈 문자열)
```


string.sub

부분 문자열을 추출할 원본 문자열입니다.


부분 문자열의 시작 바이트 위치(음수 값은 끝에서부터 계산됨)입니다.


부분 문자열의 종료 바이트 위치, 포함(음수 값은 끝에서부터 계산됨)입니다.


`s`의 부분 문자열을 반환하며, `i`에서 시작하여 `j`까지 계속합니다. `i`와 `j`는 음수일 수 있습니다. `i`의 기본값은 `1`이고, `j`의 기본값은 `-1`입니다.


제공된 이진 문자열에 패킹된 값을 추출합니다. 첫 번째 인수인 `format`은 원래 `Library.string.pack|pack()` 문자열을 사용하여 일치해야 합니다. 선택적 세 번째 매개변수는 독서가 시작되는 바이트를 지정합니다.

string.unpack

이진 데이터가 패킹된 방식을 설명하는 형식 문자열입니다.


data

값을 추출할 이진 문자열입니다.


readStart

`data`에서 읽기를 시작할 바이트 위치입니다.


제공된 이진 문자열에 패킹된 값과 첫 번째 읽지 않은 바이트의 인덱스입니다.

제공된 이진 문자열에 패킹된 값을 추출합니다.

모든 소문자 ASCII 문자(`a`-`z`)를 대문자(`A`-`Z`)로 변경한 문자열 `s`의 복사본을 반환합니다. ASCII 문자 범위를 벗어난 문자, 즉 악센트가 있는 문자나 다중 바이트 문자는 변경되지 않습니다.

```lua
print(string.upper("hello")) -- HELLO
print(string.upper("Hello World!")) -- HELLO WORLD!

-- 비문자 문자는 영향을 받지 않습니다
print(string.upper("roblox 123!")) -- ROBLOX 123!

-- 오직 ASCII 문자만 변환됩니다
print(string.upper("abc ABC")) -- ABC ABC
```


string.upper

대문자로 변환할 문자열입니다.


모든 소문자가 대문자로 변경된 문자열의 복사본을 반환합니다.

string

문자열을 조작하기 위한 일반적인 기능을 제공합니다.

특정 발생 시 연결된 함수를 실행하는 객체입니다.

Data Type

RBXScriptSignal

Luau

Tuple

Variant

true 또는 false 값을 갖는 데이터 유형.

boolean

함수는 명령에 따라 여러 번 실행할 수 있는 코드 블록입니다.

function

number

문자, 숫자 및 기호와 같은 문자 시퀀스입니다.

불린, 숫자, 문자열, 함수 및 기타 테이블을 포함하여 `nil`이 아닌 모든 유형의 여러 값을 저장할 수 있는 데이터 유형입니다.

table

체험

아바타

애셋

샘플 및 프로젝트

엔진 API

개방형 클라우드 API

Studio

애널리틱스

플랫폼

튜토리얼

크리에이터 프로그램

교육

학습

비동기적 방식으로, 현재 작업 상태를 나타내는 '작업'을 반환합니다. 여기에는 투표를 진행하여 실제 응답과 적용 가능한 메타데이터를 얻을 수 있는 엔드포인트 경로가 포함됩니다. 자세한 정보는 장기 작업에 관한 [설명서]({longRunningOperationsLink})에서 확인하세요.
            
아래 섹션은 작업 완료 시 제공되는 응답 및 메타데이터 개체에 대한 설명입니다.

베타 끝점이 공개적으로 사용될 준비가 되었습니다. 중대한 변경이 발생할 수 있지만 가능성은 낮습니다.

이 개방형 클라우드 설명서 페이지는 2026년 3월 31일부터 이용할 수 없게 됩니다. 이후에는 새로운 개방형 클라우드 설명서로 자동으로 리디렉션됩니다. {linkStart}자세히 알아보기{linkEnd}

이 기존 개방형 클라우드 페이지는 2026년 3월 31일부터 이용할 수 없게 되며, 새로운 페이지로 리디렉션됩니다. {linkStart}자세히 알아보기{linkEnd}

실험적인 엔드포인트는 공개적으로 사용할 수 있지만, API 계약이 확정되는 과정에서 간헐적으로 호환성이 깨지는 변경이 발생할 수 있습니다.

이 엔드포인트는 API 키를 사용하여 {httpServiceLinkStart}HttpService{httpServiceLinkEnd}를 통해 체험 내에서 호출할 수 있습니다.

이 필드는 리소스를 생성할 때 설정될 수 있지만 후속 요청에 의해 수정될 수는 없습니다.

이 필드는 요청에 제공될 수 있지만 응답에는 포함되지 않습니다.

레거시 인증 방식. 가능한 경우 언제나 API 키 또는 OAuth 2.0을 우선 사용합니다.

각 API 키별: IP 주소당 {periodInSeconds}초마다 {maxInPeriod} 요청

호출에 인증이 필요하지 않습니다. 일반적으로 호출 제한이 매우 낮습니다. 가능한 경우 언제나 API 키 또는 OAuth 2.0을 우선 사용합니다.

각 그룹화에 대해 스키마의 다음 필드 중 하나만 제공해야 하며 나머지는 제외할 수 있습니다.

언제든지 다시 참여할 수 있습니다. {linkStart}피드백을 남겨주세요.{linkEnd}

기존 문서를 보고 계십니다. {linkStart}피드백을 남겨주세요.{linkEnd}

언제든지 옵트아웃하고 이전의 참조 페이지로 리디렉션될 수 있습니다. {linkStart}피드백을 남겨 주세요.{linkEnd}

새롭게 개선된 문서를 보고 계십니다. {linkStart}피드백을 남겨주세요.{linkEnd}

이 필드는 응답에서 설정할 수 있지만 요청에서는 무시됩니다.

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. [속도 제한에 대해서 자세히 알아보세요]({link}).

사용자 또는 그룹의 모든 API 키에 일 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 시간당 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 분당 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 초당 요청 {limit}건

API 키 소유자당 분당 요청 {limit}건

앱 사용자당 시간당 요청 {limit}건

앱 사용자당 분당 요청 {limit}건

앱 사용자당 초당 요청 {limit}건

API 키 소유자당 초당 요청 {limit}건

범위는 내 자격 증명에 부여된 권한을 제어합니다. 내 자격 증명은 내가 선택한 범위가 지원하는 끝점만 액세스할 수 있습니다.

안정적인 엔드포인트는 프로덕션 환경에서 바로 사용할 준비가 되어 있으며 수명 주기 동안 호환성을 저해하는 변경이 발생할 가능성이 거의 없습니다.

이 대상은 선택한 {requiredParts}에 대한 내 키 액세스를 제한할 수 있게 해줍니다.

이 대상은 선택한 {requiredParts} 및 {optionalParts}에 대한 내 키 액세스를 제한할 수 있게 해줍니다.

대상 유형은 자격 증명에 권한이 있는 리소스를 제한하는 데 사용됩니다. 계정에 추가 리소스에 대한 권한이 있더라도 선택한 리소스만 이용할 수 있습니다. 일부 범위에는 대상 파트가 없으며, 이 경우 모든 관련 리소스를 이용할 수 있습니다.

사용자 소유 API 키에 대해서는 유니버스의 최상위 레벨 파트를 선택할 필요가 없습니다. 이 경우 API 키는 올바른 그룹 권한이 있는 모든 사용자 소유 체험과 그룹 소유 체험에 액세스할 수 있습니다.

이용해 보기는 아직 API 키 또는 OAuth 2.0 인증이 필요한 끝점에 지원되지 않습니다

안전을 위해 고위험 작업에선 쿠키 인증이 비활성화됩니다.

중요 위험 끝점은 극도로 민감하며 안전을 위해 이용해 보기는 비활성화됩니다

참고: 이 코드 샘플에는 인증 헤더가 포함되지 않습니다. 이 명령이 작동하려면 인증 헤더를 추가해야 할 수 있습니다.

중요 데이터를 수정하거나 삭제할 수 있는 고위험 끝점입니다. 테스트 시 매우 신중하게 이용하세요.

이 API 엔드포인트는 높은 위험으로 분류되었으며 라이브 데이터나 사용자 계정에 영향을 줄 수 있습니다.

높은 위험 API로의 인증된 요청은 되돌릴 수 없는 변경 사항을 초래할 수도 있습니다. 진행하기 전에 요청 매개변수를 신중하게 검토하세요.

쿠키 인증을 사용하려면 로그인하세요

데이터를 가져오는 저위험 끝점입니다. 일반적으로 테스트하기에 안전합니다.

데이터를 수정하는 중간 정도의 위험 끝점입니다. 변경 사항이 영구적으로 적용될 수 있으므로, 중요하지 않은 계정으로 신중하게 테스트하세요.

계정을 안전하게 보호하려면 다른 소스의 텍스트를 이곳에 붙여넣거나 이 페이지의 정보를 타인에게 전송하지 마세요.

실제 계정 자격 증명을 이용하여 실시간 API 끝점을 테스트하려고 합니다.

진행하려는 API 호출이 주는 영향을 이해한 경우에만 진행하세요. 테스트 전에 API 문서를 주의 깊게 읽어보시기 바랍니다.

API 호출은 인증된 세션을 이용해 진행됩니다

이는 실제 API 호출로, 회원님의 계정 또는 데이터에 영향을 줄 수 있습니다

비율 제한 및 기타 API 제한이 적용됩니다

일부 작업이 데이터를 수정하거나 삭제할 수 있습니다

이 끝점은 다음 추천 끝점으로 대체되었습니다.

이 엔드포인트를 호출하려면 다음 스코프가 필요합니다. 적절한 키 생성에 대한
자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

키 생성에 대한 자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

이 문자열은 [FieldMask](/cloud/reference/types#fieldmask) 형식으로 지정됩니다.

JSON 값은 `null`, `boolean`, `string`, `number`, `array`, `object`일 수 있습니다.

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 심사]({oauth2ReferenceDocLink})에서 확인하세요.

OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 검토]({oauth2ReferenceDocLink})에서 확인하세요.

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

이 끝점을 호출하려면 다음 스코프가 필요합니다.

리소스 경로

이 문자열은 [Timestamp](/cloud/reference/types#timestamp) 형식으로 지정됩니다.

권장되지 않음

개선된 개방형 클라우드 참조를 보고 있습니다.

새로운 오픈 클라우드 참조에서 옵트아웃했습니다.

광고 캠페인과 캠페인의 성과를 확인합니다.

광고 캠페인을 만들고, 업데이트하고, 관리합니다.

이를 통해 애셋에 대한 정보를 볼 수 있습니다.

이를 통해 애셋을 Roblox에 업로드하고 업데이트할 수 있습니다.

이는 나의 계정이 액세스할 수 있도록 주제(그룹 및 체험 포함)와 애셋에 애셋 권한을 볼 수 있도록 합니다.

이는 나의 계정이 액세스할 수 있는 모든 주체(그룹 및 체험 포함)와 애셋에 애셋 권한을 부여할 수 있도록 합니다.

이를 통해 사용자를 대신하여 아바타 자동 설정 작업의 상태와 결과를 볼 수 있습니다.

이를 통해 사용자를 대신하여 아바타 자동 설정 작업을 만들고 관리할 수 있습니다.

사용자가 소유한 배지를 업데이트할 수 있는 권한을 부여합니다.

이를 통해 커머스 아이템에 대한 정보를 볼 수 있습니다.

이를 통해 동기화된 커머스 아이템을 변경할 수 있습니다.

이를 통해 커머스 판매자 연결과 관련된 정보를 볼 수 있습니다.

이를 통해 커머스 판매자 연결을 편집할 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 수정할 수 있습니다.

이를 통해 크리에이터 상점 저장 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 저장 상품에 대한 정보를 수정할 수 있습니다.

나를 대신해 데이터 저장소를 생성할 권한을 부여합니다.

나를 대신해 데이터 저장소를 삭제할 수 있도록 권한을 부여합니다.

데이터 저장소의 목록을 읽을 권한을 부여합니다.

데이터 저장소의 스냅샷을 촬영할 권한을 부여합니다.

데이터 저장소에서 항목을 생성할 권한을 부여합니다.

지정된 항목을 삭제 대상으로 표시할 수 있는 권한을 부여합니다.

데이터 저장소 항목을 나열할 권한을 부여합니다.

데이터 저장소에서 지정된 항목을 읽을 권한을 부여합니다.

항목의 값, 특성, 사용자를 업데이트할 수 있는 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 삭제할 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 나열할 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 읽을 권한을 부여합니다.

승인한 사용자의 개발자 제품에 대한 구성 세부 정보를 볼 권한을 부여합니다.

승인한 사용자의 개발제 제품을 편집할 권한을 부여합니다.

이를 통해 유니버스의 환경을 볼 수 있습니다.

이를 통해 유니버스의 환경을 편집할 수 있습니다.

승인한 사용자의 게임 패스에 대한 구성 세부 정보를 볼 권한을 부여합니다.

승인한 사용자의 게임 패스를 편집할 권한을 부여합니다.

계정의 커뮤니티 포럼 정보를 볼 수 있도록 권한을 부여합니다.

계정의 커뮤니티 포럼 정보를 관리할 수 있는 권한을 부여합니다.

이를 통해 커뮤니티에 대한 정보를 볼 수 있습니다.

이를 통해 계정에 대한 커뮤니티 가입 요청과 등급이 낮은 커뮤니티 멤버의 역할 업데이트를 관리할 수 있습니다.

인스턴스의 속성 데이터를 조회하는 권한입니다.

인스턴스의 속성 데이터를 수정할 수 있는 권한입니다(현재는 스크립트만 지원됩니다).

이를 통해 인벤토리에 대한 정보를 볼 수 있습니다.

사용자 애셋을 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리하고 Robux를 사용할 수 있는 액세스 권한을 부여합니다.

승인한 사용자의 배지를 업데이트할 권한을 부여합니다.

내 개발자 상품을 관리할 수 있는 액세스 권한을 부여합니다.

알림을 설정 중인 체험의 정보를 읽을 수 있는 권한을 부여합니다.

나를 대신해 체험에 대한 알림을 켜거나 끌 수 있는 권한을 부여합니다.

내 패스를 관리할 수 있는 액세스 권한을 부여합니다.

내 커뮤니티를 관리할 수 있는 권한을 부여합니다.

커뮤니티 정보를 읽을 수 있는 권한을 부여합니다.

커뮤니티 관리 권한을 부여합니다.

내 로컬라이제이션 테이블을 읽고 쓸 수 있는 액세스 권한을 부여합니다

소유한 모든 체험의 팀 공동 작업을 관리할 수 있는 권한을 부여합니다.

체험 및 체험과 관련된 특정 정보를 관리할 자격을 부여합니다(예: 로컬라이제이션 정보).

내 체험의 로컬라이제이션 정보를 읽을 수 있는 액세스 권한을 부여합니다.

내 체험의 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

내 사용자 계정을 관리할 수 있는 권한을 부여합니다.

사용자 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

관련 플레이스의 상태, 로그, Luau 실행 작업의 결과를 조회할 수 있습니다.

관련 플레이스의 새로운 Luau 실행 작업을 생성할 수 있는 권한입니다.

유니버스 내 모든 데이터 구조를 비동기적으로 플러시할 수 있는 권한을 부여합니다.

신규 대기열 아이템을 생성할 권한을 부여합니다.

대기열 앞부분에서 읽은 아이템을 폐기할 수 있는 권한을 부여합니다.

대기열 앞부분에서 아이템을 읽을 수 있는 권한을 부여합니다.

메모리 저장소 아이템을 읽을 권한을 부여합니다.

맵 아이템을 읽는 권한을 부여합니다.

맵 아이템을 생성하고, 업데이트하고, 삭제하는 권한을 부여합니다.

사용자를 대신해 메시지를 게시할 수 있는 권한이 부여됩니다.

이를 통해 체험에서 사용자에게 알림을 보낼 수 있습니다.

(사용되지 않음) 정렬된 데이터 저장소에서 아이템 목록을 읽을 권한을 부여합니다.

(사용되지 않음) 정렬된 데이터 저장소에서 신규 항목을 생성할 권한을 부여합니다.

정렬된 데이터 저장소에서 아이템을 조회할 권한을 부여합니다.

정렬된 데이터 저장소에서 항목을 생성할 권한을 부여합니다.

이를 통해 체험과 관련된 보안 비밀을 나열할 수 있습니다.

이를 통해 체험과 관련된 보안 비밀을 생성하고 업데이트할 수 있습니다.

이 권한을 통해 평가 작업을 제출하고 결과를 조회할 수 있습니다.

구독 상품에 대해 읽을 수 있는 액세스 권한을 부여합니다.

이를 통해 사용자를 대신하여 썸네일 정보를 읽을 수 있습니다.

애널리틱스 알림을 읽을 수 있는 권한을 부여합니다.

애널리틱스 알림을 만들거나 수정할 수 있는 권한을 부여합니다.

게임 애널리틱스를 읽을 수 있는 권한을 부여합니다.

게임 애널리틱스와 관련된 리소스를 쓸 수 있는 권한을 부여합니다.

플레이스 정보를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 편집할 수 있는 권한을 부여합니다.

체험의 새로운 버전을 Roblox에 게시할 수 있는 권한을 부여합니다.

이를 통해 체험에 대한 섬네일 및 섬네일 개인화 설정을 읽을 수 있습니다.

이를 통해 체험에 대한 섬네일을 업로드 및 삭제하고 섬네일 개인화 설정을 관리할 수 있습니다.

체험 정보를 읽을 수 있는 권한을 부여합니다.

승인한 사용자의 체험을 편집할 권한을 부여합니다.

체험에서 사용자 제한을 볼 수 있습니다.

체험에서 사용자 제한을 편집할 수 있습니다.

계정으로 전송된 알림을 볼 수 있습니다.

승인한 사용자의 Premium 및 인증 상태를 읽을 수 있는 권한을 부여합니다.

이를 통해 승인한 사용자의 소셜 계정을 볼 수 있습니다.

게임 이벤트 확인 권한을 부여합니다.

게임 이벤트 편집 권한을 부여합니다.

이 작업은 싱글 사인온 기능을 활성화합니다.

프로필 정보를 읽을 수 있는 액세스 권한을 부여합니다.

요약