PeServer

Text
in package

AbstractYes

文字列操作。

Table of Contents

Constants

EMPTY  = ''
空文字列。
TRIM_CHARACTERS  = " \n\r\t\v\x00 "
トリム対象文字一覧。
TRIM_PHP_CHARACTERS  = " \t\n\r\x00\v"
PHP の使ってる対象文字一覧
TRIM_TARGET_BOTH  = 0
TRIM_TARGET_END  = 1
TRIM_TARGET_START  = -1

Methods

contains()  : bool
文字列を含んでいるか判定。
dump()  : string
データ出力。
endsWith()  : bool
終端文字列一致判定。
format()  : string
`sprintf` ラッパー。
formatNumber()  : string
数字を千の位毎にグループ化してフォーマット
fromCodePoint()  : string
Unicode のコードポイントに対応する文字を返す。
getByteCount()  : int
文字列バイト数を取得。
getLastPosition()  : int
文字列位置を取得。
getLength()  : int
文字列長を取得。
getPosition()  : int
文字列位置を取得。
isNullOrEmpty()  : bool
文字列が `null` か空か
isNullOrWhiteSpace()  : bool
文字列がnullかホワイトスペースのみで構築されているか
join()  : string
文字列結合。
repeat()  : string
文字列を反復。
replace()  : string
文字列置き換え
replaceMap()  : string
プレースホルダー文字列置き換え処理
requireNotNullOrEmpty()  : string
文字列が `null` か空の場合に代替文字列を返す。
requireNotNullOrWhiteSpace()  : string
文字列がnullかホワイトスペースのみで構築されている場合に代替文字列を返す。
split()  : array<string|int, string>
文字列分割。
splitLines()  : array<string|int, string>
文字列を改行で分割。
startsWith()  : bool
先頭文字列一致判定。
substring()  : string
文字列部分切り出し。
toCharacters()  : array<string|int, string>
文字列を文字の配列に変換。
toLower()  : string
大文字を小文字に変換。
toString()  : string
何かしらを文字列変換
toUpper()  : string
小文字を大文字に変換。
trim()  : string
トリム処理。
trimEnd()  : string
終端トリム。
trimStart()  : string
先頭トリム。
createTrimPattern()  : string
トリム用パターンの生成。
fromCodePointCore()  : string

Constants

EMPTY

空文字列。

public mixed EMPTY = ''

TRIM_CHARACTERS

トリム対象文字一覧。

public mixed TRIM_CHARACTERS = " \n\r\t\v\x00 "

TRIM_PHP_CHARACTERS

PHP の使ってる対象文字一覧

public mixed TRIM_PHP_CHARACTERS = " \t\n\r\x00\v"

TRIM_TARGET_BOTH

private mixed TRIM_TARGET_BOTH = 0

TRIM_TARGET_END

private mixed TRIM_TARGET_END = 1

TRIM_TARGET_START

private mixed TRIM_TARGET_START = -1

Methods

contains()

文字列を含んでいるか判定。

public static contains(string $haystack, string $needle, bool $ignoreCase) : bool
Parameters
$haystack : string

対象文字列。

$needle : string

検索文字列。

$ignoreCase : bool

大文字小文字を無視するか。

Return values
bool

dump()

データ出力。

public static dump(mixed $value) : string

var_export/print_r で迷ったり $return = true 忘れのためのラッパー。 色々あったけど var_dump に落ち着いた感。

Parameters
$value : mixed
Return values
string

endsWith()

終端文字列一致判定。

public static endsWith(string $haystack, string $needle, bool $ignoreCase) : bool
Parameters
$haystack : string

対象文字列。

$needle : string

検索文字列。

$ignoreCase : bool

大文字小文字を無視するか。

Return values
bool

format()

`sprintf` ラッパー。

public static format(string $format, mixed ...$values) : string

単純な文字列置き換えであれば Text::replaceMap を使用する。

Parameters
$format : string
$values : mixed
Tags
phpstan-param

FormatAlias ...$values

see
https://www.php.net/manual/function.sprintf.php
see
Text::replaceMap()
Return values
string

formatNumber()

数字を千の位毎にグループ化してフォーマット

