De stringbibliotheek biedt generieke functies om strings te manipuleren, zoals
het extraheren van substrings of het matchen van patronen. Je kunt toegang krijgen tot de stringbibliotheek via
de globale `Library.string` bibliotheek.

Zie
[String patroonreferentie](/luau/strings#string-pattern-reference)
voor details over het gebruik van `Library.string.match()`, `Library.string.gmatch()`, en
`Library.string.gsub()` om substrings te vinden (en te vervangen).


Geeft de interne numerieke codes van de karakters
`s[i], s[i+1], ..., s[j]` terug. De standaardwaarde voor `i` is 1; de standaard
waarde voor `j` is `i`. Deze indices worden gecorrigeerd volgens dezelfde regels
van de functie `Library.string.sub()`.

Numerieke codes komen overeen met single-byte karakterwaarden (`0`-`255`).
De functie retourneert één nummer per karakter in het opgegeven bereik, dus
het aanroepen ervan op een multi-character slice levert meerdere retourwaarden op. Als
toegestane bereik leeg is (startindex groter dan eindindex na
aanpassing), worden er geen waarden geretourneerd.

```lua
-- Enkel karakter
print(string.byte("A")) -- 65

-- Bereik van karakters
print(string.byte("hello", 1, 3)) -- 104 101 108

-- Negatieve indices (telt vanaf het einde)
print(string.byte("abc", -1)) -- 99 (de bytewaarde van 'c')

-- Roundtrip met string.char
local a, b, c = string.byte("ABC", 1, 3)
print(string.char(a, b, c)) -- ABC
```


string.byte

De string waaruit bytewaarden moeten worden geëxtraheerd.


De startindex van het bereik van karakters dat moet worden geconverteerd.


De eindindex van het bereik van karakters dat moet worden geconverteerd.


Geeft de interne numerieke codes van de karakters
`s[i], s[i+1], ..., s[j]` terug. De standaardwaarde voor `i` is `1`; de standaard
waarde voor `j` is `i`. Deze indices worden gecorrigeerd volgens dezelfde regels
van de functie string.sub.


Ontvangt nul of meer gehele getallen en retourneert een string met een lengte gelijk aan
to het aantal argumenten, waarin elk karakter de interne
numerieke code heeft die gelijk is aan het bijbehorende argument.

Elk geheel getal moet binnen het bereik `[0, 255]` liggen; waarden buiten dat bereik
veroorzaken een fout. Dit is de inverse van `Library.string.byte()`.

```lua
-- Basisgebruik
print(string.char(72, 101, 108, 108, 111)) -- Hallo

-- Enkel karakter
print(string.char(65)) -- A

-- Constructie vanuit bytewaarden (bijv. null byte)
local s = string.char(0)
print(#s) -- 1

-- Roundtrip met string.byte
local code = string.byte("Z")
print(string.char(code)) -- Z
```


string.char

Nul of meer gehele getallen in het bereik `[0, 255]`, elk vertegenwoordigt een
bytewaarde.


Ontvangt nul of meer gehele getallen en retourneert een string met een lengte gelijk aan
to het aantal argumenten, waarin elk karakter de interne
numerieke code heeft die gelijk is aan het bijbehorende argument.


Zoekt naar de eerste gebeurtenis van een patroon in een string en retourneert de
start- en eindindices van de match. Als er geen match wordt gevonden, retourneert het
`nil.` Je kunt specificeren waar je de zoekopdracht wilt starten met de optionele `init`
parameter die standaard op `1` staat en negatief kan zijn. Een optionele `plain`
parameter schakelt patroonmatching uit, zodat de functie een gewone
substring-zoekopdracht uitvoert; let op dat als je `plain` gebruikt, je ook `init`
moet opgeven.

```lua
-- Voorbeeld 1: Basisgebruik
local s = "Hallo, wereld!"
local pattern = "wereld"
local start_index, end_index = string.find(s, pattern)
print(start_index, end_index)  -- Uitvoer: 8 12
```

```lua
-- Voorbeeld 2: Gebruik van init-parameter
local s = "Hallo, wereld! Hallo, Roblox!"
local pattern = "Hallo"
local start_index, end_index = string.find(s, pattern, 10)
print(start_index, end_index)  -- Uitvoer: 15 19
```

```lua
-- Voorbeeld 3: Gebruik van plain-parameter
local s = "Hallo, wereld! (Hallo)"
local pattern = "(Hallo)"
local start_index, end_index = string.find(s, pattern, 1, true)
print(start_index, end_index)  -- Uitvoer: 14 20
```

```lua
-- Voorbeeld 4: Geen patroon gevonden
local s = "Hallo, wereld!"
local pattern = "Roblox"
local start_index, end_index = string.find(s, pattern)
print(start_index, end_index)  -- Uitvoer: nil
```


string.find

pattern

Het patroon waarnaar gezocht moet worden in de gegeven string.


init

plain

Als waar, schakelt patroonmatching uit en voert een gewone substring
zoekopdracht uit.


Zoekt naar de eerste match van het patroon in de string `s` en retourneert de
indices van `s` waar de gebeurtenis begint en eindigt.


Geeft een geformatteerde versie van zijn variabele aantal argumenten terug volgens
de beschrijving die in zijn eerste argument is gegeven, dat een string moet zijn.

Je kunt variabelen omzetten in gebruiksvriendelijke strings met de
`Library.string.format()` functie. De functie vereist het volgende
formaat:

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

#### Specifiers

Het belangrijkste deel van stringformattering zijn de **specifiers**.

<table>
  <thead>
    <tr>
      <th>Specifier</th>
      <th>Accepteert</th>
      <th>Geeft weer</th>
      <th>Voorbeelduitvoer</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>c</code></td>
      <td>geheel getal</td>
      <td></td>
      <td><code>3</code></td>
    </tr>
    <tr>
      <td><code>d</code> of <code>i</code></td>
      <td>geheel getal</td>
      <td>Decimale weergave.</td>
      <td><code>321</code></td>
    </tr>
    <tr>
      <td><code>e</code> of <code>E</code></td>
      <td>float</td>
      <td>Wetenschappelijke notatie met <code>e</code> of <code>E</code>.</td>
      <td><code>3.296e2</code><br><code>3.296E2</code></td>
    </tr>
    <tr>
      <td><code>f</code></td>
      <td>float</td>
      <td></td>
      <td><code>3231.1231</code></td>
    </tr>
    <tr>
      <td><code>g</code> of <code>G</code></td>
      <td>float</td>
      <td>De kortste van <code>e</code>/<code>E</code> en <code>f</code>.</td>
      <td><code>3E14</code><br><code>3e14</code></td>
    </tr>
    <tr>
      <td><code>o</code></td>
      <td>geheel getal</td>
      <td>Octale weergave.</td>
      <td><code>610</code></td>
    </tr>
    <tr>
      <td><code>q</code></td>
      <td>string</td>
      <td>String in een vorm die veilig kan worden teruggelezen door de Luau-interpreter. De string wordt tussen dubbele aanhalingstekens geschreven en alle dubbele aanhalingstekens, nieuwe regels, ingesloten nullen en backslashes worden correct ontsnapt.</td>
      <td><code>"print(\"Hi\")"</code></td>
    </tr>
    <tr>
      <td><code>s</code></td>
      <td>string</td>
      <td></td>
      <td><code>Hallo wereld!</code></td>
    </tr>
    <tr>
      <td><code>u</code></td>
      <td>geheel getal</td>
      <td>Decimale weergave.</td>
      <td><code>3131</code></td>
    </tr>
    <tr>
      <td><code>x</code> of <code>X</code></td>
      <td>geheel getal</td>
      <td>Hexadecimale weergave.</td>
      <td><code>7fa</code><br><code>7FA</code></td>
    </tr>
    <tr>
      <td><code>*</code></td>
      <td>elk</td>
      <td>Equivalent aan <code>s</code> maar accepteert elke variabele door deze om te zetten in een string met <code>Global.LuaGlobals.tostring()</code>.</td>
      <td><code>table: 0x0123456789abcdef</code></td>
    </tr>
    <tr>
      <td><code>%</code></td>
      <td></td>
      <td><code>%</code> gevolgd door een andere <code>%</code> retourneert het <code>%</code> teken zelf.</td>
      <td><code>%</code></td>
    </tr>
  </tbody>
</table>

```lua
local str = "Het magische woord is %s"
print(string.format(str, "Roblox"))
-- Het magische woord is Roblox

local str = "Het magische woord is %q"
print(string.format(str, "Roblox"))
-- Het magische woord is "Roblox"

local str = "Overslaan naar \na nieuwe regel en \nanother nieuwe regel!"
print(string.format(str, "%q"))
--[[ Uitvoer:
Overslaan naar
a nieuwe regel en
another nieuwe regel!
]]
```

#### Vlaggen

<table>
<thead>
  <tr>
    <th>Vlag</th>
    <th>Beschrijving</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>-</code></td>
    <td>Links uitlijnen van de gegeven veldbreedte (zie <b>Breedte</b> hieronder). Rechts uitlijnen is de standaard.</td>
  </tr>
  <tr>
    <td><code>+</code></td>
    <td>Forceert een <code>+</code> teken om een nummer vooraf te gaan. Heeft geen effect op negatieve getallen.</td>
  </tr>
  <tr>
    <td>(spatie)</td>
    <td>Een lege ruimte wordt vóór een positief nummer ingevoegd, terwijl negatieve getallen niet worden beïnvloed. Dit is nuttig om positieve en negatieve getallen verticaal uit te lijnen in een visuele gestapelde lijst.</td>
  </tr>
  <tr>
    <td><code>#</code></td>
    <td>Wanneer gebruikt met <code>o</code> en <code>x</code>/<code>X</code>, schrijft een <code>0</code> (octaal) of <code>0x</code>/<code>0X</code> vóór waarden anders dan nul.<br>Wanneer gebruikt met <code>e</code>/<code>E</code> en <code>f</code>, dwingt de uitvoer om een decimaal punt te bevatten, zelfs als er geen cijfers zouden volgen (standaard wordt er geen decimaal punt geschreven als er geen cijfers volgen).<br>Wanneer gebruikt met <code>g</code> of <code>G</code>, is het resultaat hetzelfde als met <code>e</code> of <code>E</code> maar worden achtervolgende nullen niet verwijderd.</td>
  </tr>
  <tr>
    <td><code>0</code></td>
    <td>Vult het nummer links aan met nullen in plaats van lege ruimtes (zie <b>Breedte</b> hieronder).</td>
  </tr>
</tbody>
</table>

```lua
local str = "%-10d"
print(string.format(str, 300) .. "]")
-- 300       ]
-- Er zijn 7 spaties tussen '300' en ']'

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

local str = "Er is een% i%% kans op regen in Seattle vandaag."
print(string.format(str, 100))
-- Er is een 100% kans op regen in Seattle vandaag.
```

#### Breedte

<table>
  <thead>
    <tr>
      <th>Breedte</th>
      <th>Beschrijving</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>(nummer)</td>
      <td>Minimaal aantal karakters dat moet worden geretourneerd. Als het aantal karakters dat moet worden geformatteerd minder is dan dit nummer, wordt het resultaat opgevuld met lege ruimtes.</td>
    </tr>
  </tbody>
</table>

```lua
local str = "%012i"
print("Score: " .. string.format(str, 15000))
-- Uitvoer: Score: 000000015000
-- De uitvoer heeft in totaal 12 cijfers, links opgevuld met nullen
```

#### Precisie

De standaardprecisie is <code>1</code>. Als je een punt zonder een
waarde geeft, is de standaard <code>0</code>.

<table>
  <thead>
    <tr>
      <th>Precisie</th>
      <th>Beschrijving</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>.</code>(nummer)</td>
      <td>Voor gehele getal specifiers (<code>d</code>, <code>i</code>, <code>o</code>, <code>u</code>, <code>x</code>/<code>X</code>), specificeert precisie het minimale aantal cijfers dat moet worden geretourneerd. Als de waarde die moet worden geformatteerd korter is dan dit nummer, wordt het resultaat opgevuld met voorloopnullen. Een precisie van <code>0</code> betekent dat er geen teken wordt geschreven voor de waarde <code>0</code>.<br>Voor <code>e</code>/<code>E</code> en <code>f</code> specifiers, is dit het aantal cijfers dat na het decimale punt moet worden afgedrukt.<br>Voor <code>g</code>/<code>G</code> specifiers, is dit het maximale aantal cijfers (voor de <code>e</code>/<code>E</code>, indien aanwezig).<br>Voor <code>s</code>, is dit het maximale aantal karakters dat moet worden geretourneerd.<br>Voor <code>c</code> en <code>q</code>, heeft dit geen effect.</td>
    </tr>
  </tbody>
</table>

```lua
-- Voeg decimaal toe met precisie van 2 voor een valuta-uitvoer
local str = "$%.2f"
print(string.format(str, 300)) -- Uitvoer: $300.00

-- Retourneer de eerste 6 letters van een string
local str = "%.6s"
print(string.format(str, "Robloxian")) -- Uitvoer: Roblox

local str = "Er was eens een draak genaamd %s en hij had %.8f hoorns."
print(string.format(str, "Pi", math.pi))
-- Uitvoer: Er was eens een draak genaamd Pi en hij had 3.14159265 hoorns.
```


string.format

formatstring

Een string die format specifiers bevat die bepalen hoe de volgende
argumenten worden geformatteerd.


Waarden die moeten worden geformatteerd volgens de specifiers in de format
string.


Geeft een geformatteerde versie van zijn variabele aantal argumenten terug volgens
de beschrijving die in zijn eerste argument is gegeven, dat een string moet zijn.


Geeft een iteratorfunctie terug die, elke keer dat deze wordt aangeroepen, de
volgende captures van `pattern` over de string `s` retourneert. Als het patroon geen
captures heeft, wordt de hele match bij elke aanroep geretourneerd.

De iterator wordt meestal gebruikt in een generieke `for`-lus. Wanneer het patroon
capturegroepen bevat, retourneert elke aanroep de gevangen substrings als
aparte waarden. Een lege match (nulbreedte) gaat één teken verder dan de huidige
positie om een oneindige lus te voorkomen.

```lua
-- Itereer over alle woorden in een zin
for word in string.gmatch("Hallo Roblox wereld", "%a+") do
    print(word)
end
-- Hallo
-- Roblox
-- wereld

-- Extraheer sleutel-waarde paren met behulp van captures
local t = {}
for key, value in string.gmatch("naam=Roblox, versie=1.0", "(%w+)=(%w[%w.]*)") do
    t[key] = value
end
print(t.naam, t.versie) -- Roblox 1.0

-- Verzamel alle cijfers
local digits = {}
for d in string.gmatch("abc123def456", "%d+") do
    table.insert(digits, d)
end
print(table.concat(digits, ", ")) -- 123, 456
```


string.gmatch

De string waarin gezocht moet worden naar patroonmatches.


Het patroon dat herhaaldelijk tegen de string moet worden gematcht.


Geeft een iteratorfunctie terug die de volgende captures van het patroon
over de string `s` retourneert elke keer dat deze wordt aangeroepen.


Afgekort voor globale vervanging. Geeft een kopie van `s` terug waarin alle (of de
eerste `n`, indien gegeven) voorkomens van het patroon worden vervangen (vervangen)
met de gegeven `replacement`. De tweede waarde die wordt geretourneerd is het totale
aantal gemaakte vervangingen.

De `replacement` kan een van verschillende types zijn, elk op een andere manier gebruikt om
de werkelijke string te bepalen:

- string: Het patroon wordt rechtstreeks vervangen door de string
- table: De string die het patroon heeft gematcht, wordt in de tabel als
  een sleutel opgezocht, en de waarde (string) is wat het vervangt, als deze bestaat.
- functie: Wordt aangeroepen met de string die het patroon heeft gematcht, moet de string retourneren
  om het gematchte patroon te vervangen.

Een optioneel laatste argument kan worden opgegeven dat het maximale
aantal vervangingen specificeert (bijvoorbeeld, stop na 2 vervangingen)

#### Diverse Voorbeelden

```lua
-- Basisvervanging
string.gsub("Ik hou van taco's!", "taco's", "Roblox") --> Ik hou van Roblox! 1
-- Vervanging met een patroon
string.gsub("Ik hou van rood!", "%w+", "woord") --> woord woord woord! 3
-- Vervangings tabel
string.gsub("Ik speel Roblox.", "%w+", {Ik="Je", speel="joue à"}) --> "Je joue à Roblox." 3
-- Vervangingsfunctie
string.gsub("Ik heb 2 katten.", "%d+", function(n) return tonumber(n) * 12 end) --> "Ik heb 24 katten." 1
-- Vervang alleen twee keer
string.gsub("aaa", "a", "b", 2) --> "bba" 2
-- Vervanging met capturegroepen (maximaal negen)
string.gsub("love2play Roblox", "(%w+)(%d+)(%w+)%s+(%w+)", "Ik %1 %2 %3 %4!") --> "Ik hou 2 van Roblox!" 1
```


string.gsub

De string waarvan de voorkomens van het gegeven patroon moeten worden vervangen.


Het patroon dat moet worden gematcht en vervangen.


replacement

Bepaalt wat de voorkomens van het gegeven patroon moet vervangen.


replacements

Het maximale aantal vervangingen dat moet worden gemaakt.


Geeft een kopie van `s` terug waarin alle of de eerste `n` voorkomens van het
patroon worden vervangen door de gegeven vervanging. De tweede waarde die wordt geretourneerd
is het totale aantal gemaakte vervangingen.


Geeft het aantal bytes in de string `s` terug. Omdat Luau-strings
byte-sequenties zijn, telt dit bytes in plaats van Unicode-tekens of
grapheme-clusters. Een lege string retourneert `0`. Ingesloten null bytes (`\\0`)
worden meegeteld.

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

-- Ingesloten null bytes worden meegeteld
local s = "ab\\0cd"
print(string.len(s)) -- 5

-- Equivalent aan de # lengte operator
local str = "Roblox"
print(string.len(str) == #str) -- true
```


string.len

Geeft een kopie van de string `s` terug waarin alle hoofdletters ASCII
(`A`-`Z`) zijn veranderd in hun kleine letters equivalenten (`a`-`z`). Karakters
buiten het ASCII-letterbereik, inclusief geaccentueerde of multibyte
karakters, blijven onveranderd.

```lua
print(string.lower("HALLO")) -- hallo
print(string.lower("Hallo Wereld!")) -- hallo wereld!

-- Niet-lettertekens worden niet beïnvloed
print(string.lower("Roblox 123!")) -- roblox 123!

-- Alleen ASCII-letters worden omgezet
print(string.lower("ABC abc")) -- abc abc
```


string.lower

De string die naar kleine letters moet worden omgezet.


Geeft een kopie van een string terug waarin alle hoofdletters zijn veranderd in
kleine letters.


Zoekt naar de eerste match van `pattern` in de string `s`. Als het patroon
captures bevat, worden de gevangen substrings als aparte
waarden geretourneerd; anders wordt de hele match geretourneerd. Als er geen match wordt gevonden, retourneert de
functie `nil`.

De optionele derde argument `init` specificeert de bytepositie om te beginnen
met zoeken (standaard `1`). Een negatieve `init` telt vanaf het einde van de
string. In tegenstelling tot `Library.string.find()`, retourneert deze functie de gevangen
waarden direct in plaats van de matchindices.

```lua
-- Extraheer gematchte substring
print(string.match("Ik heb 42 katten", "%d+")) -- 42

-- Meerdere captures
local year, month, day = string.match("2024-03-15", "(%d+)-(%d+)-(%d+)")
print(year, month, day) -- 2024 03 15

-- Geen match retourneert nil
print(string.match("hallo", "%d+")) -- nil

-- Gebruik van init om vooruit te springen
print(string.match("foo123bar456", "%d+", 7)) -- 456

-- Geankerd patroon
print(string.match("hallo", "^%a+")) -- hallo
```


string.match

De string waarin gezocht moet worden naar een patroonmatch.


Het patroon waartegen de string moet worden gematcht.


De bytepositie waarop met zoeken moet worden begonnen.


Zoekt naar de eerste match van `pattern` in de string `s`.


Geeft een binaire string terug die de opgegeven argumenten bevat. Het eerste
argument, `format`, bepaalt de manier waarop de resterende argumenten worden verpakt;
zie [hier](https://www.lua.org/manual/5.3/manual.html#6.4.2) voor opties.


string.pack

format

Een formatstring die de indeling en types van de waarden beschrijft die
verpakt moeten worden.


De waarden die in binaire vorm moeten worden geserialiseerd volgens de format
string.


Geeft een binaire string terug die de opgegeven argumenten bevat.


Geeft de grootte in bytes van elke string terug die is verpakt met een gegeven beschrijving.
Het enige argument, `format`, bepaalt de manier waarop de resterende argumenten
worden verpakt, maar je kunt `s` en `z` niet gebruiken omdat ze variabele
lengtes hebben. Zie [hier](https://www.lua.org/manual/5.3/manual.html#6.4.2) voor
opties.


string.packsize

Een formatstring die de verpakkingsindeling beschrijft (mag geen
variabele-lengte opties `s` of `z` bevatten).


Geeft de grootte in bytes van elke string terug die is verpakt met een gegeven beschrijving.


Geeft een string terug die de concatenatie is van `n` kopieën van de string
`s`. Als `n` nul of negatief is, retourneert de functie een lege string. Een
fout wordt gegenereerd als de resulterende string de maximale stringgrootte zou overschrijden.

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

-- Nul of negatieve herhalingen retourneren een lege string
print(string.rep("x", 0))  -- (lege string)
print(string.rep("x", -1)) -- (lege string)

-- Nuttig voor opvulling of scheidingstekens
local separator = string.rep("-", 20)
print(separator) -- --------------------
```


string.rep

Het aantal keren dat de string moet worden herhaald.


Geeft een string terug die de concatenatie is van `n` kopieën van de string
`s`.


Geeft een string terug die de string `s` omgekeerd is byte-voor-byte. Omdat de
omkering op individuele bytes werkt, worden multibyte UTF-8-sequenties niet
behouden als geldige karakters na omkering.

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

-- Enkel karakter of lege string
print(string.reverse("a")) -- a
print(string.reverse(""))  -- (lege string)

-- Palindroomcontrole
local function isPalindrome(s)
    local lower = string.lower(s)
    return lower == string.reverse(lower)
end
print(isPalindrome("racecar")) -- true
print(isPalindrome("hallo"))   -- false
```


string.reverse

Geeft een string terug die de string `s` omgekeerd is.


Splits een string in delen op basis van de gedefinieerde scheidingsteken(s),
terugkerend een tabel van geordende resultaten.

Als er een lege "slice" wordt gevonden, wordt dat deel geretourneerd als een lege
string. Bijvoorbeeld `string.split("abc||def", "|")` retourneert een tabel
met drie strings: `"abc"`, `""`, en `"def"`.

```lua
local input = "a,b,c"
local values = input:split(",")
print(values[1], values[2], values[3]) --> "a" "b" "c"
```
Let ook op dat witruimte uit de oorspronkelijke string behouden blijft, bijvoorbeeld `string.split("abc _ def", "_")` zal de witruimte aan beide
zijden van de `_` scheidingsteken respecteren. Standaard is het scheidingsteken `,` maar
jij kunt een alternatief teken of reeks tekens opgeven.

**Hoekgevallen**

#### Lege String

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

#### Lege Slices

```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]) --> "" "" ""
```

#### Witruimte Behouden

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

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

#### Ongeldige 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"
```

