NAME¶
NetSDS::Util::String - string prcessing routines
SYNOPSIS¶
use NetSDS::Util::String qw();
# Read from standard input
my $string = <STDIN>;
# Encode string to internal structure
$string = string_encode($tring);
DESCRIPTION¶
"NetSDS::Util::String" module contains functions may be used to
quickly solve string processing tasks like parsing, recoding, formatting.
As in other NetSDS modules standard encoding is UTF-8.
EXPORTED FUNCTIONS¶
- str_encode($str[, $encoding]) - encode
string to internal UTF-8
- By default this function treat first argument as byte
string in UTF-8 and return it's internal Unicode representation.
In case of external character set isn't UTF-8 it should be added as second
argument of function.
# Convert UTF-8 byte string to internal Unicode representation
$uni_string = str_encode($byte_string);
# Convert KOI8-U byte string to internal
$uni_string = str_encode($koi8_string, 'KOI8-U');
After "str_encode()" it's possible to process this string
correctly including regular expressions. All characters will be understood
as UTF-8 symbols instead of byte sequences.
- str_decode($str[, $encoding]) - decode
internal UTF-8 to byte string
- By default this function treat first argument as string in
internal UTF-8 and return it in byte string (external) representation.
In case of external character set isn't UTF-8 it should be added as second
argument of function.
# Get UTF-8 byte string from internal Unicode representation
$byte_string = str_decode($uni_string);
# Convert to KOI8-U byte string from internal Unicode
$koi8_string = str_encode($uni_string, 'KOI8-U');
It's recommended to use "str_encode()" when preparing data for
communication with external systems (especially networking).
- str_recode($str, $FROM_ENC[,
$TO_ENC ]) - recode string
- Translate string between different encodings. If target
encoding is not set UTF-8 used as default one.
- str_trim($str) - remove leading/trailing space
characters
-
$orig_str = " string with spaces ";
$new_str = str_trim($orig_str);
# Output: "string with spaces"
print $new_str;
- str_trim_left($str) - removes leading
whitespaces
- This function is similar to "str_trim()" except
of it removes only leading space characters and leave trailing ones.
- str_trim_right($str) - removes trailing
whitespaces
- This function is similar to "str_trim()" except
of it removes only trailing space characters and leave leading ones.
- str_clean($str) - clean string from extra
spaces
- Function is similar to "str_trim()" but also
changes all spacing chains inside string to single spaces.
- str_camelize($strin)
- If pass undef - return undef. If pass '' - return ''.
Examples:
# returns 'getValue'
str_camelize( 'get_value' )
# returns 'addUserAction'
str_camelize( 'ADD_User_actION' )
- str_decamelize(...)
- If pass undef - return undef. If pass '' - return ''.
Examples:
# returns 'get_value'
str_decamelize( 'getValue' )
EXAMPLES¶
None yet
BUGS¶
Unknown yet
TODO¶
Implement examples and tests.
SEE ALSO¶
Encode, perlunicode
AUTHORS¶
Valentyn Solomko <pere@pere.org.ua>
Michael Bochkaryov <misha@rattler.kiev.ua>