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

Panoramica

Guide

Tutorial

Referenza

Risorse

Arte

Design

Motore

Avatar

Cloud

This field may be set when creating a resource, but may not be modified by subsequent requests.

This field may be provided in requests, but will never be included in responses.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

This field may be set on responses, but will be ignored in requests.

Per chiamare questo endpoint sono richiesti i seguenti permessi della chiave API. Per maggiori informazioni
sulla generazione delle chiavi corrette, vedere [Gestione delle chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Questo permette di visualizzare informazioni sui tuoi beni.

Questo permette di caricare e aggiornare gli asset su Roblox.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

Questo permette di vedere le informazioni sui tuoi Gruppi.

This allows you to manage group join requests for your account.

Ciò garantisce la possibilità di pubblicare messaggi per conto degli utenti.

This allows sending notifications from your experience to users

Questo permette di elencare i segreti associati alla tua esperienza.

Ciò consente di creare e aggiornare i segreti associati alla tua esperienza.

Grants the ability to read place information.

Grants the ability to edit place information.

Questa operazione consente di pubblicare nuove versioni di esperienze a Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Consente di visualizzare le restrizioni degli utenti nell'esperienza.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

Questo garantisce l'accesso alla lettura delle informazioni del tuo profilo

Valore predefinito: {defaultValueStart}{defaultValueEnd}

An array is an ordered list of values. Arrays are useful for storing collections of data.

A set of key-value pairs, where the keys can be any number, string, or object.

Questa funzione restituisce immediatamente, se possibile, ma può restituire il thread che lo ha chiamato fino a quando non può restituire un valore.

{nameStart}nome{nameEnd} non è più supportato o mantenuto da Roblox.

Questa operazione matematica non è più supportata o mantenuta da Roblox.

Questo membro non appare nel browser degli oggetti e non è destinato ad un uso diffuso.

Questo membro è accessibile solo tramite la barra dei comandi. Il tentativo di accedere a questo membro dagli script provoca un errore.

Questa funzione non può mettere in pausa il thread di Lua che l'ha chiamato.

Il tentativo di accedere a questo membro negli script causa un errore. Potresti essere in grado di accedere a questo membro dalla finestra delle proprietà di Roblox Studio.

Questo membro non appare nel browser degli oggetti di Roblox Studio.

Non è possibile creare un'istanza di questa classe con il Instance.new constructor.

Roblox non replica questo membro attraverso il suo confine server-client.

Il codice Lua non può accedere a questo membro. Potresti cambiare il suo valore dalla finestra di proprietà in Roblox Studio.

Il comportamento di replica di questo oggetto dipende dal giocatore che lo possiede.

Questo membro è accessibile solo attraverso la barra dei comandi e solo i plugin. Tentando di accedere a questo membro dagli script provoca un errore.

This property is read-only and is safe to read in unsynchronized threads. Attempting to write to it causes an error.

Questa proprietà è in sola lettura ed è sicura da leggere in thread non sincronizzati. Tentando di scriverci causa un errore.

Questo membro è in sola lettura. Tentando di scrivere a questo membro causa un errore.

Questo membro è accessibile solo in CoreScripts.

Solo Roblox CoreScripts può accedere a questo membro e non è utilizzabile dai giocatori.

È possibile leggere e scrivere a questa proprietà in modo sicuro da più thread.

Questa classe è un singleton di primo livello. Recupera un'istanza di questa classe con la funzione GetService.

Più thread possono potenzialmente scrivere su questa proprietà, quindi non è sicuro leggere da thread non sincronizzati.

You can read and write to this property safely from multiple threads.

Questa funzione interrompe il thread di Lua che lo chiamava fino a quando non restituisce un risultato. Questo non interrompe altri script.

Scopri come creare contenuti di successo su Roblox con guide complete, esempi di codice, riferimenti e tutorial.


{pageTitle} | {SiteName}

title

Impossibile aggiungere all'inventario

L'esempio di codice {title} è stato aggiunto al tuo inventario.

La versione {versionNumber} include miglioramenti generali delle prestazioni e correzioni di bug. Controlla le nostre altre note di rilascio per lo stato su miglioramenti specifici e bug.

Si prega di non includere informazioni private o personali. Massimo {maxDescriptionLength} parole.

Minimo {minDescriptionLength} parole richieste nella descrizione.

Note di rilascio per la versione Roblox Studio {versionNumber}

Stiamo rendendo tutto più fantastico. Grazie per la tua pazienza.

Cliccando su "Continua", sarai indirizzato a {redirectLinkStart}{redirectLinkEnd}

Questo sito non è di o gestito da Roblox. Possono avere termini e privacy policy diversi.

string

Sommario

Funzioni

Funzioni

byte

Parametri

Restituzioni

char

Parametri

Restituzioni

find

Parametri

Restituzioni

format

Parametri

Restituzioni

gmatch

Parametri

Restituzioni

gsub

Parametri

Restituzioni

len

Parametri

Restituzioni

lower

Parametri

Restituzioni

match

Parametri

Restituzioni

pack

Parametri

Restituzioni

packsize

Parametri

Restituzioni

rep

Parametri

Restituzioni

reverse

Parametri

Restituzioni

split

Parametri

Restituzioni

sub

Parametri

Restituzioni

unpack

Parametri

Restituzioni

upper

Parametri

Restituzioni