#### Unicode

```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

De scheidingsteken(s) die moeten worden gebruikt om de string te splitsen.


Splits een string in delen op basis van de gedefinieerde scheidingsteken(s),
terugkerend een tabel van geordende resultaten.


Geeft de substring van `s` terug die begint bij bytepositie `i` en
doorgaat tot en met bytepositie `j`. Zowel `i` als `j` kunnen negatief zijn: `-1` verwijst naar de laatste byte, `-2` naar de op één na laatste, en zo
verder. De standaardwaarde voor `i` is `1` (het begin) en `j` is standaard `-1`
(de einde).

Als de vastgestelde `i` kleiner is dan `1`, wordt deze gecorrigeerd naar `1`. Als `j`
het stringlengte overschrijdt, wordt deze gecorrigeerd naar de stringlengte. Als na
deze correcties `i` groter is dan `j`, retourneert de functie een lege
string.

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

-- Extraheer bestandsextensie
local filename = "script.lua"
local dot = string.find(filename, "%.")
print(string.sub(filename, dot + 1)) -- lua

-- Lege resultaat wanneer start > eind
print(string.sub("abc", 3, 1)) -- (lege string)
```


string.sub

De bronstring waaruit een substring moet worden geëxtraheerd.


De startbytepositie van de substring (negatieve waarden tellen
vanaf het einde).


