Returns the internal numerical codes of the characters
`s[i], s[i+1], ..., s[j]`. The default value for `i` is 1; the default
value for `j` is `i`. These indices are corrected following the same rules
of function `Library.string.sub()`.


string.byte

Returns the internal numerical codes of the characters
`s[i], s[i+1], ..., s[j]`. The default value for `i` is 1; the default
value for `j` is `i`. These indices are corrected following the same rules
of function string.sub.


Receives zero or more integers and returns a string with length equal to
the number of arguments that has each character has the internal numerical
code equal to its corresponding argument.


string.char

Looks for the first match of pattern in the string `s`. If it finds a
match, then it returns the indices of `s` where the occurrence starts and
ends; otherwise, it returns nil. A third, optional numerical argument init
specifies where to start the search; its default value is 1 and can be
negative. A value of true as a fourth, optional argument plain turns off
the pattern matching facilities, so the function does a plain "find
substring" operation, with no characters in the pattern being considered
"magic". Note that if _plain_ is given, then _init_ must be given as well.


string.find

pattern

init

plain

Looks for the first match of pattern in the string `s` and returns the
indices of `s` where the occurrence starts and ends.


Returns a formatted version of its variable number of arguments following
the description given in its first argument, which must be a string.

You can convert variables into user-friendly strings of text using the
`Library.string.format()` function. The function requires the following
format:

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

#### Specifiers

The most important part of string formatting is the **specifiers**.

<table>
  <thead>
    <tr>
      <th>Specifier</th>
      <th>Accepts</th>
      <th>Outputs</th>
      <th>Example Output</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>c</code></td>
      <td>integer</td>
      <td></td>
      <td>3</td>
    </tr>
    <tr>
      <td><code>d</code> or <code>i</code></td>
      <td>integer</td>
      <td>Decimal representation.</td>
      <td> 321 </td>
    </tr>
    <tr>
      <td><code>e</code> or <code>E</code></td>
      <td>float</td>
      <td>Scientific notation using <code>e</code> or <code>E</code>.</td>
      <td>3.296e2<br>3.296E2</td>
    </tr>
    <tr>
      <td><code>f</code></td>
      <td>float</td>
      <td></td>
      <td>3231.1231</td>
    </tr>
    <tr>
      <td><code>g</code> or <code>G</code></td>
      <td>float</td>
      <td>The shorter of <code>e</code>/<code>E</code> and <code>f</code>.</td>
      <td>3E14<br>3e14</td>
    </tr>
    <tr>
      <td><code>o</code></td>
      <td>integer</td>
      <td>Octal representation.</td>
      <td>610</td>
    </tr>
    <tr>
      <td><code>q</code></td>
      <td>string</td>
      <td>String in a form suitable to be safely read back by the Lua interpreter. The string is written between double quotes and all double quotes, new lines, embedded zeros, and backslashes are correctly escaped.</td>
      <td>"print(\"Hi\")"</td>
    </tr>
    <tr>
      <td><code>s</code></td>
      <td>string</td>
      <td></td>
      <td>Hello world!</td>
    </tr>
    <tr>
      <td><code>u</code></td>
      <td>integer</td>
      <td>Decimal representation.</td>
      <td>3131</td>
    </tr>
    <tr>
      <td><code>x</code> or <code>X</code></td>
      <td>integer</td>
      <td>Hexadecimal representation.</td>
      <td>7fa<br>7FA</td>
    </tr>
    <tr>
      <td><code>*</code></td>
      <td>any</td>
      <td>Equivalent to <code>s</code> but accepts any variable by converting it to a string using <code>Global.LuaGlobals.tostring()</code>.</td>
      <td>table: 0x0123456789abcdef</td>
    </tr>
    <tr>
      <td><code>%</code></td>
      <td></td>
      <td><code>%</code> followed by another <code>%</code> will return the <code>%</code> sign itself.</td>
      <td>%</td>
    </tr>
  </tbody>
</table>

