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

Vista general

Guías

Tutoriales

Referencia

Recursos

Arte

Diseño

Motor

Avatar

Nube

Este campo se puede establecer al crear un recurso, pero no se puede modificar por solicitudes posteriores.

Este campo se puede proporcionar en las solicitudes, pero nunca se incluirá en las respuestas.

Por clave API: {maxInPeriod} solicitudes cada {periodInSeconds} segundos por dirección IP

Este campo se puede configurar como respuestas, pero se ignorará en las solicitudes.

Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta [Gestionar claves API]({apiKeyReferenceDocLink}).

Los siguientes extremos están disponibles en rutas relativas a la URL base.

Esta cadena está formateada como [Timestamp](/cloud/reference/types#timestamp).

Un valor JSON puede ser `null`, `boolean`, `string`, `number`, `array`, u `object`.

Los siguientes ámbitos son necesarios para que tu aplicación OAuth 2.0 use este extremo. Para obtener más información sobre cómo registrar una aplicación de OAuth 2.0, consulta [Registro y revisión de aplicaciones]({oauth2ReferenceDocLink}).

Los siguientes objetos describen cargas que son aceptadas o devueltas. Ve cada extremo para más información sobre cuándo se utilizan estos objetos.

Esto permite ver información sobre tus recursos.

Esto permite cargar y actualizar recursos a Roblox.

Esto te permite ver información sobre tus productos de la Tienda de creadores.

Esto te permite modificar la información sobre tus productos de la Tienda de creadores.

Esto permite ver información sobre tus grupos.

Esto te permite gestionar las solicitudes de unión a grupo para tu cuenta.

Esto permite ver información sobre tu inventario.

Esta acción permite publicar mensajes en nombre de los usuarios.

Esto permite enviar notificaciones de tu experiencia a los usuarios

Esto permite enumerar los secretos asociados a tu experiencia.

Esto permite crear y actualizar secretos asociados a tu experiencia.

Permite leer información sobre el lugar.

Permite editar información sobre el lugar.

Esta operación permite el acceso a la publicación de nuevas versiones de experiencias en Roblox.

Permite leer información sobre la experiencia.

Permite editar información sobre la experiencia.

Te permite ver las restricciones de usuario en la experiencia.

Te permite editar las restricciones de usuario en la experiencia.

Permite leer el estado Premium y verificado del usuario.

Esto te permite ver las cuentas sociales de un usuario.

Activa la funcionalidad de inicio de sesión único

Da acceso a leer la información de tu perfil

Valor predeterminado: {defaultValueStart}{defaultValueEnd}

Una matriz es una lista ordenada de valores. Las matrices son útiles para almacenar colecciones de datos.

Un conjunto de pares clave-valor, donde las claves pueden ser cualquier número, cadena u objeto.

Esta función devuelve inmediatamente si es posible, pero puede producir el hilo que la llamó hasta que devuelva un valor.

Roblox ya no soporta o mantiene {nameStart}nombre{nameEnd}

Esta operación matemática ya no es soportada o mantenida por Roblox.

Este miembro no aparece en el navegador de objetos y no está destinado a un uso generalizado.

Solo se puede acceder a este miembro a través de la barra de comandos y de los plugins. Se producirá un error si se intenta acceder a través de los scripts.

Esta función no puede pausar el hilo de Lua que la llamó.

Se producirá un error al intentar acceder a este miembro a través de los scripts. Es posible acceder a él desde la ventana de propiedades de Roblox Studio.

Este miembro no aparece en el navegador de objetos de Roblox Studio.

No se puede crear una instancia de esta clase con el constructor Instance.new.

Roblox no replica este miembro a través de su límite entre servidor y cliente.

El código Lua no puede acceder a este miembro. Puedes cambiar su valor desde la ventana de propiedades en Roblox Studio.

El comportamiento de replicación de este objeto depende del jugador que lo posee.

Esta propiedad es de solo lectura y es segura para leer en hilos no sincronizados. Escribir en ella producirá un error.

Esta propiedad es de solo lectura y es seguro leerla en hilos no sincronizados. Se producirá un error al intentar escribir en ella.

Este miembro es de solo lectura. Se producirá un error al intentar escribir a este miembro.

Se puede acceder a este miembro solo en CoreScripts.

Solo Roblox CoreScripts puede acceder a este miembro y no se puede utilizar por los Jugadores.

Puedes leer y escribir en esta propiedad de forma segura desde múltiples hilos.

Esta clase es un singleton de nivel superior. Recupera una instancia de esta clase con la función GetService.

Múltiples hilos pueden escribir en esta propiedad, por lo que no es seguro leerla desde hilos no sincronizados.

Esta función pausa el hilo Lua que la llamó hasta que devuelva un resultado. Esta acción no interrumpe otros scripts.

Aprende cómo crear contenidos exitosos en Roblox con guías integrales, muestras de código, referencias y tutoriales.


{pageTitle} | {SiteName}

título

No se puede añadir al inventario

La muestra de código {title} se añadió a tu inventario.

La versión {versionNumber} incluye mejoras generales de rendimiento y correcciones de errores. Revisa nuestras otras notas de publicación para ver el estado de las mejoras y errores específicos.

No incluyas información personal o privada. Máximo de {maxDescriptionLength} palabras.

Se requiere un mínimo de {minDescriptionLength} palabras en la descripción.

Notas de lanzamiento para Roblox Studio versión {versionNumber}

Estamos trabajando en cosas aún más increíbles. Gracias por tu paciencia.

Al hacer clic en Continuar, se te dirigirá a {redirectLinkStart}{redirectLinkEnd}

Este sitio no es propiedad de Roblox, ni está gestionado por Roblox. Pueden tener diferentes términos y políticas de privacidad.

string

Resumen

Funciones

Funciones

byte

Parámetros

Devuelve

char

Parámetros

Devuelve

find

Parámetros

Devuelve

format

Parámetros

Devuelve

gmatch

Parámetros

Devuelve

gsub

Parámetros

Devuelve

len

Parámetros

Devuelve

lower

Parámetros

Devuelve

match

Parámetros

Devuelve

pack

Parámetros

Devuelve

packsize

Parámetros

Devuelve

rep

Parámetros

Devuelve

reverse

Parámetros

Devuelve

split

Parámetros

Devuelve

sub

Parámetros

Devuelve

unpack

Parámetros

Devuelve

upper

Parámetros

Devuelve