Name
SPVM::Fn - SPVM Starndard Functions
Usage
use Fn;
my $byte_max = Fn->BYTE_MAX();
my $short_max = Fn->SHORT_MAX();
my $int_max = Fn->INT_MAX();
my $long_max = Fn->LONG_MAX();
# Cut a newline LF
{
my $ret = Fn->chompr("abc\n");
}
# Copy a string
{
my $string = "abc";
my $string_copy = Fn->copy_string ($string);
}
# Search substr
{
my $found_offset = Fn->index("pppabcde", "bcd", 2);
}
# split a string by the specific separator
my $string = "foo,bar,baz";
my $splited_strs = Fn->split(",", $string);
# Copy a byte array
{
my $nums = [(byte)1, 2, 3];
my $nums_copy = Fn->copy_array_byte($nums);
}
# Copy a short array
{
my $nums = [(short)1, 2, 3];
my $nums_copy = Fn->copy_array_short($nums);
}
# Copy a int array
{
my $nums = [1, 2, 3];
my $nums_copy = Fn->copy_array_int($nums);
}
# Copy a long array
{
my $nums = [(long)1, 2, 3];
my $nums_copy = Fn->copy_array_long($nums);
}
# Copy a float array
{
my $nums = [1.5f, 2.5f, 3.5f];
my $nums_copy = Fn->copy_array_float($nums);
}
# Copy a double array
{
my $nums = [1.5, 2.5, 3.5];
my $nums_copy = Fn->copy_array_double($nums);
}
# Copy a string array
{
my $strs = ["abc", "def", "ghi"]
my $strs_copy = Fn->copy_array_string($strs);
}
# Check if the two byte arrays equal
{
my $nums1 = [(byte)1, 2];
my $nums2 = [(byte)1, 2];
my $ret = Fn->equals_array_byte($nums1, $nums2);
}
# Check if the two short arrays equal
{
my $nums1 = [(short)1, 2];
my $nums2 = [(short)1, 2];
my $ret = Fn->equals_array_short($nums1, $nums2);
}
# Check if the two int arrays equal
{
my $nums1 = [(int)1, 2];
my $nums2 = [(int)1, 2];
my $ret = Fn->equals_array_int($nums1, $nums2);
}
# Check if the two long arrays equal
{
my $nums1 = [(long)1, 2];
my $nums2 = [(long)1, 2];
my $ret = Fn->equals_array_long($nums1, $nums2);
}
# Check if the two float arrays equal
{
my $nums1 = [(float)1, 2];
my $nums2 = [(float)1, 2];
my $ret = Fn->equals_array_float($nums1, $nums2);
}
# Check if the two double arrays equal
{
my $nums1 = [(double)1, 2];
my $nums2 = [(double)1, 2];
my $ret = Fn->equals_array_double($nums1, $nums2);
}
# Check if the two string arrays equal
{
my $strs1 = ["abc", "def"];
my $strs2 = ["abc", "def"];
my $ret = Fn->equals_array_string($strs1, $strs2);
}
# Copy object array
my $objects = [(object)Int->new(1), Int->new(2), Int->new(3)];
my $objects_copy = Fn->copy_array_object($objects, method : object ($obj : object) {
my $int_obj = (Int)$obj;
my $new_int_obj = Int->new($int_obj->value);
return $new_int_obj;
});Description
Fn module provides SPVM Starndard Functions. Fn contains number, string and array utilities.
Class Methods
Class method of Fn module.
DBL_MAX
static method DBL_MAX : double ()Return the value of DBL_MAX macro defined in float.h header of C language.
DBL_MIN
static method DBL_MIN : double ()Return the value of DBL_MIN macro defined in float.h header of C language.
FLT_MAX
static method FLT_MAX : float ()Return the value of FLT_MAX macro defined in float.h header of C language.
FLT_MIN
static method FLT_MIN : float ()Return the value of FLT_MIN macro defined in float.h header of C language.
INT16_MAX
static method INT16_MAX : short ()Return 32767. The maximum value of the signed 16bit integer.
INT16_MIN
static method INT16_MIN : short ()Return -32768. The minimal value of the signed 16bit integer.
INT32_MAX
static method INT32_MAX : int ()Return 2147483647. The maximum value of the signed 32bit integer.
INT32_MIN
static method INT32_MIN : int ()Return -2147483648. The minimal value of the signed 32bit integer.
INT64_MAX
static method INT64_MAX : long ()Return 9223372036854775807. The maximum value of the signed 64bit integer.
INT64_MIN
static method INT64_MIN : long ()Return -9223372036854775808. The minimal value of the signed 64bit integer.
INT8_MAX
INT8_MAX : byte ()Return 127. The maximum value of the signed 8bit integer.
INT8_MIN
static method INT8_MIN : byte ()Return -128. The minimal value of the signed 8bit integer.
UINT16_MAX
static method UINT16_MAX : short ()Return -1. This represents 0xFFFF in the unsigned 16bit integer in 2's complement.
UINT32_MAX
static method UINT32_MAX : int ()Return -1. This represents 0xFFFFFFFF in the unsigned 32bit integer in 2's complement.
UINT64_MAX
static method UINT64_MAX : long ()Return -1. This represents 0xFFFFFFFFFFFFFFFF in the unsigned 64bit integer in 2's complement.
UINT8_MAX
static method UINT8_MAX : byte ()Return -1. The same bit expression of 0xFF in the unsigned 8bit integer in 2's complement.
DOUBLE_MAX
static method DOUBLE_MAX : double ()Same as "DBL_MAX".
DOUBLE_MIN
static method DOUBLE_MIN : double ()Same as "DBL_MIN".
FLOAT_MAX
static method FLOAT_MAX : float ()Same as "FLT_MAX".
FLOAT_MIN
static method FLOAT_MIN : float()Same as "FLT_MIN".
SHORT_MAX
static method SHORT_MAX : short ()Same as "INT16_MAX".
SHORT_MIN
static method SHORT_MIN : short ()Same as "INT16_MIN".
INT_MAX
static method INT_MAX : int ()Same as "INT32_MAX".
INT_MIN
static method INT_MIN : int ()Same as "INT32_MIN".
LONG_MAX
static method LONG_MAX : long ()Same as "INT64_MAX".
LONG_MIN
static method LONG_MIN : long ()Same as "INT64_MIN".
INT8_MAX
static method INT8_MAX : byte ()Same as "INT8_MAX".
BYTE_MIN
static method BYTE_MIN : byte ()Same as "INT8_MIN".
USHORT_MAX
static method USHORT_MAX : short ()Same as "UINT16_MAX".
UINT_MAX
static method UINT_MAX : int ()Same as "UINT32_MAX".
ULONG_MAX
static method ULONG_MAX : longSame as "UINT64_MAX".
UBYTE_MAX
static method UBYTE_MAX : byte ()Same as "UINT8_MAX".
abs
static method abs : int ($x : int)Return the absolute value.
chomp
static method chomp : void ($string : mutable string)Remove \n of the end of the string. This method changes the given string itself.
If the string is undef or the length is zero, does nothing.
chompr
static method chompr : string ($string : string)Copy the string and remove "\n" of the end of the string and return it.
chr
static method contains : int ($string : string, $sub_string : string)Convert Unicode code point to a UTF-8 character. If the Unicode code point is not a Unicode scalar value, return undef.
See also Unicode-is_unicode_scalar_value|SPVM::Unicode/"is_unicode_scalar_value">.
contains
static method index : int ($string : string, $sub_string : string, $start_pos : int)Search for the substring in the string. If the substring is found, return 1. Otherwise return 0.
copy_array_byte
static method copy_array_byte : byte[] ($nums : byte[])Copy a byte array.
If the array is undef, return undef.
copy_array_double
static method copy_array_double : double[] ($nums : double[])Copy a double array.
If the array is undef, return undef.
copy_array_float
static method copy_array_float : float[] ($nums : float[])Copy a float array.
If the array is undef, return undef.
copy_array_int
static method copy_array_int : int[] ($nums : int[])Copy a int array.
If the array is undef, return undef.
copy_array_long
static method copy_array_long : long[] ($nums : long[])Copy a long array.
If the array is undef, return undef.
copy_array_object
static method copy_array_object : object[] ($objects : object[], $cloner : Cloner)Copy a object array with a Cloner callback implemetation.
If the array is undef, return undef.
copy_array_range_byte
static method copy_array_range_byte : byte[] ($nums : byte[], $offset : int, $length : int)Slice elements in the byte array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_double
static method copy_array_range_double : double[] ($nums : double[], $offset : int, $length : int)Slice elements in the double array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_float
static method copy_array_range_float : float[] ($nums : float[], $offset : int, $length : int)Slice elements in the float array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_int
static method copy_array_range_int : int[] ($nums : int[], $offset : int, $length : int)Slice elements in the int array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_long
static method copy_array_range_long : long[] ($nums : long[], $offset : int, $length : int)Slice elements in the long array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_object
static method copy_array_range_object : object[] ($elems : object[], $offset : int, $length : int)Slice elements in the object array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_short
static method copy_array_range_short : short[] ($nums : short[], $offset : int, $length : int)Slice elements in the short array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_range_string
static method copy_array_range_string : string[] ($strings : string[], $offset : int, $length : int)Slice elements in the string array with the start offset and the length.
Array must be defined, otherwise an exception occurs.
Offset must be in the array range, otherwise an exception occurs.
Length must be more than or equals to 0, othrewise an exception occurs.
Offset + length must not be in the array range, othrewise an exception occurs.
copy_array_short
static method copy_array_short : short[] ($nums : short[])Copy a short array.
If the array is undef, return undef.
copy_array_string
static method copy_array_string : string[] ($strings : string[])Copy a string array.
If the array is undef, return undef.
copy_string
static method copy_string : string ($string : string)Copy the value of the string, and return a new string.
If the argument string is undef, return undef.
crand
static method crand : int ($seed : int*);Get random number(0 <= rundom_number <= Fn->RAND_MAX) with a seed.
The seed is updated.
This method is thread safe different from rand function of C language.
Examples:
use Time;
my $seed = (int)Time->time;
my $crand0 = Fn->crand(\$seed);
my $crand1 = Fn->crand(\$seed);dump_array_byte
static method dump_array_byte : string ($nums : byte[])Convert the elements in the byte array to string and join them with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
dump_array_double
static method dump_array_double : string ($nums : double[])Convert the elements in the double array to string and join them with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
dump_array_float
static method dump_array_float : string ($nums : float[])Convert the elements in the float array to string and join them with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
dump_array_int
static method dump_array_int : string ($nums : int[])Convert the elements in the int array to string and join them with "," and surround it with "[" and "]", and return it.
If byte array is undef, return undef.
dump_array_long
static method dump_array_long : string ($nums : long[])Convert the elements in the long array to string and join them with "," and surround it with "[" and "]", and return it.
If byte array is undef, return undef.
dump_array_object
static method dump_array_object : string ($objects : object[], $stringer : Stringer)Convert the elements in the object array to string by a SPVM::Stringer callback implementation and join them with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If string array is undef, return undef.
dump_array_short
static method dump_array_short : string ($nums : short[])Convert the elements in the short array to string and join them with "," and surround it with "[" and "]".
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
dump_array_string
static method dump_array_string : string ($strings : string[])Join the strings in the array with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If string array is undef, return undef.
dump_array_unsigned_byte
static method dump_array_unsigned_byte : string ($nums : byte[])Convert the elements in the byte array to string interpreting as an unsigned 8bit integer and join them with "," and surround it with "[" and "]", and return it.
If byte array is undef, return undef.
dump_array_unsigned_int
static method dump_array_unsigned_int : string ($nums : int[])Convert the elements in the int array to string interpreting as an unsigned 32bit integer and join them with "," and surround it with "[" and "]", and return it.
If byte array is undef, return undef.
dump_array_unsigned_long
static method dump_array_unsigned_long : string ($nums : long[])Convert the elements in the long array to string interpreting as an unsigned 64bit integer and join them with "," and surround it with "[" and "]", and return it.
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
dump_array_unsigned_short
static method dump_array_unsigned_short : string ($nums : short[])Convert the elements in the short array to string interpreting as an unsigned 16bit integer and join them with "," and surround it with "[" and "]".
For readability spaces and line breaks are inserted.
If byte array is undef, return undef.
get_next_code_point
static method get_next_code_point : int ($str : string, $offset_ref : int*)Get a Unicode codepoint from UTF-8 string with the reference of the offset of the string.
The offset is updated to the position of the next UTF-8 character.
If the offset is over the length of the string, return a negative value.
If an invalid code point is got, return a negative value.
equals_array_byte
static method equals_array_byte : int ($nums1 : byte[], $nums2 : byte[])Check if two byte arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_double
static method equals_array_double : int ($nums1 : double[], $nums2 : double[])Check if two double arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_float
static method equals_array_float : int ($nums1 : float[], $nums2 : float[])Check if two float arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_int
static method equals_array_int : int ($nums1 : int[], $nums2 : int[])Check if two int arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_long
static method equals_array_long : int ($nums1 : long[], $nums2 : long[])Check if two long arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_object
static method static method equals_array_object : int ($objs1 : object[], $objs2 : object[], $equality_checker : EqualityChecker)Check equality of two objects. You must sepecify a EqualityChecker object to check the equality of each element.
$objs1 and $objs2 and $equality_checker must be defined, otherwise an exception occurs.
Return 1 if the length of $objs1 and $objs2 is same and all element is same, otherwise return 0.
equals_array_short
static method equals_array_short : int ($nums1 : short[], $nums2 : short[])Check if two short arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
equals_array_string
static method equals_array_string : int ($strs1 : double[], $strs2 : double[])Check if two string arrays equal.
If at least one of the arrays is undef, a excetpion occurs.
hex
static method hex : int ($hex_string : string)Convert hex string to int value.
the hex string must be defined, otherwise an exception occurs.
the hex string must be a valid expression which is represented by a regex "^([0-9a-fA-F]{1,8})$", otherwise an exception occurs.
index
static method index : int ($string : string, $sub_string : string, $start_pos : int)Search for the substring in the string from the starting position and return the found position. If the substring is not found, return -1.
index_len
static method index_len : int ($string : string, $sub_string : string, $start_pos : int, $max_string_length : int)Same as the "index" method except that the max length of the string can be specified.
If the max string length of the argument is greater than the lenght of the string, the max string length become the length of string.
is_alnum
static method is_alnum : int ($code_point : int)If character is alphanumeric('A'-'Z', 'a'-'z', '0'-'9'), return 1. Otherwise return 0.
is_alpha
static method is_alpha : int ($code_point : int)If character is alphabetic('A'-'Z', 'a'-'z'), return 1. Otherwise return 0.
is_blank
static method is_blank : int ($code_point : int)If character is blank(' ', '\t'), return 1. Otherwise return 0.
is_cntrl
static method is_cntrl : int ($code_point : int)If character is a control character(0x00-0x1F, 0x7F), return 1. Otherwise return 0.
is_digit
static method is_digit : int ($code_point : int)If character is decimal digit 0-9, return 1. Otherwise return 0.
is_graph
static method is_graph : int ($code_point : int)If character has graphical representation(0x21-0x7E), return 1. Otherwise return 0.
is_hex_digit
static method is_hex_digit : int ($code_point : int)If the character is hexadecimal digit 0-9a-fA-F, return 1. Otherwise return 0.
is_lower
static method is_lower : int ($code_point : int)If character is lowercase letter('a'-'z'), return 1. Otherwise return 0.
is_perl_space
static method is_perl_space : int ($code_point : int)If character is Perl space character(' ', '\r', '\n', '\t', '\f'), return 1. Otherwise return 0.
is_perl_word
static method is_perl_word : int ($code_point : int)If character is Perl word character('a'-'z', 'A'-'Z', '_', '0'-'9'), return 1. Otherwise return 0.
is_print
static method is_print : int ($code_point : int)If character is printable(0x20-0x7E), return 1. Otherwise return 0.
is_punct
static method is_punct : int ($code_point : int)If character is a punctuation character(0x21-0x2f, 0x3a-0x40, 0x5b-0x60, 0x7b-0x7e), return 1. Otherwise return 0.
is_space
static method is_space : int ($code_point : int)If character is a white-space(' ', '\t', '\n', '\v', '\f', '\r'), return 1. Otherwise return 0.
is_upper
static method is_upper : int ($code_point : int)If character is uppercase letter('A'-'Z'), return 1. Otherwise return 0.
is_xdigit
static method is_xdigit : int ($code_point : int)If character is hexadecimal digit('0'-'9', 'A'-'F', 'a'-'f'), return 1. Otherwise return 0.
is_mulnum_array
static method is_mulnum_array : int ($object : object)If the object is a multi numeric array, returns 1, otherwise returns 0.
If the object is NULL, returns 0.
is_numeric_array
static method is_numeric_array : int ($object : object)If the object is a numeric array, returns 1, otherwise returns 0.
If the object is NULL, returns 0.
is_object_array
static method is_object_array : int ($object : object)If the object is a object array, returns 1, otherwise returns 0.
If the object is NULL, returns 0.
join
static method join : string ($sep : string, $strings : string[])Join a string array with separater and return it.
If separater is undef, an exception occurs.
If string array is undef, an exception occurs.
labs
static method labs : long ($x : long)Return the absolute value.
lc
static method lc : string ($string : string)Convert uppercase string to lowercase string.
lcfirst
static method lcfirst : string ($string : string)Convert first chracter of string from uppercase to lowercase.
look_next_code_point
static method look_next_code_point : int ($string : string, $offset_ref : int*)Same as "get_next_code_point", but the offset is not updated.
memcpy
static method memcpy : void ($dest : object, $dest_byte_offset : int, $source : object, $source_byte_offset : int, $byte_length : int);The destination must be a string type, a numeric type, or a multi numeric type, otherwise an exception is thrown.
If the destination is a read-only string, an exception is thrown.
The source must be a string type, a numeric type, or a multi numeric type, otherwise an exception is thrown.
Copy the source to the destination with the given each offset and the given length by byte unit.
If source data range and destination data overlap, the result is not guaranteed.
The destnation must be defined, otherwise an exception occurs.
The source must be defined, otherwise an exception occurs.
The length must be more than or equals to 0, otherwise an exception occurs.
The destnation byte offset + byte length must be within the byte range of the destnation, otherwise an exception occurs.
The source byte offset + byte length must be within the byte range of the source, otherwise an exception occurs.
If source data range and destination data overlap, the result is not guaranteed.
memcpy_byte
static method memcpy_byte : void ($dest : byte[], $dest_offset : int, $source : byte[], $source_offset : int, $length : int)Copy source byte array to destination byte array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_double
static method memcpy_double : void ($dest : double[], $dest_offset : int, $source : double[], $source_offset : int, $length : int)Copy source double array to destination double array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_float
static method memcpy_float : void ($dest : float[], $dest_offset : int, $source : float[], $source_offset : int, $length : int)Copy source float array to destination float array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_int
static method memcpy_int : void ($dest : int[], $dest_offset : int, $source : int[], $source_offset : int, $length : int)Copy source int array to destination int array with the each offset and a length.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_long
static method memcpy_long : void ($dest : long[], $dest_offset : int, $source : long[], $source_offset : int, $length : int)Copy source long array to destination long array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_short
static method memcpy_short : void ($dest : short[], $dest_offset : int, $source : short[], $source_offset : int, $length : int)Copy source short array to destination short array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memcpy_object
static method memcpy_object : void ($dest : object[], $dest_offset : int, $source : object[], $source_offset : int, $length : int)Copy source object array to destination object array with the each offset and a length.
If source data range and destination data overlap, the result is not guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove
static method memmove : void ($dest : object, $dest_byte_offset : int, $source : object, $source_byte_offset : int, $byte_length : int);The destination must be a string type, a numeric type, or a multi numeric type, otherwise an exception is thrown.
If the destination is a read-only string, an exception is thrown.
The source must be a string type, a numeric type, or a multi numeric type, otherwise an exception is thrown.
Copy the source to the destination with the given each offset and the given length by byte unit.
If source data range and destination data overlap, the result is not guaranteed.
The destnation must be defined, otherwise an exception occurs.
The source must be defined, otherwise an exception occurs.
The length must be more than or equals to 0, otherwise an exception occurs.
The destnation byte offset + byte length must be within the byte range of the destnation, otherwise an exception occurs.
The source byte offset + byte length must be within the byte range of the source, otherwise an exception occurs.
memmove_byte
static method memmove_byte : void ($dest : byte[], $dest_offset : int, $source : byte[], $source_offset : int, $length : int)Copy source byte array to destination byte array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_double
memmove_double : void ($dest : double[], $dest_offset : int, $source : double[], $source_offset : int, $length : int)Copy source double array to destination double array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_float
static method memmove_float : void ($dest : float[], $dest_offset : int, $source : float[], $source_offset : int, $length : int)Copy source float array to destination float array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_int
memmove_int : void ($dest : int[], $dest_offset : int, $source : int[], $source_offset : int, $length : int)Copy source int array to destination int array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_long
memmove_long : void ($dest : long[], $dest_offset : int, $source : long[], $source_offset : int, $length : int)Copy source long array to destination long array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_short
memmove_short : void ($dest : short[], $dest_offset : int, $source : short[], $source_offset : int, $length : int)Copy source short array to destination short array with the each offset and a length.
Even if source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
memmove_object
static method memmove_object : void ($dest : object[], $dest_offset : int, $source : object[], $source_offset : int, $length : int)Copy source object array to destination object array with the each offset and a length.
If source data range and destination data overlap, the result is guaranteed.
Destnation must be defined, otherwise an exception occurs.
Source must be defined, otherwise an exception occurs.
Length must be more than or equals to 0, otherwise an exception occurs.
Destnation offset + length must be within the range of the destnation array, otherwise an exception occurs.
Source offset + length must be within the range of the source array, otherwise an exception occurs.
new_array_proto
static method new_array_proto : object[] ($proto_array : object[], $length : int)Create a new generic object array as the same type as the given array.
memset_byte
static method memset_byte : void ($dest : byte[], $dest_offset : int, $value : byte, $length : int)Set each element of the byte array to the value with the offset and the length.
memset_double
static method memset_double : void ($dest : double[], $dest_offset : int, $value : double, $length : int)Set each element of the double array to the value with the offset and the length.
memset_float
static method memset_float : void ($dest : float[], $dest_offset : int, $value : float, $length : int)Set each element of the float array to the value with the offset and the length.
memset_int
static method memset_int : void ($dest : int[], $dest_offset : int, $value : int, $length : int)Set each element of the int array to the value with the offset and the length.
memset_long
static method memset_long : void ($dest : long[], $dest_offset : int, $value : long, $length : int)Set each element of the long array to the value with the offset and the length.
memset_short
static method memset_short : void ($dest : short[], $dest_offset : int, $value : short, $length : int)Set each element of the short array to the value with the offset and the length.
memset_object
static method memset_object : void ($dest : object[], $dest_offset : int : int, $value : object, $length)Set each element of the object array to the value with the offset and the length.
ord
static method ord : int ($utf8_character : string)Gets the Unicode code point from the first character of the specified <UTF-8> string.
If the specified UTF-8 character is undef, returns a negative value.
If the length of the specified UTF-8 string is 0, returns a negative value.
If the specified UTF-8 character is invalid UTF-8 character, returns a negative value.
powi
static method powi : int ($x : int, $y : int)Calculate the exponentiation.
powl
static method powl : long ($x : long, $y : long)Calculate the exponentiation.
rand
static method rand : double ($seed : int*)Get random number(0 <= random_number < 1)with a seed.
The seed is updated.
This method is thread safe different from rand function of C language.
Examples:
use Time;
my $seed = (int)Time->time;
my $rand0 = Fn->rand(\$seed);
my $rand1 = Fn->rand(\$seed);repeat
static method repeat : double ($string : string, $count : int)Get the repeat string.
If the string is not defined, an exception will be thrown.
If the repeat is not more than 0, an exception will be thrown.
Examples:
# "abcabcabc"
my $repeat_string = Fn->repeat("abc", 3);rindex
static method rindex : int ($string : string, $sub_string : string, $start_pos : int)Search for the substring in the string from the starting position to the start of the string. and return the found position. If the substring is not found, return -1.
rindex_len
static method rindex_len : int ($string : string, $sub_string : string, $start_pos : int, $max_string_length : int)Same as the "rindex" method except that the max length of the string can be specified.
If the max string length of the argument is greater than the lenght of the string, the max string length become the length of string.
shorten
static method shorten : void ($string : mutable string, $length : int32_t)Shorten the string to the given length.
If the string is null, does nothing.
If the given length is greater than the length of the string, does nothing.
If the given length is lower than 0, the given length become 0.
In the level of native APIs, the charaters of the after the given length are filled with \0.
split
static method split : string[] ($sep : string, $string : string)Split a string by the specific separator.
sprintf
static method sprintf : string ($format : string, $args : object[]...)Create a formatted string with the format and the values.
| Specifiers | Descriptions | Acceptable Types |
|---|---|---|
| %c | An UTF-8 character | Byte, Int |
| %d | Signed 32bit integer | Int |
| %u | Unsigned 32bit integer | Int |
| %x | Unsiged 32 bit integer to a hexadecimal string using 0-9a-z | Int |
| %X | Unsiged 32 bit integer to a hexadecimal string using 0-9A-Z | Int |
| %ld | Signed 64bit integer | Long |
| %lu | Unsigned 64bit integer | Long |
| %lx | Unsiged 64 bit integer to a hexadecimal string using 0-9a-z | Long |
| %lX | Unsiged 64 bit integer to a hexadecimal string using 0-9A-Z | Long |
| %f | 64bit floating point | Double, Float |
| %s | String | string |
| %U | Unicode Code Point to a UTF-8 character |
Specifier Options:
Specifier options can be written between % and the character of specifier such as d, f.
| Specifier options | Descriptions |
|---|---|
| 0[DECIMAL_NUMBERS] | Zero padding |
| + | Adding a plus sign |
| - | Left justified |
| .[DECIMAL_NUMBERS] | Precision |
Examples:
# %d - "123"
my $formatted_string = Fn->sprintf("%d", 123);
# %5d - " 123"
my $formatted_string = Fn->sprintf("%5d", 123);
# %05d - "00123"
my $formatted_string = Fn->sprintf("%05d", 123);
# %+d - "+123"
my $formatted_string = Fn->sprintf("%+d", 123);
# %-5d - "123 "
my $formatted_string = Fn->sprintf("%-5d", 123);
# %d - "x"
my $formatted_string = Fn->sprintf("%c", 'x');
# %c - "あ"
my $formatted_string = Fn->sprintf("%c", Fn->ord("あ"));
# %s - "ABC"
my $formatted_string = Fn->sprintf("%s", "ABC") eq "ABC");
# %u - "4294967295"
my $formatted_string = Fn->sprintf("%u", -1) eq "4294967295");
# %f - "3.141500"
my $formatted_string = Fn->sprintf("%f", 3.1415) eq "3.141500");
# %.2f - "3.14"
my $formatted_string = Fn->sprintf("%.2f", 3.1415) eq "3.14");
# %g - "3.14"
my $formatted_string = Fn->sprintf("%g", 3.14) eq "3.14");
# %x - "ff"
my $formatted_string = Fn->sprintf("%x", 255) eq "ff");
# %x - "ffffffff"
my $formatted_string = Fn->sprintf("%x", -1) eq "ffffffff");substr
static method substr : string ($string : string, $offset : int, $length : int)Get the substring of the string with the start offset and the length.
to_double
static method to_double : double ($string : string);Convert the string to float value.
Format is [' ' or '\t' or '\n' or '\v' or '\f' or '\r'][+ or -][zero more than 0-9][.][zero more than 0-9][e or E[+ or -]zero more than 0-9]. Internal of [] is optional.
If the convertion fails, an exception occuer.
my $string = "1.25";
my $num = to_double($string);to_float
static method to_float : float ($string : string);Convert the string to float value.
Format is [' ' or '\t' or '\n' or '\v' or '\f' or '\r'][+ or -][zero more than 0-9][.][zero more than 0-9][e or E[+ or -]zero more than 0-9]. Internal of [] is optional.
If the convertion fails, an exception occuer.
my $string = "1.25";
my $num = to_float($string);to_int
static method to_int : int ($string : string, $digit : int);Convert the string to a int value. This method is same as to_int_with_base($string, 10).
my $string = "-2147483648";
my $num = to_int($string);to_int_with_base
static method to_int_with_base : int ($string : string, $digit : int);Convert the string to a int value with a digit(2, 8, 10, 16).
Format is [' ' or '\t' or '\n' or '\v' or '\f' or '\r'][+ or -][0][x][one more than 0-9]. Internal of [] is optional.
If convertion fails, an exception occuer.
my $string = "-2147483648";
my $num = to_int_with_base($string, 10);to_long
static method to_long : long ($string : string);Convert the string to long value. This method is same as to_long($string, 10).
my $string = "-9223372036854775808";
my $num = to_long($string);to_long_with_base
static method to_long_with_base : long ($string : string, $digit : int);Convert the string to long value with digit(2, 8, 10, 16).
Format is [' ' or '\t' or '\n' or '\v' or '\f' or '\r'][+ or -][0][x][zero more than 0-9]. Internal of [] is optional.
If the convertion fails, an exception occuer.
my $string = "-9223372036854775808";
my $num = to_long_with_base($string, 10);to_lower
static method to_lower : int ($code_point : int)Convert uppercase letter('A'-'Z') to lowercase. If the character is not uppercase letter, return the character.
to_upper
static method to_upper : int ($code_point : int)Convert lowercase letter('a'-'z') to lowercase. If the character is not uppercase letter, return the character.
trim_ascii_space
static method trim_ascii_space : string ($string : string)Remove right and left spaces of the string. These spaces is ascii standard spaces which can be checked by is_space method.
If the argument string is undef, return undef.
uc
static method uc : string ($string : string)Convert a lowercase string to a uppercase string.
If the string is undef, an exception occurs.
ucfirst
static method ucfirst : string ($string : string)Convert the first character of a string to a uppercase character.
If the string is undef, an exception occurs.