De eindbytepositie van de substring, inclusief (negatieve waarden
tellen vanaf het einde).


Geeft de substring van `s` terug die begint bij `i` en doorgaat tot en
met `j`. `i` en `j` kunnen negatief zijn. `i` is standaard `1` en `j`
standaard `-1`.


Extraheert de waarden verpakt in de opgegeven binaire string op basis van de
eerste argument, `format`, die moet overeenkomen met degene die oorspronkelijk is gebruikt om
`Library.string.pack|pack()` de string; zie
[hier](https://www.lua.org/manual/5.3/manual.html#6.4.2) voor opties. De
optionele derde parameter bepaalt de byte waarop het lezen begint.


string.unpack

De formatstring die beschrijft hoe de binaire gegevens zijn verpakt.


data

De binaire string waaruit waarden moeten worden uitgepakt.


readStart

De bytepositie in `data` waarop moet worden begonnen met lezen.


De waarden verpakt in de opgegeven binaire string, plus de index van
de eerste niet-gelezen byte.


Extraheert de waarden verpakt in de opgegeven binaire string.


Geeft een kopie van de string `s` terug waarin alle kleine letters ASCII
(`a`-`z`) zijn veranderd in hun hoofdletters equivalenten (`A`-`Z`). Karakters
buiten het ASCII-letterbereik, inclusief geaccentueerde of multibyte
karakters, blijven onveranderd.

```lua
print(string.upper("hallo")) -- HALLO
print(string.upper("Hallo Wereld!")) -- HALLO WERELD!

-- Niet-lettertekens worden niet beïnvloed
print(string.upper("roblox 123!")) -- ROBLOX 123!

-- Alleen ASCII-letters worden omgezet
print(string.upper("abc ABC")) -- ABC ABC
```


string.upper

De string die naar hoofdletters moet worden omgezet.


Geeft een kopie van een string terug waarin alle kleine letters zijn veranderd in
hoofdletters.


string

Biedt generieke functies om strings te manipuleren.


Een object dat verbonden functies uitvoert bij een specifieke gebeurtenis.

Data Type

RBXScriptSignal

Luau

Tuple

Variant

Gegevenstype met een waarde van ofwel true of false.

boolean

Functies zijn blokken code die meerdere keren op commando kunnen worden uitgevoerd.

function

number

Een reeks karakters, zoals letters, cijfers en symbolen.

Gegevenstype dat meerdere waarden van elk niet-nil type kan opslaan, inclusief booleans, getallen, strings, functies en andere tabellen.

table

Ervaringen

Avatar

Assets

Voorbeelden en projecten

Engine-API

Open Cloud-API

Studio

Analytics

Platform

Tutorials

Makerprogramma's

Onderwijs

Meer informatie

Deze methode is asynchroon en retourneert een 'Bewerking', die de huidige status van de bewerking weergeeft. Deze bevat een eindpuntpad dat je kunt opvragen om het daadwerkelijke antwoord en de bijbehorende metadata te verkrijgen. Zie de [documentatie]({longRunningOperationsLink}) over langlopende bewerkingen voor meer informatie. 

De volgende secties beschrijven de antwoord- en metadata-objecten die worden verstrekt wanneer een bewerking is voltooid.

Bèta-eindpunten zijn klaar voor openbaar gebruik. Ingrijpende wijzigingen zijn mogelijk, maar komen zelden voor.

Deze Open Cloud-documentatiepagina's worden op 31 maart 2026 verwijderd. Op dat moment word je automatisch doorgestuurd naar de nieuwe Open Cloud-documentatie. {linkStart}Meer informatie{linkEnd}

Deze oude Open Cloud-pagina's worden op 31 maart 2026 verwijderd en doorgestuurd. {linkStart}Meer informatie{linkEnd}

Experimentele eindpunten zijn klaar voor openbaar gebruik, maar kunnen af en toe ingrijpende wijzigingen ondergaan naarmate het API-contract wordt afgerond.

Dit eindpunt kan in de ervaring worden aangeroepen via {httpServiceLinkStart}HttpService{httpServiceLinkEnd} met een API-sleutel.

Dit veld kan worden ingesteld bij het maken van een bron, maar mag niet worden gewijzigd door latere verzoeken.

Deze velden kunnen worden ingesteld bij het maken van een bron, maar mogen niet worden gewijzigd door latere verzoeken.

Dit veld kan worden verstrekt in verzoeken, maar wordt nooit opgenomen in antwoorden.

Verouderde verificatiemethode. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Per API-sleutel: {maxInPeriod} verzoeken elke {periodInSeconds} seconden per IP-adres

Vereist geen verificatie om aan te roepen. Heeft doorgaans aanzienlijk lagere snelheidslimieten. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Voor elke groepering hoeft slechts één van de volgende velden in het schema te worden opgegeven, de overige kunnen worden uitgesloten.

Je kunt je op elk moment weer aanmelden. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de oude documenten. {linkStart}Geef feedback.{linkEnd}

Je kunt je op elk moment afmelden. Dan word je teruggestuurd naar de oude referentiepagina's. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de vernieuwde documenten. {linkStart}Geef feedback.{linkEnd}

Dit veld kan worden ingesteld voor antwoorden, maar wordt genegeerd in verzoeken.

Opmerking: snelheidslimieten kunnen lager zijn tijdens perioden met veel verkeer. Bepaalde eindpunten hebben aanvullende snelheidslimieten. [Meer informatie over snelheidslimieten]({link}).

{limit} verzoeken per dag voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per uur voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per seconde voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut per eigenaar van API-sleutel

{limit} verzoeken per dag per app-gebruiker

{limit} verzoeken per uur per app-gebruiker

{limit} verzoeken per minuut per app-gebruiker

{limit} verzoeken per seconde per app-gebruiker

{limit} verzoek(en) per seconde per eigenaar van API-sleutel

Het bereik bepaalt welke toestemmingen je inloggegevens hebben. Je inloggegevens hebben alleen toegang tot de eindpunten die worden ondersteund door het bereik dat je hebt geselecteerd.

Stabiele eindpunten zijn productieklaar en zullen tijdens hun levensduur bijna nooit ingrijpende wijzigingen ondergaan.

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts}

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts} en {optionalParts}