```
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"))
--[[ Output:
Skip to
a new line and
another new line!
]]
```

#### Flags

<table>
<thead>
  <tr>
    <th>Flag</th>
    <th>Description</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>-</code></td>
    <td>Left-justify the given field width (see <code>Width</code> below). Right justification is the default.</td>
  </tr>
  <tr>
    <td><code>+</code></td>
    <td>Forces a "+" sign to precede a number. Has no effect on negative numbers.</td>
  </tr>
  <tr>
    <td>(space)</td>
    <td>One blank space is inserted before a positive number, while negative numbers are unaffected. This is useful for making positive and negative numbers vertically align in a visual stacked list.</td>
  </tr>
  <tr>
    <td><code>#</code></td>
    <td>When used with <code>o</code> and <code>x</code>/<code>X</code>, writes a 0 (octal) or 0x/0X (hex) before values other than zero.<br>When used with <code>e</code>/<code>E</code> and <code>f</code>, forces the output to contain a decimal point, even if no digits would follow (by default, no decimal point is written if no digits follow).<br>When used with <code>g</code> or <code>G</code>, the result is the same as with <code>e</code> or <code>E</code> but trailing zeros are not removed.</td>
  </tr>
  <tr>
    <td><code>0</code></td>
    <td>Left-pads the number with zeros instead of empty spaces (see <code>Width</code> below).</td>
  </tr>
</tbody>
</table>

```lua
local str = "%-10d"
print(string.format(str, 300) .. "]")
-- 300       ]
-- There are 7 spaces between '300' and ']'

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))
-- There is a 100% chance of rain in Seattle today.
```

#### Width

<table>
  <thead>
    <tr>
      <th>Width</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>(number)</td>
      <td>Minimum number of characters to return. If the number of characters to be formatted is less than this number, the result is padded with blank spaces.</td>
    </tr>
  </tbody>
</table>

```lua
local str = "%012i"
print("Score: " .. string.format(str, 15000))
-- Output: Score: 000000015000
-- The output has 12 digits total, left-padded with zeros
```

#### Precision

The default precision is 1. If you give a period without a value, the
default is 0.

<table>
  <thead>
    <tr>
      <th>Precision</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>.</code>(number)</td>
      <td>For integer specifiers (<code>d</code>, <code>i</code>, <code>o</code>, <code>u</code>, <code>x</code>/<code>X</code>), precision specifies the minimum number of digits to be returned. If the value to be formatted is shorter than this number, the result is padded with leading zeros. A precision of 0 means that no character is written for the value 0.<br>For <code>e</code>/<code>E</code> and <code>f</code> specifiers, this is the number of digits to be printed after the decimal point.<br>For <code>g</code>/<code>G</code> specifiers, this is the maximum number of digits (before the <code>e</code>/<code>E</code>, if present).<br>For <code>s</code>, this is the maximum number of characters to be returned.<br>For <code>c</code> and <code>q</code>, this has no effect.</td>
    </tr>
  </tbody>
</table>

```lua
-- Add decimal with precision of 2 for a currency output
local str = "$%.2f"
print(string.format(str, 300)) -- Output: $300.00

-- Return first 6 letters of a string
local str = "%.6s"
print(string.format(str, "Robloxian")) -- Output: 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))
-- Output: Once upon a time, there was a dragon named Pi and it had 3.14159265 horns.
```


string.format

formatstring

Returns a formatted version of its variable number of arguments following
the description given in its first argument, which must be a string.


Returns an iterator function that returns the next captures from pattern
over the string `s` each time it's called.


string.gmatch

Short for global substitution. Returns a copy of `s` in which all (or the
first n, if given) occurrences of the pattern are substituted (replaced)
with the given `replacement`. The second value returned is the total
number of substitutions made.

The `replacement` can be one of several types, each used differently to
determine the actual string:

- string: The pattern is replaced with the string directly
- table: The string that matched the pattern is looked up in the table as
  a key, and the value (string) is what replaces it, if it exists.
