Funkcja PHP mb_encode_numericentity() | #! Shebang

Funkcja PHP mb_encode_numericentity()

Funkcja PHP mb_encode_numericentity() zamienia wszystkie znaki z określonego zakresu w łańcuchu na odpowiadające im numeryczne encje HTML.

Składnia funkcji PHP mb_encode_numericentity()

Funkcja PHP mb_encode_numericentity() ma następującą składnię:

mb_encode_numericentity(
    string $string,
    array $map,
    ?string $encoding = null,
    bool $hex = false
): string

Parametry

Parametr Opis
string Parametr obowiązkowy. Łańcuch, w którym mają zostać zakodowane znaki.
map Parametr obowiązkowy. Tablica określająca zakres zestawu znaków, które mają być kodowane.

Tablica ta powinna zawierać dowolną liczbę kwartetów wartości o następującej strukturze:


[int kod_początkowy1, int kod_końcowy1, int offset1, int maska1,
 int kod_początkowy2, int kod_końcowy2, int offset2, int maska2,…]
  • kod_początkowy to kod Unicode pierwszego znaku zakresu.
  • kod_końcowy to kod Unicode ostatniego znaku zakresu.
  • offset to wartość dodawana do kodu znaku przed zamianą na encję numeryczną.

    Wartość powyżej zera spowoduje, że encje nie będą odpowiadać rzeczywistym znakom, więc można przy jej użyciu zdefiniować jakiś specjalny rodzaj mapowania.

  • maska określa, które bity kodu znaku mają być brane pod uwagę. Można nadać jej wartość 0xFFFF, która oznacza wszystkie bity z płaszczyzny Unicode BMP (ang. Basic Multilingual Plane — podstawowa płaszczyzna wielojęzyczna), która obejmuje między innymi wszystkie litery polskiego alfabetu.

W poniższym przykładzie funkcja mb_encode_numericentity() zamieni na numeryczne encje HTML tylko litery z polskimi znakami diakrytycznymi:


$mapa = [
    0x00F3, 0x00F3, 0, 0xFFFF, 
    0x0105, 0x0105, 0, 0xFFFF, 
    0x0107, 0x0107, 0, 0xFFFF, 
    0x0119, 0x0119, 0, 0xFFFF, 
    0x0142, 0x0142, 0, 0xFFFF, 
    0x0144, 0x0144, 0, 0xFFFF, 
    0x015B, 0x015B, 0, 0xFFFF, 
    0x017A, 0x017A, 0, 0xFFFF, 
    0x017C, 0x017C, 0, 0xFFFF,
];

echo mb_encode_numericentity('tantniś krzyżowiaczek', $mapa);
encoding Określa kodowanie znaku. Jeśli zostanie pominięty lub ma wartość null, używane jest wewnętrzne kodowanie znaków.
hex Domyślnie funkcja mb_encode_numericentity() zwraca encje dziesiętne, a ten parametr zmienia to ustawienie na encje szesnastkowe (heksadecymalne).

Wartość zwrotna

Funkcja PHP mb_encode_numericentity() zwraca przetworzony łańcuch.

Typ zwrotny: string.

Udostępnij:
Share

Podobał Ci się ten artykuł?

Oceń go!

Średnia 5 / 5. Liczba głosów: 1

Jeszcze nikt nie głosował. Wyprzedź innych i zagłosuj.

Skoro spodobał Ci się ten artykuł...

Poleć go znajomym!

Ojej :( Powiedz nam, co powinniśmy poprawić!

blank
Podoba Ci się ta strona?

Pomóż nam się rozwijać, wykupując płatne konto. Dzięki temu będziemy mogli tworzyć dla Ciebie jeszcze więcej ciekawych treści, a Ty pozbędziesz się reklam.

Dodaj komentarz