format

Establecer el formato de visualización de salida

Sintaxis

format(style)

fmt = format

fmt = format(style)

Descripción

format(style) cambia el formato de visualización de salida al formato que especifica style. Por ejemplo, format("shortG") muestra valores numéricos en un formato compacto con 5 dígitos totales. Los formatos numéricos afectan solo a la forma en que se muestran los números en la visualización, no a la manera en que MATLAB^® los calcula o los guarda.

Cuando especifica el estilo por nombre, puede utilizar el formato de comando sin paréntesis ni comillas:

format shortG

fmt = format devuelve el formato de visualización actual. (desde la versión R2021a)

fmt = format(style) guarda el formato de visualización actual en fmt y después cambia el formato de visualización al estilo especificado. (desde la versión R2021a)

No puede utilizar un formato de comando cuando solicita una salida o cuando pasa una variable como entrada. Encierre las entradas entre paréntesis e incluya los nombres de los estilos entre comillas.

fmt = format("shortG");
format(fmt)

Ejemplos

Formato largo

Establezca el formato de salida como formato largo con decimales fijos y muestre el valor de pi.

format long
pi

ans = 
   3.141592653589793

Formato hexadecimal

Muestre los valores máximos para enteros y números reales en formato hexadecimal.

format hex
intmax('uint64')

ans = uint64
   ffffffffffffffff

realmax

ans = 
   7fefffffffffffff

Notación técnica larga y corta

Muestre la diferencia entre los formatos shortEng y longEng.

Establezca el formato de salida en shortEng.

format shortEng

Cree una variable y aumente su valor con un múltiplo de 10 cada vez con un bucle for.

A = 5.123456789;
for k = 1:10
   disp(A)
   A = A*10;
end

     5.1235e+000

    51.2346e+000

   512.3457e+000

     5.1235e+003

    51.2346e+003

   512.3457e+003

     5.1235e+006

    51.2346e+006

   512.3457e+006

     5.1235e+009

Los valores se muestran con 4 dígitos tras el punto decimal y un exponente que es un múltiplo de 3.

Establezca el formato de salida como formato técnico largo y muestre los mismos valores.

format longEng

A = 5.123456789;
for k = 1:10
   disp(A)
   A = A*10;
end

    5.12345678900000e+000

    51.2345678900000e+000

    512.345678900000e+000

    5.12345678900000e+003

    51.2345678900000e+003

    512.345678900000e+003

    5.12345678900000e+006

    51.2345678900000e+006

    512.345678900000e+006

    5.12345678900000e+009

Los valores se muestran con 15 dígitos y un exponente que es un múltiplo de 3.

Formato de rango de datos de gran tamaño

Utilice el formato shortG cuando algunos de los valores de un arreglo sean números cortos y otros tengan exponentes grandes. El formato shortG elige el formato corto con decimales fijos o la notación científica corta que tenga la visualización más compacta.

Cree una variable y muestre la salida en formato corto short, que es el formato predeterminado.

x = [25 56.31156 255.52675 9876899999];
format short
x

x = 1×4
109 ×

    0.0000    0.0000    0.0000    9.8769

Establezca el formato de salida en shortG y vuelva a mostrar los valores.

format shortG
x

x = 1×4

           25       56.312       255.53   9.8769e+09

Restablecer formato al valor predeterminado

Establezca el formato de salida como formato técnico corto con espaciado de línea compacto.

format shortEng
format compact
x = rand(3)

x =
   814.7237e-003   913.3759e-003   278.4982e-003
   905.7919e-003   632.3592e-003   546.8815e-003
   126.9868e-003    97.5404e-003   957.5068e-003

Restablezca el formato de visualización al valor predeterminado y muestre la matriz de nuevo.

format default
x

x =

    0.8147    0.9134    0.2785
    0.9058    0.6324    0.5469
    0.1270    0.0975    0.9575

En versiones anteriores a R2021a, restablezca el formato de visualización a los valores predeterminados con format por sí mismo.

format

Obtener el formato actual

Desde la versión R2021a

Obtenga el formato de visualización actual.

fmt = format

fmt = 
  DisplayFormatOptions with properties:

    NumericFormat: "short"
      LineSpacing: "loose"

Guardar y restablecer el formato de visualización

Desde la versión R2021a

Guarde el formato de visualización actual y restablézcalo más adelante.

Establezca la visualización numérica en shortE y muestre una matriz de valores numéricos de 2 por 2.

format shortE
m = [9638573934 37467; 236 574638295]

m = 2×2

   9.6386e+09   3.7467e+04
   2.3600e+02   5.7464e+08

Guarde el formato de visualización actual en oldFmt y cambie el formato numérico a longE.

oldFmt = format("longE")

oldFmt = 
  DisplayFormatOptions with properties:

    NumericFormat: "shortE"
      LineSpacing: "loose"

Confirme que el formato numérico sea ahora una notación científica larga volviendo a mostrar la matriz m.

m

m = 2×2

     9.638573934000000e+09     3.746700000000000e+04
     2.360000000000000e+02     5.746382950000000e+08

