Sabre\VObject\StringUtil Class Reference

Useful utilities for working with various strings. More...

Collaboration diagram for Sabre\VObject\StringUtil:

Static Public Member Functions
static	isUTF8 ($str)
	Returns true or false depending on if a string is valid UTF-8. More...
static	convertToUTF8 ($str)
	This method tries its best to convert the input string to UTF-8. More...

Detailed Description

Useful utilities for working with various strings.

Copyright

Copyright (C) fruux GmbH (https://fruux.com/)

Author

Evert Pot (http://evertpot.com/) @license http://sabre.io/license/ Modified BSD License

Definition at line 12 of file StringUtil.php.

Member Function Documentation

convertToUTF8()

static Sabre\VObject\StringUtil::convertToUTF8 (   $str )

static

This method tries its best to convert the input string to UTF-8.

Currently only ISO-5991-1 input and UTF-8 input is supported, but this may be expanded upon if we receive other examples.

Parameters

string

$str

Returns

string

Definition at line 42 of file StringUtil.php.

                                        {
 
        $encoding = mb_detect_encoding($str, ['UTF-8', 'ISO-8859-1', 'WINDOWS-1252'], true);
 
        switch ($encoding) {
            case 'ISO-8859-1' :
                $newStr = utf8_encode($str);
                break;
            /* Unreachable code. Not sure yet how we can improve this
             * situation.
            case 'WINDOWS-1252' :
                $newStr = iconv('cp1252', 'UTF-8', $str);
                break;
             */
            default :
                 $newStr = $str;
 
        }
 
        // Removing any control characters
        return (preg_replace('%(?:[\x00-\x08\x0B-\x0C\x0E-\x1F\x7F])%', '', $newStr));
 
    }

Referenced by Sabre\VObject\StringUtilTest\testConvertToUTF8ControlChar(), Sabre\VObject\StringUtilTest\testConvertToUTF8IsUTF8(), Sabre\VObject\StringUtilTest\testConvertToUTF8nonUTF8(), and Sabre\VObject\Property\validate().

Here is the caller graph for this function:

isUTF8()

static Sabre\VObject\StringUtil::isUTF8 (   $str )

static

Returns true or false depending on if a string is valid UTF-8.

Parameters

string

$str

Returns

bool

Definition at line 21 of file StringUtil.php.

                                 {
 
        // Control characters
        if (preg_match('%[\x00-\x08\x0B-\x0C\x0E\x0F]%', $str)) {
            return false;
        }
 
        return (bool)preg_match('%%u', $str);
 
    }

Referenced by Sabre\VObject\StringUtilTest\testIsUTF8(), Sabre\VObject\StringUtilTest\testNonUTF8(), Sabre\VObject\StringUtilTest\testUTF8ControlChar(), and Sabre\VObject\Property\validate().

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/sabre/vobject/lib/StringUtil.php