Doeltypen worden gebruikt om de bronnen te beperken waarvoor je inloggegevens toegang hebben. Alleen de geselecteerde bronnen kunnen worden gebruikt, zelfs als je account toegang heeft tot aanvullende bronnen. Het is mogelijk dat een bepaald bereik geen doelonderdelen heeft. In deze gevallen kunnen al je relevante bronnen worden gebruikt. 

Het universele onderdeel op het hoogste niveau hoeft niet te worden geselecteerd voor API-sleutels die eigendom zijn van de gebruiker. In dit geval heeft je API-sleutel toegang tot al je ervaringen die eigendom zijn van gebruikers en ervaringen die eigendom zijn van groepen waarvoor je de juiste groepsrechten hebt.

'Probeer het uit' wordt nog niet ondersteund voor eindpunten waarvoor een API-sleutel of OAuth 2.0-verificatie vereist is

Cookie-authenticatie is uitgeschakeld voor bewerkingen met een hoog risico om veiligheidsredenen.

Eindpunten met kritiek risico zijn uiterst gevoelig en 'Probeer het uit' is uitgeschakeld om veiligheidsredenen

Opmerking: authenticatieheaders zijn niet opgenomen in dit codevoorbeeld. Mogelijk moet je een authenticatieheader toevoegen om deze opdracht te kunnen uitvoeren.

