You are here

StringWrapperInterface.php in Zircon Profile 8

File

vendor/zendframework/zend-stdlib/src/StringWrapper/StringWrapperInterface.php
View source
<?php

/**
 * Zend Framework (http://framework.zend.com/)
 *
 * @link      http://github.com/zendframework/zf2 for the canonical source repository
 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
 * @license   http://framework.zend.com/license/new-bsd New BSD License
 */
namespace Zend\Stdlib\StringWrapper;

interface StringWrapperInterface {

  /**
   * Check if the given character encoding is supported by this wrapper
   * and the character encoding to convert to is also supported.
   *
   * @param string      $encoding
   * @param string|null $convertEncoding
   */
  public static function isSupported($encoding, $convertEncoding = null);

  /**
   * Get a list of supported character encodings
   *
   * @return string[]
   */
  public static function getSupportedEncodings();

  /**
   * Set character encoding working with and convert to
   *
   * @param string      $encoding         The character encoding to work with
   * @param string|null $convertEncoding  The character encoding to convert to
   * @return StringWrapperInterface
   */
  public function setEncoding($encoding, $convertEncoding = null);

  /**
   * Get the defined character encoding to work with (upper case)
   *
   * @return string
   */
  public function getEncoding();

  /**
   * Get the defined character encoding to convert to (upper case)
   *
   * @return string|null
   */
  public function getConvertEncoding();

  /**
   * Returns the length of the given string
   *
   * @param string $str
   * @return int|false
   */
  public function strlen($str);

  /**
   * Returns the portion of string specified by the start and length parameters
   *
   * @param string   $str
   * @param int      $offset
   * @param int|null $length
   * @return string|false
   */
  public function substr($str, $offset = 0, $length = null);

  /**
   * Find the position of the first occurrence of a substring in a string
   *
   * @param string $haystack
   * @param string $needle
   * @param int    $offset
   * @return int|false
   */
  public function strpos($haystack, $needle, $offset = 0);

  /**
   * Convert a string from defined encoding to the defined convert encoding
   *
   * @param string  $str
   * @param bool $reverse
   * @return string|false
   */
  public function convert($str, $reverse = false);

  /**
   * Wraps a string to a given number of characters
   *
   * @param  string  $str
   * @param  int $width
   * @param  string  $break
   * @param  bool $cut
   * @return string
   */
  public function wordWrap($str, $width = 75, $break = "\n", $cut = false);

  /**
   * Pad a string to a certain length with another string
   *
   * @param  string  $input
   * @param  int $padLength
   * @param  string  $padString
   * @param  int $padType
   * @return string
   */
  public function strPad($input, $padLength, $padString = ' ', $padType = STR_PAD_RIGHT);

}

Interfaces