- function: Called with the string that matched the pattern, should return
  the string to replace the matched pattern.

An optional final argument can be provided which specifies the maximum
number of substitutions to make (for example, stop after 2 replacements)

#### Various Examples

```lua
-- Simple replacement
string.gsub("I love tacos!", "tacos", "Roblox") --> I love Roblox! 1
-- Using a pattern (hint: %w+ matches whole words)
string.gsub("I like red!", "%w+", "word") --> word word word 3
-- Replacement table
string.gsub("I play Roblox.", "%w+", {I="Je", play="joue à"}) --> Je joue à Roblox. 3
-- Replacement function
string.gsub("I have 2 cats.", "%d+", function (n) return tonumber(n) * 12 end) --> I have 24 cats. 1
-- Replace only twice
string.gsub("aaa", "a", "b", 2) --> "bba", 2
```


string.gsub

The string whose occurrences of the given pattern shall be replaced.


replacement

Determines what should replace the occurrence(s) of the given pattern.


replacements

The maximum number of substitutions to make.


Returns a copy of `s` in which all or the first `n` occurrences of the
pattern are replaced with the given replacement. The second value returned
is the total number of substitutions made.


string.len

Returns a copy of a string with all uppercase letters changed to
lowercase.


string.lower

Looks for the first match of pattern in the string `s`. If a match is
found, it is returned; otherwise, it returns nil. A third, optional
numerical argument, init, specifies where to start the search; its default
value is 1 and can be negative.


string.match

Looks for the first match of pattern in the string `s`. If a match is
found, it is returned; otherwise, it returns nil. A third, optional
numerical argument, init, specifies where to start the search.