Dit is een eindpunt met een hoog risico dat kritieke gegevens kan wijzigen of verwijderen. Wees uiterst voorzichtig bij het testen.

Dit API-eindpunt is geclassificeerd als HOOG RISICO en kan van invloed zijn op live gegevens of gebruikersaccounts.

Geverifieerde verzoeken aan API's met een hoog risico kunnen wijzigingen aanbrengen die niet ongedaan kunnen worden gemaakt. Controleer de parameters van je verzoek zorgvuldig voordat je verder gaat.

Dit is een eindpunt met een laag risico dat gegevens ophaalt. Dit is over het algemeen veilig om te testen.

Dit is een eindpunt met een gemiddeld risico dat gegevens wijzigt. Test voorzichtig met niet-kritieke accounts, aangezien wijzigingen permanent kunnen zijn.

Plak hier nooit tekst uit andere bronnen en stuur nooit informatie van deze pagina naar anderen om je account veilig te houden.

Je staat op het punt live API-eindpunten te testen met de daadwerkelijke inloggegevens van je account.

Ga alleen verder als je de implicaties begrijpt van de API-oproepen die je wilt uitvoeren. Lees de API-documentatie zorgvuldig door voordat je gaat testen.

API-oproepen worden gedaan met behulp van je geverifieerde sessie

