grapheme_extract

(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.0)

grapheme_extract — Function to extract a sequence of default grapheme clusters from a text buffer, which must be encoded in UTF-8

说明

过程化风格

grapheme_extract ( string $haystack , int $size [, int $extract_type [, int $start = 0 [, int &$next ]]] ) : string

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.

范例

Example #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
相关文章
php gettext 函数 specify the character encoding in which the messages from the domain message catalog will be returnedphp dbx 函数 sort a result from a dbx query by a custom sort functionphp grapheme 函数 function to extract a sequence of default grapheme clusters from a text buffer which must be encoded in utf 8php grapheme 函数 returns part of haystack string from the first occurrence of case insensitive needle to the end of haystackphp grapheme 函数 returns part of haystack string from the first occurrence of needle to the end of haystackphp firebird/interbase 函数 register a callback function to be called when events are postedphp informix 函数 set the default text modephp imap 函数 decode base64 encoded textphp imap 函数 converts mime encoded text to utf 8php ldap 函数 extract information from reference entryphp ldap 函数 extract information from resultphp mcve 函数 returns array of strings which represents the keys that can be used for response parameters on this transactionphp mailparse 函数 scans the data from fp and extract each embedded uuencoded filephp output control 函数 在ob start中使用的用来压缩输出缓冲区中内容的回调函数。ob start callback function to gzip output bufferphp tidy 函数 ob start callback function to repair the bufferphp postgresql 函数 submits a command to the server and waits for the result with the ability to pass parameters separately from the sql command textphp runkit 函数 specify a function to capture and/or process output from a runkit sandboxphp sodium 函数 generate a deterministic sequence of bytes from a seedphp uopz 函数 gets the static variables from function or method scopephp uconverter default from callback function
关注编程学问公众号