.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strfmon 3 "28 Junio 2025" "Páginas de Manual de Linux 6.15" .SH NOMBRE strfmon, strfmon_l \- convierte valores monetarios a una cadena .SH BIBLIOTECA Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBssize_t strfmon(\fPsize_t max; \fB char \fP\fIs\fP\fB[restrict \fP\fImax\fP\fB], size_t \fP\fImax\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP \fBssize_t strfmon_l(\fPsize_t max; \fB char \fP\fIs\fP\fB[restrict \fP\fImax\fP\fB], size_t \fP\fImax\fP\fB, locale_t \fP\fIlocale\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP .fi .SH DESCRIPCIÓN La función \fBstrfmon\fP() formatea las cantidades monetarias definidas según la especificación de la localización en curso y del formato \fIformato\fP.Guarda el resultado en el vector de caracteres \fIs\fP de tamaño \fImax\fP. .P La función \fBstrfmon_l\fP() realiza la misma tarea, pero utiliza la configuración regional definida por \fIlocale\fP. El comportamiento de \fBstrfmon_l\fP() no está definido si \fIlocale\fP es el objeto de configuración regional especial \fBLC_GLOBAL_LOCALE\fP (consulte \fBduplocale\fP(3)) o no es un identificador de objeto de configuración regional válido. .P Los caracteres ordinarios en \fIformat\fP se copian a \fIs\fP sin conversión. Los especificadores de conversión se introducen con el carácter \[aq]%\[aq]. Justo después, puede haber cero o más de los siguientes indicadores: .TP \fB=\fP\fIf\fP El carácter de un sólo byte \fIf\fP se usa como carácter de relleno numérico (el relleno se produce a la izquierda, vea más abajo). Cuando no se especifica, se utiliza el carácter espacio. .TP \fB\[ha]\fP No usar ningún carácter de agrupamiento que pueda estar definido para la localización actual. Por defecto, el agrupamiento está habilitado. .TP \fB(\fP o \fB+\fP La opción ( indica que las cantidades negativas deben ser encerradas entre paréntesis. La opción + indica que los signos deben ser manejados en el modo por defecto, esto es, las cantidades son precedidas por la indicación de signo de la localización, p.e., nada para positivo, "\-" para negativo. .TP \fB!\fP Omitir el símbolo monetario. .TP \fB\-\fP Justificar a la izquierda todos los campos. Por defecto se justifican a la derecha. .P A continuación, puede haber una anchura de campo: una cadena de dígitos decimales especificando una anchura mínima de campo. El valor por defecto es 0. Un resultado más pequeño que esta anchura es rellenado con espacios (a la izquierda, a menos que se especifique la opción de justificado a la izquierda). .P Seguidamente, pueda haber una precisión izquierda de la forma "#" seguido por una cadena de dígitos decimales. Si el número de dígitos a la izquierda del carácter decimal es más pequeño que esto, la representación se rellena a la izquierda con el carácter de relleno numérico. Los caracteres de agrupamiento no se tienen en cuenta en este ancho de campo. .P Tras esto, puede haber una precisión derecha de la forma "." seguido por una cadena de dígitos decimales. La cantidad a formatear se redondea al número especificado de dígitos antes de formatear. El valor por omisión se especifica en los elementos \fIfrac_digits\fP y \fIint_frac_digits\fP de la localización actual. Si la precisión derecha es 0, no se muestra ningún carácter decimal (el carácter decimal lo determina aquí \fBLC_MONETARY\fP y puede diferir del especificado por \fBLC_NUMERIC\fP.) .P Finalmente, la especificación de conversión debe terminar con un carácter de conversión. Los tres caracteres de conversión son .TP \fB%\fP (En este caso la especificación completa debe ser exactamente "%%".) Pone un carácter \[aq]%\[aq] en la cadena resultante. .TP \fBi\fP Un argumento de tipo \fIdouble\fP se convierte usando el formato monetario internacional de la localización. .TP \fBn\fP Un argumento de tipo \fIdouble\fP se convierte usando el formato monetario nacional de la localización. .SH "VALOR DEVUELTO" La función \fBstrfmon\fP() devuelve el número de caracteres colocados en el vector \fIs\fP, sin incluir el byte nulo de terminación, siempre que la cadena, incluido el byte nulo de terminación, quepa. De lo contrario, establece \fIerrno\fP en \fBE2BIG\fP, devuelve \-1 y el contenido del vector queda indefinido. .SH ATRIBUTOS Para obtener una explicación de los términos usados en esta sección, véase \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfaz Atributo Valor T{ .na .nh \fBstrfmon\fP() T} Seguridad del hilo Configuración regional de multi\-hilo seguro T{ .na .nh \fBstrfmon_l\fP() T} Seguridad del hilo Multi\-hilo seguro .TE .SH ESTÁNDARES POSIX.1\-2008. .SH HISTORIAL POSIX.1\-2001. .SH EJEMPLOS La llamada .P .in +4n .EX strfmon(buf, sizeof(buf), "[%\[ha]=*#6n] [%=*#6i]", 1234.567, 1234.567); .EE .in .P produce la salida .P .in +4n .EX [€ **1234,57] [EUR **1 234,57] .EE .in .P en la configuración regional \fInl_NL\fP. Las configuraciones regionales \fIde_DE\fP, \fIde_CH\fP, \fIen_AU\fP e \fIen_GB\fP producen .P .in +4n .EX [ **1234,57 €] [ **1.234,57 EUR] [ Fr. **1234.57] [ CHF **1\[aq]234.57] [ $**1234.57] [ AUD**1,234.57] [ £**1234.57] [ GBP**1,234.57] .EE .in .SH "VÉASE TAMBIÉN" \fBduplocale\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3), \fBlocale\fP(7) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .