---
name: "NetSDS::Util::String"
section: "3pm"
platform: "linux"
package: "libnetsds-util-perl"
version: "1.045-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/NetSDS::Util::String"
---

# NetSDS::Util::String(3pm)

string prcessing routines

## 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\>