Restablezca el formato a su estado anterior. Vuelva a mostrar m para confirmar que el formato numérico es ahora un formato científico corto.

format(oldFmt)
m

m = 2×2

   9.6386e+09   3.7467e+04
   2.3600e+02   5.7464e+08

Argumentos de entrada

style — Formato que se desea aplicar

vector de caracteres | escalar de cadena | objeto DisplayFormatOptions

Formato que se desea aplicar, especificado como vector de caracteres, escalar de cadena u objeto DisplayFormatOptions.

Los vectores de caracteres o los escalares de cadena deben ser uno de los nombres de estilo que aparecen en la lista o default.

Valor predeterminado

default restablece el formato de visualización predeterminado, que es short para formato numérico y loose para espaciado de línea. (Desde la versión R2021a)

Formato numérico

Estos estilos controlan el formato de visualización de salida para variables numéricas.

Style	Resultado	Ejemplo
short	Formato corto con decimales fijos, con 4 dígitos después del separador decimal. Esta es la configuración numérica predeterminada.	3.1416
long	Formato largo con decimales fijos, con 15 dígitos después del separador decimal para los valores double y 7 dígitos después del separador decimal para los valores single.	3.141592653589793
shortE	Notación científica corta con 4 dígitos después del separador decimal.	3.1416e+00
longE	Notación científica larga con 15 dígitos después del separador decimal para los valores double y 7 dígitos después del separador decimal para los valores single.	3.141592653589793e+00
shortG	Notación científica o formato corto con decimales fijos, la opción que sea más compacta, con un total de 5 dígitos.	3.1416
longG	Notación científica o formato largo con decimales fijos, la opción que sea más compacta, con un total de 15 dígitos para los valores double y 7 dígitos para los valores single.	3.14159265358979
shortEng	Notación técnica corta (el exponente es un múltiplo de 3) con 4 dígitos después del separador decimal.	3.1416e+000
longEng	Notación técnica larga (el exponente es un múltiplo de 3) con 15 dígitos significativos.	3.14159265358979e+000
+	Formato positivo/negativo con los caracteres +, - y espacio en blanco para los elementos positivos, negativos y cero.	+
bank	Formato de moneda con 2 dígitos después del separador decimal.	3.14
hex	Representación hexadecimal de un número binario de doble precisión.	400921fb54442d18
rational	Relación de enteros pequeños.	355/113

Formato de espaciado de línea

Style	Resultado	Ejemplo
compact	Suprime las líneas en blanco sobrantes para mostrar más salidas en una única pantalla.	theta = pi/2 theta = 1.5708
loose	Añade líneas en blanco para hacer que las salidas sean más legibles. Esta es la configuración predeterminada para el espaciado de línea.	theta = pi/2 theta = 1.5708

El objeto DisplayFormatOptions tiene dos propiedades, NumericFormat y LineSpacing. Las opciones para entradas de vector de caracteres y de escalar de cadena son también los valores de propiedad válidos. Para ver un ejemplo del uso de un objeto DisplayFormatOptions, consulte Guardar y restablecer el formato de visualización.

Argumentos de salida

fmt — Formato de visualización actual

objeto DisplayFormatOptions

Formato de visualización actual, devuelto como un objeto DisplayFormatOptions con estas propiedades:

• NumericFormat

• LineSpacing

Para obtener más información sobre los valores de propiedades válidos, consulte el argumento style.

Nota

Los valores de propiedades reflejan el estado del formato de visualización cuando se crea el objeto. Las propiedades no cambian automáticamente cuando cambia el formado de visualización. Para ver un ejemplo, consulte Guardar y restablecer el formato de visualización.

Sugerencias

• El formato especificado solo se aplica a la sesión actual de MATLAB. Para mantener un formato entre sesiones, seleccione la opción Numeric format o Line spacing en las preferencias de la ventana de comandos.

• Puede especificar short o long y el tipo de presentación por separado, como format short E o format("short E").

• MATLAB siempre muestra los tipos de datos enteros con el número de dígitos apropiado para el correspondiente tipo de datos. Por ejemplo, MATLAB utiliza 3 dígitos para mostrar tipos de datos int8 (por ejemplo, -128:127). Si establece el formato de salida en short o long, ello no afecta a la visualización de variables de tipo entero.

• Los números de punto flotante con valor entero y un máximo de 9 dígitos no se muestran en notación científica.

• Si está mostrando una matriz con un rango amplio de valores, plantéese utilizar shortG. Consulte Formato de rango de datos de gran tamaño.

Capacidades ampliadas

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en un entorno basado en subprocesos.

Historial de versiones

Introducido antes de R2006a

R2021a: No se recomienda format sin argumentos

El comando format, por sí mismo, restablece el formato de visualización de salida al valor predeterminado, que es el formato corto con decimales fijos para notación de punto flotante y espaciado de línea amplio.

format

Para un código más claro, especifique explícitamente el estilo default (desde la versión R2021a).

format default

Consulte también

DisplayFormatOptions | disp | fprintf | formattedDisplayText

Temas

• Dar formato a la salida

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí