NAME
Clownfish::String - Immutable string holding Unicode characters.
SYNOPSIS
my$string= Clownfish::String->new('abc');$string->to_perl,"\n";
DESCRIPTION
CONSTRUCTORS
new
my$string= Clownfish::String->new($perl_string);
Return a String containing the passed-in Perl string.
METHODS
cat
$string->cat($other);
Return the concatenation of the String and other.
to_i64
$string->to_i64();
Extract a 64-bit integer from a decimal string. See basex_to_i64() for details.
basex_to_i64
$string->basex_to_i64($base);
Extract a 64-bit integer from a variable-base stringified version. Expects an optional minus sign followed by base-x digits, stopping at any non-digit character. Returns zero if no digits are found. If the value exceeds the range of an int64_t, the result is undefined.
base - A base between 2 and 36.
to_f64
$string->to_f64();
Convert a string to a floating-point number using the C library function strtod.
starts_with
$string->starts_with($prefix);
Test whether the String starts with prefix.
ends_with
$string->ends_with($suffix);
Test whether the String ends with suffix.
contains
$string->contains($substring);
Test whether the String contains substring.
find
$string->find($substring);
Return a StringIterator pointing to the first occurrence of substring within the String, or undef if the substring does not match.
length
$string->length();
Return the number of Unicode code points the String contains.
get_size
$string->get_size();
Return the number of bytes occupied by the String’s internal content.
to_bytebuf
$string->to_bytebuf();
Return a ByteBuf which holds a copy of the String.
clone
$string->clone();
Return a clone of the object.
compare_to
$string->compare_to($other);
Indicate whether one String is less than, equal to, or greater than another. The Unicode code points of the Strings are compared lexicographically. Throws an exception if other is not a String.
Returns: 0 if the Strings are equal, a negative number if self is less than other, and a positive number if self is greater than other.
trim
$string->trim();
Remove Unicode whitespace characters from both top and tail. Whitespace is any character that has the Unicode property White_Space.
trim_top
$string->trim_top();
Remove leading Unicode whitespace. Whitespace is any character that has the Unicode property White_Space.
trim_tail
$string->trim_tail();
Remove trailing Unicode whitespace. Whitespace is any character that has the Unicode property White_Space.
code_point_at
$string->code_point_at($tick);
Return the Unicode code point located tick code points in from the top. Return CFISH_STR_OOB if out of bounds.
code_point_from
$string->code_point_from($tick);
Return the Unicode code point located tick code points counting backwards from the end. Return CFISH_STR_OOB if out of bounds.
substring
$string->substring(offset=>$int,# requiredlen=>$int,# required);
Return a new String containing a copy of the specified substring.
offset - Offset from the top, in code points.
len - The desired length of the substring, in code points.
top
$string->top();
Return an iterator initialized to the start of the string.
tail
$string->tail();
Return an iterator initialized to the end of the string.
INHERITANCE
Clownfish::String isa Clownfish::Obj.