NativeStringTools

package lua

Доступно в lua

Это все внешние интерфейсы для базового класса Lua "string", который работает как дополнительный набор инструментов для строк.

Обратите внимание, что все соответствующие индексы основаны на "1".

Статические методы

staticbyte(str:String, ?index:Int):Int

Возвращает внутренние числовые коды символов str[index]. Обратите внимание, что числовые коды не обязательно являются переносимыми между платформами.

staticchar(codes:Rest<Int>):String

Принимает ноль или более целых чисел. Возвращает строку длиной, равной количеству аргументов, в которой каждый символ имеет внутренний числовой код, равный соответствующему аргументу. Обратите внимание, что числовые коды не обязательно являются переносимыми между платформами.

staticdump(d:Dynamic):Dynamic

Возвращает строку, содержащую двоичное представление заданной функции, так что последующий вызов loadstring этой строки возвращает копию функции. Функция должна быть функцией Lua без свободно используемых переменных.

staticfind(str:String, target:String, ?start:Int, ?plain:Bool):StringFind

Ищет первое вхождение шаблона в строке str. Если совпадение найдено, то find возвращает индексы str начала и конца этого вхождения.

Параметры:

staticformat(str:String, ?e1:Dynamic, ?e2:Dynamic, ?e3:Dynamic, ?e4:Dynamic):String

Возвращает отформатированную версию своих аргументов в соответствии с описанием, заданным в первом аргументе (который должен быть строкой). Строка формата следует тем же правилам, что и семейство стандартных функций C printf. Единственные отличия заключаются в том, что опции/модификаторы *, l, L, n, p, и h не поддерживаются, и есть дополнительная опция, q. Опция q форматирует строку в виде, подходящем для безопасного повторного чтения интерпретатором Lua: строка записывается между двойными кавычками, а все двойные кавычки, символы новой строки, вставленные нули и обратные слэши в строке правильно экранируются при записи. Например, вызов string.format('%q', 'a string with "quotes" and \n new line') создаст строку: `"a string with \"quotes\" and \

  new line"`

Опции c, d E, e, f, g, G, i, o, u, X- и x все ожидают число в качестве аргумента, в то время как q и s ожидают строку.

Эта функция не принимает строковые значения, содержащие вставленные нули, за исключением аргументов опции q.

staticgmatch(str:String, pattern:String):() ‑> String

staticgmatch(str:String, pattern:String, match:() ‑> String, ?n:Int):String ‑> Void

Возвращает функцию-итератор, которая каждый раз при вызове возвращает следующие захваты из шаблона над строкой str. Если pattern не задает никаких захватов, то в каждом вызове возвращается всё совпадение.

staticgsub(str:String, pattern:String, replace:String, ?n:Int):String

staticgsub(str:String, pattern:String, replace:String ‑> Void, ?n:Int):String

staticgsub(str:String, pattern:String, replace:String ‑> String, ?n:Int):String

staticlen(str:String):Int

Принимает строку и возвращает ее длину. Пустая строка "" имеет длину 0. Вставленные нули учитываются, поэтому "a\000bc\000" имеет длину 5.

staticlower(str:String):String

Принимает строку и возвращает копию этой строки со всеми заглавными буквами, преобразованными в строчные. Все остальные символы остаются неизменными. Определение того, что является заглавной буквой, зависит от текущего локали.

staticmatch(str:String, pattern:String, ?n:Int):String

Ищет первое вхождение шаблона в строке s. Если оно найдено, то match возвращает захваты из шаблона; в противном случае возвращает null. Если шаблон не задает захватов, то возвращается всё совпадение. Необязательный аргумент n задаёт, с какого места начать поиск; по умолчанию он равен 1 и может быть отрицательным.

staticrep(s:String, n:Int, ?sep:String):String

Возвращает строку, являющуюся конкатенацией n копий строки s, разделённых строкой sep. Значение sep по умолчанию — пустая строка (то есть без разделителя). Возвращает пустую строку, если n не положительно. (Обратите внимание, что с помощью одного вызова этой функции очень легко исчерпать память вашего компьютера.)

staticsub(str:String, start:Int, ?end:Int):StringSub

Возвращает подстроку str, которая начинается с позиции start и продолжается до позиции end; start и end могут быть отрицательными. Если end отсутствует, то оно считается равным -1 (что эквивалентно длине строки). В частности, вызов sub(str,1,end) возвращает префикс str длиной end, а sub(str, -end) возвращает суффикс str длиной start.

staticupper(str:String):String

Принимает строку и возвращает копию этой строки со всеми строчными буквами, преобразованными в заглавные. Все остальные символы остаются неизменными. Определение того, что является строчной буквой, зависит от текущего локали.