Ref/intl/grapheme-Phpdoc专题
grapheme_extract
Function to extract a sequence of default grapheme clusters from a text buffer, which must be encoded in UTF-8
说明
过程化风格
string <span
class="methodname">grapheme_extract ( <span
class="methodparam">string $haystack
, int $size
[, int
$extract_type [, <span
class="type">int $start =
0 [, <span
class="type">int &$next ]]] )
Function to extract a sequence of default grapheme clusters from a text buffer, which must be encoded in UTF-8.
参数
haystack
String to search.
size
Maximum number items - based on the $extract_type - to return.
extract_type
Defines the type of units referred to by the $size parameter:
- GRAPHEME_EXTR_COUNT (default) - $size is the number of default grapheme clusters to extract.
- GRAPHEME_EXTR_MAXBYTES - $size is the maximum number of bytes returned.
- GRAPHEME_EXTR_MAXCHARS - $size is the maximum number of UTF-8 characters returned.
start
Starting position in $haystack in bytes - if given, it must be zero or a
positive value that is less than or equal to the length of $haystack in
bytes, or a negative value that counts from the end of $haystack. If
$start does not point to the first byte of a UTF-8 character, the start
position is moved to the next character boundary.
next
Reference to a value that will be set to the next starting position.
When the call returns, this may point to the first byte position past
the end of the string.
返回值
A string starting at offset $start and ending on a default grapheme cluster boundary that conforms to the $size and $extract_type specified.
更新日志
| 版本 | 说明 |
|---|---|
| 7.1.0 | Support for negative starts has been added. |
范例
示例 #1 grapheme_extract example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print urlencode(grapheme_extract( $char_a_ring_nfd . $char_o_diaeresis_nfd, 1, GRAPHEME_EXTR_COUNT, 2));
?>以上例程会输出：
o%CC%88参见
- grapheme_substr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_stripos
Find position (in grapheme units) of first occurrence of a case-insensitive string
说明
过程化风格
int <span
class="methodname">grapheme_stripos ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">int $offset =
0 ] )
Find position (in grapheme units) of first occurrence of a case-insensitive string
参数
haystack
The string to look in. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
offset
The optional $offset parameter allows you to specify where in haystack
to start searching as an offset in grapheme units (not bytes or
characters). If the offset is negative, it is treated relative to the
end of the string. The position returned is still relative to the
beginning of haystack regardless of the value of $offset.
返回值
Returns the position as an integer. If needle is not found, grapheme_stripos() will return boolean FALSE.
更新日志
| 版本 | 说明 |
|---|---|
| 7.1.0 | Support for negative offsets has been added. |
范例
示例 #1 grapheme_stripos example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
$char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) normalization form "D"
print grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd);
?>以上例程会输出：
2参见
- grapheme_stristr
- grapheme_strpos
- grapheme_strripos
- grapheme_strrpos
- grapheme_strstr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_stristr
Returns part of haystack string from the first occurrence of case-insensitive needle to the end of haystack
说明
过程化风格
string <span
class="methodname">grapheme_stristr ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">bool $before_needle =
false ] )
Returns part of haystack string starting from and including the first occurrence of case-insensitive needle to the end of haystack.
参数
haystack
The input string. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
before_needle
If true, grapheme_strstr() returns the part of the haystack
before the first occurrence of the needle (excluding needle).
返回值
Returns the portion of $haystack, or FALSE if $needle is not found.
范例
示例 #1 grapheme_stristr example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
$char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) normalization form "D"
print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_O_diaeresis_nfd));
?>以上例程会输出：
o%CC%88a%CC%8A参见
- grapheme_stripos
- grapheme_strpos
- grapheme_strripos
- grapheme_strrpos
- grapheme_strstr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_strlen
Get string length in grapheme units
说明
过程化风格
int <span
class="methodname">grapheme_strlen ( <span
class="methodparam">string $input )
Get string length in grapheme units (not bytes or characters)
参数
input
The string being measured for length. It must be a valid UTF-8 string.
返回值
The length of the string on success, and 0 if the string is empty.
范例
示例 #1 grapheme_strlen example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print grapheme_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd);
?>以上例程会输出：
6参见
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
- iconv_strlen
- mb_strlen
- strlen
grapheme_strpos
Find position (in grapheme units) of first occurrence of a string
说明
过程化风格
int <span
class="methodname">grapheme_strpos ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">int $offset =
0 ] )
Find position (in grapheme units) of first occurrence of a string
参数
haystack
The string to look in. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
offset
The optional $offset parameter allows you to specify where in $haystack
to start searching as an offset in grapheme units (not bytes or
characters). If the offset is negative, it is treated relative to the
end of the string. The position returned is still relative to the
beginning of haystack regardless of the value of $offset.
返回值
Returns the position as an integer. If needle is not found, grapheme_strpos() will return boolean FALSE.
更新日志
| 版本 | 说明 |
|---|---|
| 7.1.0 | Support for negative offsets has been added. |
范例
示例 #1 grapheme_strpos example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print grapheme_strpos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd);
?>以上例程会输出：
2参见
- grapheme_stripos
- grapheme_stristr
- grapheme_strripos
- grapheme_strrpos
- grapheme_strstr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_strripos
Find position (in grapheme units) of last occurrence of a case-insensitive string
说明
过程化风格
int <span
class="methodname">grapheme_strripos ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">int $offset =
0 ] )
Find position (in grapheme units) of last occurrence of a case-insensitive string
参数
haystack
The string to look in. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
offset
The optional $offset parameter allows you to specify where in $haystack
to start searching as an offset in grapheme units (not bytes or
characters). The position returned is still relative to the beginning of
haystack regardless of the value of $offset.
返回值
Returns the position as an integer. If needle is not found, grapheme_strripos() will return boolean FALSE.
范例
示例 #1 grapheme_strripos example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
$char_O_diaeresis_nfd = "O\xCC\x88"; // 'LATIN CAPITAL LETTER O WITH DIAERESIS' (U+00D6) normalization form "D"
print grapheme_strripos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd);
?>以上例程会输出：
2参见
- grapheme_stripos
- grapheme_stristr
- grapheme_strpos
- grapheme_strrpos
- grapheme_strstr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_strrpos
Find position (in grapheme units) of last occurrence of a string
说明
过程化风格
int <span
class="methodname">grapheme_strrpos ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">int $offset =
0 ] )
Find position (in grapheme units) of last occurrence of a string
参数
haystack
The string to look in. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
offset
The optional $offset parameter allows you to specify where in $haystack
to start searching as an offset in grapheme units (not bytes or
characters). The position returned is still relative to the beginning of
haystack regardless of the value of $offset.
返回值
Returns the position as an integer. If needle is not found, grapheme_strrpos() will return boolean FALSE.
范例
示例 #1 grapheme_strrpos example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print grapheme_strrpos( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd);
?>以上例程会输出：
2参见
- grapheme_stripos
- grapheme_stristr
- grapheme_strpos
- grapheme_strripos
- grapheme_strstr
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_strstr
Returns part of haystack string from the first occurrence of needle to the end of haystack
说明
过程化风格
string <span
class="methodname">grapheme_strstr ( <span
class="methodparam">string $haystack
, string
$needle [, <span
class="type">bool $before_needle =
false ] )
Returns part of haystack string from the first occurrence of needle to the end of haystack (including the needle).
参数
haystack
The input string. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
before_needle
If true, grapheme_strstr() returns the part of the haystack
before the first occurrence of the needle (excluding the needle).
返回值
Returns the portion of string, or FALSE if needle is not found.
范例
示例 #1 grapheme_strstr example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_o_diaeresis_nfd));
?>以上例程会输出：
o%CC%88a%CC%8A参见
- grapheme_stristr
- grapheme_stripos
- grapheme_strpos
- grapheme_strripos
- grapheme_strrpos
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
grapheme_substr
Return part of a string
说明
过程化风格
string <span
class="methodname">grapheme_substr ( <span
class="methodparam">string $string ,
int $start
[, int
$length ] )
Return part of a string
参数
string
The input string. Must be valid UTF-8.
start
Start position in default grapheme units. If $start is non-negative, the
returned string will start at the $start'th position in $string,
counting from zero. If $start is negative, the returned string will
start at the $start'th grapheme unit from the end of string.
length
Length in grapheme units. If $length is given and is positive, the
string returned will contain at most $length grapheme units beginning
from $start (depending on the length of string). If $length is given and
is negative, then that many grapheme units will be omitted from the end
of string (after the start position has been calculated when a start is
negative). If $start denotes a position beyond this truncation,
false will be returned.
返回值
Returns the extracted part of $string.
范例
示例 #1 grapheme_substr example
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 ));
?>以上例程会输出：
a%CC%8Abco%CC%88参见
- grapheme_extract
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
目录
- grapheme_extract — Function to extract a sequence of default grapheme clusters from a text buffer, which must be encoded in UTF-8
- grapheme_stripos — Find position (in grapheme units) of first occurrence of a case-insensitive string
- grapheme_stristr — Returns part of haystack string from the first occurrence of case-insensitive needle to the end of haystack
- grapheme_strlen — Get string length in grapheme units
- grapheme_strpos — Find position (in grapheme units) of first occurrence of a string
- grapheme_strripos — Find position (in grapheme units) of last occurrence of a case-insensitive string
- grapheme_strrpos — Find position (in grapheme units) of last occurrence of a string
- grapheme_strstr — Returns part of haystack string from the first occurrence of needle to the end of haystack
- grapheme_substr — Return part of a string