Chris@0: <?php
Chris@0: /**
Chris@0:  * Zend Framework (http://framework.zend.com/)
Chris@0:  *
Chris@0:  * @link      http://github.com/zendframework/zf2 for the canonical source repository
Chris@0:  * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
Chris@0:  * @license   http://framework.zend.com/license/new-bsd New BSD License
Chris@0:  */
Chris@0: 
Chris@0: namespace Zend\Stdlib\StringWrapper;
Chris@0: 
Chris@0: use Zend\Stdlib\Exception;
Chris@0: use Zend\Stdlib\StringUtils;
Chris@0: 
Chris@0: class Native extends AbstractStringWrapper
Chris@0: {
Chris@0:     /**
Chris@0:      * The character encoding working on
Chris@13:      * (overwritten to change default encoding)
Chris@0:      *
Chris@0:      * @var string
Chris@0:      */
Chris@0:     protected $encoding = 'ASCII';
Chris@0: 
Chris@0:     /**
Chris@0:      * Check if the given character encoding is supported by this wrapper
Chris@0:      * and the character encoding to convert to is also supported.
Chris@0:      *
Chris@0:      * @param  string      $encoding
Chris@0:      * @param  string|null $convertEncoding
Chris@0:      * @return bool
Chris@0:      */
Chris@0:     public static function isSupported($encoding, $convertEncoding = null)
Chris@0:     {
Chris@0:         $encodingUpper      = strtoupper($encoding);
Chris@0:         $supportedEncodings = static::getSupportedEncodings();
Chris@0: 
Chris@12:         if (! in_array($encodingUpper, $supportedEncodings)) {
Chris@0:             return false;
Chris@0:         }
Chris@0: 
Chris@0:         // This adapter doesn't support to convert between encodings
Chris@0:         if ($convertEncoding !== null && $encodingUpper !== strtoupper($convertEncoding)) {
Chris@0:             return false;
Chris@0:         }
Chris@0: 
Chris@0:         return true;
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Get a list of supported character encodings
Chris@0:      *
Chris@0:      * @return string[]
Chris@0:      */
Chris@0:     public static function getSupportedEncodings()
Chris@0:     {
Chris@0:         return StringUtils::getSingleByteEncodings();
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Set character encoding working with and convert to
Chris@0:      *
Chris@0:      * @param string      $encoding         The character encoding to work with
Chris@0:      * @param string|null $convertEncoding  The character encoding to convert to
Chris@0:      * @return StringWrapperInterface
Chris@0:      */
Chris@0:     public function setEncoding($encoding, $convertEncoding = null)
Chris@0:     {
Chris@0:         $supportedEncodings = static::getSupportedEncodings();
Chris@0: 
Chris@0:         $encodingUpper = strtoupper($encoding);
Chris@12:         if (! in_array($encodingUpper, $supportedEncodings)) {
Chris@0:             throw new Exception\InvalidArgumentException(
Chris@0:                 'Wrapper doesn\'t support character encoding "' . $encoding . '"'
Chris@0:             );
Chris@0:         }
Chris@0: 
Chris@0:         if ($encodingUpper !== strtoupper($convertEncoding)) {
Chris@0:             $this->convertEncoding = $encodingUpper;
Chris@0:         }
Chris@0: 
Chris@0:         if ($convertEncoding !== null) {
Chris@0:             if ($encodingUpper !== strtoupper($convertEncoding)) {
Chris@0:                 throw new Exception\InvalidArgumentException(
Chris@0:                     'Wrapper doesn\'t support to convert between character encodings'
Chris@0:                 );
Chris@0:             }
Chris@0: 
Chris@0:             $this->convertEncoding = $encodingUpper;
Chris@0:         } else {
Chris@0:             $this->convertEncoding = null;
Chris@0:         }
Chris@0:         $this->encoding = $encodingUpper;
Chris@0: 
Chris@0:         return $this;
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Returns the length of the given string
Chris@0:      *
Chris@0:      * @param string $str
Chris@0:      * @return int|false
Chris@0:      */
Chris@0:     public function strlen($str)
Chris@0:     {
Chris@0:         return strlen($str);
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Returns the portion of string specified by the start and length parameters
Chris@0:      *
Chris@0:      * @param string   $str
Chris@0:      * @param int      $offset
Chris@0:      * @param int|null $length
Chris@0:      * @return string|false
Chris@0:      */
Chris@0:     public function substr($str, $offset = 0, $length = null)
Chris@0:     {
Chris@0:         return substr($str, $offset, $length);
Chris@0:     }
Chris@0: 
Chris@0:     /**
Chris@0:      * Find the position of the first occurrence of a substring in a string
Chris@0:      *
Chris@0:      * @param string $haystack
Chris@0:      * @param string $needle
Chris@0:      * @param int    $offset
Chris@0:      * @return int|false
Chris@0:      */
Chris@0:     public function strpos($haystack, $needle, $offset = 0)
Chris@0:     {
Chris@0:         return strpos($haystack, $needle, $offset);
Chris@0:     }
Chris@0: }