Returns a binary string containing the provided arguments. The first
argument, `format`, determines the way the remaining arguments are packed;
see [here](https://www.lua.org/manual/5.3/manual.html#6.4.2) for options.


string.pack

format

Returns a binary string containing the provided arguments.


Returns the size in bytes of any string packed with a given description.
The sole argument, `format`, determines the way the remaining arguments
are packed, but you cannot use `s` and `z` because they have variable
lengths. See [here](https://www.lua.org/manual/5.3/manual.html#6.4.2) for
options.


string.packsize

Returns the size in bytes of any string packed with a given description.


Returns a string that is the concatenation of `n` copies of the string
`s`.


string.rep

Returns a string that is the string `s` reversed.


string.reverse

Splits a string into parts based on the defined separator character(s),
returning a table of ordered results.

If an empty "slice" is located, that part will be returned as an empty
string. For instance `string.split("abc||def", "|")` will return a table
with three strings: `"abc"`, `""`, and `"def"`.

```lua
local values = input:split(",")
print(values[1], values[2], values[3])
```

Also note that whitespace from the original string will be preserved, for
example `string.split("abc _ def", "_")` will honor the whitespace on both
sides of the `_` separator. By default, the separator character is `,` but
you can specify an alternative character or series of characters.

**Corner Cases**

#### Empty String

```lua
"" --> ""
```

#### Empty Slices

```lua
"foo,,bar" --> "foo", "", "bar"
",foo" --> "", "foo"
"foo," --> "foo", ""
"," --> "", ""
",," --> "", "", ""
```

#### Whitespace Preserved

```lua
"   whitespace   " --> "   whitespace   "
"foo , bar" --> "foo ", " bar"
```

#### Invalid UTF-8

```lua
"\xFF" --> "\xFF"
"\xFD,\xFE" --> "\xFD", "\xFE"
```

#### Unicode

```lua
"，" --> U+FF0C FULLWIDTH COMMA
"我很高兴，你呢？" --> "我很高兴", "你呢？"
"•" --> U+2022 BULLET
"hello•world" --> "hello", "world"
```


string.split

separator

The separator character(s) to be used for splitting the string.


Splits a string into parts based on the defined separator character(s),
returning a table of ordered results.


Returns the substring of `s` that starts at `i` and continues until j. `i`
and `j` can be negative. `i` defaults to 1 and `j` defaults to `-1`.


string.sub

Extracts the values packed in the provided binary string based on the
first argument, `format`, which should match the one originally used to
`Library.string.pack|pack()` the string; see
[here](https://www.lua.org/manual/5.3/manual.html#6.4.2) for options. The
optional third parameter determines the byte at which the reading starts.


string.unpack

data

readStart

The values packed into the provided binary string, plus the index of
the first unread byte.


Extracts the values packed in the provided binary string.


Returns a copy of a string with all lowercase letters changed to
uppercase.


string.upper

string

Provides generic functions to manipulate strings.


An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Luau

Tuple

Variant

Data type having a value of either true or false.

bool

Functions are blocks of code that can execute multiple times on command.

function

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

Data type which can store multiple values of any non-nil type, including booleans, numbers, strings, functions, and other tables.

table

概要

ガイド

チュートリアル

リファレンス

リソース

アート

デザイン

エンジン

Avatar

クラウド

このフィールドはリソースの作成時に設定できますがその後のリクエストでは変更することはできません。

このフィールドはリクエスト上で提供されることはあるかもしれませんが、応答に入ることはありません。

各APIキー：各IPアドレスにつき {maxInPeriod} 回のリクエストが {periodInSeconds} 秒ごとに送信されます

このフィールドは応答に設定できますが、リクエストでは無視されます。

このエンドポイントを呼び出すには以下のAPIキー権限が必要です。適切なキーの生成方法についての情報は、 [API キーの管理]({apiKeyReferenceDocLink}) をごらんください。

次のエンドポイントは、ベースのURLに相対するパスで使用できます。

この文字列は [Timestamp](/cloud/reference/types#fieldmask) としてフォーマットされています。

JSON 値は、 `null`、 `boolean`、 `string`、 `number`、 `array`、 `object` にはできません。

あなたのOAuth 2.0 アプリケーションでこのエンドポイントを使用するには以下の範囲が必要です。OAuth 2.0 アプリケーションの登録方法についての情報は、 [アプリ登録とレビュー]({oauth2ReferenceDocLink}) をごらんください。

以下のオブジェクトは、受け入れられたか返されたペイロードの説明です。これらのオブジェクトがいつ使用されるかについて詳しくは、各エンドポイントを参照してください。

この文字列は [Timestamp](/cloud/reference/types#timestamp) としてフォーマットされています。

これであなたのアセットについての情報を表示できるようになります。

これでRobloxにアセットをアップロードしたり、アップデートしたりできます。

これでクリエーターストアの製品に関する情報を表示できます。

これでクリエーターストアの製品に関する情報を変更できます。

これであなたのグループについての情報を表示できるようになります。

これでお持ちのアカウントのグループ参加リクエストを管理できるようになります。

これであなたの持ち物リストについての情報を表示できるようになります。

これでユーザーに代わってメッセージを公開する権限を与えることができます。

これでバーチャル空間からユーザーに通知を送信できるようになります

これであなたのバーチャル空間に関連した秘密をリストアップできるようになります。

これであなたのバーチャル空間に関連した秘密を作成してアップデートできるようになります。

プレース情報を読み取る能力を付与。

プレース情報を編集する能力を付与。

この操作によって、Robloxに新しいバージョンのバーチャル空間を公開するアクセス権限が与えられます。

バーチャル空間の情報を読む能力を付与。

バーチャル空間の情報を編集する能力を付与。

バーチャル空間内でのユーザー制限を表示できます。

バーチャル空間内でのユーザー制限が編集できるようになります。

ユーザーがプレミアム会員がどうかと認証済みかどうかを読み取る権限を付与。

これでユーザーのSNSアカウントを表示できるようになります。

これはシングルサインオン機能を有効化

これにより、あなたのプロフィール情報を読む権限が与えられます

デフォルト値: {defaultValueStart}{defaultValueEnd}

配列は順番に並べてある値のリストです。配列はデータの集まりを保存するのに便利です。

キーと値のペアのセットで、キーは任意の番号、文字列、またはオブジェクトにできます。

{tuples} のような数値のリスト。

この関数は可能であればすぐに返しますが、値を返すまで呼び出したスレッドを返すことができます。

Robloxは現在、 {nameStart}名前{nameEnd} への対応と管理をしていません。

Robloxは現在、 この演算への対応と管理をしていません。

このメンバーはオブジェクトブラウザに表示されず、広く使用されることを意図していません。

このメンバーはコマンドバーからしかアクセスできません。スクリプトからこのメンバーにアクセスしようとするとエラーが発生します。

この関数は、それを呼び出したLuaスレッドを一時停止できません。

スクリプト内でこのメンバーにアクセスしようとするとエラーが発生します。Roblox Studio のプロパティ ウィンドウからこのメンバーにアクセスできる可能性があります。

このメンバーはRoblox Studioのオブジェクトブラウザには表示されません。

Instance.new コンストラクタを使用してこのクラスのインスタンスを作成できません。

Robloxは、このメンバーをサーバーとクライアント間の境界を超えて複製しません。

Luaコードはこのメンバーにアクセスできません。Roblox Studioのプロパティウィンドウから値を変更できるかもしれません。

このオブジェクトのレプリケーション動作は、所有しているプレイヤーによって異なります。

このメンバーはコマンドバーとプラグインからしかアクセスできません。スクリプトからこのメンバーにアクセスしようとするとエラーが発生します。

このプロパティは読み取り専用で、同期されていないスレッドでも安全に読み取りできます。書き込みを試みるとエラーが発生します。

このメンバーは読み取り専用です。このメンバーに書き込みを試みるとエラーが発生します。

このメンバーは CoreScript でしかアクセスできません。

Roblox CoreScripts のみがこのメンバーにアクセスでき、Players は使用できません。

複数のスレッドから安全にこのプロパティの読み取りと書き込みができます。

このクラスはトップレベルのシングルトンです。GetService 関数でこのクラスのインスタンスを回収します。

複数のスレッドがこのプロパティに書き込める可能性があるため、同期されていないスレッドから読み取るのは安全ではありません。

この関数は、結果を返すまで呼び出した Lua スレッドを一時停止します。他のスクリプトを中断することはありません。

包括的なガイドとコードサンプル、資料、チュートリアルを使ってRobloxで業績を上げるコンテンツを制作する方法を学びましょう。


{pageTitle} | {SiteName}

題名

持ち物リストに追加できません

{title} のコードサンプルが持ち物リストに追加されました。

バージョン {versionNumber} には、一般的なパフォーマンスの改善とバグ修正が含まれています。具体的な改善やバグの状況については、他のリリースノートをご確認ください。

私的な情報や個人情報を入れないでください。最大 {maxDescriptionLength} 文字まで。

詳細には最低 {minDescriptionLength} 語句が必要です。

Roblox Studio バージョン {versionNumber} のリリースノート

メンテナンス中のため、大変ご不便をおかけいたしますが、しばらくの間ご利用いただけません。

「続ける」をクリックすると、 {redirectLinkStart}{redirectLinkEnd} に飛びます

このサイトは、Robloxが所有や管理をしているものではありません。違う利用規約やプライバシーポリシーがあるかもしれません。

string

概要

関数

関数

byte

パラメータ

戻り値

char

パラメータ

戻り値

find

パラメータ

戻り値

format

パラメータ

戻り値

gmatch

パラメータ

戻り値

gsub

パラメータ

戻り値

len

パラメータ

戻り値

lower

パラメータ

戻り値

match

パラメータ

戻り値

pack

パラメータ

戻り値

packsize

パラメータ

戻り値

rep

パラメータ

戻り値

reverse

パラメータ

戻り値

split

パラメータ

戻り値

sub

パラメータ

戻り値

unpack

パラメータ

戻り値

upper

パラメータ

戻り値