L. Funciones iconv

Introducción

Este módulo contiene una interfaz con la facilidad de conversión de juegos de caracteres iconv. Con éste módulo, es posible convertir una cadena representada por un juego de caracteres local a una representada por otro juego de caracteres, que puede ser el juego de caracteres Unicode. Los juegos de caracteres soportados dependen de la implementación de iconv en su sistema. Note que la función iconv en algunos sistemas puede que no funcione como lo espera. En tal caso, sería una buena idea instalar la biblioteca libiconv GNU. Es muy probable que consiga unos resultados más consistentes.

A partir de PHP 5.0.0, esta extensión viene con varias funciones utilitarias que le ayudan a escribir scripts multi-lingües. Echemos un vistazo a las siguientes secciones para explorar las nuevas características.

Requirimientos

No necesita de nada si el sistema que usa es uno de los sistemas recientes compatibles con POSIX, ya que las bibliotecas C estándar que vienen con ellos ofrecen la facilidad iconv. De otro modo, es necesario instalar la biblioteca libiconv en su sistema.

Instalación

Para usar las funciones de éste módulo, el binario PHP debe ser compilado con la siguiente línea de configuración: --with-iconv[=DIR].

Nota para Usuarios de Windows®: Para habilitar éste módulo en un entorno Windows®, necesita colocar un archivo DLL llamado iconv.dll o iconv-1.3.dll (antes de 4.2.1), el cual hace parte del paquete binario PHP/Win32, en un directorio especificado por la variable de entorno PATH o uno de los directorios de sistema de su instalación de Windows®.
Este módulo es parte de PHP a partir de PHP 5, por lo tanto iconv.dll y php_iconv.dll no se requieren más.

Configuración en tiempo de ejecución

El comportamiento de estas funciones está afectado por los valores definidos en php.ini.

Tabla 1. Opciones de configuración de iconv

Nombre	Predeterminado	Modificable	Cambios
iconv.input_encoding	"ISO-8859-1"	PHP_INI_ALL	Disponible desde PHP 4.0.5.
iconv.output_encoding	"ISO-8859-1"	PHP_INI_ALL	Disponible desde PHP 4.0.5.
iconv.internal_encoding	"ISO-8859-1"	PHP_INI_ALL	Disponible desde PHP 4.0.5.

For further details and definitions of the PHP_INI_* constants, see the Apéndice H.

Nota: La opción de configuración iconv.input_encoding actualmente no es usada en absoluto.

Tipos de recursos

Esta extensión no tiene ningún tipo de recurso definido.

Constantes predefinidas

Desde PHP 4.3.0, es posible identificar, en tiempo de ejecución, qué implementación de iconv es adoptada por esta extensión.

Tabla 2. Constantes de iconv

Nombre	Tipo	Descripción
ICONV_IMPL	string	El nombre de la implementación
ICONV_VERSION	string	La versión de la implementación

Nota: Escribir scripts que dependan de la implementación con éstas constantes no se recomienda en absoluto.

A partir de PHP 5.0.0, las siguientes constantes se encuentran disponibles también:

Tabla 3. Constantes de iconv disponibles desde PHP 5.0.0

Nombre	Tipo	Descripción
ICONV_MIME_DECODE_STRICT	integer	Una máscara de bits usada para iconv_mime_decode()
ICONV_MIME_DECODE_CONTINUE_ON_ERROR	integer	Una máscara de bits usada para iconv_mime_decode()

Ver también

Vea también las funciones GNU Recode.

Tabla de contenidos
iconv_get_encoding -- Retrieve internal configuration variables of iconv extension
iconv_mime_decode_headers -- Decodes multiple MIME header fields at once
iconv_mime_decode -- Decodes a MIME header field
iconv_mime_encode -- Composes a MIME header field
iconv_set_encoding -- Set current setting for character encoding conversion
iconv_strlen -- Returns the character count of string
iconv_strpos -- Finds position of first occurrence of a needle within a haystack
iconv_strrpos -- Finds the last occurrence of a needle within the specified range of haystack
iconv_substr -- Cut out part of a string
iconv -- Convert string to requested character encoding
ob_iconv_handler -- Convert character encoding as output buffer handler