grapheme_extract

Function • Params and return types changed in PHP 8.0
PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

grapheme_extract Function synopsis

grapheme_extract(
    string $haystack,
    int $size,
    int $type = GRAPHEME_EXTR_COUNT,
    int $offset = 0,
    &$next = null
  ): string|false

Parameters

$haystack

Typestring

$size

Typeint

$type

OptionalTypeintDefault valueGRAPHEME_EXTR_COUNT

$offset

OptionalTypeintDefault value0

$next

Passed by reference, OptionalDefault valuenull

Note that the parameter $next is passed by reference, and contains additional/updated context data that may be useful.

Return value

Typestring|false

Changes to the grapheme_extract Function

PHP 8.0

  • Return type added: string|false
  • Parameter name of parameter #1 changed: $arg1 to $haystack
  • Parameter type added for parameter #1 ($haystack): string
  • Parameter name of parameter #2 changed: $arg2 to $size
  • Parameter type added for parameter #2 ($size): int
  • Parameter name of parameter #3 changed: $arg3 to $type
  • Parameter type added for parameter #3 ($type): int
  • Parameter default value added for position #3 ($type): GRAPHEME_EXTR_COUNT
  • Parameter name of parameter #4 changed: $arg4 to $offset
  • Parameter type added for parameter #4 ($offset): int
  • Parameter default value added for position #4 ($offset): 0
  • Parameter name of parameter #5 changed: $arg5 to $next
  • Parameter default value added for position #5 ($next): null
  grapheme_extract(
-     $arg1,
+     string $haystack,
-     $arg2,
+     int $size,
-     $arg3,
+     int $type = GRAPHEME_EXTR_COUNT,
-     $arg4,
+     int $offset = 0,
-     &$arg5
+     &$next = null
-   )
+   ): string|false

grapheme_extract Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes