Documentation

ByteString extends AbstractString
in package

Represents a binary-safe string of bytes.

Tags
author

Nicolas Grekas p@tchwork.com

author

Hugo Hamon hugohamon@neuf.fr

throws
ExceptionInterface

Table of Contents

Constants

PREG_OFFSET_CAPTURE  = \PREG_OFFSET_CAPTURE
PREG_PATTERN_ORDER  = \PREG_PATTERN_ORDER
PREG_SET_ORDER  = \PREG_SET_ORDER
PREG_SPLIT  = 0
PREG_SPLIT_DELIM_CAPTURE  = \PREG_SPLIT_DELIM_CAPTURE
PREG_SPLIT_NO_EMPTY  = \PREG_SPLIT_NO_EMPTY
PREG_SPLIT_OFFSET_CAPTURE  = \PREG_SPLIT_OFFSET_CAPTURE
PREG_UNMATCHED_AS_NULL  = \PREG_UNMATCHED_AS_NULL
ALPHABET_ALPHANUMERIC  = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'

Properties

$ignoreCase  : mixed
$string  : mixed

Methods

__clone()  : mixed
__construct()  : mixed
__sleep()  : array<string|int, mixed>
__toString()  : string
after()  : static
afterLast()  : static
append()  : static
before()  : static
beforeLast()  : static
bytesAt()  : array<string|int, int>
camel()  : static
chunk()  : array<string|int, static>
collapseWhitespace()  : static
containsAny()  : bool
endsWith()  : bool
ensureEnd()  : static
ensureStart()  : static
equalsTo()  : bool
folded()  : static
fromRandom()  : self
ignoreCase()  : static
indexOf()  : int|null
indexOfLast()  : int|null
isEmpty()  : bool
isUtf8()  : bool
join()  : static
jsonSerialize()  : string
length()  : int
lower()  : static
match()  : array<string|int, mixed>
Matches the string using a regular expression.
padBoth()  : static
padEnd()  : static
padStart()  : static
prepend()  : static
repeat()  : static
replace()  : static
replaceMatches()  : static
reverse()  : static
slice()  : static
snake()  : static
splice()  : static
split()  : array<string|int, static>
startsWith()  : bool
title()  : static
toByteString()  : ByteString
toCodePointString()  : CodePointString
toString()  : string
toUnicodeString()  : UnicodeString
trim()  : static
trimEnd()  : static
trimPrefix()  : static
trimStart()  : static
trimSuffix()  : static
truncate()  : static
unwrap()  : array<string|int, string>|array<string|int, mixed>
Unwraps instances of AbstractString back to strings.
upper()  : static
width()  : int
Returns the printable length on a terminal.
wordwrap()  : static
wrap()  : array<string|int, static>|array<string|int, mixed>
Wraps (and normalizes) strings in instances of AbstractString.

Constants

PREG_OFFSET_CAPTURE

public mixed PREG_OFFSET_CAPTURE = \PREG_OFFSET_CAPTURE

PREG_PATTERN_ORDER

public mixed PREG_PATTERN_ORDER = \PREG_PATTERN_ORDER

PREG_SPLIT_DELIM_CAPTURE

public mixed PREG_SPLIT_DELIM_CAPTURE = \PREG_SPLIT_DELIM_CAPTURE

PREG_SPLIT_NO_EMPTY

public mixed PREG_SPLIT_NO_EMPTY = \PREG_SPLIT_NO_EMPTY

PREG_SPLIT_OFFSET_CAPTURE

public mixed PREG_SPLIT_OFFSET_CAPTURE = \PREG_SPLIT_OFFSET_CAPTURE

PREG_UNMATCHED_AS_NULL

public mixed PREG_UNMATCHED_AS_NULL = \PREG_UNMATCHED_AS_NULL

ALPHABET_ALPHANUMERIC

private mixed ALPHABET_ALPHANUMERIC = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'

Properties

Methods

__construct()

public __construct([string $string = '' ]) : mixed
Parameters
$string : string = ''

__sleep()

public __sleep() : array<string|int, mixed>
Return values
array<string|int, mixed>

after()

public after(string|array<string|int, string> $needle[, bool $includeNeedle = false ][, int $offset = 0 ]) : static
Parameters
$needle : string|array<string|int, string>
$includeNeedle : bool = false
$offset : int = 0
Return values
static

afterLast()

public afterLast(string|array<string|int, string> $needle[, bool $includeNeedle = false ][, int $offset = 0 ]) : static
Parameters
$needle : string|array<string|int, string>
$includeNeedle : bool = false
$offset : int = 0
Return values
static

append()

public append(string ...$suffix) : static
Parameters
$suffix : string
Return values
static

before()

public before(string|array<string|int, string> $needle[, bool $includeNeedle = false ][, int $offset = 0 ]) : static
Parameters
$needle : string|array<string|int, string>
$includeNeedle : bool = false
$offset : int = 0
Return values
static

beforeLast()

public beforeLast(string|array<string|int, string> $needle[, bool $includeNeedle = false ][, int $offset = 0 ]) : static
Parameters
$needle : string|array<string|int, string>
$includeNeedle : bool = false
$offset : int = 0
Return values
static

bytesAt()

public bytesAt(int $offset) : array<string|int, int>
Parameters
$offset : int
Return values
array<string|int, int>

camel()

public camel() : static
Return values
static

chunk()

public chunk([int $length = 1 ]) : array<string|int, static>
Parameters
$length : int = 1
Return values
array<string|int, static>

collapseWhitespace()

public collapseWhitespace() : static
Return values
static

containsAny()

public containsAny(string|array<string|int, string> $needle) : bool
Parameters
$needle : string|array<string|int, string>
Return values
bool

ensureEnd()

public ensureEnd(string $suffix) : static
Parameters
$suffix : string
Return values
static

ensureStart()

public ensureStart(string $prefix) : static
Parameters
$prefix : string
Return values
static

folded()

public folded() : static
Return values
static

fromRandom()

public static fromRandom([int $length = 16 ][, string|null $alphabet = null ]) : self
Parameters
$length : int = 16
$alphabet : string|null = null
Return values
self

indexOf()

public indexOf(string|iterable<string|int, mixed>|AbstractString $needle[, int $offset = 0 ]) : int|null
Parameters
$needle : string|iterable<string|int, mixed>|AbstractString
$offset : int = 0
Return values
int|null

indexOfLast()

public indexOfLast(string|iterable<string|int, mixed>|AbstractString $needle[, int $offset = 0 ]) : int|null
Parameters
$needle : string|iterable<string|int, mixed>|AbstractString
$offset : int = 0
Return values
int|null

isUtf8()

public isUtf8() : bool
Return values
bool

join()

public join(array<string|int, mixed> $strings[, string|null $lastGlue = null ]) : static
Parameters
$strings : array<string|int, mixed>
$lastGlue : string|null = null
Return values
static

jsonSerialize()

public jsonSerialize() : string
Return values
string

length()

public length() : int
Return values
int

lower()

public lower() : static
Return values
static

match()

Matches the string using a regular expression.

public match(string $regexp[, int $flags = 0 ][, int $offset = 0 ]) : array<string|int, mixed>

Pass PREG_PATTERN_ORDER or PREG_SET_ORDER as $flags to get all occurrences matching the regular expression.

Parameters
$regexp : string
$flags : int = 0
$offset : int = 0
Return values
array<string|int, mixed>

All matches in a multi-dimensional array ordered according to flags

padBoth()

public padBoth(int $length[, string $padStr = ' ' ]) : static
Parameters
$length : int
$padStr : string = ' '
Return values
static

padEnd()

public padEnd(int $length[, string $padStr = ' ' ]) : static
Parameters
$length : int
$padStr : string = ' '
Return values
static

padStart()

public padStart(int $length[, string $padStr = ' ' ]) : static
Parameters
$length : int
$padStr : string = ' '
Return values
static

prepend()

public prepend(string ...$prefix) : static
Parameters
$prefix : string
Return values
static

repeat()

public repeat(int $multiplier) : static
Parameters
$multiplier : int
Return values
static

replace()

public replace(string $from, string $to) : static
Parameters
$from : string
$to : string
Return values
static

replaceMatches()

public replaceMatches(string $fromRegexp, string|callable $to) : static
Parameters
$fromRegexp : string
$to : string|callable
Return values
static

reverse()

public reverse() : static
Return values
static

slice()

public slice([int $start = 0 ][, int|null $length = null ]) : static
Parameters
$start : int = 0
$length : int|null = null
Return values
static

snake()

public snake() : static
Return values
static

splice()

public splice(string $replacement[, int $start = 0 ][, int|null $length = null ]) : static
Parameters
$replacement : string
$start : int = 0
$length : int|null = null
Return values
static

split()

public split(string $delimiter[, int|null $limit = null ][, int|null $flags = null ]) : array<string|int, static>
Parameters
$delimiter : string
$limit : int|null = null
$flags : int|null = null
Return values
array<string|int, static>

startsWith()

public startsWith(string|iterable<string|int, mixed>|AbstractString $prefix) : bool
Parameters
$prefix : string|iterable<string|int, mixed>|AbstractString
Return values
bool

title()

public title([bool $allWords = false ]) : static
Parameters
$allWords : bool = false
Return values
static

trim()

public trim([string $chars = " " ]) : static
Parameters
$chars : string = " "
Return values
static

trimEnd()

public trimEnd([string $chars = " " ]) : static
Parameters
$chars : string = " "
Return values
static

trimPrefix()

public trimPrefix(string|array<string|int, string> $prefix) : static
Parameters
$prefix : string|array<string|int, string>
Return values
static

trimStart()

public trimStart([string $chars = " " ]) : static
Parameters
$chars : string = " "
Return values
static

trimSuffix()

public trimSuffix(string|array<string|int, string> $suffix) : static
Parameters
$suffix : string|array<string|int, string>
Return values
static

truncate()

public truncate(int $length[, string $ellipsis = '' ][, bool $cut = true ]) : static
Parameters
$length : int
$ellipsis : string = ''
$cut : bool = true
Return values
static

unwrap()

Unwraps instances of AbstractString back to strings.

public static unwrap(array<string|int, mixed> $values) : array<string|int, string>|array<string|int, mixed>
Parameters
$values : array<string|int, mixed>
Return values
array<string|int, string>|array<string|int, mixed>

upper()

public upper() : static
Return values
static

width()

Returns the printable length on a terminal.

public width([bool $ignoreAnsiDecoration = true ]) : int
Parameters
$ignoreAnsiDecoration : bool = true
Return values
int

wordwrap()

public wordwrap([int $width = 75 ][, string $break = " " ][, bool $cut = false ]) : static
Parameters
$width : int = 75
$break : string = " "
$cut : bool = false
Return values
static

wrap()

Wraps (and normalizes) strings in instances of AbstractString.

public static wrap(array<string|int, mixed> $values) : array<string|int, static>|array<string|int, mixed>
Parameters
$values : array<string|int, mixed>
Return values
array<string|int, static>|array<string|int, mixed>

        
On this page

Search results