mb_strimwidth

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

mb_strimwidthTrunca una cadena

Descripción

mb_strimwidth(
    string $string,
    int $start,
    int $width,
    string $trim_marker = "",
    ?string $encoding = null
): string

Trunca la cadena string a la longitud width especificada, donde los caracteres de media caja cuentan como 1, y los caracteres de caja completa cuentan como 2. Ver » http://www.unicode.org/reports/tr11/ para más detalles sobre las cajas de caracteres asiáticos del este.

Parámetros

string

La cadena a truncar.

start

start es la posición de inicio, en número de caracteres desde el principio de la cadena (el primer carácter es 0), o si la posición es negativa, número de caracteres desde el final de la chaîne de caractères.

width

La anchura de la truncación deseada. Si se especifica una anchura negativa, debe contarse desde el final de la cadena.

Nota:

Proporcionar una anchura negativa está obsoleto a partir de PHP 8.3.0.

trim_marker

trim_marker es la cadena añadida al final de la cadena truncada.

encoding

El parámetro encoding es la codificación de caracteres. Si es omitido o null, será usado el valor de la codificación de caracteres interna.

Valores devueltos

La cadena truncada. Si trim_marker está definido, trim_marker reemplaza los últimos caracteres para corresponder al tamaño width.

Historial de cambios

Versión Descripción
8.3.0 Proporcionar una width negativa a mb_strimwidth() ahora está obsoleto.
8.0.0 encoding ahora es nullable.
7.1.0 Se añadió soporte para starts y widths negativos.

Ejemplos

Ejemplo #1 Ejemplo con mb_strimwidth()

<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// Muestra: "Hello W..."
?>

Ver también