dymokomi/luce-browser-foundation
Source of release 0.6.1
0.6.1 / src / ak / string_view.lucb
#==============================================================================================
#
# string_view - StringView: a non-owning view of bytes (usually UTF-8)
#
# DESCRIPTION:
# Port of AK/StringView.h (lines 1-406) and AK/StringView.cpp (lines 1-314), in the
# header's order with the .cpp bodies in place of their declarations.
#
# StringView is `m_characters` + `m_length`. A zero-initialized view has no characters
# pointer (the C++ default is ""); every accessor treats that as the empty view. The
# `Optional<StringView>` sentinel (a null pointer) is not needed: `StringView?` is an
# ordinary optional. Views of a String or FlyString take the owner by pointer, since a
# short string's bytes live inside the owner.
#
#==============================================================================================
# mark: Construction ============================================================================
## Ported from AK/StringView.h:27 AK::StringView::StringView(char const*, size_t).
pub func string_view_construct_u8_usize(this: StringView*, characters: const u8*?, length: usize):
this.m_characters = characters
this.m_length = length
assert(characters != none)
## Ported from AK/StringView.h:37 AK::StringView::StringView(unsigned char const*, size_t).
pub func string_view_construct_u8_usize_2(this: StringView*, characters: const u8*?, length: usize):
this.m_characters = characters
this.m_length = length
assert(characters != none)
## Ported from AK/StringView.h:45 AK::StringView::StringView(ReadonlyBytes).
pub func string_view_construct_span_u8(this: StringView*, bytes: const u8[]):
this.m_characters = "".bytes.data if bytes.length == 0 else bytes.data
this.m_length = bytes.length
## Ported from AK/StringView.cpp:40 AK::StringView::StringView(ByteBuffer const&).
pub func string_view_construct_byte_buffer(this: StringView*, buffer: const ByteBuffer*):
this.m_characters = byte_buffer_data_const(buffer)
this.m_length = byte_buffer_size(buffer)
assert(byte_buffer_data_const(buffer) != none)
## Ported from AK/StringView.cpp:22 AK::StringView::StringView(String const&).
pub func string_view_construct_string(this: StringView*, string: const String*):
let bytes = string_base_bytes(&string.string_base)
this.m_characters = bytes.data
this.m_length = bytes.length
## Ported from AK/StringView.cpp:28 AK::StringView::StringView(FlyString const&).
pub func string_view_construct_fly_string(this: StringView*, string: const FlyString*):
let bytes = fly_string_bytes(string)
this.m_characters = bytes.data
this.m_length = bytes.length
## Ported from AK/StringView.cpp:34 AK::StringView::StringView(ByteString const&).
pub func string_view_construct_byte_string(this: StringView*, string: ByteString):
this.m_characters = byte_string_characters(&string)
this.m_length = byte_string_length(&string)
## A view of `bytes` (the value form of StringView(ReadonlyBytes)).
pub func string_view_from_bytes(bytes: const u8[]) -> StringView:
var view = StringView()
string_view_construct_span_u8(&view, bytes)
return view
## `"text"sv`: a view of a string literal or any other `str` (DESIGN.md ยง2.6).
pub func sv(text: str) -> StringView:
return StringView(m_characters = text.bytes.data, m_length = text.length)
## Ported from AK/StringView.cpp:63 AK::for_each_line: calls back with each line of `string`
## split at "\n", "\r" and "\r\n".
func for_each_line[TCallback: StringViewCallback](string: StringView, callback: TCallback*):
let characters = string_view_bytes(&string)
var substart: usize = 0
var last_ch_was_cr = false
for i in 0..<characters.length:
let ch = characters[i]
var split_view = false
match ch:
'\n':
if last_ch_was_cr:
substart = i + 1
else:
split_view = true
last_ch_was_cr = false
'\r':
split_view = true
last_ch_was_cr = true
_:
last_ch_was_cr = false
if split_view:
_ = callback.call(string_view_substring_view_usize(&string, substart, i - substart)) else trap("MUST: for_each_line")
substart = i + 1
let taillen = string.m_length - substart
if taillen != 0:
_ = callback.call(string_view_substring_view_usize(&string, substart, taillen)) else trap("MUST: for_each_line")
# mark: Accessors ===============================================================================
## Ported from AK/StringView.h:64 AK::StringView::is_empty.
pub func string_view_is_empty(this: const StringView*) -> bool:
return this.m_length == 0
## Ported from AK/StringView.h:66 AK::StringView::characters_without_null_termination.
pub func string_view_characters_without_null_termination(this: const StringView*) -> const u8*?:
return this.m_characters
## Ported from AK/StringView.h:67 AK::StringView::length.
pub func string_view_length(this: const StringView*) -> usize:
return this.m_length
## Ported from AK/StringView.h:69 AK::StringView::bytes.
pub func string_view_bytes(this: const StringView*) -> const u8[]:
if let characters = this.m_characters:
return u8[]((u8*)characters, this.m_length)
return b""
## Ported from AK/StringView.h:71 AK::StringView::operator[].
pub func string_view_at(this: const StringView*, index: usize) -> u8:
assert(index < this.m_length)
return string_view_bytes(this)[index]
## Ported from AK/StringView.h:81 AK::StringView::begin.
pub func string_view_begin(this: const StringView*) -> SimpleIterator[StringView, u8]:
return SimpleIterator[StringView, u8](m_container = (StringView*)this, m_index = 0)
## Ported from AK/StringView.h:82 AK::StringView::end.
pub func string_view_end(this: const StringView*) -> SimpleIterator[StringView, u8]:
return SimpleIterator[StringView, u8](m_container = (StringView*)this, m_index = this.m_length)
## Ported from AK/StringView.h:84 AK::StringView::hash.
pub func string_view_hash(this: const StringView*) -> u32:
if string_view_is_empty(this):
return 0
return string_hash(string_view_characters_without_null_termination(this), string_view_length(this))
# mark: Queries =================================================================================
## Ported from AK/StringView.cpp:139 AK::StringView::starts_with(StringView, CaseSensitivity).
pub func string_view_starts_with_string_view(this: const StringView*, str_: StringView, case_sensitivity: CaseSensitivity = CaseSensitivity.case_sensitive) -> bool:
return string_utils_starts_with(*this, str_, case_sensitivity)
## Ported from AK/StringView.cpp:151 AK::StringView::ends_with(StringView, CaseSensitivity).
pub func string_view_ends_with_string_view(this: const StringView*, str_: StringView, case_sensitivity: CaseSensitivity = CaseSensitivity.case_sensitive) -> bool:
return string_utils_ends_with(*this, str_, case_sensitivity)
## Ported from AK/StringView.cpp:132 AK::StringView::starts_with(char).
pub func string_view_starts_with_u8(this: const StringView*, ch: u8) -> bool:
if string_view_is_empty(this):
return false
return ch == string_view_bytes(this)[0]
## Ported from AK/StringView.cpp:144 AK::StringView::ends_with(char).
pub func string_view_ends_with_u8(this: const StringView*, ch: u8) -> bool:
if string_view_is_empty(this):
return false
return ch == string_view_bytes(this)[string_view_length(this) - 1]
## Ported from AK/StringView.cpp:161 AK::StringView::matches(StringView, CaseSensitivity).
pub func string_view_matches_case_sensitivity(this: const StringView*, mask: StringView, case_sensitivity: CaseSensitivity = CaseSensitivity.case_insensitive) -> bool:
return string_utils_matches(*this, mask, case_sensitivity)
## Ported from AK/StringView.cpp:156 AK::StringView::matches(StringView, Vector<MaskSpan>&, CaseSensitivity).
pub func string_view_matches_vector(this: const StringView*, mask: StringView, mask_spans: Vector[MaskSpan]*, case_sensitivity: CaseSensitivity = CaseSensitivity.case_insensitive) -> bool:
return string_utils_matches(*this, mask, case_sensitivity, mask_spans)
## Ported from AK/StringView.cpp:166 AK::StringView::contains(char).
pub func string_view_contains_u8(this: const StringView*, needle: u8) -> bool:
for current in string_view_bytes(this):
if current == needle:
return true
return false
## Ported from AK/StringView.cpp:175 AK::StringView::contains(u32).
pub func string_view_contains_u32(this: const StringView*, needle: u32) -> bool:
# A code point should be at most four UTF-8 bytes, which easily fits into StringBuilder's
# inline-buffer. Therefore, this will not allocate.
var needle_builder = string_builder_new()
string_builder_try_append_code_point(&needle_builder, needle) catch:
# The needle is invalid, therefore the string does not contain it.
return false
return string_view_contains_string_view(this, string_builder_string_view(&needle_builder))
## Ported from AK/StringView.cpp:189 AK::StringView::contains(StringView, CaseSensitivity).
pub func string_view_contains_string_view(this: const StringView*, needle: StringView, case_sensitivity: CaseSensitivity = CaseSensitivity.case_sensitive) -> bool:
if needle.m_length == 1:
return string_view_contains_u8(this, string_view_bytes(&needle)[0])
return string_utils_contains(*this, needle, case_sensitivity)
## Ported from AK/StringView.cpp:196 AK::StringView::equals_ignoring_ascii_case.
pub func string_view_equals_ignoring_ascii_case(this: const StringView*, other: StringView) -> bool:
return string_utils_equals_ignoring_ascii_case(*this, other)
## Ported from AK/StringView.cpp:201 AK::StringView::is_ascii.
pub func string_view_is_ascii(this: const StringView*) -> bool:
if string_view_is_empty(this):
return true
return simdutf_validate_ascii(string_view_bytes(this))
## Ported from AK/StringView.h:103 AK::StringView::trim.
pub func string_view_trim(this: const StringView*, characters: StringView, mode: TrimMode = TrimMode.both) -> StringView:
return string_utils_trim(*this, characters, mode)
## Ported from AK/StringView.h:104 AK::StringView::trim_whitespace.
pub func string_view_trim_whitespace(this: const StringView*, mode: TrimMode = TrimMode.both) -> StringView:
return string_utils_trim_whitespace(*this, mode)
## The lambda of StringView::to_ascii_lowercase_string and to_ascii_uppercase_string: writes the
## view's bytes with ASCII case mapped.
struct StringViewToAsciiCaseCopy: BytesCallback:
var source: const u8[]
var to_uppercase: bool
func call(buffer: u8[]) -> !:
for i in 0..<self.source.length:
let character = (u32)self.source[i]
buffer[i] = (u8)(to_ascii_uppercase(character) if self.to_uppercase else to_ascii_lowercase(character))
## Ported from AK/StringView.cpp:208 AK::StringView::to_ascii_lowercase_string.
pub func string_view_to_ascii_lowercase_string(this: const StringView*) -> String:
let utf8 = Utf8View(m_string = *this)
assert(utf8_view_validate_allow_lonely_surrogates(&utf8))
var result = string_new()
var copy = StringViewToAsciiCaseCopy(source = string_view_bytes(this), to_uppercase = false)
string_base_replace_with_new_string_string_view(&result.string_base, string_view_length(this), ©) else trap("MUST: to_ascii_lowercase_string")
return result
## Ported from AK/StringView.cpp:223 AK::StringView::to_ascii_uppercase_string.
pub func string_view_to_ascii_uppercase_string(this: const StringView*) -> String:
let utf8 = Utf8View(m_string = *this)
assert(utf8_view_validate_allow_lonely_surrogates(&utf8))
var result = string_new()
var copy = StringViewToAsciiCaseCopy(source = string_view_bytes(this), to_uppercase = true)
string_base_replace_with_new_string_string_view(&result.string_base, string_view_length(this), ©) else trap("MUST: to_ascii_uppercase_string")
return result
## Ported from AK/StringView.cpp:238 AK::StringView::to_ascii_titlecase_string.
pub func string_view_to_ascii_titlecase_string(this: const StringView*) -> String:
return string_utils_to_titlecase(*this)
# mark: Searching ===============================================================================
## Ported from AK/StringView.h:110 AK::StringView::find(char, size_t).
pub func string_view_find_u8(this: const StringView*, needle: u8, start: usize = 0) -> usize?:
return string_utils_find_u8(*this, needle, start)
## Ported from AK/StringView.h:111 AK::StringView::find(StringView, size_t).
pub func string_view_find_string_view(this: const StringView*, needle: StringView, start: usize = 0) -> usize?:
return string_utils_find_string_view(*this, needle, start)
## Ported from AK/StringView.h:112 AK::StringView::find_last(char).
pub func string_view_find_last_u8(this: const StringView*, needle: u8) -> usize?:
return string_utils_find_last_u8(*this, needle)
## Ported from AK/StringView.h:113 AK::StringView::find_last(StringView).
pub func string_view_find_last_string_view(this: const StringView*, needle: StringView) -> usize?:
return string_utils_find_last_string_view(*this, needle)
## Ported from AK/StringView.h:114 AK::StringView::find_last_not.
pub func string_view_find_last_not(this: const StringView*, needle: u8) -> usize?:
return string_utils_find_last_not(*this, needle)
## Ported from AK/StringView.cpp:285 AK::StringView::find_all.
pub func string_view_find_all(this: const StringView*, needle: StringView) -> Vector[usize]:
return string_utils_find_all(*this, needle)
## Ported from AK/StringView.h:119 AK::StringView::find_any_of.
pub func string_view_find_any_of(this: const StringView*, needles: StringView, direction: SearchDirection = SearchDirection.forward) -> usize?:
return string_utils_find_any_of(*this, needles, direction)
# mark: Substrings and splitting ================================================================
## Ported from AK/StringView.h:121 AK::StringView::substring_view(size_t, size_t).
pub func string_view_substring_view_usize(this: const StringView*, start: usize, length: usize) -> StringView:
assert(start + length <= this.m_length)
if let characters = this.m_characters:
return StringView(m_characters = characters + start, m_length = length)
return StringView(m_characters = none, m_length = length)
## Ported from AK/StringView.h:129 AK::StringView::substring_view(size_t).
pub func string_view_substring_view(this: const StringView*, start: usize) -> StringView:
assert(start <= string_view_length(this))
return string_view_substring_view_usize(this, start, string_view_length(this) - start)
## The lambda of StringView::split_view: appends each part to a vector.
struct StringViewSplitViewCollect: StringViewCallback:
var parts: Vector[StringView]*
func call(part: StringView) -> IterationDecision!:
vector_append_t(self.parts, part)
return IterationDecision.continue_
## Ported from AK/StringView.cpp:47 AK::StringView::split_view(char, SplitBehavior).
pub func string_view_split_view_u8(this: const StringView*, separator: u8, split_behavior: SplitBehavior = SplitBehavior.nothing) -> Vector[StringView]:
var separator_bytes: u8[1] = [separator]
let separator_view = string_view_from_bytes(separator_bytes)
return string_view_split_view_string_view(this, separator_view, split_behavior)
## Ported from AK/StringView.cpp:53 AK::StringView::split_view(StringView, SplitBehavior).
pub func string_view_split_view_string_view(this: const StringView*, separator: StringView, split_behavior: SplitBehavior = SplitBehavior.nothing) -> Vector[StringView]:
var parts: Vector[StringView]
var collect = StringViewSplitViewCollect(parts = &parts)
string_view_for_each_split_view_string_view(this, separator, split_behavior, &collect) else trap("MUST: split_view")
return parts
## Ported from AK/StringView.cpp:290 AK::StringView::split_view_if. The predicate is a
## CharPredicate (the C++ takes a Function<bool(char)>).
pub func string_view_split_view_if[P: CharPredicate](this: const StringView*, predicate: const P*, split_behavior: SplitBehavior = SplitBehavior.nothing) -> Vector[StringView]:
var v: Vector[StringView]
if string_view_is_empty(this):
return v
var substart: usize = 0
let keep_empty = has_flag(split_behavior, SplitBehavior.keep_empty)
let keep_separator = has_flag(split_behavior, SplitBehavior.keep_trailing_separator)
let characters = string_view_bytes(this)
for i in 0..<string_view_length(this):
let ch = characters[i]
if predicate.matches(ch):
let sublen = i - substart
if sublen != 0 or keep_empty:
vector_append_t(&v, string_view_substring_view_usize(this, substart, sublen + 1 if keep_separator else sublen))
substart = i + 1
let taillen = string_view_length(this) - substart
if taillen != 0 or keep_empty:
vector_append_t(&v, string_view_substring_view_usize(this, substart, taillen))
return v
## Ported from AK/StringView.h:142 AK::StringView::find_last_split_view.
pub func string_view_find_last_split_view(this: const StringView*, separator: u8) -> StringView:
let begin = string_view_find_last_u8(this, separator) else return *this
return string_view_substring_view(this, begin + 1)
## Ported from AK/StringView.h:150 AK::StringView::find_first_split_view.
pub func string_view_find_first_split_view(this: const StringView*, separator: u8) -> StringView:
let needle_begin = string_view_find_u8(this, separator) else return *this
return string_view_substring_view_usize(this, 0, needle_begin)
## Ported from AK/StringView.h:159 AK::StringView::for_each_split_view(char, SplitBehavior, Callback).
pub func string_view_for_each_split_view_u8[TCallback: StringViewCallback](this: const StringView*, separator: u8, split_behavior: SplitBehavior, callback: TCallback*) -> !:
var separator_bytes: u8[1] = [separator]
let separator_view = string_view_from_bytes(separator_bytes)
try string_view_for_each_split_view_string_view(this, separator_view, split_behavior, callback)
## Ported from AK/StringView.h:166 AK::StringView::for_each_split_view(StringView, SplitBehavior,
## Callback). The callback answers IterationDecision and may fail; a failure propagates.
pub func string_view_for_each_split_view_string_view[TCallback: StringViewCallback](this: const StringView*, separator: StringView, split_behavior: SplitBehavior, callback: TCallback*) -> !:
assert(not string_view_is_empty(&separator))
if string_view_is_empty(this):
return
var view = *this
var maybe_separator_index = string_view_find_string_view(&view, separator)
let keep_empty = has_flag(split_behavior, SplitBehavior.keep_empty)
let keep_separator = has_flag(split_behavior, SplitBehavior.keep_trailing_separator)
while let separator_index = maybe_separator_index:
let part_with_separator = string_view_substring_view_usize(&view, 0, separator_index + separator.m_length)
if keep_empty or separator_index > 0:
var part = part_with_separator
if not keep_separator:
part = string_view_substring_view_usize(&part_with_separator, 0, separator_index)
if try callback.call(part) == IterationDecision.break_:
return
view = string_view_substring_view_starting_after_substring(&view, part_with_separator)
maybe_separator_index = string_view_find_string_view(&view, separator)
if keep_empty or not string_view_is_empty(&view):
_ = try callback.call(view)
## The lambda of StringView::lines: appends each line to a vector.
struct StringViewLinesCollect: StringViewCallback:
var lines: Vector[StringView]*
func call(part: StringView) -> IterationDecision!:
vector_append_t(self.lines, part)
return IterationDecision.continue_
## The lambda of StringView::count_lines: counts the lines.
struct StringViewCountLines: StringViewCallback:
var lines: usize
func call(part: StringView) -> IterationDecision!:
self.lines += 1
return IterationDecision.continue_
## Ported from AK/StringView.cpp:104 AK::StringView::lines. Splits by line endings; as of
## CommonMark 0.29 a line ending is "a newline (U+000A), a carriage return (U+000D) not followed
## by a newline, or a carriage return and a following newline".
pub func string_view_lines(this: const StringView*, consider_carriage_return: StringViewConsiderCarriageReturn = StringViewConsiderCarriageReturn.yes) -> Vector[StringView]:
var lines: Vector[StringView]
if string_view_is_empty(this):
return lines
if consider_carriage_return == StringViewConsiderCarriageReturn.no:
return string_view_split_view_u8(this, '\n', SplitBehavior.keep_empty)
var collect = StringViewLinesCollect(lines = &lines)
for_each_line(*this, &collect)
return lines
## Ported from AK/StringView.cpp:118 AK::StringView::count_lines.
pub func string_view_count_lines(this: const StringView*, consider_carriage_return: StringViewConsiderCarriageReturn = StringViewConsiderCarriageReturn.yes) -> usize:
if string_view_is_empty(this):
return 1
if consider_carriage_return == StringViewConsiderCarriageReturn.no:
return string_view_count_u8(this, '\n') + 1
var counter = StringViewCountLines(lines = 0)
for_each_line(*this, &counter)
return counter.lines
## Ported from AK/StringView.cpp:243 AK::StringView::substring_view_starting_from_substring:
## the rest of this view from the start of `substring`, which must be a view into this one.
pub func string_view_substring_view_starting_from_substring(this: const StringView*, substring: StringView) -> StringView:
let remaining_characters = (usize)(substring.m_characters else trap("VERIFY: substring view"))
let characters = (usize)(this.m_characters else trap("VERIFY: substring view"))
assert(remaining_characters >= characters)
assert(remaining_characters <= characters + this.m_length)
let remaining_length = this.m_length - (remaining_characters - characters)
return string_view_substring_view_usize(this, remaining_characters - characters, remaining_length)
## Ported from AK/StringView.cpp:252 AK::StringView::substring_view_starting_after_substring:
## the rest of this view after the end of `substring`, which must be a view into this one.
pub func string_view_substring_view_starting_after_substring(this: const StringView*, substring: StringView) -> StringView:
let remaining_characters = (usize)(substring.m_characters else trap("VERIFY: substring view")) + substring.m_length
let characters = (usize)(this.m_characters else trap("VERIFY: substring view"))
assert(remaining_characters >= characters)
assert(remaining_characters <= characters + this.m_length)
let remaining_length = this.m_length - (remaining_characters - characters)
return string_view_substring_view_usize(this, remaining_characters - characters, remaining_length)
## Ported from AK/StringView.h:336 AK::StringView::is_one_of_ignoring_ascii_case: whether the
## view equals any of `strings`, ignoring ASCII case. The C++ parameter pack of string literals
## is a span of `str` (added at integration for text_codec).
pub func string_view_is_one_of_ignoring_ascii_case(this: const StringView*, strings: const str[]) -> bool:
for string in strings:
if string_view_equals_ignoring_ascii_case(this, sv(string)):
return true
return false
## Ported from AK/StringView.cpp:261 AK::StringView::copy_characters_to_buffer: copies as much as
## fits and a NUL; answers whether everything fit.
pub func string_view_copy_characters_to_buffer(this: const StringView*, buffer: u8[]) -> bool:
# We must fit at least the NUL-terminator.
assert(buffer.length > 0)
let characters_to_copy = this.m_length if this.m_length < buffer.length - 1 else buffer.length - 1
copy_bytes(buffer, string_view_bytes(this)[..<characters_to_copy])
buffer[characters_to_copy] = 0
return characters_to_copy == this.m_length
# mark: Comparison ==============================================================================
## Ported from AK/StringView.h:256 AK::StringView::operator==(char const*): compares with a
## NUL-terminated string.
pub func string_view_eq_u8_const(this: const StringView*, cstring: const u8*?) -> bool:
let cp = cstring else return false
# NOTE: `m_characters` is not guaranteed to be null-terminated, but `cstring` is.
let characters = string_view_bytes(this)
for i in 0..<this.m_length:
if cp[i] == 0:
return false
if characters[i] != cp[i]:
return false
return cp[this.m_length] == 0
## Ported from AK/StringView.h:271 AK::StringView::operator==(char).
pub func string_view_eq_u8_const_2(this: const StringView*, c_: u8) -> bool:
return this.m_length == 1 and string_view_bytes(this)[0] == c_
## Ported from AK/StringView.cpp:273 AK::StringView::operator==(ByteString const&).
pub func string_view_eq_byte_string(this: const StringView*, string: ByteString) -> bool:
return string_view_eq_string_view(this, byte_string_view(&string))
## Ported from AK/StringView.h:278 AK::StringView::compare.
pub func string_view_compare(this: const StringView*, other: StringView) -> i32:
if this.m_length == 0 and other.m_length == 0:
return 0
let c_ = compare_bytes(string_view_bytes(this), string_view_bytes(&other))
if c_ == 0:
if string_view_length(this) < string_view_length(&other):
return -1
if string_view_length(this) == string_view_length(&other):
return 0
return 1
return c_
## Ported from AK/StringView.h:295 AK::StringView::operator==(StringView).
pub func string_view_eq_string_view(this: const StringView*, other: StringView) -> bool:
return string_view_length(this) == string_view_length(&other) and string_view_compare(this, other) == 0
## Ported from AK/StringView.h:300 AK::StringView::operator!=.
pub func string_view_ne(this: const StringView*, other: StringView) -> bool:
return string_view_length(this) != string_view_length(&other) or string_view_compare(this, other) != 0
## Ported from AK/StringView.h:305 AK::StringView::operator<.
pub func string_view_lt(this: const StringView*, other: StringView) -> bool:
return string_view_compare(this, other) < 0
## Ported from AK/StringView.h:306 AK::StringView::operator<=.
pub func string_view_le(this: const StringView*, other: StringView) -> bool:
return string_view_compare(this, other) <= 0
## Ported from AK/StringView.h:307 AK::StringView::operator>.
pub func string_view_gt(this: const StringView*, other: StringView) -> bool:
return string_view_compare(this, other) > 0
## Ported from AK/StringView.h:308 AK::StringView::operator>=.
pub func string_view_ge(this: const StringView*, other: StringView) -> bool:
return string_view_compare(this, other) >= 0
## `view == "text"`: compares with a string literal (the C++'s `sv == "text"sv`).
pub func string_view_equals(this: const StringView*, text: str) -> bool:
return string_view_eq_string_view(this, sv(text))
# mark: Conversions =============================================================================
## Ported from AK/StringView.cpp:278 AK::StringView::to_byte_string.
pub func string_view_to_byte_string(this: const StringView*) -> ByteString:
return byte_string_from_string_view(*this)
## Ported from AK/StringView.h:312 AK::StringView::is_whitespace.
pub func string_view_is_whitespace(this: const StringView*) -> bool:
return string_utils_is_whitespace(*this)
## Ported from AK/StringView.cpp:280 AK::StringView::replace.
pub func string_view_replace(this: const StringView*, needle: StringView, replacement: StringView, replace_mode: ReplaceMode) -> ByteString:
return string_utils_replace_string_view(*this, needle, replacement, replace_mode)
## Ported from AK/StringView.h:319 AK::StringView::count(StringView).
pub func string_view_count_string_view(this: const StringView*, needle: StringView) -> usize:
return string_utils_count_string_view(*this, needle)
## Ported from AK/StringView.h:324 AK::StringView::count(char).
pub func string_view_count_u8(this: const StringView*, needle: u8) -> usize:
return string_utils_count_u8(*this, needle)
## Ported from AK/StringView.h:348 AK::StringView::to_number<i8>.
pub func string_view_to_number_i8(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> i8?:
return parse_number_string_view_i8(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<i16>.
pub func string_view_to_number_i16(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> i16?:
return parse_number_string_view_i16(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<i32>.
pub func string_view_to_number_i32(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> i32?:
return parse_number_string_view_i32(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<i64>.
pub func string_view_to_number_i64(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> i64?:
return parse_number_string_view_i64(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<u8>.
pub func string_view_to_number_u8(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> u8?:
return parse_number_string_view_u8(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<u16>.
pub func string_view_to_number_u16(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> u16?:
return parse_number_string_view_u16(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<u32>.
pub func string_view_to_number_u32(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> u32?:
return parse_number_string_view_u32(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<u64>.
pub func string_view_to_number_u64(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> u64?:
return parse_number_string_view_u64(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<f32>.
pub func string_view_to_number_f32(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> f32?:
return parse_number_string_view_f32(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:348 AK::StringView::to_number<f64>.
pub func string_view_to_number_f64(this: const StringView*, trim_whitespace: TrimWhitespace = TrimWhitespace.yes, base_: i32 = 10) -> f64?:
return parse_number_string_view_f64(*this, trim_whitespace, base_)
## Ported from AK/StringView.h:357 AK::StringView::StringView(Badge<SentinelOptionalTraits>,
## nullptr_t): the view with no characters pointer.
pub func string_view_construct_string_view(this: StringView*):
this.m_characters = none
this.m_length = 0
# mark: Traits and literals =====================================================================
## Ported from AK/StringView.h:387 AK::CaseInsensitiveASCIIStringViewTraits::hash.
pub func case_insensitive_ascii_string_view_traits_hash(s: StringView) -> u32:
if string_view_is_empty(&s):
return 0
return case_insensitive_string_hash(string_view_characters_without_null_termination(&s), string_view_length(&s))
## Ported from AK/StringView.h:393 AK::CaseInsensitiveASCIIStringViewTraits::equals.
pub func case_insensitive_ascii_string_view_traits_equals(a: StringView, b: StringView) -> bool:
return string_view_equals_ignoring_ascii_case(&a, b)
## Ported from AK/StringView.h:398 operator""sv: a view of `length` characters.
pub func literalsv_u8(cstring: const u8*?, length: usize) -> StringView:
var view = StringView()
string_view_construct_u8_usize(&view, cstring, length)
return view