public static formatNumber(int|float $number[, int $decimals = 0 ][, string|null $decimalSeparator = '.' ][, string|null $thousandsSeparator = ',' ]) : string
Parameters
$number : int|float

フォーマットする数値

$decimals : int = 0

小数点以下の桁数。 0 を指定すると、 戻り値の $decimalSeparator は省略されます

$decimalSeparator : string|null = '.'

小数点を表す区切り文字

$thousandsSeparator : string|null = ','

千の位毎の区切り文字

Tags
see
https://www.php.net/manual/function.number-format.php
Return values
string

置き換え後文字列

fromCodePoint()

Unicode のコードポイントに対応する文字を返す。

public static fromCodePoint(int|array<string|int, int> $value) : string

mb_chr ラッパー。

Parameters
$value : int|array<string|int, int>
Tags
phpstan-param

non-negative-int|non-negative-int[] $value

see
https://www.php.net/manual/function.mb-chr.php
throws
ArgumentException
Return values
string

getByteCount()

文字列バイト数を取得。

public static getByteCount(string $value) : int

strlen ラッパー。

Parameters
$value : string

対象文字列。

Tags
phpstan-return

non-negative-int

see
https://www.php.net/manual/function.strlen.php
Return values
int

バイト数。

getLastPosition()

文字列位置を取得。

public static getLastPosition(string $haystack, string $needle[, int $offset = 0 ]) : int
Parameters
$haystack : string

対象文字列。

$needle : string

検索文字列。

$offset : int = 0

終端文字数目。

Tags
phpstan-param

non-negative-int $offset

phpstan-return

non-negative-int|-1

throws
ArgumentException
Return values
int

見つかった文字位置。見つかんない場合は -1

getLength()

文字列長を取得。

public static getLength(string $value) : int

mb_strlen ラッパー。

Parameters
$value : string

対象文字列。

Tags
phpstan-return

non-negative-int

see
https://www.php.net/manual/function.mb-strlen.php
Return values
int

文字数。

getPosition()

文字列位置を取得。

public static getPosition(string $haystack, string $needle[, int $offset = 0 ]) : int
Parameters
$haystack : string

対象文字列。

$needle : string

検索文字列。

$offset : int = 0

開始文字数目。

Tags
phpstan-param

non-negative-int $offset

phpstan-return

non-negative-int|-1

throws
ArgumentException
Return values
int

見つかった文字位置。見つかんない場合は -1

isNullOrEmpty()

文字列が `null` か空か

public static isNullOrEmpty(string|null $s) : bool
Parameters
$s : string|null

対象文字列。

Tags
phpstan-assert-if-false

non-empty-string $s

Return values
bool

真: nullか空。

isNullOrWhiteSpace()

文字列がnullかホワイトスペースのみで構築されているか

public static isNullOrWhiteSpace(string|null $s) : bool

TRIM_CHARACTERS がホワイトスペースとして扱われる。

Parameters
$s : string|null

対象文字列。

Tags
phpstan-assert-if-false

non-empty-string $s

Return values
bool

真: nullかホワイトスペースのみ。

join()

文字列結合。

public static join(string $separator, array<string|int, string> $values) : string

implode ラッパー。

Parameters
$separator : string
$values : array<string|int, string>
Tags
see
https://www.php.net/manual/function.implode.php
Return values
string

replace()

文字列置き換え

public static replace(string $source, string|array<string|int, string> $oldValue, string|array<string|int, string> $newValue) : string

str_replace ラッパー。

Parameters
$source : string

入力文字列。

$oldValue : string|array<string|int, string>

元文字列(か、元文字列配列)

$newValue : string|array<string|int, string>

置き換え文字列(か、元文字列配列)。

Tags
see
https://www.php.net/manual/function.str-replace.php
Return values
string

置き換え後文字列。

replaceMap()

プレースホルダー文字列置き換え処理

public static replaceMap(string $source, array<string, string> $map[, non-empty-string $head = '{' ][, non-empty-string $tail = '}' ]) : string
Parameters
$source : string

元文字列

$map : array<string, string>

置き換え対象辞書

$head : non-empty-string = '{'

プレースホルダー先頭