Dit zijn echte API-oproepen die van invloed kunnen zijn op je account of gegevens

Snelheidslimieten en andere API-beperkingen zijn van toepassing

Sommige bewerkingen kunnen gegevens wijzigen of verwijderen

Dit eindpunt is vervangen door deze aanbevolen alternatieve eindpunten:

Het volgend bereik is vereist om dit eindpunt aan te roepen. Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer 
informatie over het genereren van de juiste sleutels.

Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer informatie over het genereren van sleutels.

De volgende eindpunten zijn beschikbaar op paden ten opzichte van de basis-URL.

Deze string is opgemaakt als een [FieldMask](/cloud/reference/types#fieldmask).

Een JSON-waarde kan 'null', 'boolean', 'string', 'number', 'array' of 'object' zijn.

Het volgende bereik is vereist om je OAuth 2.0-applicatie dit eindpunt te laten gebruiken. Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

De volgende objecten beschrijven payloads die worden geaccepteerd of geretourneerd. Raadpleeg elk afzonderlijk eindpunt voor meer informatie over wanneer deze objecten worden gebruikt.

Het volgende bereik is vereist om dit eindpunt aan te roepen.

Bronpaden

Deze string is opgemaakt als een [Tijdstempel](/cloud/reference/types#timestamp).

Niet aanbevolen

Je bekijkt de vernieuwde Open Cloud-referentie.

Je hebt je afgemeld voor de nieuwe Open Cloud-referentie.

Bekijk je factureringsaccounts voor advertenties.

Verleent toegang om factureringsaccounts te configureren en advertentietegoed te kopen.

Bekijk je advertentiecampagnes en hun prestaties.

Je advertentiecampagnes maken, bijwerken en beheren.

Hiermee kun je informatie over je assets bekijken.

Hiermee kun je assets uploaden naar en bijwerken op Roblox.

Hiermee kun je assetmachtigingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je assettoestemmingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je namens jou de status en resultaten van taken voor automatische instelling van avatars bekijken.

Hiermee kun je namens jou taken voor automatische instelling van avatars maken en beheren.

Geeft de mogelijkheid om badges van de gebruiker bij te werken.

Hiermee kun je informatie over je commerciële items bekijken.

Hiermee kun je wijzigingen aanbrengen in je gesynchroniseerde commerciële items.

Hiermee kun je informatie over je Connecties met handelaren bekijken.

Hiermee kun je je connecties met handelaren bewerken.

Hiermee kun je informatie over je Creatorwinkel-producten bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel wijzigen.

Geeft toegang om namens jou gegevensopslagplaatsen te maken.

Geeft toegang om namens jou gegevensopslagplaatsen te verwijderen.

Geeft toegang om een lijst met gegevensopslagplaatsen te lezen.

Geeft toegang om een snapshot van je gegevensopslagplaatsen te maken.

Geeft toegang om items in je gegevensopslagplaatsen te maken.

Geeft toegang om specifieke items te markeren voor verwijdering.

Geeft toegang om de items van je gegevensopslag te vermelden.

Geeft toegang om specifieke items in je gegevensopslagplaatsen te lezen.

Geeft toegang om de waarde, attributen en gebruikers van een item bij te werken.

Geeft toegang om revisies van de items van je gegevensopslag te verwijderen.

Geeft toegang om revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om gelezen revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om de configuratiegegevens van de ontwikkelaarsproducten van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de Developer Products van de geautoriseerde gebruiker te bewerken.

Hiermee kun je informatie over de omgevingen van je universum bekijken.

Hiermee kun je de omgevingen van je universum bewerken.

Geeft toegang om de configuratiegegevens van de game passes van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de game passes van de geautoriseerde gebruiker te bewerken.

Geeft toegang om informatie over de communityforums voor je account te bekijken.

Geeft toegang om informatie over de communityforums voor je account te beheren.

Hiermee kun je informatie over je community's bekijken.

Hiermee kun je lidmaatschapsverzoeken voor de community en rolwijzigingen van lager gerangschikte communityleden beheren voor je account.

Hiermee kun je de eigenschapsgegevens van een instantie bekijken.

Hiermee kun je de property-gegevens van instanties wijzigen (momenteel alleen ondersteuning voor scripts).

Hiermee kun je informatie over je inventaris bekijken.

Geeft toegang om gebruikersassets te beheren.

Geeft toegang om je badges te beheren en Robux uit te geven.

Geeft toegang om de badges van de geautoriseerde gebruiker bij te werken.

Geeft toegang om je ontwikkelaarsproducten te beheren.

Geeft toegang om informatie te lezen over de ervaringen waarvoor je meldingen hebt ingeschakeld.

Geeft toegang om namens jou meldingen voor ervaringen in of uit te schakelen.

Geeft toegang om je community's te beheren.

Geeft toestemming om communitygegevens te lezen.

Verleent toestemmingen voor communitybeheer.

Geeft toegang om je lokalisatietabellen te lezen en te schrijven

Geeft toegang om teamsamenwerking te beheren voor alle ervaringen die je bezit.

Geeft toegang om je ervaringen en bepaalde informatie die aan je ervaringen is gekoppeld (bijv. lokalisatie-informatie) te beheren.

Geeft toegang om de lokalisatie-informatie van je ervaringen te lezen.

Geeft toegang om de lokalisatievoorkeuren van je ervaringen te wijzigen.

Geeft toegang om je gebruikersaccount te beheren.

Geeft toegang om de lokalisatievoorkeuren van de gebruiker te wijzigen.

Hiermee kun je de status, logs en resultaten van Luau-uitvoeringstaken voor de bijbehorende plaats bekijken.

Hiermee kun je nieuwe Luau-uitvoeringstaken voor de bijbehorende plaats maken.

Geeft toegang om asynchroon alle gegevensstructuren in het universum te flushen.

Geeft toegang om nieuwe wachtrijitems te maken.

Geeft toegang om gelezen items vooraan in de wachtrij te negeren.

Geeft toegang tot gelezen items vooraan in de wachtrij.

Geeft toegang om je geheugenopslagitems te lezen.

Geeft toegang om kaartitems te maken, bij te werken en te verwijderen.

Dit geeft de mogelijkheid om namens gebruikers berichten te publiceren.

Hiermee kun je meldingen vanuit je ervaring naar gebruikers sturen.

(Verouderd) Geeft toegang om een lijst met items in een genummerde gegevensopslag te lezen.

(Verouderd) Geeft toegang om een nieuw item in een genummerde gegevensopslag te maken.

Geeft toegang om items uit een genummerde gegevensopslag te vermelden.

Geeft toegang om items in een genummerde gegevensopslag te maken.

Hiermee kun je geheimen vermelden die aan je ervaring zijn gekoppeld.

Hiermee kun je geheimen maken en bijwerken die aan je ervaring zijn gekoppeld.

Met deze toestemming kun je een evaluatietaak indienen en het resultaat van de taak bekijken.

Geeft toegang om informatie over je abonnementsproducten te lezen.

Hiermee kun je namens jou informatie over miniaturen lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te maken of te wijzigen.

Geeft de mogelijkheid om game analytics te lezen.

Geeft de mogelijkheid om bronnen met betrekking tot game analytics te schrijven.

Geeft de mogelijkheid om plaatsinformatie te lezen.

Geeft de mogelijkheid om plaatsinformatie te bewerken.

Geeft toegang om nieuwe versies van ervaringen op Roblox te publiceren.

Hiermee kun je de miniaturen en de bijbehorende personalisatie-instellingen voor je ervaringen lezen.

Hiermee kun je de miniaturen uploaden en verwijderen en de bijbehorende personalisatie-instellingen voor je ervaringen beheren.

Geeft de mogelijkheid om informatie over ervaringen te lezen.

Geeft toegang om de ervaringen van de geautoriseerde gebruiker te bewerken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bekijken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bewerken.

Hiermee kun je meldingen bekijken die naar je account zijn gestuurd.

Geeft de mogelijkheid om de premium- en geverifieerde status van de gebruiker te lezen.

Hiermee kun je de sociale media-accounts van de geautoriseerde gebruiker bekijken.

Geeft de mogelijkheid om game-evenementen te lezen.

Geeft de mogelijkheid om game-evenementen te bewerken.

Dit schakelt de Single Sign-On-functionaliteit in.

Dit geeft toegang om je profielinformatie te lezen.

Samenvatting