PHP Classes

Portable UTF-8: Manipulate UTF-8 text strings in pure PHP

Recommend this page to a friend!
  Info   View files Documentation   View files View files (107)   DownloadInstall with Composer Download .zip   Reputation   Support forum (2)   Blog (1)    
Ratings Unique User Downloads Download Rankings
StarStarStarStar 67%Total: 688 This week: 1All time: 4,736 This week: 560Up
Version License PHP version Categories
portable-utf8 3.0.107Custom (specified...5.3PHP 5, Text processing
Collaborate with this project 

Authors

Nicolas Grekas
Hamid Sarfraz
Lars Moelleken


Contributor

portable-utf8 - github.com

Description

This package can manipulate UTF-8 text strings in pure PHP.

It performs several types of functions to manipulate text strings encoded using UTF-8 that can work even when extensions like mbstring, iconv, or Intl are not available.

If these extensions are available the class will fallback to using them instead.

Innovation Award
PHP Programming Innovation award nominee
September 2016
Number 3


Prize: One downloadable e-book of choice by O'Reilly
Nowadays PHP has different extensions to manipulate text strings using Unicode UTF-8. However some may be available or not in different PHP environments.

This package provides a pure PHP solution to manipulate text in UTF-8, so you do not depend on whether any other extensions are available.

If such extensions are available, the package may fallback to using them them for performing the same UTF-8 text manipulation operations.

Manuel Lemos
Picture of Lars Moelleken
  Performance   Level  
Name: Lars Moelleken <contact>
Classes: 25 packages by
Country: Germany Germany
Age: 36
All time rank: 62340 in Germany Germany
Week rank: 33 Up2 in Germany Germany Up
Innovation award
Innovation award
Nominee: 11x

Winner: 1x

Recommendations

What is the best PHP count words class?
Count the number of words in a string

Documentation

[//]: # (AUTO-GENERATED BY "PHP README Helper": base file -> docs/base.md) Build Status Build status FOSSA Status codecov.io Codacy Badge Latest Stable Version Total Downloads License Donate to this project using PayPal Donate to this project using Patreon

? Portable UTF-8

Description

It is written in PHP (PHP 7+) and can work without "mbstring", "iconv" or any other extra encoding php-extension on your server.

The benefit of Portable UTF-8 is that it is easy to use, easy to bundle. This library will also auto-detect your server environment and will use the installed php-extensions if they are available, so you will have the best possible performance.

As a fallback we will use Symfony Polyfills, if needed. (https://github.com/symfony/polyfill)

The project based on ... + Hamid Sarfraz's work - portable-utf8 + Nicolas Grekas's work - tchwork/utf8 + Behat's work - Behat/Transliterator + Sebastián Grignoli's work - neitanod/forceutf8 + Ivan Enderlin's work - hoaproject/Ustring + and many cherry-picks from "GitHub"-gists and "Stack Overflow"-snippets ...

Demo

Here you can test some basic functions from this library and you can compare some results with the native php function results.

Index

Alternative

If you like a more Object Oriented Way to edit strings, then you can take a look at voku/Stringy, it's a fork of "danielstjules/Stringy" but it used the "Portable UTF-8"-Class and some extra methods.

// Standard library
strtoupper('fòôbà?');       // 'FòôBà?'
strlen('fòôbà?');           // 10

// mbstring 
// WARNING: if you don't use a polyfill like "Portable UTF-8", you need to install the php-extension "mbstring" on your server
mb_strtoupper('fòôbà?');    // 'FÒÔBÀ?'
mb_strlen('fòôbà?');        // '6'

// Portable UTF-8
use voku\helper\UTF8;
UTF8::strtoupper('fòôbà?');    // 'FÒÔBÀ?'
UTF8::strlen('fòôbà?');        // '6'

// voku/Stringy
use Stringy\Stringy as S;
$stringy = S::create('fòôbà?');
$stringy->toUpperCase();    // 'FÒÔBÀ?'
$stringy->length();         // '6'

Install "Portable UTF-8" via "composer require"

composer require voku/portable-utf8

If your project do not need some of the Symfony polyfills please use the replace section of your composer.json. This removes any overhead from these polyfills as they are no longer part of your project. e.g.:

{
  "replace": {
    "symfony/polyfill-php72": "1.99",
    "symfony/polyfill-iconv": "1.99",
    "symfony/polyfill-intl-grapheme": "1.99",
    "symfony/polyfill-intl-normalizer": "1.99",
    "symfony/polyfill-mbstring": "1.99"
  }
}

Why Portable UTF-8?[]()

PHP 5 and earlier versions have no native Unicode support. To bridge the gap, there exist several extensions like "mbstring", "iconv" and "intl".

The problem with "mbstring" and others is that most of the time you cannot ensure presence of a specific one on a server. If you rely on one of these, your application is no more portable. This problem gets even severe for open source applications that have to run on different servers with different configurations. Considering these, I decided to write a library:

Requirements and Recommendations

  • No extensions are required to run this library. Portable UTF-8 only needs PCRE library that is available by default since PHP 4.2.0 and cannot be disabled since PHP 5.3.0. "\u" modifier support in PCRE for UTF-8 handling is not a must.
  • PHP 5.3 is the minimum requirement, and all later versions are fine with Portable UTF-8.
  • PHP 7.0 is the minimum requirement since version 4.0 of Portable UTF-8, otherwise composer will install an older version
  • PHP 8.0 support is also available and will adapt the behaviours of the native functions.
  • To speed up string handling, it is recommended that you have "mbstring" or "iconv" available on your server, as well as the latest version of PCRE library
  • Although Portable UTF-8 is easy to use; moving from native API to Portable UTF-8 may not be straight-forward for everyone. It is highly recommended that you do not update your scripts to include Portable UTF-8 or replace or change anything before you first know the reason and consequences. Most of the time, some native function may be all what you need.
  • There is also a shim for "mbstring", "iconv" and "intl", so you can use it also on shared webspace.

Usage

Example 1: UTF8::cleanup()

  echo UTF8::cleanup('?Düsseldorf?');
  
  // will output:
  // Düsseldorf

Example 2: UTF8::strlen()

  $string = 'string <strong>with utf-8 chars åèä</strong> - doo-bee doo-bee dooh';

  echo strlen($string) . "\n<br />";
  echo UTF8::strlen($string) . "\n<br />";

  // will output:
  // 70
  // 67

  $string_test1 = strip_tags($string);
  $string_test2 = UTF8::strip_tags($string);

  echo strlen($string_test1) . "\n<br />";
  echo UTF8::strlen($string_test2) . "\n<br />";

  // will output:
  // 53
  // 50

Example 3: UTF8::fix_utf8()


  echo UTF8::fix_utf8('Düsseldorf');
  echo UTF8::fix_utf8('ä');
  
  // will output:
  // Düsseldorf
  // ä

Portable UTF-8 | API

The API from the "UTF8"-Class is written as small static methods that will match the default PHP-API.

Class methods

<p id="voku-php-readme-class-methods"></p><table><tr><td><a href="#accessstring-str-int-pos-string-encoding-string">access</a> </td><td><a href="#add_bom_to_stringstring-str-string">add_bom_to_string</a> </td><td><a href="#array_change_key_casearray-array-int-case-string-encoding-string">array_change_key_case</a> </td><td><a href="#betweenstring-str-string-start-string-end-int-offset-string-encoding-string">between</a> </td></tr><tr><td><a href="#binary_to_strstring-bin-string">binary_to_str</a> </td><td><a href="#bom-string">bom</a> </td><td><a href="#callbackcallable-callback-string-str-string">callback</a> </td><td><a href="#char_atstring-str-int-index-string-encoding-string">char_at</a> </td></tr><tr><td><a href="#charsstring-str-string">chars</a> </td><td><a href="#checkforsupport-truenull">checkForSupport</a> </td><td><a href="#chrint-code_point-string-encoding-stringnull">chr</a> </td><td><a href="#chr_mapcallable-callback-string-str-string">chr_map</a> </td></tr><tr><td><a href="#chr_size_liststring-str-int">chr_size_list</a> </td><td><a href="#chr_to_decimalstring-char-int">chr_to_decimal</a> </td><td><a href="#chr_to_hexintstring-char-string-prefix-string">chr_to_hex</a> </td><td><a href="#chunk_splitstring-body-int-chunk_length-string-end-string">chunk_split</a> </td></tr><tr><td><a href="#cleanstring-str-bool-remove_bom-bool-normalize_whitespace-bool-normalize_msword-bool-keep_non_breaking_space-bool-replace_diamond_question_mark-bool-remove_invisible_characters-bool-remove_invisible_characters_url_encoded-string">clean</a> </td><td><a href="#cleanupstring-str-string">cleanup</a> </td><td><a href="#codepointsstringstring-arg-bool-use_u_style-intstring">codepoints</a> </td><td><a href="#collapse_whitespacestring-str-string">collapse_whitespace</a> </td></tr><tr><td><a href="#count_charsstring-str-bool-clean_utf8-bool-try_to_use_mb_functions-int">count_chars</a> </td><td><a href="#css_identifierstring-str-string-filter-bool-strip_tags-bool-strtolower-string">css_identifier</a> </td><td><a href="#css_stripe_media_queriesstring-str-string">css_stripe_media_queries</a> </td><td><a href="#ctype_loaded-bool">ctype_loaded</a> </td></tr><tr><td><a href="#decimal_to_chrintstring-int-string">decimal_to_chr</a> </td><td><a href="#decode_mimeheaderstring-str-string-encoding-falsestring">decode_mimeheader</a> </td><td><a href="#emoji_decodestring-str-bool-use_reversible_string_mappings-string">emoji_decode</a> </td><td><a href="#emoji_encodestring-str-bool-use_reversible_string_mappings-string">emoji_encode</a> </td></tr><tr><td><a href="#emoji_from_country_codestring-country_code_iso_3166_1-string">emoji_from_country_code</a> </td><td><a href="#encodestring-to_encoding-string-str-bool-auto_detect_the_from_encoding-string-from_encoding-string">encode</a> </td><td><a href="#encode_mimeheaderstring-str-string-from_charset-string-to_charset-string-transfer_encoding-string-linefeed-int-indent-falsestring">encode_mimeheader</a> </td><td><a href="#extract_textstring-str-string-search-intnull-length-string-replacer_for_skipped_text-string-encoding-string">extract_text</a> </td></tr><tr><td><a href="#file_get_contentsstring-filename-bool-use_include_path-resourcenull-context-intnull-offset-intnull-max_length-int-timeout-bool-convert_to_utf8-string-from_encoding-falsestring">file_get_contents</a> </td><td><a href="#file_has_bomstring-file_path-bool">file_has_bom</a> </td><td><a href="#filterarrayobjectstring-var-int-normalization_form-string-leading_combining-mixed">filter</a> </td><td><a href="#filter_inputint-type-string-variable_name-int-filter-intintnull-options-mixed">filter_input</a> </td></tr><tr><td><a href="#filter_input_arrayint-type-arraynull-definition-bool-add_empty-mixed">filter_input_array</a> </td><td><a href="#filter_varfloatintstringnull-variable-int-filter-intintnull-options-mixed">filter_var</a> </td><td><a href="#filter_var_arrayarray-data-arrayintnull-definition-bool-add_empty-mixed">filter_var_array</a> </td><td><a href="#finfo_loaded-bool">finfo_loaded</a> </td></tr><tr><td><a href="#first_charstring-str-int-n-string-encoding-string">first_char</a> </td><td><a href="#fits_insidestring-str-int-box_size-bool">fits_inside</a> </td><td><a href="#fix_simple_utf8string-str-string">fix_simple_utf8</a> </td><td><a href="#fix_utf8stringstring-str-stringstring">fix_utf8</a> </td></tr><tr><td><a href="#getchardirectionstring-char-string">getCharDirection</a> </td><td><a href="#getsupportinfostringnull-key-mixed">getSupportInfo</a> </td><td><a href="#get_file_typestring-str-array-fallback-nullstring">get_file_type</a> </td><td><a href="#get_random_stringint-length-string-possible_chars-string-encoding-string">get_random_string</a> </td></tr><tr><td><a href="#get_unique_stringintstring-extra_entropy-bool-use_md5-string">get_unique_string</a> </td><td><a href="#has_lowercasestring-str-bool">has_lowercase</a> </td><td><a href="#has_uppercasestring-str-bool">has_uppercase</a> </td><td><a href="#has_whitespacestring-str-bool">has_whitespace</a> </td></tr><tr><td><a href="#hex_to_chrstring-hexdec-falsestring">hex_to_chr</a> </td><td><a href="#hex_to_intstring-hexdec-falseint">hex_to_int</a> </td><td><a href="#html_encodestring-str-bool-keep_ascii_chars-string-encoding-string">html_encode</a> </td><td><a href="#html_entity_decodestring-str-intnull-flags-string-encoding-string">html_entity_decode</a> </td></tr><tr><td><a href="#html_escapestring-str-string-encoding-string">html_escape</a> </td><td><a href="#html_stripe_empty_tagsstring-str-string">html_stripe_empty_tags</a> </td><td><a href="#htmlentitiesstring-str-int-flags-string-encoding-bool-double_encode-string">htmlentities</a> </td><td><a href="#htmlspecialcharsstring-str-int-flags-string-encoding-bool-double_encode-string">htmlspecialchars</a> </td></tr><tr><td><a href="#iconv_loaded-bool">iconv_loaded</a> </td><td><a href="#int_to_hexint-int-string-prefix-string">int_to_hex</a> </td><td><a href="#intlchar_loaded-bool">intlChar_loaded</a> </td><td><a href="#intl_loaded-bool">intl_loaded</a> </td></tr><tr><td><a href="#is_alphastring-str-bool">is_alpha</a> </td><td><a href="#is_alphanumericstring-str-bool">is_alphanumeric</a> </td><td><a href="#is_asciistring-str-bool">is_ascii</a> </td><td><a href="#is_base64stringnull-str-bool-empty_string_is_valid-bool">is_base64</a> </td></tr><tr><td><a href="#is_binaryintstring-input-bool-strict-bool">is_binary</a> </td><td><a href="#is_binary_filestring-file-bool">is_binary_file</a> </td><td><a href="#is_blankstring-str-bool">is_blank</a> </td><td><a href="#is_bomstring-str-bool">is_bom</a> </td></tr><tr><td><a href="#is_emptyarrayfloatintstring-str-bool">is_empty</a> </td><td><a href="#is_hexadecimalstring-str-bool">is_hexadecimal</a> </td><td><a href="#is_htmlstring-str-bool">is_html</a> </td><td><a href="#is_jsonstring-str-bool-only_array_or_object_results_are_valid-bool">is_json</a> </td></tr><tr><td><a href="#is_lowercasestring-str-bool">is_lowercase</a> </td><td><a href="#is_printablestring-str-bool-ignore_control_characters-bool">is_printable</a> </td><td><a href="#is_punctuationstring-str-bool">is_punctuation</a> </td><td><a href="#is_serializedstring-str-bool">is_serialized</a> </td></tr><tr><td><a href="#is_uppercasestring-str-bool">is_uppercase</a> </td><td><a href="#is_urlstring-url-bool-disallow_localhost-bool">is_url</a> </td><td><a href="#is_utf8intstringstringnull-str-bool-strict-bool">is_utf8</a> </td><td><a href="#is_utf16string-str-bool-check_if_string_is_binary-falseint">is_utf16</a> </td></tr><tr><td><a href="#is_utf32string-str-bool-check_if_string_is_binary-falseint">is_utf32</a> </td><td><a href="#json_decodestring-json-bool-assoc-int-depth-int-options-mixed">json_decode</a> </td><td><a href="#json_encodemixed-value-int-options-int-depth-falsestring">json_encode</a> </td><td><a href="#json_loaded-bool">json_loaded</a> </td></tr><tr><td><a href="#lcfirststring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">lcfirst</a> </td><td><a href="#lcwordsstring-str-string-exceptions-string-char_list-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">lcwords</a> </td><td><a href="#ltrimstring-str-stringnull-chars-string">ltrim</a> </td><td><a href="#maxstringstring-arg-stringnull">max</a> </td></tr><tr><td><a href="#max_chr_widthstring-str-int">max_chr_width</a> </td><td><a href="#mbstring_loaded-bool">mbstring_loaded</a> </td><td><a href="#minstringstring-arg-stringnull">min</a> </td><td><a href="#normalize_encodingmixed-encoding-mixed-fallback-mixedstring">normalize_encoding</a> </td></tr><tr><td><a href="#normalize_line_endingstring-str-stringstring-replacer-string">normalize_line_ending</a> </td><td><a href="#normalize_mswordstring-str-string">normalize_msword</a> </td><td><a href="#normalize_whitespacestring-str-bool-keep_non_breaking_space-bool-keep_bidi_unicode_controls-bool-normalize_control_characters-string">normalize_whitespace</a> </td><td><a href="#ordstring-chr-string-encoding-int">ord</a> </td></tr><tr><td><a href="#parse_strstring-str-array-result-bool-clean_utf8-bool">parse_str</a> </td><td><a href="#pcre_utf8_support-bool">pcre_utf8_support</a> </td><td><a href="#rangeintstring-var1-intstring-var2-bool-use_ctype-string-encoding-floatint-step-string">range</a> </td><td><a href="#rawurldecodestring-str-bool-multi_decode-string">rawurldecode</a> </td></tr><tr><td><a href="#regex_replacestring-str-string-pattern-string-replacement-string-options-string-delimiter-string">regex_replace</a> </td><td><a href="#remove_bomstring-str-string">remove_bom</a> </td><td><a href="#remove_duplicatesstring-str-stringstring-what-string">remove_duplicates</a> </td><td><a href="#remove_htmlstring-str-string-allowable_tags-string">remove_html</a> </td></tr><tr><td><a href="#remove_html_breaksstring-str-string-replacement-string">remove_html_breaks</a> </td><td><a href="#remove_invisible_charactersstring-str-bool-url_encoded-string-replacement-bool-keep_basic_control_characters-string">remove_invisible_characters</a> </td><td><a href="#remove_leftstring-str-string-substring-string-encoding-string">remove_left</a> </td><td><a href="#remove_rightstring-str-string-substring-string-encoding-string">remove_right</a> </td></tr><tr><td><a href="#replacestring-str-string-search-string-replacement-bool-case_sensitive-string">replace</a> </td><td><a href="#replace_allstring-str-array-search-arraystring-replacement-bool-case_sensitive-string">replace_all</a> </td><td><a href="#replace_diamond_question_markstring-str-string-replacement_char-bool-process_invalid_utf8_chars-string">replace_diamond_question_mark</a> </td><td><a href="#rtrimstring-str-stringnull-chars-string">rtrim</a> </td></tr><tr><td><a href="#showsupportbool-useecho-stringvoid">showSupport</a> </td><td><a href="#single_chr_html_encodestring-char-bool-keep_ascii_chars-string-encoding-string">single_chr_html_encode</a> </td><td><a href="#spaces_to_tabsstring-str-int-tab_length-string">spaces_to_tabs</a> </td><td><a href="#str_camelizestring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">str_camelize</a> </td></tr><tr><td><a href="#str_capitalize_namestring-str-string">str_capitalize_name</a> </td><td><a href="#str_containsstring-haystack-string-needle-bool-case_sensitive-bool">str_contains</a> </td><td><a href="#str_contains_allstring-haystack-array-needles-bool-case_sensitive-bool">str_contains_all</a> </td><td><a href="#str_contains_anystring-haystack-array-needles-bool-case_sensitive-bool">str_contains_any</a> </td></tr><tr><td><a href="#str_dasherizestring-str-string-encoding-string">str_dasherize</a> </td><td><a href="#str_delimitstring-str-string-delimiter-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">str_delimit</a> </td><td><a href="#str_detect_encodingstring-str-falsestring">str_detect_encoding</a> </td><td><a href="#str_ends_withstring-haystack-string-needle-bool">str_ends_with</a> </td></tr><tr><td><a href="#str_ends_with_anystring-str-string-substrings-bool">str_ends_with_any</a> </td><td><a href="#str_ensure_leftstring-str-string-substring-string">str_ensure_left</a> </td><td><a href="#str_ensure_rightstring-str-string-substring-string">str_ensure_right</a> </td><td><a href="#str_humanizestring-str-string">str_humanize</a> </td></tr><tr><td><a href="#str_iends_withstring-haystack-string-needle-bool">str_iends_with</a> </td><td><a href="#str_iends_with_anystring-str-string-substrings-bool">str_iends_with_any</a> </td><td><a href="#str_insertstring-str-string-substring-int-index-string-encoding-string">str_insert</a> </td><td><a href="#str_ireplacestringstring-search-stringstring-replacement-stringstring-subject-int-count-stringstring">str_ireplace</a> </td></tr><tr><td><a href="#str_ireplace_beginningstring-str-string-search-string-replacement-string">str_ireplace_beginning</a> </td><td><a href="#str_ireplace_endingstring-str-string-search-string-replacement-string">str_ireplace_ending</a> </td><td><a href="#str_istarts_withstring-haystack-string-needle-bool">str_istarts_with</a> </td><td><a href="#str_istarts_with_anystring-str-array-substrings-bool">str_istarts_with_any</a> </td></tr><tr><td><a href="#str_isubstr_after_first_separatorstring-str-string-separator-string-encoding-string">str_isubstr_after_first_separator</a> </td><td><a href="#str_isubstr_after_last_separatorstring-str-string-separator-string-encoding-string">str_isubstr_after_last_separator</a> </td><td><a href="#str_isubstr_before_first_separatorstring-str-string-separator-string-encoding-string">str_isubstr_before_first_separator</a> </td><td><a href="#str_isubstr_before_last_separatorstring-str-string-separator-string-encoding-string">str_isubstr_before_last_separator</a> </td></tr><tr><td><a href="#str_isubstr_firststring-str-string-needle-bool-before_needle-string-encoding-string">str_isubstr_first</a> </td><td><a href="#str_isubstr_laststring-str-string-needle-bool-before_needle-string-encoding-string">str_isubstr_last</a> </td><td><a href="#str_last_charstring-str-int-n-string-encoding-string">str_last_char</a> </td><td><a href="#str_limitstring-str-int-length-string-str_add_on-string-encoding-string">str_limit</a> </td></tr><tr><td><a href="#str_limit_after_wordstring-str-int-length-string-str_add_on-string-encoding-string">str_limit_after_word</a> </td><td><a href="#str_longest_common_prefixstring-str1-string-str2-string-encoding-string">str_longest_common_prefix</a> </td><td><a href="#str_longest_common_substringstring-str1-string-str2-string-encoding-string">str_longest_common_substring</a> </td><td><a href="#str_longest_common_suffixstring-str1-string-str2-string-encoding-string">str_longest_common_suffix</a> </td></tr><tr><td><a href="#str_matches_patternstring-str-string-pattern-bool">str_matches_pattern</a> </td><td><a href="#str_obfuscatestring-str-float-percent-string-obfuscatechar-string-keepchars-string">str_obfuscate</a> </td><td><a href="#str_offset_existsstring-str-int-offset-string-encoding-bool">str_offset_exists</a> </td><td><a href="#str_offset_getstring-str-int-index-string-encoding-string">str_offset_get</a> </td></tr><tr><td><a href="#str_padstring-str-int-pad_length-string-pad_string-intstring-pad_type-string-encoding-string">str_pad</a> </td><td><a href="#str_pad_bothstring-str-int-length-string-pad_str-string-encoding-string">str_pad_both</a> </td><td><a href="#str_pad_leftstring-str-int-length-string-pad_str-string-encoding-string">str_pad_left</a> </td><td><a href="#str_pad_rightstring-str-int-length-string-pad_str-string-encoding-string">str_pad_right</a> </td></tr><tr><td><a href="#str_repeatstring-str-int-multiplier-string">str_repeat</a> </td><td><a href="#str_replace_beginningstring-str-string-search-string-replacement-string">str_replace_beginning</a> </td><td><a href="#str_replace_endingstring-str-string-search-string-replacement-string">str_replace_ending</a> </td><td><a href="#str_replace_firststring-search-string-replace-string-subject-string">str_replace_first</a> </td></tr><tr><td><a href="#str_replace_laststring-search-string-replace-string-subject-string">str_replace_last</a> </td><td><a href="#str_shufflestring-str-string-encoding-string">str_shuffle</a> </td><td><a href="#str_slicestring-str-int-start-intnull-end-string-encoding-falsestring">str_slice</a> </td><td><a href="#str_snakeizestring-str-string-encoding-string">str_snakeize</a> </td></tr><tr><td><a href="#str_sortstring-str-bool-unique-bool-desc-string">str_sort</a> </td><td><a href="#str_splitintstring-input-int-length-bool-clean_utf8-bool-try_to_use_mb_functions-string">str_split</a> </td><td><a href="#str_split_arrayintstring-input-int-length-bool-clean_utf8-bool-try_to_use_mb_functions-string">str_split_array</a> </td><td><a href="#str_split_patternstring-str-string-pattern-int-limit-string">str_split_pattern</a> </td></tr><tr><td><a href="#str_starts_withstring-haystack-string-needle-bool">str_starts_with</a> </td><td><a href="#str_starts_with_anystring-str-array-substrings-bool">str_starts_with_any</a> </td><td><a href="#str_substr_after_first_separatorstring-str-string-separator-string-encoding-string">str_substr_after_first_separator</a> </td><td><a href="#str_substr_after_last_separatorstring-str-string-separator-string-encoding-string">str_substr_after_last_separator</a> </td></tr><tr><td><a href="#str_substr_before_first_separatorstring-str-string-separator-string-encoding-string">str_substr_before_first_separator</a> </td><td><a href="#str_substr_before_last_separatorstring-str-string-separator-string-encoding-string">str_substr_before_last_separator</a> </td><td><a href="#str_substr_firststring-str-string-needle-bool-before_needle-string-encoding-string">str_substr_first</a> </td><td><a href="#str_substr_laststring-str-string-needle-bool-before_needle-string-encoding-string">str_substr_last</a> </td></tr><tr><td><a href="#str_surroundstring-str-string-substring-string">str_surround</a> </td><td><a href="#str_titleizestring-str-arraystringnull-ignore-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-bool-use_trim_first-stringnull-word_define_chars-string">str_titleize</a> </td><td><a href="#str_titleize_for_humansstring-str-array-ignore-string-encoding-string">str_titleize_for_humans</a> </td><td><a href="#str_to_binarystring-str-falsestring">str_to_binary</a> </td></tr><tr><td><a href="#str_to_linesstring-str-bool-remove_empty_values-intnull-remove_short_values-string">str_to_lines</a> </td><td><a href="#str_to_wordsstring-str-string-char_list-bool-remove_empty_values-intnull-remove_short_values-string">str_to_words</a> </td><td><a href="#str_truncatestring-str-int-length-string-substring-string-encoding-string">str_truncate</a> </td><td><a href="#str_truncate_safestring-str-int-length-string-substring-string-encoding-bool-ignore_do_not_split_words_for_one_word-string">str_truncate_safe</a> </td></tr><tr><td><a href="#str_underscoredstring-str-string">str_underscored</a> </td><td><a href="#str_upper_camelizestring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">str_upper_camelize</a> </td><td><a href="#str_word_countstring-str-int-format-string-char_list-intstring">str_word_count</a> </td><td><a href="#strcasecmpstring-str1-string-str2-string-encoding-int">strcasecmp</a> </td></tr><tr><td><a href="#strcmpstring-str1-string-str2-int">strcmp</a> </td><td><a href="#strcspnstring-str-string-char_list-int-offset-intnull-length-string-encoding-int">strcspn</a> </td><td><a href="#stringintintstringstring-intorhex-string">string</a> </td><td><a href="#string_has_bomstring-str-bool">string_has_bom</a> </td></tr><tr><td><a href="#strip_tagsstring-str-stringnull-allowable_tags-bool-clean_utf8-string">strip_tags</a> </td><td><a href="#strip_whitespacestring-str-string">strip_whitespace</a> </td><td><a href="#striposstring-haystack-string-needle-int-offset-string-encoding-bool-clean_utf8-falseint">stripos</a> </td><td><a href="#stripos_in_bytestring-haystack-string-needle-int-offset-falseint">stripos_in_byte</a> </td></tr><tr><td><a href="#stristrstring-haystack-string-needle-bool-before_needle-string-encoding-bool-clean_utf8-falsestring">stristr</a> </td><td><a href="#strlenstring-str-string-encoding-bool-clean_utf8-falseint">strlen</a> </td><td><a href="#strlen_in_bytestring-str-int">strlen_in_byte</a> </td><td><a href="#strnatcasecmpstring-str1-string-str2-string-encoding-int">strnatcasecmp</a> </td></tr><tr><td><a href="#strnatcmpstring-str1-string-str2-int">strnatcmp</a> </td><td><a href="#strncasecmpstring-str1-string-str2-int-len-string-encoding-int">strncasecmp</a> </td><td><a href="#strncmpstring-str1-string-str2-int-len-string-encoding-int">strncmp</a> </td><td><a href="#strpbrkstring-haystack-string-char_list-falsestring">strpbrk</a> </td></tr><tr><td><a href="#strposstring-haystack-intstring-needle-int-offset-string-encoding-bool-clean_utf8-falseint">strpos</a> </td><td><a href="#strpos_in_bytestring-haystack-string-needle-int-offset-falseint">strpos_in_byte</a> </td><td><a href="#strrchrstring-haystack-string-needle-bool-before_needle-string-encoding-bool-clean_utf8-falsestring">strrchr</a> </td><td><a href="#strrevstring-str-string-encoding-string">strrev</a> </td></tr><tr><td><a href="#strrichrstring-haystack-string-needle-bool-before_needle-string-encoding-bool-clean_utf8-falsestring">strrichr</a> </td><td><a href="#strriposstring-haystack-intstring-needle-int-offset-string-encoding-bool-clean_utf8-falseint">strripos</a> </td><td><a href="#strripos_in_bytestring-haystack-string-needle-int-offset-falseint">strripos_in_byte</a> </td><td><a href="#strrposstring-haystack-intstring-needle-int-offset-string-encoding-bool-clean_utf8-falseint">strrpos</a> </td></tr><tr><td><a href="#strrpos_in_bytestring-haystack-string-needle-int-offset-falseint">strrpos_in_byte</a> </td><td><a href="#strspnstring-str-string-mask-int-offset-intnull-length-string-encoding-falseint">strspn</a> </td><td><a href="#strstrstring-haystack-string-needle-bool-before_needle-string-encoding-bool-clean_utf8-falsestring">strstr</a> </td><td><a href="#strstr_in_bytestring-haystack-string-needle-bool-before_needle-falsestring">strstr_in_byte</a> </td></tr><tr><td><a href="#strtocasefoldstring-str-bool-full-bool-clean_utf8-string-encoding-stringnull-lang-bool-lower-string">strtocasefold</a> </td><td><a href="#strtolowerstring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">strtolower</a> </td><td><a href="#strtoupperstring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">strtoupper</a> </td><td><a href="#strtrstring-str-stringstring-from-stringstring-to-string">strtr</a> </td></tr><tr><td><a href="#strwidthstring-str-string-encoding-bool-clean_utf8-int">strwidth</a> </td><td><a href="#substrstring-str-int-offset-intnull-length-string-encoding-bool-clean_utf8-falsestring">substr</a> </td><td><a href="#substr_comparestring-str1-string-str2-int-offset-intnull-length-bool-case_insensitivity-string-encoding-int">substr_compare</a> </td><td><a href="#substr_countstring-haystack-string-needle-int-offset-intnull-length-string-encoding-bool-clean_utf8-falseint">substr_count</a> </td></tr><tr><td><a href="#substr_count_in_bytestring-haystack-string-needle-int-offset-intnull-length-falseint">substr_count_in_byte</a> </td><td><a href="#substr_count_simplestring-str-string-substring-bool-case_sensitive-string-encoding-int">substr_count_simple</a> </td><td><a href="#substr_ileftstring-haystack-string-needle-string">substr_ileft</a> </td><td><a href="#substr_in_bytestring-str-int-offset-intnull-length-falsestring">substr_in_byte</a> </td></tr><tr><td><a href="#substr_irightstring-haystack-string-needle-string">substr_iright</a> </td><td><a href="#substr_leftstring-haystack-string-needle-string">substr_left</a> </td><td><a href="#substr_replacestringstring-str-stringstring-replacement-intint-offset-intintnull-length-string-encoding-stringstring">substr_replace</a> </td><td><a href="#substr_rightstring-haystack-string-needle-string-encoding-string">substr_right</a> </td></tr><tr><td><a href="#swapcasestring-str-string-encoding-bool-clean_utf8-string">swapCase</a> </td><td><a href="#symfony_polyfill_used-bool">symfony_polyfill_used</a> </td><td><a href="#tabs_to_spacesstring-str-int-tab_length-string">tabs_to_spaces</a> </td><td><a href="#titlecasestring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">titlecase</a> </td></tr><tr><td><a href="#to_asciistring-str-string-unknown-bool-strict-string">to_ascii</a> </td><td><a href="#to_booleanboolfloatintstring-str-bool">to_boolean</a> </td><td><a href="#to_filenamestring-str-bool-use_transliterate-string-fallback_char-string">to_filename</a> </td><td><a href="#to_intstring-str-intnull">to_int</a> </td></tr><tr><td><a href="#to_iso8859stringstring-str-stringstring">to_iso8859</a> </td><td><a href="#to_stringfloatintobjectstringnull-input-stringnull">to_string</a> </td><td><a href="#to_utf8stringstring-str-bool-decode_html_entity_to_utf8-stringstring">to_utf8</a> </td><td><a href="#to_utf8_stringstring-str-bool-decode_html_entity_to_utf8-string">to_utf8_string</a> </td></tr><tr><td><a href="#trimstring-str-stringnull-chars-string">trim</a> </td><td><a href="#ucfirststring-str-string-encoding-bool-clean_utf8-stringnull-lang-bool-try_to_keep_the_string_length-string">ucfirst</a> </td><td><a href="#ucwordsstring-str-string-exceptions-string-char_list-string-encoding-bool-clean_utf8-string">ucwords</a> </td><td><a href="#urldecodestring-str-bool-multi_decode-string">urldecode</a> </td></tr><tr><td><a href="#utf8_decodestring-str-bool-keep_utf8_chars-string">utf8_decode</a> </td><td><a href="#utf8_encodestring-str-string">utf8_encode</a> </td><td><a href="#whitespace_table-string">whitespace_table</a> </td><td><a href="#words_limitstring-str-int-limit-string-str_add_on-string">words_limit</a> </td></tr><tr><td><a href="#wordwrapstring-str-int-width-string-break-bool-cut-string">wordwrap</a> </td><td><a href="#wordwrap_per_linestring-str-int-width-string-break-bool-cut-bool-add_final_break-stringnull-delimiter-string">wordwrap_per_line</a> </td><td><a href="#ws-string">ws</a> </td></tr></table>

access(string $str, int $pos, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Return the character at the specified position: $str[1] like functionality.

EXAMPLE: <code>UTF8::access('fòô', 1); // 'ò'</code>

Parameters: - string $str <p>A UTF-8 string.</p> - int $pos <p>The position of character to return.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>Single multi-byte character.</p>

add_bom_to_string(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Prepends UTF-8 BOM character to the string and returns the whole string.

INFO: If BOM already existed there, the Input string is returned.

EXAMPLE: <code>UTF8::add_bom_to_string('fòô'); // "\xEF\xBB\xBF" . 'fòô'</code>

Parameters: - string $str <p>The input string.</p>

Return: - string <p>The output string that contains BOM.</p>

array_change_key_case(array $array, int $case, string $encoding): string[]

<a href="#voku-php-readme-class-methods">?</a> Changes all keys in an array.

Parameters: - array<string, mixed> $array <p>The array to work on</p> - `int $case [optional] <p> Either <strong>CASE_UPPER</strong><br> or <strong>CASE_LOWER</strong> (default)</p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string[] <p>An array with its keys lower- or uppercased.</p>

between(string $str, string $start, string $end, int $offset, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the substring between $start and $end, if found, or an empty string. An optional offset may be supplied from which to begin the search for the start string.

Parameters: - string $str - string $start <p>Delimiter marking the start of the substring.</p> - string $end <p>Delimiter marking the end of the substring.</p> - int $offset [optional] <p>Index from which to begin the search. Default: 0</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

binary_to_str(string $bin): string

<a href="#voku-php-readme-class-methods">?</a> Convert binary into a string.

INFO: opposite to UTF8::str_to_binary()

EXAMPLE: <code>UTF8::binary_to_str('11110000100111111001100010000011'); // '?'</code>

Parameters: - string $bin 1|0

Return: - string

bom(): string

<a href="#voku-php-readme-class-methods">?</a> Returns the UTF-8 Byte Order Mark Character.

INFO: take a look at UTF8::$bom for e.g. UTF-16 and UTF-32 BOM values

EXAMPLE: <code>UTF8::bom(); // "\xEF\xBB\xBF"</code>

Parameters: __nothing__

Return: - string <p>UTF-8 Byte Order Mark.</p>

callback(callable $callback, string $str): string[]

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - callable $callback - string $str

Return: - string[]

char_at(string $str, int $index, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the character at $index, with indexes starting at 0.

Parameters: - string $str <p>The input string.</p> - int $index <p>Position of the character.</p> - string $encoding [optional] <p>Default is UTF-8</p>

Return: - string <p>The character at $index.</p>

chars(string $str): string[]

<a href="#voku-php-readme-class-methods">?</a> Returns an array consisting of the characters in the string.

Parameters: - string $str <p>The input string.</p>

Return: - string[] <p>An array of chars.</p>

checkForSupport(): true|null

<a href="#voku-php-readme-class-methods">?</a> This method will auto-detect your server environment for UTF-8 support.

Parameters: __nothing__

Return: - true|null

chr(int $code_point, string $encoding): string|null

<a href="#voku-php-readme-class-methods">?</a> Generates a UTF-8 encoded character from the given code point.

INFO: opposite to UTF8::ord()

EXAMPLE: <code>UTF8::chr(0x2603); // '?'</code>

Parameters: - int $code_point <p>The code point for which to generate a character.</p> - string $encoding [optional] <p>Default is UTF-8</p>

Return: - string|null <p>Multi-byte character, returns null on failure or empty input.</p>

chr_map(callable $callback, string $str): string[]

<a href="#voku-php-readme-class-methods">?</a> Applies callback to all characters of a string.

EXAMPLE: <code>UTF8::chr_map([UTF8::class, 'strtolower'], '?????'); // ['?','?', '?', '?', '?']</code>

Parameters: - callable $callback <p>The callback function.</p> - string $str <p>UTF-8 string to run callback on.</p>

Return: - string[] <p>The outcome of the callback, as array.</p>

chr_size_list(string $str): int[]

<a href="#voku-php-readme-class-methods">?</a> Generates an array of byte length of each character of a Unicode string.

1 byte => U+0000 - U+007F 2 byte => U+0080 - U+07FF 3 byte => U+0800 - U+FFFF 4 byte => U+10000 - U+10FFFF

EXAMPLE: <code>UTF8::chr_size_list('????-test'); // [3, 3, 3, 3, 1, 1, 1, 1, 1]</code>

Parameters: - string $str <p>The original unicode string.</p>

Return: - int[] <p>An array of byte lengths of each character.</p>

chr_to_decimal(string $char): int

<a href="#voku-php-readme-class-methods">?</a> Get a decimal code representation of a specific character.

INFO: opposite to UTF8::decimal_to_chr()

EXAMPLE: <code>UTF8::chr_to_decimal('§'); // 0xa7</code>

Parameters: - string $char <p>The input character.</p>

Return: - int

chr_to_hex(int|string $char, string $prefix): string

<a href="#voku-php-readme-class-methods">?</a> Get hexadecimal code point (U+xxxx) of a UTF-8 encoded character.

EXAMPLE: <code>UTF8::chr_to_hex('§'); // U+00a7</code>

Parameters: - int|string $char <p>The input character</p> - string $prefix [optional]

Return: - string <p>The code point encoded as U+xxxx.</p>

chunk_split(string $body, int $chunk_length, string $end): string

<a href="#voku-php-readme-class-methods">?</a> Splits a string into smaller chunks and multiple lines, using the specified line ending character.

EXAMPLE: <code>UTF8::chunk_split('ABC-ÖÄÜ-????-?????', 3); // "ABC\r\n-ÖÄ\r\nÜ-?\r\n???\r\n-??\r\n???"</code>

Parameters: - string $body <p>The original string to be split.</p> - int $chunk_length [optional] <p>The maximum character length of a chunk.</p> - string $end [optional] <p>The character(s) to be inserted at the end of each chunk.</p>

Return: - string <p>The chunked string.</p>

clean(string $str, bool $remove_bom, bool $normalize_whitespace, bool $normalize_msword, bool $keep_non_breaking_space, bool $replace_diamond_question_mark, bool $remove_invisible_characters, bool $remove_invisible_characters_url_encoded): string

<a href="#voku-php-readme-class-methods">?</a> Accepts a string and removes all non-UTF-8 characters from it + extras if needed.

EXAMPLE: <code>UTF8::clean("\xEF\xBB\xBF?Abcdef\xc2\xa0\x20?? ? ? - Düsseldorf", true, true); // '?Abcdef  ?? ? ? - Düsseldorf'</code>

Parameters: - string $str <p>The string to be sanitized.</p> - `bool $remove_bom [optional] <p>Set to true, if you need to remove UTF-BOM.</p>` - `bool $normalize_whitespace [optional] <p>Set to true, if you need to normalize the whitespace.</p>` - `bool $normalize_msword [optional] <p>Set to true, if you need to normalize MS Word chars e.g.: "?" => "..."</p>` - `bool $keep_non_breaking_space [optional] <p>Set to true, to keep non-breaking-spaces, in combination with $normalize_whitespace</p>` - `bool $replace_diamond_question_mark [optional] <p>Set to true, if you need to remove diamond question mark e.g.: "?"</p>` - `bool $remove_invisible_characters [optional] <p>Set to false, if you not want to remove invisible characters e.g.: "\0"</p>` - `bool $remove_invisible_characters_url_encoded [optional] <p>Set to true, if you not want to remove invisible url encoded characters e.g.: "%0B"<br> WARNING: maybe contains false-positives e.g. aa%0Baa -> aaaa. </p>`

Return: - string <p>An clean UTF-8 encoded string.</p>

cleanup(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Clean-up a string and show only printable UTF-8 chars at the end + fix UTF-8 encoding.

EXAMPLE: <code>UTF8::cleanup("\xEF\xBB\xBF?Abcdef\xc2\xa0\x20?? ? ? - Düsseldorf", true, true); // '?Abcdef  ?? ? ? - Düsseldorf'</code>

Parameters: - string $str <p>The input string.</p>

Return: - string

codepoints(string|string[] $arg, bool $use_u_style): int[]|string[]

<a href="#voku-php-readme-class-methods">?</a> Accepts a string or a array of strings and returns an array of Unicode code points.

INFO: opposite to UTF8::string()

EXAMPLE: <code> UTF8::codepoints('?öñ'); // array(954, 246, 241) // ... OR ... UTF8::codepoints('?öñ', true); // array('U+03ba', 'U+00f6', 'U+00f1') </code>

Parameters: - string|string[] $arg <p>A UTF-8 encoded string or an array of such strings.</p> - `bool $use_u_style <p>If True, will return code points in U+xxxx format, default, code points will be returned as integers.</p>`

Return: - `int[]|string[] <p> The array of code points:<br> int[] for $u_style === false<br> string[] for $u_style === true<br> </p>`

collapse_whitespace(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Trims the string and replaces consecutive whitespace characters with a single space. This includes tabs and newline characters, as well as multibyte whitespace such as the thin space and ideographic space.

Parameters: - string $str <p>The input string.</p>

Return: - string <p>A string with trimmed $str and condensed whitespace.</p>

count_chars(string $str, bool $clean_utf8, bool $try_to_use_mb_functions): int[]

<a href="#voku-php-readme-class-methods">?</a> Returns count of characters used in a string.

EXAMPLE: <code>UTF8::count_chars('?a?b?c'); // array('?' => 3, 'a' => 1, 'b' => 1, 'c' => 1)</code>

Parameters: - string $str <p>The input string.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - bool $try_to_use_mb_functions [optional] <p>Set to false, if you don't want to use

Return: - `int[] <p>An associative array of Character as keys and their count as values.</p>`

css_identifier(string $str, string[] $filter, bool $strip_tags, bool $strtolower): string

<a href="#voku-php-readme-class-methods">?</a> Create a valid CSS identifier for e.g. "class"- or "id"-attributes.

EXAMPLE: <code>UTF8::css_identifier('123foo/bar!!!'); // _23foo-bar</code>

copy&past from https://github.com/drupal/core/blob/8.8.x/lib/Drupal/Component/Utility/Html.php#L95

Parameters: - string $str <p>INFO: if no identifier is given e.g. " " or "", we will create a unique string automatically</p> - array<string, string> $filter - bool $strip_tags - bool $strtolower

Return: - string

css_stripe_media_queries(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Remove css media-queries.

Parameters: - string $str

Return: - string

ctype_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether ctype is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

decimal_to_chr(int|string $int): string

<a href="#voku-php-readme-class-methods">?</a> Converts an int value into a UTF-8 character.

INFO: opposite to UTF8::string()

EXAMPLE: <code>UTF8::decimal_to_chr(931); // '?'</code>

Parameters: - int|string $int

Return: - string

decode_mimeheader(string $str, string $encoding): false|string

<a href="#voku-php-readme-class-methods">?</a> Decodes a MIME header field

Parameters: - string $str - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `false|string <p>A decoded MIME field on success, or false if an error occurs during the decoding.</p>`

emoji_decode(string $str, bool $use_reversible_string_mappings): string

<a href="#voku-php-readme-class-methods">?</a> Decodes a string which was encoded by "UTF8::emoji_encode()".

INFO: opposite to UTF8::emoji_encode()

EXAMPLE: <code> UTF8::emoji_decode('foo CHARACTER_OGRE', false); // 'foo ?' // UTF8::emoji_decode('foo _-_PORTABLE_UTF8_-_308095726_-_627590803_-_8FTU_ELBATROP_-_', true); // 'foo ?' </code>

Parameters: - string $str <p>The input string.</p> - `bool $use_reversible_string_mappings [optional] <p> When <b>TRUE</b>, we se a reversible string mapping between "emoji_encode" and "emoji_decode".</p>`

Return: - string

emoji_encode(string $str, bool $use_reversible_string_mappings): string

<a href="#voku-php-readme-class-methods">?</a> Encode a string with emoji chars into a non-emoji string.

INFO: opposite to UTF8::emoji_decode()

EXAMPLE: <code> UTF8::emoji_encode('foo ?', false)); // 'foo CHARACTER_OGRE' // UTF8::emoji_encode('foo ?', true)); // 'foo _-_PORTABLE_UTF8_-_308095726_-_627590803_-_8FTU_ELBATROP_-_' </code>

Parameters: - string $str <p>The input string</p> - `bool $use_reversible_string_mappings [optional] <p> when <b>TRUE</b>, we use a reversible string mapping between "emoji_encode" and "emoji_decode"</p>`

Return: - string

emoji_from_country_code(string $country_code_iso_3166_1): string

<a href="#voku-php-readme-class-methods">?</a> Convert any two-letter country code (ISO 3166-1) to the corresponding Emoji.

Parameters: - string $country_code_iso_3166_1 <p>e.g. DE</p>

Return: - string <p>Emoji or empty string on error.</p>

encode(string $to_encoding, string $str, bool $auto_detect_the_from_encoding, string $from_encoding): string

<a href="#voku-php-readme-class-methods">?</a> Encode a string with a new charset-encoding.

INFO: This function will also try to fix broken / double encoding,

   so you can call this function also on a UTF-8 string and you don't mess up the string.

EXAMPLE: <code> UTF8::encode('ISO-8859-1', '-ABC-????-'); // '-ABC-????-' // UTF8::encode('UTF-8', '-ABC-????-'); // '-ABC-????-' // UTF8::encode('HTML', '-ABC-????-'); // '-ABC-&#20013;&#25991;&#31354;&#30333;-' // UTF8::encode('BASE64', '-ABC-????-'); // 'LUFCQy3kuK3mlofnqbrnmb0t' </code>

Parameters: - string $to_encoding <p>e.g. 'UTF-16', 'UTF-8', 'ISO-8859-1', etc.</p> - string $str <p>The input string</p> - `bool $auto_detect_the_from_encoding [optional] <p>Force the new encoding (we try to fix broken / double encoding for UTF-8)<br> otherwise we auto-detect the current string-encoding</p>` - `string $from_encoding [optional] <p>e.g. 'UTF-16', 'UTF-8', 'ISO-8859-1', etc.<br> A empty string will trigger the autodetect anyway.</p>`

Return: - string

encode_mimeheader(string $str, string $from_charset, string $to_charset, string $transfer_encoding, string $linefeed, int $indent): false|string

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - string $str - string $from_charset [optional] <p>Set the input charset.</p> - string $to_charset [optional] <p>Set the output charset.</p> - string $transfer_encoding [optional] <p>Set the transfer encoding.</p> - string $linefeed [optional] <p>Set the used linefeed.</p> - int $indent [optional] <p>Set the max length indent.</p>

Return: - `false|string <p>An encoded MIME field on success, or false if an error occurs during the encoding.</p>`

extract_text(string $str, string $search, int|null $length, string $replacer_for_skipped_text, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Create an extract from a sentence, so if the search-string was found, it try to centered in the output.

Parameters: - string $str <p>The input string.</p> - string $search <p>The searched string.</p> - int|null $length [optional] <p>Default: null === text->length / 2</p> - string $replacer_for_skipped_text [optional] <p>Default: ?</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

file_get_contents(string $filename, bool $use_include_path, resource|null $context, int|null $offset, int|null $max_length, int $timeout, bool $convert_to_utf8, string $from_encoding): false|string

<a href="#voku-php-readme-class-methods">?</a> Reads entire file into a string.

EXAMPLE: <code>UTF8::file_get_contents('utf16le.txt'); // ...</code>

WARNING: Do not use UTF-8 Option ($convert_to_utf8) for binary files (e.g.: images) !!!

Parameters: - `string $filename <p> Name of the file to read. </p>` - `bool $use_include_path [optional] <p> Prior to PHP 5, this parameter is called use_include_path and is a bool. As of PHP 5 the FILE_USE_INCLUDE_PATH can be used to trigger include path search. </p>` - `resource|null $context [optional] <p> A valid context resource created with stream_context_create. If you don't need to use a custom context, you can skip this parameter by &null;. </p>` - `int|null $offset [optional] <p> The offset where the reading starts. </p>` - `int|null $max_length [optional] <p> Maximum length of data read. The default is to read until end of file is reached. </p>` - int $timeout <p>The time in seconds for the timeout.</p> - `bool $convert_to_utf8 <strong>WARNING!!!</strong> <p>Maybe you can't use this option for some files, because they used non default utf-8 chars. Binary files like images or pdf will not be converted.</p>` - `string $from_encoding [optional] <p>e.g. 'UTF-16', 'UTF-8', 'ISO-8859-1', etc.<br> A empty string will trigger the autodetect anyway.</p>`

Return: - false|string <p>The function returns the read data as string or <b>false</b> on failure.</p>

file_has_bom(string $file_path): bool

<a href="#voku-php-readme-class-methods">?</a> Checks if a file starts with BOM (Byte Order Mark) character.

EXAMPLE: <code>UTF8::file_has_bom('utf8_with_bom.txt'); // true</code>

Parameters: - string $file_path <p>Path to a valid file.</p>

Return: - bool <p><strong>true</strong> if the file has BOM at the start, <strong>false</strong> otherwise</p>

filter(array|object|string $var, int $normalization_form, string $leading_combining): mixed

<a href="#voku-php-readme-class-methods">?</a> Normalizes to UTF-8 NFC, converting from WINDOWS-1252 when needed.

EXAMPLE: <code>UTF8::filter(array("\xE9", 'à', 'a')); // array('é', 'a?', 'a')</code>

Parameters: - TFilter $var - int $normalization_form - string $leading_combining

Return: - mixed

filter_input(int $type, string $variable_name, int $filter, int|int[]|null $options): mixed

<a href="#voku-php-readme-class-methods">?</a> "filter_input()"-wrapper with normalizes to UTF-8 NFC, converting from WINDOWS-1252 when needed.

Gets a specific external variable by name and optionally filters it.

EXAMPLE: <code> // _GET['foo'] = 'bar'; UTF8::filter_input(INPUT_GET, 'foo', FILTER_UNSAFE_RAW)); // 'bar' </code>

Parameters: - `int $type <p> One of <b>INPUT_GET</b>, <b>INPUT_POST</b>, <b>INPUT_COOKIE</b>, <b>INPUT_SERVER</b>, or <b>INPUT_ENV</b>. </p>` - `string $variable_name <p> Name of a variable to get. </p>` - `int $filter [optional] <p> The ID of the filter to apply. The manual page lists the available filters. </p>` - `int|int[]|null $options [optional] <p> Associative array of options or bitwise disjunction of flags. If filter accepts options, flags can be provided in "flags" field of array. </p>`

Return: - `mixed <p> Value of the requested variable on success, <b>FALSE</b> if the filter fails, or <b>NULL</b> if the <i>variable_name</i> variable is not set. If the flag <b>FILTER_NULL_ON_FAILURE</b> is used, it returns <b>FALSE</b> if the variable is not set and <b>NULL</b> if the filter fails. </p>`

filter_input_array(int $type, array|null $definition, bool $add_empty): mixed

<a href="#voku-php-readme-class-methods">?</a> "filter_input_array()"-wrapper with normalizes to UTF-8 NFC, converting from WINDOWS-1252 when needed.

Gets external variables and optionally filters them.

EXAMPLE: <code> // _GET['foo'] = 'bar'; UTF8::filter_input_array(INPUT_GET, array('foo' => 'FILTER_UNSAFE_RAW')); // array('bar') </code>

Parameters: - `int $type <p> One of <b>INPUT_GET</b>, <b>INPUT_POST</b>, <b>INPUT_COOKIE</b>, <b>INPUT_SERVER</b>, or <b>INPUT_ENV</b>. </p>` - `array|null $definition [optional] <p> An array defining the arguments. A valid key is a string containing a variable name and a valid value is either a filter type, or an array optionally specifying the filter, flags and options. If the value is an array, valid keys are filter which specifies the filter type, flags which specifies any flags that apply to the filter, and options which specifies any options that apply to the filter. See the example below for a better understanding. </p> <p> This parameter can be also an integer holding a filter constant. Then all values in the input array are filtered by this filter. </p>` - `bool $add_empty [optional] <p> Add missing keys as <b>NULL</b> to the return value. </p>`

Return: - `mixed <p> An array containing the values of the requested variables on success, or <b>FALSE</b> on failure. An array value will be <b>FALSE</b> if the filter fails, or <b>NULL</b> if the variable is not set. Or if the flag <b>FILTER_NULL_ON_FAILURE</b> is used, it returns <b>FALSE</b> if the variable is not set and <b>NULL</b> if the filter fails. </p>`

filter_var(float|int|string|null $variable, int $filter, int|int[]|null $options): mixed

<a href="#voku-php-readme-class-methods">?</a> "filter_var()"-wrapper with normalizes to UTF-8 NFC, converting from WINDOWS-1252 when needed.

Filters a variable with a specified filter.

EXAMPLE: <code>UTF8::filter_var('-ABC-????-', FILTER_VALIDATE_URL); // false</code>

Parameters: - `float|int|string|null $variable <p> Value to filter. </p>` - `int $filter [optional] <p> The ID of the filter to apply. The manual page lists the available filters. </p>` - `int|int[]|null $options [optional] <p> Associative array of options or bitwise disjunction of flags. If filter accepts options, flags can be provided in "flags" field of array. For the "callback" filter, callable type should be passed. The callback must accept one argument, the value to be filtered, and return the value after filtering/sanitizing it. </p> <p> <code> // for filters that accept options, use this format $options = array( 'options' => array( 'default' => 3, // value to return if the filter fails // other options here 'min_range' => 0 ), 'flags' => FILTER_FLAG_ALLOW_OCTAL, ); $var = filter_var('0755', FILTER_VALIDATE_INT, $options); // for filter that only accept flags, you can pass them directly $var = filter_var('oops', FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE); // for filter that only accept flags, you can also pass as an array $var = filter_var('oops', FILTER_VALIDATE_BOOLEAN, array('flags' => FILTER_NULL_ON_FAILURE)); // callback validate filter function foo($value) { // Expected format: Surname, GivenNames if (strpos($value, ", ") === false) return false; list($surname, $givennames) = explode(", ", $value, 2); $empty = (empty($surname) || empty($givennames)); $notstrings = (!is_string($surname) || !is_string($givennames)); if ($empty || $notstrings) { return false; } else { return $value; } } $var = filter_var('Doe, Jane Sue', FILTER_CALLBACK, array('options' => 'foo')); </code> </p>`

Return: - mixed <p>The filtered data, or <b>FALSE</b> if the filter fails.</p>

filter_var_array(array $data, array|int|null $definition, bool $add_empty): mixed

<a href="#voku-php-readme-class-methods">?</a> "filter_var_array()"-wrapper with normalizes to UTF-8 NFC, converting from WINDOWS-1252 when needed.

Gets multiple variables and optionally filters them.

EXAMPLE: <code> $filters = [

'name'  => ['filter'  => FILTER_CALLBACK, 'options' => [UTF8::class, 'ucwords']],
'age'   => ['filter'  => FILTER_VALIDATE_INT, 'options' => ['min_range' => 1, 'max_range' => 120]],
'email' => FILTER_VALIDATE_EMAIL,

];

$data = [

'name' => '?????',
'age' => '18',
'email' => 'foo@bar.de'

];

UTF8::filter_var_array($data, $filters, true); // ['name' => '?????', 'age' => 18, 'email' => 'foo@bar.de'] </code>

Parameters: - `array $data <p> An array with string keys containing the data to filter. </p>` - `array|int|null $definition [optional] <p> An array defining the arguments. A valid key is a string containing a variable name and a valid value is either a filter type, or an array optionally specifying the filter, flags and options. If the value is an array, valid keys are filter which specifies the filter type, flags which specifies any flags that apply to the filter, and options which specifies any options that apply to the filter. See the example below for a better understanding. </p> <p> This parameter can be also an integer holding a filter constant. Then all values in the input array are filtered by this filter. </p>` - `bool $add_empty [optional] <p> Add missing keys as <b>NULL</b> to the return value. </p>`

Return: - `mixed <p> An array containing the values of the requested variables on success, or <b>FALSE</b> on failure. An array value will be <b>FALSE</b> if the filter fails, or <b>NULL</b> if the variable is not set. </p>`

finfo_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether finfo is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

first_char(string $str, int $n, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the first $n characters of the string.

Parameters: - string $str <p>The input string.</p> - int $n <p>Number of characters to retrieve from the start.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

fits_inside(string $str, int $box_size): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the number of Unicode characters isn't greater than the specified integer.

EXAMPLE: <code>UTF8::fits_inside('?????', 6); // false</code>

Parameters: - string $str the original string to be checked - int $box_size the size in number of chars to be checked against string

Return: - bool <p><strong>TRUE</strong> if string is less than or equal to $box_size, <strong>FALSE</strong> otherwise.</p>

fix_simple_utf8(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Try to fix simple broken UTF-8 strings.

INFO: Take a look at "UTF8::fix_utf8()" if you need a more advanced fix for broken UTF-8 strings.

EXAMPLE: <code>UTF8::fix_simple_utf8('Düsseldorf'); // 'Düsseldorf'</code>

If you received an UTF-8 string that was converted from Windows-1252 as it was ISO-8859-1 (ignoring Windows-1252 chars from 80 to 9F) use this function to fix it. See: http://en.wikipedia.org/wiki/Windows-1252

Parameters: - string $str <p>The input string</p>

Return: - string

fix_utf8(string|string[] $str): string|string[]

<a href="#voku-php-readme-class-methods">?</a> Fix a double (or multiple) encoded UTF8 string.

EXAMPLE: <code>UTF8::fix_utf8('Fédération'); // 'Fédération'</code>

Parameters: - TFixUtf8 $str you can use a string or an array of strings

Return: - `string|string[] <p>Will return the fixed input-"array" or the fixed input-"string".</p>`

getCharDirection(string $char): string

<a href="#voku-php-readme-class-methods">?</a> Get character of a specific character.

EXAMPLE: <code>UTF8::getCharDirection('?'); // 'RTL'</code>

Parameters: - string $char

Return: - string <p>'RTL' or 'LTR'.</p>

getSupportInfo(string|null $key): mixed

<a href="#voku-php-readme-class-methods">?</a> Check for php-support.

Parameters: - string|null $key

Return: - `mixed Return the full support-"array", if $key === null<br> return bool-value, if $key is used and available<br> otherwise return <strong>null</strong>`

get_file_type(string $str, array $fallback): null[]|string[]

<a href="#voku-php-readme-class-methods">?</a> Warning: this method only works for some file-types (png, jpg)

     if you need more supported types, please use e.g. "finfo"

Parameters: - string $str - array{ext: (null|string), mime: (null|string), type: (null|string)} $fallback <p>with this keys: 'ext', 'mime', 'type'

Return: - null[]|string[] <p>with this keys: 'ext', 'mime', 'type'</p>

get_random_string(int $length, string $possible_chars, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - int $length <p>Length of the random string.</p> - string $possible_chars [optional] <p>Characters string for the random selection.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

get_unique_string(int|string $extra_entropy, bool $use_md5): string

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - int|string $extra_entropy [optional] <p>Extra entropy via a string or int value.</p> - bool $use_md5 [optional] <p>Return the unique identifier as md5-hash? Default: true</p>

Return: - string

has_lowercase(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains a lower case char, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not the string contains a lower case character.</p>

has_uppercase(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains an upper case char, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not the string contains an upper case character.</p>

has_whitespace(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains whitespace, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not the string contains whitespace.</p>

hex_to_chr(string $hexdec): false|string

<a href="#voku-php-readme-class-methods">?</a> Converts a hexadecimal value into a UTF-8 character.

INFO: opposite to UTF8::chr_to_hex()

EXAMPLE: <code>UTF8::hex_to_chr('U+00a7'); // '§'</code>

Parameters: - string $hexdec <p>The hexadecimal value.</p>

Return: - false|string one single UTF-8 character

hex_to_int(string $hexdec): false|int

<a href="#voku-php-readme-class-methods">?</a> Converts hexadecimal U+xxxx code point representation to integer.

INFO: opposite to UTF8::int_to_hex()

EXAMPLE: <code>UTF8::hex_to_int('U+00f1'); // 241</code>

Parameters: - string $hexdec <p>The hexadecimal code point representation.</p>

Return: - false|int <p>The code point, or false on failure.</p>

html_encode(string $str, bool $keep_ascii_chars, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Converts a UTF-8 string to a series of HTML numbered entities.

INFO: opposite to UTF8::html_decode()

EXAMPLE: <code>UTF8::html_encode('????'); // '&#20013;&#25991;&#31354;&#30333;'</code>

Parameters: - string $str <p>The Unicode string to be encoded as numbered entities.</p> - bool $keep_ascii_chars [optional] <p>Keep ASCII chars.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string HTML numbered entities

html_entity_decode(string $str, int|null $flags, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> UTF-8 version of html_entity_decode()

The reason we are not using html_entity_decode() by itself is because while it is not technically correct to leave out the semicolon at the end of an entity most browsers will still interpret the entity correctly. html_entity_decode() does not convert entities without semicolons, so we are left with our own little solution here. Bummer.

Convert all HTML entities to their applicable characters.

INFO: opposite to UTF8::html_encode()

EXAMPLE: <code>UTF8::html_entity_decode('&#20013;&#25991;&#31354;&#30333;'); // '????'</code>

Parameters: - `string $str <p> The input string. </p>` - `int|null $flags [optional] <p> A bitmask of one or more of the following flags, which specify how to handle quotes and which document type to use. The default is ENT_COMPAT | ENT_HTML401. <table> Available <i>flags</i> constants <tr valign="top"> <td>Constant Name</td> <td>Description</td> </tr> <tr valign="top"> <td><b>ENT_COMPAT</b></td> <td>Will convert double-quotes and leave single-quotes alone.</td> </tr> <tr valign="top"> <td><b>ENT_QUOTES</b></td> <td>Will convert both double and single quotes.</td> </tr> <tr valign="top"> <td><b>ENT_NOQUOTES</b></td> <td>Will leave both double and single quotes unconverted.</td> </tr> <tr valign="top"> <td><b>ENT_HTML401</b></td> <td> Handle code as HTML 4.01. </td> </tr> <tr valign="top"> <td><b>ENT_XML1</b></td> <td> Handle code as XML 1. </td> </tr> <tr valign="top"> <td><b>ENT_XHTML</b></td> <td> Handle code as XHTML. </td> </tr> <tr valign="top"> <td><b>ENT_HTML5</b></td> <td> Handle code as HTML 5. </td> </tr> </table> </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string the decoded string

html_escape(string $str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Create a escape html version of the string via "UTF8::htmlspecialchars()".

Parameters: - string $str - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

html_stripe_empty_tags(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Remove empty html-tag.

e.g.: <pre><tag></tag></pre>

Parameters: - string $str

Return: - string

htmlentities(string $str, int $flags, string $encoding, bool $double_encode): string

<a href="#voku-php-readme-class-methods">?</a> Convert all applicable characters to HTML entities: UTF-8 version of htmlentities().

EXAMPLE: <code>UTF8::htmlentities('<?-öäü>'); // '&lt;&#30333;-&ouml;&auml;&uuml;&gt;'</code>

Parameters: - `string $str <p> The input string. </p>` - `int $flags [optional] <p> A bitmask of one or more of the following flags, which specify how to handle quotes, invalid code unit sequences and the used document type. The default is ENT_COMPAT | ENT_HTML401. <table> Available <i>flags</i> constants <tr valign="top"> <td>Constant Name</td> <td>Description</td> </tr> <tr valign="top"> <td><b>ENT_COMPAT</b></td> <td>Will convert double-quotes and leave single-quotes alone.</td> </tr> <tr valign="top"> <td><b>ENT_QUOTES</b></td> <td>Will convert both double and single quotes.</td> </tr> <tr valign="top"> <td><b>ENT_NOQUOTES</b></td> <td>Will leave both double and single quotes unconverted.</td> </tr> <tr valign="top"> <td><b>ENT_IGNORE</b></td> <td> Silently discard invalid code unit sequences instead of returning an empty string. Using this flag is discouraged as it may have security implications. </td> </tr> <tr valign="top"> <td><b>ENT_SUBSTITUTE</b></td> <td> Replace invalid code unit sequences with a Unicode Replacement Character U+FFFD (UTF-8) or &#38;#38;#FFFD; (otherwise) instead of returning an empty string. </td> </tr> <tr valign="top"> <td><b>ENT_DISALLOWED</b></td> <td> Replace invalid code points for the given document type with a Unicode Replacement Character U+FFFD (UTF-8) or &#38;#38;#FFFD; (otherwise) instead of leaving them as is. This may be useful, for instance, to ensure the well-formedness of XML documents with embedded external content. </td> </tr> <tr valign="top"> <td><b>ENT_HTML401</b></td> <td> Handle code as HTML 4.01. </td> </tr> <tr valign="top"> <td><b>ENT_XML1</b></td> <td> Handle code as XML 1. </td> </tr> <tr valign="top"> <td><b>ENT_XHTML</b></td> <td> Handle code as XHTML. </td> </tr> <tr valign="top"> <td><b>ENT_HTML5</b></td> <td> Handle code as HTML 5. </td> </tr> </table> </p>` - `string $encoding [optional] <p> Like <b>htmlspecialchars</b>, <b>htmlentities</b> takes an optional third argument <i>encoding</i> which defines encoding used in conversion. Although this argument is technically optional, you are highly encouraged to specify the correct value for your code. </p>` - `bool $double_encode [optional] <p> When <i>double_encode</i> is turned off PHP will not encode existing html entities. The default is to convert everything. </p>`

Return: - `string <p> The encoded string. <br><br> If the input <i>string</i> contains an invalid code unit sequence within the given <i>encoding</i> an empty string will be returned, unless either the <b>ENT_IGNORE</b> or <b>ENT_SUBSTITUTE</b> flags are set. </p>`

htmlspecialchars(string $str, int $flags, string $encoding, bool $double_encode): string

<a href="#voku-php-readme-class-methods">?</a> Convert only special characters to HTML entities: UTF-8 version of htmlspecialchars()

INFO: Take a look at "UTF8::htmlentities()"

EXAMPLE: <code>UTF8::htmlspecialchars('<?-öäü>'); // '&lt;?-öäü&gt;'</code>

Parameters: - `string $str <p> The string being converted. </p>` - `int $flags [optional] <p> A bitmask of one or more of the following flags, which specify how to handle quotes, invalid code unit sequences and the used document type. The default is ENT_COMPAT | ENT_HTML401. <table> Available <i>flags</i> constants <tr valign="top"> <td>Constant Name</td> <td>Description</td> </tr> <tr valign="top"> <td><b>ENT_COMPAT</b></td> <td>Will convert double-quotes and leave single-quotes alone.</td> </tr> <tr valign="top"> <td><b>ENT_QUOTES</b></td> <td>Will convert both double and single quotes.</td> </tr> <tr valign="top"> <td><b>ENT_NOQUOTES</b></td> <td>Will leave both double and single quotes unconverted.</td> </tr> <tr valign="top"> <td><b>ENT_IGNORE</b></td> <td> Silently discard invalid code unit sequences instead of returning an empty string. Using this flag is discouraged as it may have security implications. </td> </tr> <tr valign="top"> <td><b>ENT_SUBSTITUTE</b></td> <td> Replace invalid code unit sequences with a Unicode Replacement Character U+FFFD (UTF-8) or &#38;#38;#FFFD; (otherwise) instead of returning an empty string. </td> </tr> <tr valign="top"> <td><b>ENT_DISALLOWED</b></td> <td> Replace invalid code points for the given document type with a Unicode Replacement Character U+FFFD (UTF-8) or &#38;#38;#FFFD; (otherwise) instead of leaving them as is. This may be useful, for instance, to ensure the well-formedness of XML documents with embedded external content. </td> </tr> <tr valign="top"> <td><b>ENT_HTML401</b></td> <td> Handle code as HTML 4.01. </td> </tr> <tr valign="top"> <td><b>ENT_XML1</b></td> <td> Handle code as XML 1. </td> </tr> <tr valign="top"> <td><b>ENT_XHTML</b></td> <td> Handle code as XHTML. </td> </tr> <tr valign="top"> <td><b>ENT_HTML5</b></td> <td> Handle code as HTML 5. </td> </tr> </table> </p>` - `string $encoding [optional] <p> Defines encoding used in conversion. </p> <p> For the purposes of this function, the encodings ISO-8859-1, ISO-8859-15, UTF-8, cp866, cp1251, cp1252, and KOI8-R are effectively equivalent, provided the <i>string</i> itself is valid for the encoding, as the characters affected by <b>htmlspecialchars</b> occupy the same positions in all of these encodings. </p>` - `bool $double_encode [optional] <p> When <i>double_encode</i> is turned off PHP will not encode existing html entities, the default is to convert everything. </p>`

Return: - `string the converted string. </p> <p> If the input <i>string</i> contains an invalid code unit sequence within the given <i>encoding</i> an empty string will be returned, unless either the <b>ENT_IGNORE</b> or <b>ENT_SUBSTITUTE</b> flags are set`

iconv_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether iconv is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

int_to_hex(int $int, string $prefix): string

<a href="#voku-php-readme-class-methods">?</a> Converts Integer to hexadecimal U+xxxx code point representation.

INFO: opposite to UTF8::hex_to_int()

EXAMPLE: <code>UTF8::int_to_hex(241); // 'U+00f1'</code>

Parameters: - int $int <p>The integer to be converted to hexadecimal code point.</p> - string $prefix [optional]

Return: - string the code point, or empty string on failure

intlChar_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether intl-char is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

intl_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether intl is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

is_alpha(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only alphabetic chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only alphabetic chars.</p>

is_alphanumeric(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only alphabetic and numeric chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only alphanumeric chars.</p>

is_ascii(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Checks if a string is 7 bit ASCII.

EXAMPLE: <code>UTF8::is_ascii('?'); // false</code>

Parameters: - string $str <p>The string to check.</p>

Return: - `bool <p> <strong>true</strong> if it is ASCII<br> <strong>false</strong> otherwise </p>`

is_base64(string|null $str, bool $empty_string_is_valid): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string is base64 encoded, false otherwise.

EXAMPLE: <code>UTF8::is_base64('4KSu4KWL4KSo4KS/4KSa'); // true</code>

Parameters: - string|null $str <p>The input string.</p> - bool $empty_string_is_valid [optional] <p>Is an empty string valid base64 or not?</p>

Return: - bool <p>Whether or not $str is base64 encoded.</p>

is_binary(int|string $input, bool $strict): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the input is binary... (is look like a hack).

EXAMPLE: <code>UTF8::is_binary(01); // true</code>

Parameters: - int|string $input - bool $strict

Return: - bool

is_binary_file(string $file): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the file is binary.

EXAMPLE: <code>UTF8::is_binary('./utf32.txt'); // true</code>

Parameters: - string $file

Return: - bool

is_blank(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only whitespace chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only whitespace characters.</p>

is_bom(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Checks if the given string is equal to any "Byte Order Mark".

WARNING: Use "UTF8::string_has_bom()" if you will check BOM in a string.

EXAMPLE: <code>UTF8::is_bom("\xef\xbb\xbf"); // true</code>

Parameters: - string $str <p>The input string.</p>

Return: - bool <p><strong>true</strong> if the $utf8_chr is Byte Order Mark, <strong>false</strong> otherwise.</p>

is_empty(array|float|int|string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Determine whether the string is considered to be empty.

A variable is considered empty if it does not exist or if its value equals FALSE. empty() does not generate a warning if the variable does not exist.

Parameters: - array|float|int|string $str

Return: - bool <p>Whether or not $str is empty().</p>

is_hexadecimal(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only hexadecimal chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only hexadecimal chars.</p>

is_html(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the string contains any HTML tags.

EXAMPLE: <code>UTF8::is_html('<b>lall</b>'); // true</code>

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains html elements.</p>

is_json(string $str, bool $only_array_or_object_results_are_valid): bool

<a href="#voku-php-readme-class-methods">?</a> Try to check if "$str" is a JSON-string.

EXAMPLE: <code>UTF8::is_json('{"array":[1,"¥","ä"]}'); // true</code>

Parameters: - string $str <p>The input string.</p> - `bool $only_array_or_object_results_are_valid [optional] <p>Only array and objects are valid json results.</p>`

Return: - bool <p>Whether or not the $str is in JSON format.</p>

is_lowercase(string $str): bool

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only lowercase chars.</p>

is_printable(string $str, bool $ignore_control_characters): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only printable (non-invisible) chars, false otherwise.

Parameters: - string $str <p>The input string.</p> - bool $ignore_control_characters [optional] <p>Ignore control characters like [LRM] or [LSEP].</p>

Return: - bool <p>Whether or not $str contains only printable (non-invisible) chars.</p>

is_punctuation(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only punctuation chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only punctuation chars.</p>

is_serialized(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string is serialized, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str is serialized.</p>

is_uppercase(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains only lower case chars, false otherwise.

Parameters: - string $str <p>The input string.</p>

Return: - bool <p>Whether or not $str contains only lower case characters.</p>

is_url(string $url, bool $disallow_localhost): bool

<a href="#voku-php-readme-class-methods">?</a> Check if $url is an correct url.

Parameters: - string $url - bool $disallow_localhost

Return: - bool

is_utf8(int|string|string[]|null $str, bool $strict): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether the passed input contains only byte sequences that appear valid UTF-8.

EXAMPLE: <code> UTF8::is_utf8(['Iñtërnâtiônàlizætiøn', 'foo']); // true // UTF8::is_utf8(["Iñtërnâtiônàlizætiøn\xA0\xA1", 'bar']); // false </code>

Parameters: - int|string|string[]|null $str <p>The input to be checked.</p> - bool $strict <p>Check also if the string is not UTF-16 or UTF-32.</p>

Return: - bool

is_utf16(string $str, bool $check_if_string_is_binary): false|int

<a href="#voku-php-readme-class-methods">?</a> Check if the string is UTF-16.

EXAMPLE: <code> UTF8::is_utf16(file_get_contents('utf-16-le.txt')); // 1 // UTF8::is_utf16(file_get_contents('utf-16-be.txt')); // 2 // UTF8::is_utf16(file_get_contents('utf-8.txt')); // false </code>

Parameters: - string $str <p>The input string.</p> - bool $check_if_string_is_binary

Return: - `false|int <strong>false</strong> if is't not UTF-16,<br> <strong>1</strong> for UTF-16LE,<br> <strong>2</strong> for UTF-16BE`

is_utf32(string $str, bool $check_if_string_is_binary): false|int

<a href="#voku-php-readme-class-methods">?</a> Check if the string is UTF-32.

EXAMPLE: <code> UTF8::is_utf32(file_get_contents('utf-32-le.txt')); // 1 // UTF8::is_utf32(file_get_contents('utf-32-be.txt')); // 2 // UTF8::is_utf32(file_get_contents('utf-8.txt')); // false </code>

Parameters: - string $str <p>The input string.</p> - bool $check_if_string_is_binary

Return: - `false|int <strong>false</strong> if is't not UTF-32,<br> <strong>1</strong> for UTF-32LE,<br> <strong>2</strong> for UTF-32BE`

json_decode(string $json, bool $assoc, int $depth, int $options): mixed

<a href="#voku-php-readme-class-methods">?</a> (PHP 5 &gt;= 5.2.0, PECL json &gt;= 1.2.0)<br/> Decodes a JSON string

EXAMPLE: <code>UTF8::json_decode('[1,"\u00a5","\u00e4"]'); // array(1, '¥', 'ä')</code>

Parameters: - `string $json <p> The <i>json</i> string being decoded. </p> <p> This function only works with UTF-8 encoded strings. </p> <p>PHP implements a superset of JSON - it will also encode and decode scalar types and <b>NULL</b>. The JSON standard only supports these values when they are nested inside an array or an object. </p>` - `bool $assoc [optional] <p> When <b>TRUE</b>, returned objects will be converted into associative arrays. </p>` - `int $depth [optional] <p> User specified recursion depth. </p>` - `int $options [optional] <p> Bitmask of JSON decode options. Currently only <b>JSON_BIGINT_AS_STRING</b> is supported (default is to cast large integers as floats) </p>`

Return: - `mixed <p>The value encoded in <i>json</i> in appropriate PHP type. Values true, false and null (case-insensitive) are returned as <b>TRUE</b>, <b>FALSE</b> and <b>NULL</b> respectively. <b>NULL</b> is returned if the <i>json</i> cannot be decoded or if the encoded data is deeper than the recursion limit.</p>`

json_encode(mixed $value, int $options, int $depth): false|string

<a href="#voku-php-readme-class-methods">?</a> (PHP 5 &gt;= 5.2.0, PECL json &gt;= 1.2.0)<br/> Returns the JSON representation of a value.

EXAMPLE: <code>UTF8::json_enocde(array(1, '¥', 'ä')); // '[1,"\u00a5","\u00e4"]'</code>

Parameters: - `mixed $value <p> The <i>value</i> being encoded. Can be any type except a resource. </p> <p> All string data must be UTF-8 encoded. </p> <p>PHP implements a superset of JSON - it will also encode and decode scalar types and <b>NULL</b>. The JSON standard only supports these values when they are nested inside an array or an object. </p>` - `int $options [optional] <p> Bitmask consisting of <b>JSON_HEX_QUOT</b>, <b>JSON_HEX_TAG</b>, <b>JSON_HEX_AMP</b>, <b>JSON_HEX_APOS</b>, <b>JSON_NUMERIC_CHECK</b>, <b>JSON_PRETTY_PRINT</b>, <b>JSON_UNESCAPED_SLASHES</b>, <b>JSON_FORCE_OBJECT</b>, <b>JSON_UNESCAPED_UNICODE</b>. The behaviour of these constants is described on the JSON constants page. </p>` - `int $depth [optional] <p> Set the maximum depth. Must be greater than zero. </p>`

Return: - `false|string A JSON encoded <strong>string</strong> on success or<br> <strong>FALSE</strong> on failure`

json_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether JSON is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

lcfirst(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Makes string's first char lowercase.

EXAMPLE: <code>UTF8::lcfirst('ÑTËRNÂTIÔNÀLIZÆTIØN'); // ñTËRNÂTIÔNÀLIZÆTIØN</code>

Parameters: - string $str <p>The input string</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string the resulting string

lcwords(string $str, string[] $exceptions, string $char_list, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Lowercase for all words in the string.

Parameters: - string $str <p>The input string.</p> - string[] $exceptions [optional] <p>Exclusion for some words.</p> - `string $char_list [optional] <p>Additional chars that contains to words and do not start a new word.</p>` - string $encoding [optional] <p>Set the charset.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string

ltrim(string $str, string|null $chars): string

<a href="#voku-php-readme-class-methods">?</a> Strip whitespace or other characters from the beginning of a UTF-8 string.

EXAMPLE: <code>UTF8::ltrim('?????? '); // '????? '</code>

Parameters: - string $str <p>The string to be trimmed</p> - string|null $chars <p>Optional characters to be stripped</p>

Return: - string the string with unwanted characters stripped from the left

max(string[]|string $arg): string|null

<a href="#voku-php-readme-class-methods">?</a> Returns the UTF-8 character with the maximum code point in the given data.

EXAMPLE: <code>UTF8::max('abc-äöü-????'); // 'ø'</code>

Parameters: - string[]|string $arg <p>A UTF-8 encoded string or an array of such strings.</p>

Return: - string|null the character with the highest code point than others, returns null on failure or empty input

max_chr_width(string $str): int

<a href="#voku-php-readme-class-methods">?</a> Calculates and returns the maximum number of bytes taken by any UTF-8 encoded character in the given string.

EXAMPLE: <code>UTF8::max_chr_width('Intërnâtiônàlizætiøn'); // 2</code>

Parameters: - string $str <p>The original Unicode string.</p>

Return: - int <p>Max byte lengths of the given chars.</p>

mbstring_loaded(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether mbstring is available on the server.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if available, <strong>false</strong> otherwise</p>

min(string|string[] $arg): string|null

<a href="#voku-php-readme-class-methods">?</a> Returns the UTF-8 character with the minimum code point in the given data.

EXAMPLE: <code>UTF8::min('abc-äöü-????'); // '-'</code>

Parameters: - string|string[] $arg <strong>A UTF-8 encoded string or an array of such strings.</strong>

Return: - string|null <p>The character with the lowest code point than others, returns null on failure or empty input.</p>

normalize_encoding(mixed $encoding, mixed $fallback): mixed|string

<a href="#voku-php-readme-class-methods">?</a> Normalize the encoding-"name" input.

EXAMPLE: <code>UTF8::normalize_encoding('UTF8'); // 'UTF-8'</code>

Parameters: - mixed $encoding <p>e.g.: ISO, UTF8, WINDOWS-1251 etc.</p> - string|TNormalizeEncodingFallback $fallback <p>e.g.: UTF-8</p>

Return: - mixed|string <p>e.g.: ISO-8859-1, UTF-8, WINDOWS-1251 etc.<br>Will return a empty string as fallback (by default)</p>

normalize_line_ending(string $str, string|string[] $replacer): string

<a href="#voku-php-readme-class-methods">?</a> Standardize line ending to unix-like.

Parameters: - string $str <p>The input string.</p> - `string|string[] $replacer <p>The replacer char e.g. "\n" (Linux) or "\r\n" (Windows). You can also use \PHP_EOL here.</p>`

Return: - string <p>A string with normalized line ending.</p>

normalize_msword(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Normalize some MS Word special characters.

EXAMPLE: <code>UTF8::normalize_msword('?Abcdef??'); // '"Abcdef..."'</code>

Parameters: - string $str <p>The string to be normalized.</p>

Return: - string <p>A string with normalized characters for commonly used chars in Word documents.</p>

normalize_whitespace(string $str, bool $keep_non_breaking_space, bool $keep_bidi_unicode_controls, bool $normalize_control_characters): string

<a href="#voku-php-readme-class-methods">?</a> Normalize the whitespace.

EXAMPLE: <code>UTF8::normalize_whitespace("abc-\xc2\xa0-öäü-\xe2\x80\xaf-\xE2\x80\xAC", true); // "abc-\xc2\xa0-öäü- -"</code>

Parameters: - string $str <p>The string to be normalized.</p> - bool $keep_non_breaking_space [optional] <p>Set to true, to keep non-breaking-spaces.</p> - `bool $keep_bidi_unicode_controls [optional] <p>Set to true, to keep non-printable (for the web) bidirectional text chars.</p>` - bool $normalize_control_characters [optional] <p>Set to true, to convert e.g. LINE-, PARAGRAPH-SEPARATOR with "\n" and LINE TABULATION with "\t".</p>

Return: - string <p>A string with normalized whitespace.</p>

ord(string $chr, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Calculates Unicode code point of the given UTF-8 encoded character.

INFO: opposite to UTF8::chr()

EXAMPLE: <code>UTF8::ord('?'); // 0x2603</code>

Parameters: - string $chr <p>The character of which to calculate code point.<p/> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <p>Unicode code point of the given character,<br> 0 on invalid UTF-8 byte sequence</p>`

parse_str(string $str, array $result, bool $clean_utf8): bool

<a href="#voku-php-readme-class-methods">?</a> Parses the string into an array (into the the second parameter).

WARNING: Unlike "parse_str()", this method does not (re-)place variables in the current scope,

     if the second parameter is not set!

EXAMPLE: <code> UTF8::parse_str('Iñtërnâtiônéàlizætiøn=??&arr[]=foo+??&arr[]=?????????', $array); echo $array['Iñtërnâtiônéàlizætiøn']; // '??' </code>

Parameters: - string $str <p>The input string.</p> - array $result <p>The result will be returned into this reference parameter.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - bool <p>Will return <strong>false</strong> if php can't parse the string and we haven't any $result.</p>

pcre_utf8_support(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks if \u modifier is available that enables Unicode support in PCRE.

Parameters: __nothing__

Return: - `bool <p> <strong>true</strong> if support is available,<br> <strong>false</strong> otherwise </p>`

range(int|string $var1, int|string $var2, bool $use_ctype, string $encoding, float|int $step): string[]

<a href="#voku-php-readme-class-methods">?</a> Create an array containing a range of UTF-8 characters.

EXAMPLE: <code>UTF8::range('?', '?'); // array('?', '?', '?', '?', '?',)</code>

Parameters: - int|string $var1 <p>Numeric or hexadecimal code points, or a UTF-8 character to start from.</p> - int|string $var2 <p>Numeric or hexadecimal code points, or a UTF-8 character to end at.</p> - `bool $use_ctype <p>use ctype to detect numeric and hexadecimal, otherwise we will use a simple "is_numeric"</p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - `float|int $step [optional] <p> If a step value is given, it will be used as the increment between elements in the sequence. step should be given as a positive number. If not specified, step will default to 1. </p>`

Return: - string[]

rawurldecode(string $str, bool $multi_decode): string

<a href="#voku-php-readme-class-methods">?</a> Multi decode HTML entity + fix urlencoded-win1252-chars.

EXAMPLE: <code>UTF8::rawurldecode('tes%20öäü%20\u00edtest+test'); // 'tes öäü ítest+test'</code>

e.g: 'test+test' => 'test+test' 'D&#252;sseldorf' => 'Düsseldorf' 'D%FCsseldorf' => 'Düsseldorf' 'D&#xFC;sseldorf' => 'Düsseldorf' 'D%26%23xFC%3Bsseldorf' => 'Düsseldorf' 'Düsseldorf' => 'Düsseldorf' 'D%C3%BCsseldorf' => 'Düsseldorf' 'D%C3%83%C2%BCsseldorf' => 'Düsseldorf' 'D%25C3%2583%25C2%25BCsseldorf' => 'Düsseldorf'

Parameters: - string $str <p>The input string.</p> - bool $multi_decode <p>Decode as often as possible.</p>

Return: - string <p>The decoded URL, as a string.</p>

regex_replace(string $str, string $pattern, string $replacement, string $options, string $delimiter): string

<a href="#voku-php-readme-class-methods">?</a> Replaces all occurrences of $pattern in $str by $replacement.

Parameters: - string $str <p>The input string.</p> - string $pattern <p>The regular expression pattern.</p> - string $replacement <p>The string to replace with.</p> - string $options [optional] <p>Matching conditions to be used.</p> - string $delimiter [optional] <p>Delimiter the the regex. Default: '/'</p>

Return: - string

remove_bom(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Remove the BOM from UTF-8 / UTF-16 / UTF-32 strings.

EXAMPLE: <code>UTF8::remove_bom("\xEF\xBB\xBF????? ??"); // '????? ??'</code>

Parameters: - string $str <p>The input string.</p>

Return: - string <p>A string without UTF-BOM.</p>

remove_duplicates(string $str, string|string[] $what): string

<a href="#voku-php-readme-class-methods">?</a> Removes duplicate occurrences of a string in another string.

EXAMPLE: <code>UTF8::remove_duplicates('öäü-??????????-äöü', '?????'); // 'öäü-?????-äöü'</code>

Parameters: - string $str <p>The base string.</p> - string|string[] $what <p>String to search for in the base string.</p>

Return: - string <p>A string with removed duplicates.</p>

remove_html(string $str, string $allowable_tags): string

<a href="#voku-php-readme-class-methods">?</a> Remove html via "strip_tags()" from the string.

Parameters: - string $str <p>The input string.</p> - `string $allowable_tags [optional] <p>You can use the optional second parameter to specify tags which should not be stripped. Default: null </p>`

Return: - string <p>A string with without html tags.</p>

remove_html_breaks(string $str, string $replacement): string

<a href="#voku-php-readme-class-methods">?</a> Remove all breaks [<br> | \r\n | \r | \n | ...] from the string.

Parameters: - string $str <p>The input string.</p> - string $replacement [optional] <p>Default is a empty string.</p>

Return: - string <p>A string without breaks.</p>

remove_invisible_characters(string $str, bool $url_encoded, string $replacement, bool $keep_basic_control_characters): string

<a href="#voku-php-readme-class-methods">?</a> Remove invisible characters from a string.

e.g.: This prevents sandwiching null characters between ascii characters, like Java\0script.

EXAMPLE: <code>UTF8::remove_invisible_characters("???\0??"); // '?????'</code>

copy&past from https://github.com/bcit-ci/CodeIgniter/blob/develop/system/core/Common.php

Parameters: - string $str <p>The input string.</p> - `bool $url_encoded [optional] <p> Try to remove url encoded control character. WARNING: maybe contains false-positives e.g. aa%0Baa -> aaaa. <br> Default: false </p>` - string $replacement [optional] <p>The replacement character.</p> - bool $keep_basic_control_characters [optional] <p>Keep control characters like [LRM] or [LSEP].</p>

Return: - string <p>A string without invisible chars.</p>

remove_left(string $str, string $substring, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a new string with the prefix $substring removed, if present.

Parameters: - string $str <p>The input string.</p> - string $substring <p>The prefix to remove.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string <p>A string without the prefix $substring.</p>

remove_right(string $str, string $substring, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a new string with the suffix $substring removed, if present.

Parameters: - string $str - string $substring <p>The suffix to remove.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string <p>A string having a $str without the suffix $substring.</p>

replace(string $str, string $search, string $replacement, bool $case_sensitive): string

<a href="#voku-php-readme-class-methods">?</a> Replaces all occurrences of $search in $str by $replacement.

Parameters: - string $str <p>The input string.</p> - string $search <p>The needle to search for.</p> - string $replacement <p>The string to replace with.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p>

Return: - string <p>A string with replaced parts.</p>

replace_all(string $str, array $search, array|string $replacement, bool $case_sensitive): string

<a href="#voku-php-readme-class-methods">?</a> Replaces all occurrences of $search in $str by $replacement.

Parameters: - string $str <p>The input string.</p> - array $search <p>The elements to search for.</p> - array|string $replacement <p>The string to replace with.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p>

Return: - string <p>A string with replaced parts.</p>

replace_diamond_question_mark(string $str, string $replacement_char, bool $process_invalid_utf8_chars): string

<a href="#voku-php-readme-class-methods">?</a> Replace the diamond question mark (?) and invalid-UTF8 chars with the replacement.

EXAMPLE: <code>UTF8::replace_diamond_question_mark('?????', ''); // '????'</code>

Parameters: - string $str <p>The input string</p> - string $replacement_char <p>The replacement character.</p> - bool $process_invalid_utf8_chars <p>Convert invalid UTF-8 chars </p>

Return: - string <p>A string without diamond question marks (?).</p>

rtrim(string $str, string|null $chars): string

<a href="#voku-php-readme-class-methods">?</a> Strip whitespace or other characters from the end of a UTF-8 string.

EXAMPLE: <code>UTF8::rtrim('-ABC-????- '); // '-ABC-????-'</code>

Parameters: - string $str <p>The string to be trimmed.</p> - string|null $chars <p>Optional characters to be stripped.</p>

Return: - string <p>A string with unwanted characters stripped from the right.</p>

showSupport(bool $useEcho): string|void

<a href="#voku-php-readme-class-methods">?</a> WARNING: Print native UTF-8 support (libs) by default, e.g. for debugging.

Parameters: - bool $useEcho

Return: - string|void

single_chr_html_encode(string $char, bool $keep_ascii_chars, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Converts a UTF-8 character to HTML Numbered Entity like "&#123;".

EXAMPLE: <code>UTF8::single_chr_html_encode('?'); // '&#954;'</code>

Parameters: - string $char <p>The Unicode character to be encoded as numbered entity.</p> - bool $keep_ascii_chars <p>Set to <strong>true</strong> to keep ASCII chars.</> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The HTML numbered entity for the given character.</p>

spaces_to_tabs(string $str, int $tab_length): string

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - string $str - int $tab_length

Return: - string

str_camelize(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Returns a camelCase version of the string. Trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, as well as underscores.

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string

str_capitalize_name(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Returns the string with the first letter of each word capitalized, except for when the word is a name which shouldn't be capitalized.

Parameters: - string $str

Return: - string <p>A string with $str capitalized.</p>

str_contains(string $haystack, string $needle, bool $case_sensitive): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains $needle, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $case_sensitive to false.

Parameters: - string $haystack <p>The input string.</p> - string $needle <p>Substring to look for.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p>

Return: - bool <p>Whether or not $haystack contains $needle.</p>

str_contains_all(string $haystack, array $needles, bool $case_sensitive): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains all $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $case_sensitive to false.

Parameters: - string $haystack <p>The input string.</p> - array $needles <p>SubStrings to look for.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p>

Return: - bool <p>Whether or not $haystack contains $needle.</p>

str_contains_any(string $haystack, array $needles, bool $case_sensitive): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string contains any $needles, false otherwise. By default the comparison is case-sensitive, but can be made insensitive by setting $case_sensitive to false.

Parameters: - string $haystack <p>The input string.</p> - array $needles <p>SubStrings to look for.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p>

Return: - bool <p>Whether or not $str contains $needle.</p>

str_dasherize(string $str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a lowercase and trimmed string separated by dashes. Dashes are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as underscores.

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_delimit(string $str, string $delimiter, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Returns a lowercase and trimmed string separated by the given delimiter.

Delimiters are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces, dashes, and underscores. Alpha delimiters are not converted to lowercase.

Parameters: - string $str <p>The input string.</p> - string $delimiter <p>Sequence used to separate parts of the string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string

str_detect_encoding(string $str): false|string

<a href="#voku-php-readme-class-methods">?</a> Optimized "mb_detect_encoding()"-function -> with support for UTF-16 and UTF-32.

EXAMPLE: <code> UTF8::str_detect_encoding('????'); // 'UTF-8' UTF8::str_detect_encoding('Abc'); // 'ASCII' </code>

Parameters: - string $str <p>The input string.</p>

Return: - `false|string <p> The detected string-encoding e.g. UTF-8 or UTF-16BE,<br> otherwise it will return false e.g. for BINARY or not detected encoding. </p>`

str_ends_with(string $haystack, string $needle): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the string ends with the given substring.

EXAMPLE: <code> UTF8::str_ends_with('BeginMiddle?????', '?????'); // true UTF8::str_ends_with('BeginMiddle?????', '?????'); // false </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - bool

str_ends_with_any(string $str, string[] $substrings): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string ends with any of $substrings, false otherwise.

  • case-sensitive

Parameters: - string $str <p>The input string.</p> - string[] $substrings <p>Substrings to look for.</p>

Return: - bool <p>Whether or not $str ends with $substring.</p>

str_ensure_left(string $str, string $substring): string

<a href="#voku-php-readme-class-methods">?</a> Ensures that the string begins with $substring. If it doesn't, it's prepended.

Parameters: - string $str <p>The input string.</p> - string $substring <p>The substring to add if not present.</p>

Return: - string

str_ensure_right(string $str, string $substring): string

<a href="#voku-php-readme-class-methods">?</a> Ensures that the string ends with $substring. If it doesn't, it's appended.

Parameters: - string $str <p>The input string.</p> - string $substring <p>The substring to add if not present.</p>

Return: - string

str_humanize(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Capitalizes the first word of the string, replaces underscores with spaces, and strips '_id'.

Parameters: - string $str

Return: - string

str_iends_with(string $haystack, string $needle): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the string ends with the given substring, case-insensitive.

EXAMPLE: <code> UTF8::str_iends_with('BeginMiddle?????', '?????'); // true UTF8::str_iends_with('BeginMiddle?????', '?????'); // true </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - bool

str_iends_with_any(string $str, string[] $substrings): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string ends with any of $substrings, false otherwise.

  • case-insensitive

Parameters: - string $str <p>The input string.</p> - string[] $substrings <p>Substrings to look for.</p>

Return: - bool <p>Whether or not $str ends with $substring.</p>

str_insert(string $str, string $substring, int $index, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Inserts $substring into the string at the $index provided.

Parameters: - string $str <p>The input string.</p> - string $substring <p>String to be inserted.</p> - int $index <p>The index at which to insert the substring.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_ireplace(string|string[] $search, string|string[] $replacement, string|string[] $subject, int $count): string|string[]

<a href="#voku-php-readme-class-methods">?</a> Case-insensitive and UTF-8 safe version of <function>str_replace</function>.

EXAMPLE: <code> UTF8::str_ireplace('lIzÆ', 'lise', 'Iñtërnâtiônàlizætiøn'); // 'Iñtërnâtiônàlisetiøn' </code>

Parameters: - `string|string[] $search <p> Every replacement with search array is performed on the result of previous replacement. </p>` - string|string[] $replacement <p>The replacement.</p> - `TStrIReplaceSubject $subject <p> If subject is an array, then the search and replace is performed with every entry of subject, and the return value is an array as well. </p>` - `int $count [optional] <p> The number of matched and replaced needles will be returned in count which is passed by reference. </p>`

Return: - string|string[] <p>A string or an array of replacements.</p>

str_ireplace_beginning(string $str, string $search, string $replacement): string

<a href="#voku-php-readme-class-methods">?</a> Replaces $search from the beginning of string with $replacement.

Parameters: - string $str <p>The input string.</p> - string $search <p>The string to search for.</p> - string $replacement <p>The replacement.</p>

Return: - string <p>The string after the replacement.</p>

str_ireplace_ending(string $str, string $search, string $replacement): string

<a href="#voku-php-readme-class-methods">?</a> Replaces $search from the ending of string with $replacement.

Parameters: - string $str <p>The input string.</p> - string $search <p>The string to search for.</p> - string $replacement <p>The replacement.</p>

Return: - string <p>The string after the replacement.</p>

str_istarts_with(string $haystack, string $needle): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the string starts with the given substring, case-insensitive.

EXAMPLE: <code> UTF8::str_istarts_with('?????MiddleEnd', '?????'); // true UTF8::str_istarts_with('?????MiddleEnd', '?????'); // true </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - bool

str_istarts_with_any(string $str, array $substrings): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string begins with any of $substrings, false otherwise.

  • case-insensitive

Parameters: - string $str <p>The input string.</p> - array $substrings <p>Substrings to look for.</p>

Return: - bool <p>Whether or not $str starts with $substring.</p>

str_isubstr_after_first_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after the first occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_isubstr_after_last_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after the last occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_isubstr_before_first_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring before the first occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_isubstr_before_last_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring before the last occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_isubstr_first(string $str, string $needle, bool $before_needle, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after (or before via "$before_needle") the first occurrence of the "$needle".

Parameters: - string $str <p>The input string.</p> - string $needle <p>The string to look for.</p> - bool $before_needle [optional] <p>Default: false</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_isubstr_last(string $str, string $needle, bool $before_needle, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after (or before via "$before_needle") the last occurrence of the "$needle".

Parameters: - string $str <p>The input string.</p> - string $needle <p>The string to look for.</p> - bool $before_needle [optional] <p>Default: false</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_last_char(string $str, int $n, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the last $n characters of the string.

Parameters: - string $str <p>The input string.</p> - int $n <p>Number of characters to retrieve from the end.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_limit(string $str, int $length, string $str_add_on, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Limit the number of characters in a string.

Parameters: - string $str <p>The input string.</p> - int $length [optional] <p>Default: 100</p> - string $str_add_on [optional] <p>Default: ?</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_limit_after_word(string $str, int $length, string $str_add_on, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Limit the number of characters in a string, but also after the next word.

EXAMPLE: <code>UTF8::str_limit_after_word('fòô bà? fòô', 8, ''); // 'fòô bà?'</code>

Parameters: - string $str <p>The input string.</p> - int $length [optional] <p>Default: 100</p> - string $str_add_on [optional] <p>Default: ?</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_longest_common_prefix(string $str1, string $str2, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the longest common prefix between the $str1 and $str2.

Parameters: - string $str1 <p>The input sting.</p> - string $str2 <p>Second string for comparison.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_longest_common_substring(string $str1, string $str2, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the longest common substring between the $str1 and $str2.

In the case of ties, it returns that which occurs first.

Parameters: - string $str1 - string $str2 <p>Second string for comparison.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>A string with its $str being the longest common substring.</p>

str_longest_common_suffix(string $str1, string $str2, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the longest common suffix between the $str1 and $str2.

Parameters: - string $str1 - string $str2 <p>Second string for comparison.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string

str_matches_pattern(string $str, string $pattern): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if $str matches the supplied pattern, false otherwise.

Parameters: - string $str <p>The input string.</p> - string $pattern <p>Regex pattern to match against.</p>

Return: - bool <p>Whether or not $str matches the pattern.</p>

str_obfuscate(string $str, float $percent, string $obfuscateChar, string[] $keepChars): string

<a href="#voku-php-readme-class-methods">?</a> Convert a string into a obfuscate string.

EXAMPLE: <code>

UTF8::str_obfuscate('lars@moelleken.org', 0.5, '', ['@', '.']); // e.g. "l@mlleke.r*" </code>

Parameters: - string $str - float $percent - string $obfuscateChar - string[] $keepChars

Return: - string <p>The obfuscate string.</p>

str_offset_exists(string $str, int $offset, string $encoding): bool

<a href="#voku-php-readme-class-methods">?</a> Returns whether or not a character exists at an index. Offsets may be negative to count from the last character in the string. Implements part of the ArrayAccess interface.

Parameters: - string $str <p>The input string.</p> - int $offset <p>The index to check.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - bool <p>Whether or not the index exists.</p>

str_offset_get(string $str, int $index, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns the character at the given index. Offsets may be negative to count from the last character in the string. Implements part of the ArrayAccess interface, and throws an OutOfBoundsException if the index does not exist.

Parameters: - string $str <p>The input string.</p> - int $index <p>The <strong>index</strong> from which to retrieve the char.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The character at the specified index.</p>

str_pad(string $str, int $pad_length, string $pad_string, int|string $pad_type, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Pad a UTF-8 string to a given length with another string.

EXAMPLE: <code>UTF8::str_pad('????', 10, '_', STR_PAD_BOTH); // '___????___'</code>

Parameters: - string $str <p>The input string.</p> - int $pad_length <p>The length of return string.</p> - string $pad_string [optional] <p>String to use for padding the input string.</p> - `int|string $pad_type [optional] <p> Can be <strong>STR_PAD_RIGHT</strong> (default), [or string "right"]<br> <strong>STR_PAD_LEFT</strong> [or string "left"] or<br> <strong>STR_PAD_BOTH</strong> [or string "both"] </p>` - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string <p>Returns the padded string.</p>

str_pad_both(string $str, int $length, string $pad_str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a new string of a given length such that both sides of the string are padded. Alias for "UTF8::str_pad()" with a $pad_type of 'both'.

Parameters: - string $str - int $length <p>Desired string length after padding.</p> - string $pad_str [optional] <p>String used to pad, defaults to space. Default: ' '</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The string with padding applied.</p>

str_pad_left(string $str, int $length, string $pad_str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a new string of a given length such that the beginning of the string is padded. Alias for "UTF8::str_pad()" with a $pad_type of 'left'.

Parameters: - string $str - int $length <p>Desired string length after padding.</p> - string $pad_str [optional] <p>String used to pad, defaults to space. Default: ' '</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The string with left padding.</p>

str_pad_right(string $str, int $length, string $pad_str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a new string of a given length such that the end of the string is padded. Alias for "UTF8::str_pad()" with a $pad_type of 'right'.

Parameters: - string $str - int $length <p>Desired string length after padding.</p> - string $pad_str [optional] <p>String used to pad, defaults to space. Default: ' '</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The string with right padding.</p>

str_repeat(string $str, int $multiplier): string

<a href="#voku-php-readme-class-methods">?</a> Repeat a string.

EXAMPLE: <code>UTF8::str_repeat("°~\xf0\x90\x28\xbc", 2); // '°~ð(¼°~ð(¼'</code>

Parameters: - `string $str <p> The string to be repeated. </p>` - `int $multiplier <p> Number of time the input string should be repeated. </p> <p> multiplier has to be greater than or equal to 0. If the multiplier is set to 0, the function will return an empty string. </p>`

Return: - string <p>The repeated string.</p>

str_replace_beginning(string $str, string $search, string $replacement): string

<a href="#voku-php-readme-class-methods">?</a> Replaces $search from the beginning of string with $replacement.

Parameters: - string $str <p>The input string.</p> - string $search <p>The string to search for.</p> - string $replacement <p>The replacement.</p>

Return: - string <p>A string after the replacements.</p>

str_replace_ending(string $str, string $search, string $replacement): string

<a href="#voku-php-readme-class-methods">?</a> Replaces $search from the ending of string with $replacement.

Parameters: - string $str <p>The input string.</p> - string $search <p>The string to search for.</p> - string $replacement <p>The replacement.</p>

Return: - string <p>A string after the replacements.</p>

str_replace_first(string $search, string $replace, string $subject): string

<a href="#voku-php-readme-class-methods">?</a> Replace the first "$search"-term with the "$replace"-term.

Parameters: - string $search - string $replace - string $subject

Return: - string

str_replace_last(string $search, string $replace, string $subject): string

<a href="#voku-php-readme-class-methods">?</a> Replace the last "$search"-term with the "$replace"-term.

Parameters: - string $search - string $replace - string $subject

Return: - string

str_shuffle(string $str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Shuffles all the characters in the string.

INFO: uses random algorithm which is weak for cryptography purposes

EXAMPLE: <code>UTF8::str_shuffle('fòô bà? fòô'); // 'àòô?b ffòô '</code>

Parameters: - string $str <p>The input string</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The shuffled string.</p>

str_slice(string $str, int $start, int|null $end, string $encoding): false|string

<a href="#voku-php-readme-class-methods">?</a> Returns the substring beginning at $start, and up to, but not including the index specified by $end. If $end is omitted, the function extracts the remaining string. If $end is negative, it is computed from the end of the string.

Parameters: - string $str - int $start <p>Initial index from which to begin extraction.</p> - int|null $end [optional] <p>Index at which to end extraction. Default: null</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `false|string <p>The extracted substring.</p><p>If <i>str</i> is shorter than <i>start</i> characters long, <b>FALSE</b> will be returned.`

str_snakeize(string $str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Convert a string to e.g.: "snake_case"

Parameters: - string $str - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>A string in snake_case.</p>

str_sort(string $str, bool $unique, bool $desc): string

<a href="#voku-php-readme-class-methods">?</a> Sort all characters according to code points.

EXAMPLE: <code>UTF8::str_sort(' -ABC-????- '); // ' ---ABC????'</code>

Parameters: - string $str <p>A UTF-8 string.</p> - bool $unique <p>Sort unique. If <strong>true</strong>, repeated characters are ignored.</p> - bool $desc <p>If <strong>true</strong>, will sort characters in reverse code point order.</p>

Return: - string <p>A string of sorted characters.</p>

str_split(int|string $input, int $length, bool $clean_utf8, bool $try_to_use_mb_functions): string[]

<a href="#voku-php-readme-class-methods">?</a> Convert a string to an array of unicode characters.

EXAMPLE: <code>UTF8::str_split('????'); // array('?', '?', '?', '?')</code>

Parameters: - int|string $input <p>The string or int to split into array.</p> - `int $length [optional] <p>Max character length of each array element.</p>` - `bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>` - `bool $try_to_use_mb_functions [optional] <p>Set to false, if you don't want to use "mb_substr"</p>`

Return: - string[] <p>An array containing chunks of chars from the input.</p>

str_split_array(int[]|string[] $input, int $length, bool $clean_utf8, bool $try_to_use_mb_functions): string[][]

<a href="#voku-php-readme-class-methods">?</a> Convert a string to an array of Unicode characters.

EXAMPLE: <code> UTF8::str_split_array(['????', 'test'], 2); // [['??', '??'], ['te', 'st']] </code>

Parameters: - int[]|string[] $input <p>The string[] or int[] to split into array.</p> - `int $length [optional] <p>Max character length of each array lement.</p>` - `bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>` - `bool $try_to_use_mb_functions [optional] <p>Set to false, if you don't want to use "mb_substr"</p>`

Return: - string[][] <p>An array containing chunks of the input.</p>

str_split_pattern(string $str, string $pattern, int $limit): string[]

<a href="#voku-php-readme-class-methods">?</a> Splits the string with the provided regular expression, returning an array of strings. An optional integer $limit will truncate the results.

Parameters: - string $str - string $pattern <p>The regex with which to split the string.</p> - int $limit [optional] <p>Maximum number of results to return. Default: -1 === no limit</p>

Return: - string[] <p>An array of strings.</p>

str_starts_with(string $haystack, string $needle): bool

<a href="#voku-php-readme-class-methods">?</a> Check if the string starts with the given substring.

EXAMPLE: <code> UTF8::str_starts_with('?????MiddleEnd', '?????'); // true UTF8::str_starts_with('?????MiddleEnd', '?????'); // false </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - bool

str_starts_with_any(string $str, array $substrings): bool

<a href="#voku-php-readme-class-methods">?</a> Returns true if the string begins with any of $substrings, false otherwise.

  • case-sensitive

Parameters: - string $str <p>The input string.</p> - array $substrings <p>Substrings to look for.</p>

Return: - bool <p>Whether or not $str starts with $substring.</p>

str_substr_after_first_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after the first occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_substr_after_last_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after the last occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_substr_before_first_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring before the first occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_substr_before_last_separator(string $str, string $separator, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring before the last occurrence of a separator.

Parameters: - string $str <p>The input string.</p> - string $separator <p>The string separator.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_substr_first(string $str, string $needle, bool $before_needle, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after (or before via "$before_needle") the first occurrence of the "$needle".

Parameters: - string $str <p>The input string.</p> - string $needle <p>The string to look for.</p> - bool $before_needle [optional] <p>Default: false</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_substr_last(string $str, string $needle, bool $before_needle, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Gets the substring after (or before via "$before_needle") the last occurrence of the "$needle".

Parameters: - string $str <p>The input string.</p> - string $needle <p>The string to look for.</p> - bool $before_needle [optional] <p>Default: false</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string

str_surround(string $str, string $substring): string

<a href="#voku-php-readme-class-methods">?</a> Surrounds $str with the given substring.

Parameters: - string $str - string $substring <p>The substring to add to both sides.</p>

Return: - string <p>A string with the substring both prepended and appended.</p>

str_titleize(string $str, array|string[]|null $ignore, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length, bool $use_trim_first, string|null $word_define_chars): string

<a href="#voku-php-readme-class-methods">?</a> Returns a trimmed string with the first letter of each word capitalized.

Also accepts an array, $ignore, allowing you to list words not to be capitalized.

Parameters: - string $str - `array|string[]|null $ignore [optional] <p>An array of words not to capitalize or null. Default: null</p>` - string $encoding [optional] <p>Default: 'UTF-8'</p> - `bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>` - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>` - `bool $use_trim_first [optional] <p>true === trim the input string, first</p>` - `string|null $word_define_chars [optional] <p>An string of chars that will be used as whitespace separator === words.</p>`

Return: - string <p>The titleized string.</p>

str_titleize_for_humans(string $str, array $ignore, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Returns a trimmed string in proper title case.

Also accepts an array, $ignore, allowing you to list words not to be capitalized.

Adapted from John Gruber's script.

Parameters: - string $str - array $ignore <p>An array of words not to capitalize.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The titleized string.</p>

str_to_binary(string $str): false|string

<a href="#voku-php-readme-class-methods">?</a> Get a binary representation of a specific string.

EXAPLE: <code>UTF8::str_to_binary('?'); // '11110000100111111001100010000011'</code>

Parameters: - string $str <p>The input string.</p>

Return: - false|string <p>false on error</p>

str_to_lines(string $str, bool $remove_empty_values, int|null $remove_short_values): string[]

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - string $str - bool $remove_empty_values <p>Remove empty values.</p> - int|null $remove_short_values <p>The min. string length or null to disable</p>

Return: - string[]

str_to_words(string $str, string $char_list, bool $remove_empty_values, int|null $remove_short_values): string[]

<a href="#voku-php-readme-class-methods">?</a> Convert a string into an array of words.

EXAMPLE: <code>UTF8::str_to_words('???? oöäü#s', '#') // array('', '????', ' ', 'oöäü#s', '')</code>

Parameters: - string $str - string $char_list <p>Additional chars for the definition of "words".</p> - bool $remove_empty_values <p>Remove empty values.</p> - int|null $remove_short_values <p>The min. string length or null to disable</p>

Return: - string[]

str_truncate(string $str, int $length, string $substring, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Truncates the string to a given length. If $substring is provided, and truncating occurs, the string is further truncated so that the substring may be appended without exceeding the desired length.

Parameters: - string $str - int $length <p>Desired length of the truncated string.</p> - string $substring [optional] <p>The substring to append if it can fit. Default: ''</p> - string $encoding [optional] <p>Default: 'UTF-8'</p>

Return: - string <p>A string after truncating.</p>

str_truncate_safe(string $str, int $length, string $substring, string $encoding, bool $ignore_do_not_split_words_for_one_word): string

<a href="#voku-php-readme-class-methods">?</a> Truncates the string to a given length, while ensuring that it does not split words. If $substring is provided, and truncating occurs, the string is further truncated so that the substring may be appended without exceeding the desired length.

Parameters: - string $str - int $length <p>Desired length of the truncated string.</p> - `string $substring [optional] <p>The substring to append if it can fit. Default: ''</p>` - string $encoding [optional] <p>Default: 'UTF-8'</p> - bool $ignore_do_not_split_words_for_one_word [optional] <p>Default: false</p>

Return: - string <p>A string after truncating.</p>

str_underscored(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Returns a lowercase and trimmed string separated by underscores.

Underscores are inserted before uppercase characters (with the exception of the first character of the string), and in place of spaces as well as dashes.

Parameters: - string $str

Return: - string <p>The underscored string.</p>

str_upper_camelize(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Returns an UpperCamelCase version of the supplied string. It trims surrounding spaces, capitalizes letters following digits, spaces, dashes and underscores, and removes spaces, dashes, underscores.

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Default: 'UTF-8'</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string <p>A string in UpperCamelCase.</p>

str_word_count(string $str, int $format, string $char_list): int|string[]

<a href="#voku-php-readme-class-methods">?</a> Get the number of words in a specific string.

EXAMPLES: <code> // format: 0 -> return only word count (int) // UTF8::str_word_count('???? öäü abc#c'); // 4 UTF8::str_word_count('???? öäü abc#c', 0, '#'); // 3

// format: 1 -> return words (array) // UTF8::str_word_count('???? öäü abc#c', 1); // array('????', 'öäü', 'abc', 'c') UTF8::str_word_count('???? öäü abc#c', 1, '#'); // array('????', 'öäü', 'abc#c')

// format: 2 -> return words with offset (array) // UTF8::str_word_count('???? öäü ab#c', 2); // array(0 => '????', 5 => 'öäü', 9 => 'abc', 13 => 'c') UTF8::str_word_count('???? öäü ab#c', 2, '#'); // array(0 => '????', 5 => 'öäü', 9 => 'abc#c') </code>

Parameters: - string $str <p>The input string.</p> - `int $format [optional] <p> <strong>0</strong> => return a number of words (default)<br> <strong>1</strong> => return an array of words<br> <strong>2</strong> => return an array of words with word-offset as key </p>` - string $char_list [optional] <p>Additional chars that contains to words and do not start a new word.</p>

Return: - int|string[] <p>The number of words in the string.</p>

strcasecmp(string $str1, string $str2, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Case-insensitive string comparison.

INFO: Case-insensitive version of UTF8::strcmp()

EXAMPLE: <code>UTF8::strcasecmp("iñtërnâtiôn\nàlizætiøn", "Iñtërnâtiôn\nàlizætiøn"); // 0</code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <strong>&lt; 0</strong> if str1 is less than str2;<br> <strong>&gt; 0</strong> if str1 is greater than str2,<br> <strong>0</strong> if they are equal`

strcmp(string $str1, string $str2): int

<a href="#voku-php-readme-class-methods">?</a> Case-sensitive string comparison.

EXAMPLE: <code>UTF8::strcmp("iñtërnâtiôn\nàlizætiøn", "iñtërnâtiôn\nàlizætiøn"); // 0</code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p>

Return: - `int <strong>&lt; 0</strong> if str1 is less than str2<br> <strong>&gt; 0</strong> if str1 is greater than str2<br> <strong>0</strong> if they are equal`

strcspn(string $str, string $char_list, int $offset, int|null $length, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Find length of initial segment not matching mask.

Parameters: - string $str - string $char_list - int $offset - int|null $length - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - int

string(int|int[]|string|string[] $intOrHex): string

<a href="#voku-php-readme-class-methods">?</a> Create a UTF-8 string from code points.

INFO: opposite to UTF8::codepoints()

EXAMPLE: <code>UTF8::string(array(246, 228, 252)); // 'öäü'</code>

Parameters: - int[]|numeric-string[]|int|numeric-string $intOrHex <p>Integer or Hexadecimal codepoints.</p>

Return: - string <p>A UTF-8 encoded string.</p>

string_has_bom(string $str): bool

<a href="#voku-php-readme-class-methods">?</a> Checks if string starts with "BOM" (Byte Order Mark Character) character.

EXAMPLE: <code>UTF8::string_has_bom("\xef\xbb\xbf foobar"); // true</code>

Parameters: - string $str <p>The input string.</p>

Return: - `bool <p> <strong>true</strong> if the string has BOM at the start,<br> <strong>false</strong> otherwise </p>`

strip_tags(string $str, string|null $allowable_tags, bool $clean_utf8): string

<a href="#voku-php-readme-class-methods">?</a> Strip HTML and PHP tags from a string + clean invalid UTF-8.

EXAMPLE: <code>UTF8::strip_tags("<span>?????\xa0\xa1</span>"); // '?????'</code>

Parameters: - `string $str <p> The input string. </p>` - `string|null $allowable_tags [optional] <p> You can use the optional second parameter to specify tags which should not be stripped. </p> <p> HTML comments and PHP tags are also stripped. This is hardcoded and can not be changed with allowable_tags. </p>` - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - string <p>The stripped string.</p>

strip_whitespace(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Strip all whitespace characters. This includes tabs and newline characters, as well as multibyte whitespace such as the thin space and ideographic space.

EXAMPLE: <code>UTF8::strip_whitespace(' ? ?????????? '); // '???????????'</code>

Parameters: - string $str

Return: - string

stripos(string $haystack, string $needle, int $offset, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the first occurrence of a substring in a string, case-insensitive.

INFO: use UTF8::stripos_in_byte() for the byte-length

EXAMPLE: <code>UTF8::stripos('a??b', '??'); // 1</code> (?? == ??)

Parameters: - string $haystack <p>The string from which to get the position of the first occurrence of needle.</p> - string $needle <p>The string to find in haystack.</p> - int $offset [optional] <p>The position in haystack to start searching.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|int Return the <strong>(int)</strong> numeric position of the first occurrence of needle in the haystack string,<br> or <strong>false</strong> if needle is not found`

stripos_in_byte(string $haystack, string $needle, int $offset): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the first occurrence of a substring in a string, case-insensitive.

Parameters: - `string $haystack <p> The string being checked. </p>` - `string $needle <p> The position counted from the beginning of haystack. </p>` - `int $offset [optional] <p> The search offset. If it is not specified, 0 is used. </p>`

Return: - `false|int <p>The numeric position of the first occurrence of needle in the haystack string. If needle is not found, it returns false.</p>`

stristr(string $haystack, string $needle, bool $before_needle, string $encoding, bool $clean_utf8): false|string

<a href="#voku-php-readme-class-methods">?</a> Returns all of haystack starting from and including the first occurrence of needle to the end.

EXAMPLE: <code> $str = 'iñtërnâtiônàlizætiøn'; $search = 'NÂT';

UTF8::stristr($str, $search)); // 'nâtiônàlizætiøn' UTF8::stristr($str, $search, true)); // 'iñtër' </code>

Parameters: - string $haystack <p>The input string. Must be valid UTF-8.</p> - string $needle <p>The string to look for. Must be valid UTF-8.</p> - `bool $before_needle [optional] <p> If <b>TRUE</b>, it returns the part of the haystack before the first occurrence of the needle (excluding the needle). </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - false|string <p>A sub-string,<br>or <strong>false</strong> if needle is not found.</p>

strlen(string $str, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Get the string length, not the byte-length!

INFO: use UTF8::strwidth() for the char-length

EXAMPLE: <code>UTF8::strlen("Iñtërnâtiôn\xE9àlizætiøn")); // 20</code>

Parameters: - string $str <p>The string being checked for length.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|int <p> The number <strong>(int)</strong> of characters in the string $str having character encoding $encoding. (One multi-byte character counted as +1). <br> Can return <strong>false</strong>, if e.g. mbstring is not installed and we process invalid chars. </p>`

strlen_in_byte(string $str): int

<a href="#voku-php-readme-class-methods">?</a> Get string length in byte.

Parameters: - string $str

Return: - int

strnatcasecmp(string $str1, string $str2, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Case-insensitive string comparisons using a "natural order" algorithm.

INFO: natural order version of UTF8::strcasecmp()

EXAMPLES: <code> UTF8::strnatcasecmp('2', '10Hello WORLD ????!'); // -1 UTF8::strcasecmp('2Hello world ????!', '10Hello WORLD ????!'); // 1

UTF8::strnatcasecmp('10Hello world ????!', '2Hello WORLD ????!'); // 1 UTF8::strcasecmp('10Hello world ????!', '2Hello WORLD ????!'); // -1 </code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <strong>&lt; 0</strong> if str1 is less than str2<br> <strong>&gt; 0</strong> if str1 is greater than str2<br> <strong>0</strong> if they are equal`

strnatcmp(string $str1, string $str2): int

<a href="#voku-php-readme-class-methods">?</a> String comparisons using a "natural order" algorithm

INFO: natural order version of UTF8::strcmp()

EXAMPLES: <code> UTF8::strnatcmp('2Hello world ????!', '10Hello WORLD ????!'); // -1 UTF8::strcmp('2Hello world ????!', '10Hello WORLD ????!'); // 1

UTF8::strnatcmp('10Hello world ????!', '2Hello WORLD ????!'); // 1 UTF8::strcmp('10Hello world ????!', '2Hello WORLD ????!'); // -1 </code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p>

Return: - `int <strong>&lt; 0</strong> if str1 is less than str2;<br> <strong>&gt; 0</strong> if str1 is greater than str2;<br> <strong>0</strong> if they are equal`

strncasecmp(string $str1, string $str2, int $len, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Case-insensitive string comparison of the first n characters.

EXAMPLE: <code> UTF8::strcasecmp("iñtërnâtiôn\nàlizætiøn321", "iñtërnâtiôn\nàlizætiøn123", 5); // 0 </code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p> - int $len <p>The length of strings to be used in the comparison.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <strong>&lt; 0</strong> if <i>str1</i> is less than <i>str2</i>;<br> <strong>&gt; 0</strong> if <i>str1</i> is greater than <i>str2</i>;<br> <strong>0</strong> if they are equal`

strncmp(string $str1, string $str2, int $len, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> String comparison of the first n characters.

EXAMPLE: <code> UTF8::strncmp("Iñtërnâtiôn\nàlizætiøn321", "Iñtërnâtiôn\nàlizætiøn123", 5); // 0 </code>

Parameters: - string $str1 <p>The first string.</p> - string $str2 <p>The second string.</p> - int $len <p>Number of characters to use in the comparison.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <strong>&lt; 0</strong> if <i>str1</i> is less than <i>str2</i>;<br> <strong>&gt; 0</strong> if <i>str1</i> is greater than <i>str2</i>;<br> <strong>0</strong> if they are equal`

strpbrk(string $haystack, string $char_list): false|string

<a href="#voku-php-readme-class-methods">?</a> Search a string for any of a set of characters.

EXAMPLE: <code>UTF8::strpbrk('-????-', '?'); // '?-'</code>

Parameters: - string $haystack <p>The string where char_list is looked for.</p> - string $char_list <p>This parameter is case-sensitive.</p>

Return: - false|string <p>The string starting from the character found, or false if it is not found.</p>

strpos(string $haystack, int|string $needle, int $offset, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the first occurrence of a substring in a string.

INFO: use UTF8::strpos_in_byte() for the byte-length

EXAMPLE: <code>UTF8::strpos('ABC-ÖÄÜ-????-????', '?'); // 8</code>

Parameters: - string $haystack <p>The string from which to get the position of the first occurrence of needle.</p> - int|string $needle <p>The string to find in haystack.<br>Or a code point as int.</p> - int $offset [optional] <p>The search offset. If it is not specified, 0 is used.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|int The <strong>(int)</strong> numeric position of the first occurrence of needle in the haystack string.<br> If needle is not found it returns false.`

strpos_in_byte(string $haystack, string $needle, int $offset): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the first occurrence of a substring in a string.

Parameters: - `string $haystack <p> The string being checked. </p>` - `string $needle <p> The position counted from the beginning of haystack. </p>` - `int $offset [optional] <p> The search offset. If it is not specified, 0 is used. </p>`

Return: - `false|int <p>The numeric position of the first occurrence of needle in the haystack string. If needle is not found, it returns false.</p>`

strrchr(string $haystack, string $needle, bool $before_needle, string $encoding, bool $clean_utf8): false|string

<a href="#voku-php-readme-class-methods">?</a> Find the last occurrence of a character in a string within another.

EXAMPLE: <code>UTF8::strrchr('??????????-äöü', '?????'); // '?????-äöü'</code>

Parameters: - string $haystack <p>The string from which to get the last occurrence of needle.</p> - string $needle <p>The string to find in haystack</p> - `bool $before_needle [optional] <p> Determines which portion of haystack this function returns. If set to true, it returns all of haystack from the beginning to the last occurrence of needle. If set to false, it returns all of haystack from the last occurrence of needle to the end, </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - false|string <p>The portion of haystack or false if needle is not found.</p>

strrev(string $str, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Reverses characters order in the string.

EXAMPLE: <code>UTF8::strrev('?-öäü'); // 'üäö-?'</code>

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>The string with characters in the reverse sequence.</p>

strrichr(string $haystack, string $needle, bool $before_needle, string $encoding, bool $clean_utf8): false|string

<a href="#voku-php-readme-class-methods">?</a> Find the last occurrence of a character in a string within another, case-insensitive.

EXAMPLE: <code>UTF8::strrichr('A??????????-äöü', 'a?????'); // 'A??????????-äöü'</code>

Parameters: - string $haystack <p>The string from which to get the last occurrence of needle.</p> - string $needle <p>The string to find in haystack.</p> - `bool $before_needle [optional] <p> Determines which portion of haystack this function returns. If set to true, it returns all of haystack from the beginning to the last occurrence of needle. If set to false, it returns all of haystack from the last occurrence of needle to the end, </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - false|string <p>The portion of haystack or<br>false if needle is not found.</p>

strripos(string $haystack, int|string $needle, int $offset, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the last occurrence of a substring in a string, case-insensitive.

EXAMPLE: <code>UTF8::strripos('ABC-ÖÄÜ-????-????', '?'); // 13</code>

Parameters: - string $haystack <p>The string to look in.</p> - int|string $needle <p>The string to look for.</p> - int $offset [optional] <p>Number of characters to ignore in the beginning or end.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|int <p>The <strong>(int)</strong> numeric position of the last occurrence of needle in the haystack string.<br>If needle is not found, it returns false.</p>`

strripos_in_byte(string $haystack, string $needle, int $offset): false|int

<a href="#voku-php-readme-class-methods">?</a> Finds position of last occurrence of a string within another, case-insensitive.

Parameters: - `string $haystack <p> The string from which to get the position of the last occurrence of needle. </p>` - `string $needle <p> The string to find in haystack. </p>` - `int $offset [optional] <p> The position in haystack to start searching. </p>`

Return: - `false|int <p>eturn the numeric position of the last occurrence of needle in the haystack string, or false if needle is not found.</p>`

strrpos(string $haystack, int|string $needle, int $offset, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the last occurrence of a substring in a string.

EXAMPLE: <code>UTF8::strrpos('ABC-ÖÄÜ-????-????', '?'); // 13</code>

Parameters: - string $haystack <p>The string being checked, for the last occurrence of needle</p> - int|string $needle <p>The string to find in haystack.<br>Or a code point as int.</p> - `int $offset [optional] <p>May be specified to begin searching an arbitrary number of characters into the string. Negative values will stop searching at an arbitrary point prior to the end of the string. </p>` - string $encoding [optional] <p>Set the charset.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|int <p>The <strong>(int)</strong> numeric position of the last occurrence of needle in the haystack string.<br>If needle is not found, it returns false.</p>`

strrpos_in_byte(string $haystack, string $needle, int $offset): false|int

<a href="#voku-php-readme-class-methods">?</a> Find the position of the last occurrence of a substring in a string.

Parameters: - `string $haystack <p> The string being checked, for the last occurrence of needle. </p>` - `string $needle <p> The string to find in haystack. </p>` - `int $offset [optional] <p>May be specified to begin searching an arbitrary number of characters into the string. Negative values will stop searching at an arbitrary point prior to the end of the string. </p>`

Return: - `false|int <p>The numeric position of the last occurrence of needle in the haystack string. If needle is not found, it returns false.</p>`

strspn(string $str, string $mask, int $offset, int|null $length, string $encoding): false|int

<a href="#voku-php-readme-class-methods">?</a> Finds the length of the initial segment of a string consisting entirely of characters contained within a given mask.

EXAMPLE: <code>UTF8::strspn('iñtërnâtiônàlizætiøn', 'itñ'); // '3'</code>

Parameters: - string $str <p>The input string.</p> - string $mask <p>The mask of chars</p> - int $offset [optional] - int|null $length [optional] - string $encoding [optional] <p>Set the charset.</p>

Return: - false|int

strstr(string $haystack, string $needle, bool $before_needle, string $encoding, bool $clean_utf8): false|string

<a href="#voku-php-readme-class-methods">?</a> Returns part of haystack string from the first occurrence of needle to the end of haystack.

EXAMPLE: <code> $str = 'iñtërnâtiônàlizætiøn'; $search = 'nât';

UTF8::strstr($str, $search)); // 'nâtiônàlizætiøn' UTF8::strstr($str, $search, true)); // 'iñtër' </code>

Parameters: - string $haystack <p>The input string. Must be valid UTF-8.</p> - string $needle <p>The string to look for. Must be valid UTF-8.</p> - `bool $before_needle [optional] <p> If <b>TRUE</b>, strstr() returns the part of the haystack before the first occurrence of the needle (excluding the needle). </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - false|string <p>A sub-string,<br>or <strong>false</strong> if needle is not found.</p>

strstr_in_byte(string $haystack, string $needle, bool $before_needle): false|string

<a href="#voku-php-readme-class-methods">?</a> Finds first occurrence of a string within another.

Parameters: - `string $haystack <p> The string from which to get the first occurrence of needle. </p>` - `string $needle <p> The string to find in haystack. </p>` - `bool $before_needle [optional] <p> Determines which portion of haystack this function returns. If set to true, it returns all of haystack from the beginning to the first occurrence of needle. If set to false, it returns all of haystack from the first occurrence of needle to the end, </p>`

Return: - `false|string <p>The portion of haystack, or false if needle is not found.</p>`

strtocasefold(string $str, bool $full, bool $clean_utf8, string $encoding, string|null $lang, bool $lower): string

<a href="#voku-php-readme-class-methods">?</a> Unicode transformation for case-less matching.

EXAMPLE: <code>UTF8::strtocasefold('???'); // 'j???'</code>

Parameters: - string $str <p>The input string.</p> - `bool $full [optional] <p> <b>true</b>, replace full case folding chars (default)<br> <b>false</b>, use only limited static array [UTF8::$COMMON_CASE_FOLD] </p>` - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - string $encoding [optional] <p>Set the charset.</p> - string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p> - `bool $lower [optional] <p>Use lowercase string, otherwise use uppercase string. PS: uppercase is for some languages better ...</p>`

Return: - string

strtolower(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Make a string lowercase.

EXAMPLE: <code>UTF8::strtolower('DÉJÀ ??? I??i'); // 'déjà ??? i?ii'</code>

Parameters: - string $str <p>The string being lowercased.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string <p>String with all alphabetic characters converted to lowercase.</p>

strtoupper(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Make a string uppercase.

EXAMPLE: <code>UTF8::strtoupper('Déjà ??? I??i'); // 'DÉJÀ ??? II?I'</code>

Parameters: - string $str <p>The string being uppercased.</p> - string $encoding [optional] <p>Set the charset.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string <p>String with all alphabetic characters converted to uppercase.</p>

strtr(string $str, string|string[] $from, string|string[] $to): string

<a href="#voku-php-readme-class-methods">?</a> Translate characters or replace sub-strings.

EXAMPLE: <code> $array = [

'Hello'   => '???',
'????' => 'earth',

]; UTF8::strtr('Hello ????', $array); // '??? earth' </code>

Parameters: - string $str <p>The string being translated.</p> - string|string[] $from <p>The string replacing from.</p> - string|string[] $to [optional] <p>The string being translated to to.</p>

Return: - `string <p>This function returns a copy of str, translating all occurrences of each character in "from" to the corresponding character in "to".</p>`

strwidth(string $str, string $encoding, bool $clean_utf8): int

<a href="#voku-php-readme-class-methods">?</a> Return the width of a string.

INFO: use UTF8::strlen() for the byte-length

EXAMPLE: <code>UTF8::strwidth("Iñtërnâtiôn\xE9àlizætiøn")); // 21</code>

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - int

substr(string $str, int $offset, int|null $length, string $encoding, bool $clean_utf8): false|string

<a href="#voku-php-readme-class-methods">?</a> Get part of a string.

EXAMPLE: <code>UTF8::substr('????', 1, 2); // '??'</code>

Parameters: - string $str <p>The string being checked.</p> - int $offset <p>The first position used in str.</p> - int|null $length [optional] <p>The maximum length of the returned string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - `false|string The portion of <i>str</i> specified by the <i>offset</i> and <i>length</i> parameters.</p><p>If <i>str</i> is shorter than <i>offset</i> characters long, <b>FALSE</b> will be returned.`

substr_compare(string $str1, string $str2, int $offset, int|null $length, bool $case_insensitivity, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Binary-safe comparison of two strings from an offset, up to a length of characters.

EXAMPLE: <code> UTF8::substr_compare("???\r", '??', 0, 2); // -1 UTF8::substr_compare("???\r", '??', 1, 2); // 1 UTF8::substr_compare("???\r", '??', 1, 2); // 0 </code>

Parameters: - string $str1 <p>The main string being compared.</p> - string $str2 <p>The secondary string being compared.</p> - `int $offset [optional] <p>The start position for the comparison. If negative, it starts counting from the end of the string.</p>` - `int|null $length [optional] <p>The length of the comparison. The default value is the largest of the length of the str compared to the length of main_str less the offset.</p>` - `bool $case_insensitivity [optional] <p>If case_insensitivity is TRUE, comparison is case insensitive.</p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - `int <strong>&lt; 0</strong> if str1 is less than str2;<br> <strong>&gt; 0</strong> if str1 is greater than str2,<br> <strong>0</strong> if they are equal`

substr_count(string $haystack, string $needle, int $offset, int|null $length, string $encoding, bool $clean_utf8): false|int

<a href="#voku-php-readme-class-methods">?</a> Count the number of substring occurrences.

EXAMPLE: <code>UTF8::substr_count('????', '??', 1, 2); // 1</code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p> - int $offset [optional] <p>The offset where to start counting.</p> - `int|null $length [optional] <p> The maximum length after the specified offset to search for the substring. It outputs a warning if the offset plus the length is greater than the haystack length. </p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - false|int <p>This functions returns an integer or false if there isn't a string.</p>

substr_count_in_byte(string $haystack, string $needle, int $offset, int|null $length): false|int

<a href="#voku-php-readme-class-methods">?</a> Count the number of substring occurrences.

Parameters: - `string $haystack <p> The string being checked. </p>` - `string $needle <p> The string being found. </p>` - `int $offset [optional] <p> The offset where to start counting </p>` - `int|null $length [optional] <p> The maximum length after the specified offset to search for the substring. It outputs a warning if the offset plus the length is greater than the haystack length. </p>`

Return: - `false|int <p>The number of times the needle substring occurs in the haystack string.</p>`

substr_count_simple(string $str, string $substring, bool $case_sensitive, string $encoding): int

<a href="#voku-php-readme-class-methods">?</a> Returns the number of occurrences of $substring in the given string.

By default, the comparison is case-sensitive, but can be made insensitive by setting $case_sensitive to false.

Parameters: - string $str <p>The input string.</p> - string $substring <p>The substring to search for.</p> - bool $case_sensitive [optional] <p>Whether or not to enforce case-sensitivity. Default: true</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - int

substr_ileft(string $haystack, string $needle): string

<a href="#voku-php-readme-class-methods">?</a> Removes a prefix ($needle) from the beginning of the string ($haystack), case-insensitive.

EXMAPLE: <code> UTF8::substr_ileft('?????MiddleEnd', '?????'); // 'MiddleEnd' UTF8::substr_ileft('?????MiddleEnd', '?????'); // 'MiddleEnd' </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - string <p>Return the sub-string.</p>

substr_in_byte(string $str, int $offset, int|null $length): false|string

<a href="#voku-php-readme-class-methods">?</a> Get part of a string process in bytes.

Parameters: - string $str <p>The string being checked.</p> - int $offset <p>The first position used in str.</p> - int|null $length [optional] <p>The maximum length of the returned string.</p>

Return: - `false|string The portion of <i>str</i> specified by the <i>offset</i> and <i>length</i> parameters.</p><p>If <i>str</i> is shorter than <i>offset</i> characters long, <b>FALSE</b> will be returned.`

substr_iright(string $haystack, string $needle): string

<a href="#voku-php-readme-class-methods">?</a> Removes a suffix ($needle) from the end of the string ($haystack), case-insensitive.

EXAMPLE: <code> UTF8::substr_iright('BeginMiddle?????', '?????'); // 'BeginMiddle' UTF8::substr_iright('BeginMiddle?????', '?????'); // 'BeginMiddle' </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - string <p>Return the sub-string.<p>

substr_left(string $haystack, string $needle): string

<a href="#voku-php-readme-class-methods">?</a> Removes a prefix ($needle) from the beginning of the string ($haystack).

EXAMPLE: <code> UTF8::substr_left('?????MiddleEnd', '?????'); // 'MiddleEnd' UTF8::substr_left('?????MiddleEnd', '?????'); // '?????MiddleEnd' </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p>

Return: - string <p>Return the sub-string.</p>

substr_replace(string|string[] $str, string|string[] $replacement, int|int[] $offset, int|int[]|null $length, string $encoding): string|string[]

<a href="#voku-php-readme-class-methods">?</a> Replace text within a portion of a string.

EXAMPLE: <code>UTF8::substr_replace(array('Iñtërnâtiônàlizætiøn', 'foo'), 'æ', 1); // array('Iæñtërnâtiônàlizætiøn', 'fæoo')</code>

source: https://gist.github.com/stemar/8287074

Parameters: - TSubReplace $str <p>The input string or an array of stings.</p> - string|string[] $replacement <p>The replacement string or an array of stings.</p> - `int|int[] $offset <p> If start is positive, the replacing will begin at the start'th offset into string. <br><br> If start is negative, the replacing will begin at the start'th character from the end of string. </p>` - `int|int[]|null $length [optional] <p>If given and is positive, it represents the length of the portion of string which is to be replaced. If it is negative, it represents the number of characters from the end of string at which to stop replacing. If it is not given, then it will default to strlen( string ); i.e. end the replacing at the end of string. Of course, if length is zero then this function will have the effect of inserting replacement into string at the given start offset.</p>` - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string|string[] <p>The result string is returned. If string is an array then array is returned.</p>

substr_right(string $haystack, string $needle, string $encoding): string

<a href="#voku-php-readme-class-methods">?</a> Removes a suffix ($needle) from the end of the string ($haystack).

EXAMPLE: <code> UTF8::substr_right('BeginMiddle?????', '?????'); // 'BeginMiddle' UTF8::substr_right('BeginMiddle?????', '?????'); // 'BeginMiddle?????' </code>

Parameters: - string $haystack <p>The string to search in.</p> - string $needle <p>The substring to search for.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p>

Return: - string <p>Return the sub-string.</p>

swapCase(string $str, string $encoding, bool $clean_utf8): string

<a href="#voku-php-readme-class-methods">?</a> Returns a case swapped version of the string.

EXAMPLE: <code>UTF8::swapCase('déJÀ ??? i?II'); // 'DÉjà ??? IIii'</code>

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - string <p>Each character's case swapped.</p>

symfony_polyfill_used(): bool

<a href="#voku-php-readme-class-methods">?</a> Checks whether symfony-polyfills are used.

Parameters: __nothing__

Return: - bool <p><strong>true</strong> if in use, <strong>false</strong> otherwise</p>

tabs_to_spaces(string $str, int $tab_length): string

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - string $str - int $tab_length

Return: - string

titlecase(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Converts the first character of each word in the string to uppercase and all other chars to lowercase.

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string <p>A string with all characters of $str being title-cased.</p>

to_ascii(string $str, string $unknown, bool $strict): string

<a href="#voku-php-readme-class-methods">?</a> Convert a string into ASCII.

EXAMPLE: <code>UTF8::to_ascii('déjà ??? i?ii'); // 'deja sss iiii'</code>

Parameters: - string $str <p>The input string.</p> - string $unknown [optional] <p>Character use if character unknown. (default is ?)</p> - `bool $strict [optional] <p>Use "transliterator_transliterate()" from PHP-Intl | WARNING: bad performance</p>`

Return: - string

to_boolean(bool|float|int|string $str): bool

<a href="#voku-php-readme-class-methods">?</a>

Parameters: - bool|float|int|string $str

Return: - bool

to_filename(string $str, bool $use_transliterate, string $fallback_char): string

<a href="#voku-php-readme-class-methods">?</a> Convert given string to safe filename (and keep string case).

Parameters: - string $str - `bool $use_transliterate No transliteration, conversion etc. is done by default - unsafe characters are simply replaced with hyphen.` - string $fallback_char

Return: - string

to_int(string $str): int|null

<a href="#voku-php-readme-class-methods">?</a> Returns the given string as an integer, or null if the string isn't numeric.

Parameters: - string $str

Return: - int|null <p>null if the string isn't numeric</p>

to_iso8859(string|string[] $str): string|string[]

<a href="#voku-php-readme-class-methods">?</a> Convert a string into "ISO-8859"-encoding (Latin-1).

EXAMPLE: <code>UTF8::to_utf8(UTF8::to_iso8859(' -ABC-????- ')); // ' -ABC-????- '</code>

Parameters: - TToIso8859 $str

Return: - string|string[]

to_string(float|int|object|string|null $input): string|null

<a href="#voku-php-readme-class-methods">?</a> Returns the given input as string, or null if the input isn't int|float|string and do not implement the "__toString()" method.

Parameters: - float|int|object|string|null $input

Return: - string|null <p>null if the input isn't int|float|string and has no "__toString()" method</p>

to_utf8(string|string[] $str, bool $decode_html_entity_to_utf8): string|string[]

<a href="#voku-php-readme-class-methods">?</a> This function leaves UTF-8 characters alone, while converting almost all non-UTF8 to UTF8.

<ul> <li>It decode UTF-8 codepoints and Unicode escape sequences.</li> <li>It assumes that the encoding of the original string is either WINDOWS-1252 or ISO-8859.</li> <li>WARNING: It does not remove invalid UTF-8 characters, so you maybe need to use "UTF8::clean()" for this case.</li> </ul>

EXAMPLE: <code>UTF8::to_utf8(["\u0063\u0061\u0074"]); // array('cat')</code>

Parameters: - TToUtf8 $str <p>Any string or array of strings.</p> - bool $decode_html_entity_to_utf8 <p>Set to true, if you need to decode html-entities.</p>

Return: - string|string[] <p>The UTF-8 encoded string</p>

to_utf8_string(string $str, bool $decode_html_entity_to_utf8): string

<a href="#voku-php-readme-class-methods">?</a> This function leaves UTF-8 characters alone, while converting almost all non-UTF8 to UTF8.

<ul> <li>It decode UTF-8 codepoints and Unicode escape sequences.</li> <li>It assumes that the encoding of the original string is either WINDOWS-1252 or ISO-8859.</li> <li>WARNING: It does not remove invalid UTF-8 characters, so you maybe need to use "UTF8::clean()" for this case.</li> </ul>

EXAMPLE: <code>UTF8::to_utf8_string("\u0063\u0061\u0074"); // 'cat'</code>

Parameters: - string $str <p>Any string.</p> - bool $decode_html_entity_to_utf8 <p>Set to true, if you need to decode html-entities.</p>

Return: - string <p>The UTF-8 encoded string</p>

trim(string $str, string|null $chars): string

<a href="#voku-php-readme-class-methods">?</a> Strip whitespace or other characters from the beginning and end of a UTF-8 string.

INFO: This is slower then "trim()"

We can only use the original-function, if we use <= 7-Bit in the string / chars but the check for ASCII (7-Bit) cost more time, then we can safe here.

EXAMPLE: <code>UTF8::trim(' -ABC-????- '); // '-ABC-????-'</code>

Parameters: - string $str <p>The string to be trimmed</p> - string|null $chars [optional] <p>Optional characters to be stripped</p>

Return: - string <p>The trimmed string.</p>

ucfirst(string $str, string $encoding, bool $clean_utf8, string|null $lang, bool $try_to_keep_the_string_length): string

<a href="#voku-php-readme-class-methods">?</a> Makes string's first char uppercase.

EXAMPLE: <code>UTF8::ucfirst('ñtërnâtiônàlizætiøn foo'); // 'Ñtërnâtiônàlizætiøn foo'</code>

Parameters: - string $str <p>The input string.</p> - string $encoding [optional] <p>Set the charset for e.g. "mb_" function</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p> - `string|null $lang [optional] <p>Set the language for special cases: az, el, lt, tr</p>` - `bool $try_to_keep_the_string_length [optional] <p>true === try to keep the string length: e.g. ? -> ß</p>`

Return: - string <p>The resulting string with with char uppercase.</p>

ucwords(string $str, string[] $exceptions, string $char_list, string $encoding, bool $clean_utf8): string

<a href="#voku-php-readme-class-methods">?</a> Uppercase for all words in the string.

EXAMPLE: <code>UTF8::ucwords('iñt ërn âTi ônà liz æti øn'); // 'Iñt Ërn ÂTi Ônà Liz Æti Øn'</code>

Parameters: - string $str <p>The input string.</p> - string[] $exceptions [optional] <p>Exclusion for some words.</p> - `string $char_list [optional] <p>Additional chars that contains to words and do not start a new word.</p>` - string $encoding [optional] <p>Set the charset.</p> - bool $clean_utf8 [optional] <p>Remove non UTF-8 chars from the string.</p>

Return: - string

urldecode(string $str, bool $multi_decode): string

<a href="#voku-php-readme-class-methods">?</a> Multi decode HTML entity + fix urlencoded-win1252-chars.

EXAMPLE: <code>UTF8::urldecode('tes%20öäü%20\u00edtest+test'); // 'tes öäü ítest test'</code>

e.g: 'test+test' => 'test test' 'D&#252;sseldorf' => 'Düsseldorf' 'D%FCsseldorf' => 'Düsseldorf' 'D&#xFC;sseldorf' => 'Düsseldorf' 'D%26%23xFC%3Bsseldorf' => 'Düsseldorf' 'Düsseldorf' => 'Düsseldorf' 'D%C3%BCsseldorf' => 'Düsseldorf' 'D%C3%83%C2%BCsseldorf' => 'Düsseldorf' 'D%25C3%2583%25C2%25BCsseldorf' => 'Düsseldorf'

Parameters: - string $str <p>The input string.</p> - bool $multi_decode <p>Decode as often as possible.</p>

Return: - string

utf8_decode(string $str, bool $keep_utf8_chars): string

<a href="#voku-php-readme-class-methods">?</a> Decodes a UTF-8 string to ISO-8859-1.

EXAMPLE: <code>UTF8::encode('UTF-8', UTF8::utf8_decode('-ABC-????-')); // '-ABC-????-'</code>

Parameters: - string $str <p>The input string.</p> - bool $keep_utf8_chars

Return: - string

utf8_encode(string $str): string

<a href="#voku-php-readme-class-methods">?</a> Encodes an ISO-8859-1 string to UTF-8.

EXAMPLE: <code>UTF8::utf8_decode(UTF8::utf8_encode('-ABC-????-')); // '-ABC-????-'</code>

Parameters: - string $str <p>The input string.</p>

Return: - string

whitespace_table(): string[]

<a href="#voku-php-readme-class-methods">?</a> Returns an array with all utf8 whitespace characters.

Parameters: __nothing__

Return: - `string[] An array with all known whitespace characters as values and the type of whitespace as keys as defined in above URL`

words_limit(string $str, int $limit, string $str_add_on): string

<a href="#voku-php-readme-class-methods">?</a> Limit the number of words in a string.

EXAMPLE: <code>UTF8::words_limit('fòô bà? fòô', 2, ''); // 'fòô bà?'</code>

Parameters: - string $str <p>The input string.</p> - int $limit <p>The limit of words as integer.</p> - string $str_add_on <p>Replacement for the striped string.</p>

Return: - string

wordwrap(string $str, int $width, string $break, bool $cut): string

<a href="#voku-php-readme-class-methods">?</a> Wraps a string to a given number of characters

EXAMPLE: <code>UTF8::wordwrap('Iñtërnâtiônàlizætiøn', 2, '<br>', true)); // 'Iñ<br>të<br>rn<br>ât<br>iô<br>nà<br>li<br>zæ<br>ti<br>øn'</code>

Parameters: - string $str <p>The input string.</p> - int $width [optional] <p>The column width.</p> - string $break [optional] <p>The line is broken using the optional break parameter.</p> - `bool $cut [optional] <p> If the cut is set to true, the string is always wrapped at or before the specified width. So if you have a word that is larger than the given width, it is broken apart. </p>`

Return: - string <p>The given string wrapped at the specified column.</p>

wordwrap_per_line(string $str, int $width, string $break, bool $cut, bool $add_final_break, string|null $delimiter): string

<a href="#voku-php-readme-class-methods">?</a> Line-Wrap the string after $limit, but split the string by "$delimiter" before ... ... so that we wrap the per line.

Parameters: - string $str <p>The input string.</p> - int $width [optional] <p>The column width.</p> - string $break [optional] <p>The line is broken using the optional break parameter.</p> - `bool $cut [optional] <p> If the cut is set to true, the string is always wrapped at or before the specified width. So if you have a word that is larger than the given width, it is broken apart. </p>` - `bool $add_final_break [optional] <p> If this flag is true, then the method will add a $break at the end of the result string. </p>` - `string|null $delimiter [optional] <p> You can change the default behavior, where we split the string by newline. </p>`

Return: - string

ws(): string[]

<a href="#voku-php-readme-class-methods">?</a> Returns an array of Unicode White Space characters.

Parameters: __nothing__

Return: - string[] <p>An array with numeric code point as key and White Space Character as value.</p>

Unit Test

1) Composer is a prerequisite for running the tests.

composer install

2) The tests can be executed by running this command from the root directory:

./vendor/bin/phpunit

Support

For support and donations please visit GitHub | Issues | PayPal | Patreon.

For status updates and release announcements please visit Releases | Twitter | Patreon.

For professional support please contact me.

Thanks

  • Thanks to GitHub (Microsoft) for hosting the code and a good infrastructure including Issues-Management, etc.
  • Thanks to IntelliJ as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
  • Thanks to Travis CI for being the most awesome, easiest continuous integration tool out there!
  • Thanks to StyleCI for the simple but powerful code style check.
  • Thanks to PHPStan && Psalm for really great Static analysis tools and for discovering bugs in the code!

License and Copyright

"Portable UTF8" is free software; you can redistribute it and/or modify it under the terms of the (at your option): - Apache License v2.0, or - GNU General Public License v2.0.

Unicode handling requires tedious work to be implemented and maintained on the long run. As such, contributions such as unit tests, bug reports, comments or patches licensed under both licenses are really welcomed.

FOSSA Status


  Files folder image Files  
File Role Description
Files folder image.github (4 files, 1 directory)
Files folder imagebuild (2 files, 1 directory)
Files folder imagesrc (1 directory)
Files folder imagetests (47 files, 1 directory)
Accessible without login Plain text file .bookignore Data Auxiliary data
Accessible without login Plain text file .editorconfig Data Auxiliary data
Accessible without login Plain text file .scrutinizer.yml Data Auxiliary data
Accessible without login Plain text file .styleci.yml Data Auxiliary data
Accessible without login Plain text file .travis.yml Data Auxiliary data
Accessible without login Plain text file appveyor.yml Data Auxiliary data
Accessible without login Plain text file book.json Data Auxiliary data
Accessible without login Plain text file bootstrap.php Aux. Auxiliary script
Accessible without login Plain text file CHANGELOG.md Data Auxiliary data
Accessible without login Plain text file circle.yml Data Auxiliary data
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file LICENSE-APACHE Lic. License text
Accessible without login Plain text file package.json Data Auxiliary data
Accessible without login Plain text file phpcs.php_cs Example Example script
Accessible without login Plain text file phpstan.neon Data Auxiliary data
Accessible without login Plain text file phpunit.xml Data Auxiliary data
Accessible without login Plain text file psalm.xml Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation
Accessible without login Plain text file SECURITY.md Data Auxiliary data
Accessible without login Plain text file SUMMARY.md Data Auxiliary data

  Files folder image Files  /  .github  
File Role Description
Files folder imageworkflows (1 file)
  Accessible without login Plain text file CONTRIBUTING.md Data Auxiliary data
  Accessible without login Plain text file FUNDING.yml Data Auxiliary data
  Accessible without login Plain text file ISSUE_TEMPLATE.md Data Auxiliary data
  Accessible without login Plain text file PULL_REQUEST_TEMPLATE.md Data Auxiliary data

  Files folder image Files  /  .github  /  workflows  
File Role Description
  Accessible without login Plain text file ci.yml Data Auxiliary data

  Files folder image Files  /  build  
File Role Description
Files folder imagedocs (1 file)
  Accessible without login Plain text file composer.json Data Auxiliary data
  Accessible without login Plain text file generate_docs.php Example Example script

  Files folder image Files  /  build  /  docs  
File Role Description
  Accessible without login Plain text file base.md Data Auxiliary data

  Files folder image Files  /  src  
File Role Description
Files folder imagevoku (1 directory)

  Files folder image Files  /  src  /  voku  
File Role Description
Files folder imagehelper (2 files, 1 directory)

  Files folder image Files  /  src  /  voku  /  helper  
File Role Description
Files folder imagedata (8 files)
  Plain text file Bootup.php Class Class source
  Plain text file UTF8.php Class Class source

  Files folder image Files  /  src  /  voku  /  helper  /  data  
File Role Description
  Accessible without login Plain text file caseFolding_full.php Aux. Auxiliary script
  Accessible without login Plain text file chr.php Aux. Auxiliary script
  Accessible without login Plain text file emoji.php Aux. Auxiliary script
  Accessible without login Plain text file encodings.php Aux. Auxiliary script
  Accessible without login Plain text file ord.php Aux. Auxiliary script
  Accessible without login Plain text file transliterator_list.php Aux. Auxiliary script
  Accessible without login Plain text file utf8_fix.php Aux. Auxiliary script
  Accessible without login Plain text file win1252_to_utf8.php Aux. Auxiliary script

  Files folder image Files  /  tests  
File Role Description
Files folder imagefixtures (22 files)
  Accessible without login Plain text file bootstrap.php Aux. Auxiliary script
  Plain text file BootupTest.php Class Class source
  Plain text file HhvmTest.php Class Class source
  Plain text file ShimIconvTest.php Class Class source
  Plain text file ShimIntlTest.php Class Class source
  Plain text file ShimMbstringTest.php Class Class source
  Plain text file ShimXmlTest.php Class Class source
  Plain text file Utf8AccessTest.php Class Class source
  Plain text file Utf8AsciiTest.php Class Class source
  Plain text file Utf8CodePointsTest.php Class Class source
  Plain text file Utf8CompliantTest.php Class Class source
  Plain text file Utf8GlobalNonStrictPart1Test.php Class Class source
  Plain text file Utf8GlobalNonStrictPart2Test.php Class Class source
  Plain text file Utf8GlobalNonStrictPart3Test.php Class Class source
  Plain text file Utf8GlobalPart1Test.php Class Class source
  Plain text file Utf8GlobalPart2Test.php Class Class source
  Plain text file Utf8GlobalPart3Test.php Class Class source
  Plain text file Utf8HtmlEncode.php Class Class source
  Plain text file Utf8IsUtf8Test.php Class Class source
  Plain text file Utf8IsValidTest.php Class Class source
  Plain text file Utf8LcfirstTest.php Class Class source
  Plain text file Utf8LtrimTest.php Class Class source
  Plain text file Utf8OrdTest.php Class Class source
  Plain text file Utf8RtrimTest.php Class Class source
  Plain text file Utf8StrcasecmpTest.php Class Class source
  Plain text file Utf8StrcspnTest.php Class Class source
  Plain text file Utf8StrIreplaceTest.php Class Class source
  Plain text file Utf8StristrTest.php Class Class source
  Plain text file Utf8StrlenTest.php Class Class source
  Plain text file Utf8StrPadTest.php Class Class source
  Plain text file Utf8StrReplaceTest.php Class Class source
  Plain text file Utf8StrrevTest.php Class Class source
  Plain text file Utf8StrriposTest.php Class Class source
  Plain text file Utf8StrrposTest.php Class Class source
  Plain text file Utf8StrSplitTest.php Class Class source
  Plain text file Utf8StrspnTest.php Class Class source
  Plain text file Utf8StrToUpperTest.php Class Class source
  Plain text file Utf8StrTransliterateTest.php Class Class source
  Plain text file Utf8StrtToLowerTest.php Class Class source
  Plain text file Utf8StrWordwrapTest.php Class Class source
  Plain text file Utf8SubstrReplaceTest.php Class Class source
  Plain text file Utf8SubstrTest.php Class Class source
  Plain text file Utf8ToAsciiTest.php Class Class source
  Plain text file Utf8TrimTest.php Class Class source
  Plain text file Utf8UcfirstTest.php Class Class source
  Plain text file Utf8UcwordsTest.php Class Class source
  Plain text file ZNormalizationTest.php Class Class source

  Files folder image Files  /  tests  /  fixtures  
File Role Description
  Accessible without login Plain text file broken_import.csv Data Auxiliary data
  Accessible without login Image file image.png Data Auxiliary data
  Accessible without login Image file image_small.png Data Auxiliary data
  Accessible without login Plain text file iso-8859-7.txt Doc. Documentation
  Accessible without login Plain text file latin.txt Doc. Documentation
  Accessible without login Plain text file sample-ascii-chart.txt Doc. Documentation
  Accessible without login Plain text file sample-html.txt Doc. Documentation
  Accessible without login Plain text file sample-unicode-chart.txt Doc. Documentation
  Accessible without login Plain text file sample-utf-16-be-bom-only.txt Doc. Documentation
  Accessible without login Plain text file sample-utf-16-le-bom-only.txt Doc. Documentation
  Accessible without login Plain text file sample-utf-8-bom-only.txt Doc. Documentation
  Accessible without login Plain text file sample-utf-8-bom.txt Doc. Documentation
  Accessible without login HTML file sample-win1252.html Doc. Documentation
  Accessible without login Plain text file test.js Data Auxiliary data
  Accessible without login Plain text file test.pdf Data Auxiliary data
  Accessible without login Plain text file utf-8-bom.txt Doc. Documentation
  Accessible without login Plain text file utf-8-extra.txt Doc. Documentation
  Accessible without login Plain text file utf-8.txt Doc. Documentation
  Accessible without login Plain text file ZNormalizationTest.50.txt Doc. Documentation
  Accessible without login Plain text file ZNormalizationTest.63.txt Doc. Documentation
  Accessible without login Plain text file ZNormalizationTest.70.txt Doc. Documentation
  Accessible without login Plain text file ZNormalizationTest.80.txt Doc. Documentation

 Version Control Reuses Unique User Downloads Download Rankings  
 100%5
Total:688
This week:1
All time:4,736
This week:560Up
User Ratings User Comments (2)
 All time
Utility:100%StarStarStarStarStarStar
Consistency:92%StarStarStarStarStar
Documentation:85%StarStarStarStarStar
Examples:-
Tests:-
Videos:-
Overall:67%StarStarStarStar
Rank:432
 
nice
7 years ago (muabshir)
70%StarStarStarStar
There is a huge amount of work behind this package, which mak...
7 years ago (Christian Vigh)
65%StarStarStarStar