$tail : non-empty-string = '}'

プレースホルダー終端

Tags
phpstan-param

literal-string $source

throws
StringException

なんかもうあかんかった

Return values
string

置き換え後文字列

requireNotNullOrEmpty()

文字列が `null` か空の場合に代替文字列を返す。

public static requireNotNullOrEmpty(string|null $s, string $fallback) : string
Parameters
$s : string|null
$fallback : string
Return values
string

requireNotNullOrWhiteSpace()

文字列がnullかホワイトスペースのみで構築されている場合に代替文字列を返す。

public static requireNotNullOrWhiteSpace(string|null $s, string $fallback) : string
Parameters
$s : string|null
$fallback : string
Return values
string

split()

文字列分割。

public static split(string $value, non-empty-string $separator[, int $limit = PHP_INT_MAX ]) : array<string|int, string>

explode ラッパー。

Parameters
$value : string

対象文字列。

$separator : non-empty-string

分割対象文字列。

$limit : int = PHP_INT_MAX

分割数。

Tags
throws
ArgumentException

分割失敗(PHP8未満)

throws
ValueError

分割失敗(PHP8以上)

see
https://www.php.net/manual/function.explode.php
Return values
array<string|int, string>

分割された文字列。

splitLines()

文字列を改行で分割。

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

startsWith()

先頭文字列一致判定。

public static startsWith(string $haystack, string $needle, bool $ignoreCase) : bool
Parameters
$haystack : string

対象文字列。

$needle : string

検索文字列。

$ignoreCase : bool

大文字小文字を無視するか。

Return values
bool

substring()

文字列部分切り出し。

public static substring(string $value, int $offset[, int $length = -1 ]) : string
Parameters
$value : string

対象文字列。

$offset : int

開始文字数目。負数の場合は後ろから。

$length : int = -1

抜き出す長さ。負数の場合は最後まで($offset)

Return values
string

切り抜き後文字列。

toCharacters()

文字列を文字の配列に変換。

public static toCharacters(non-empty-string $value) : array<string|int, string>
Parameters
$value : non-empty-string
Return values
array<string|int, string>

toLower()

大文字を小文字に変換。

public static toLower(string $value) : string
Parameters
$value : string
Return values
string

toString()

何かしらを文字列変換

public static toString(mixed $raw[, string $newline = PHP_EOL ]) : string
Parameters
$raw : mixed
$newline : string = PHP_EOL

配列の場合の改行(未指定時に PHP_EOL)

Return values
string

toUpper()

小文字を大文字に変換。

public static toUpper(string $value) : string
Parameters
$value : string
Return values
string

trim()

トリム処理。

public static trim(string $value[, string $characters = self::TRIM_CHARACTERS ]) : string

trim ラッパー。

Parameters
$value : string

対象文字列。

$characters : string = self::TRIM_CHARACTERS

トリム対象文字。

Tags
see
https://www.php.net/manual/function.trim.php
Return values
string

トリム後文字列。

trimEnd()

終端トリム。

public static trimEnd(string $value[, string $characters = self::TRIM_CHARACTERS ]) : string

rtrim ラッパー。

Parameters
$value : string

対象文字列。

$characters : string = self::TRIM_CHARACTERS

トリム対象文字。

Tags
see
https://www.php.net/manual/function.rtrim.php
Return values
string

トリム後文字列。

trimStart()

先頭トリム。

public static trimStart(string $value[, string $characters = self::TRIM_CHARACTERS ]) : string

ltrim ラッパー。

Parameters
$value : string

対象文字列。

$characters : string = self::TRIM_CHARACTERS

トリム対象文字。

Tags
see
https://www.php.net/manual/function.ltrim.php
Return values
string

トリム後文字列。

createTrimPattern()

トリム用パターンの生成。

private static createTrimPattern(Regex $regex, string $characters, int $trimTarget) : string
Parameters
$regex : Regex
$characters : string
$trimTarget : int
Tags
phpstan-param

self::TRIM_TARGET_* $trimTarget

Return values
string

fromCodePointCore()

private static fromCodePointCore(int $value) : string
Parameters
$value : int
Return values
string

        
On this page

Search results