mb_detect_order

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_detect_order — Lee/modifica el orden de detección de codificaciones

Descripción

Reemplaza el orden de detección de codificaciones actual por encoding.

Parámetros

encoding

encoding es un array, o una lista de codificaciones separadas por comas. Ver las codificaciones soportadas.

Si encoding es omitido o null , mb_detect_order() devuelve el orden de detección de codificaciones actual en un array.

Esta configuración afecta a las funciones mb_detect_encoding() y mb_send_mail() .

Actualmente, mbstring soporta los siguientes filtros de detección. Si una secuencia de bytes es inválida para uno de los siguientes filtros, la detección fallará.

UTF-8, UTF-7, ASCII, EUC-JP,SJIS, eucJP-win, SJIS-win, JIS, ISO-2022-JP

Para ISO-8859-*, mbstring siempre detecta ISO-8859-*.

Para UTF-16, UTF-32, UCS2 y UCS4 la detección siempre fallará.

Valores devueltos

Al definir el orden de detección de codificación, true es devuelto en caso de éxito o false en caso de fallo.

Al obtener el orden de detección de codificación, un array ordenado de codificaciones es devuelto.

Historial de cambios

Ejemplos

<?php
/* Reemplaza el orden de detección por una lista enumerada */
mb_detect_order("eucjp-win,sjis-win,UTF-8");
/* Reemplaza el orden de detección por un array */
$ary[] = "ASCII";
$ary[] = "JIS";
$ary[] = "EUC-JP";
mb_detect_order($ary);
/* Muestra el orden de detección actual */
echo implode(", ", mb_detect_order());
?>

; Siempre detectado como ISO-8859-1
detect_order = ISO-8859-1, UTF-8
; Siempre detectado como UTF-8, desde que los valores ASCII/UTF-7
; son válidos para UTF-8
detect_order = UTF-8, ASCII, UTF-7

Véase también

• mb_internal_encoding() - Lee/modifica la codificación interna
• mb_http_input() - Detecta el tipo de codificación de caracteres HTTP
• mb_http_output() - Lee/modifica la codificación de visualización
• mb_send_mail() - Envía un correo electrónico codificado