Bloco de Função STR_FORMAT
O bloco de função STR_FORMAT retorna uma string formatada.
Este bloco de função corresponde à função sprintf em C++.
Aviso: Este bloco de função pode ter mais de duas entradas. Você pode clicar com o botão direito do mouse no bloco de função para adicionar outra entrada.
Entrada Formato
A entrada define a formatação. Esta é composta por nenhuma ou várias instruções: caracteres normais (exceto %), que são copiados diretamente para o resultado, e instruções de conversão, cada uma com seus próprios parâmetros.
Neste caso, a instrução de conversão segue este protótipo:
%[ArgNum$][Flags][Weite][.Präzision]Spezifizierer.
ArgNum
Um inteiro seguido por um sinal de dólar $, que indica o número da entrada STR# a ser usada para a conversão.
Flags
| Flag | Descrição |
|---|---|
| - | Alinhado à esquerda dentro da largura de campo especificada; alinhado à direita é o padrão |
| + | Números positivos com um sinal de mais +; por padrão, apenas números negativos são exibidos com sinais negativos |
| (Espaço) | Preenche o resultado com espaços. Este é o padrão. |
| 0 | Preenche à esquerda com zeros. Com o especificador s, isso também pode preencher à direita com zeros. |
| '(Caractere) | Preenche o resultado com o caractere especificado. |
Weite
Um inteiro que indica quantos caracteres (mínimo) o resultado da conversão deve ter.
Präzision
O significado de um ponto . seguido por um inteiro depende do especificador:
- Para os especificadores e, E, f e F: Isso define o número de casas decimais a serem exibidas após o separador decimal (o padrão é 6).
- Para os especificadores g e G: O número máximo de casas decimais significativas a serem exibidas.
- Para o especificador s: Comporta-se como um ponto de corte, que define um número máximo de caracteres na string.
Aviso: Se o ponto for especificado sem um valor explícito para a precisão, 0 será assumido.
Spezifizierer
| Especificador | Descrição |
|---|---|
| % | Um caractere de porcentagem. Nenhum parâmetro necessário. |
| b | O parâmetro é tratado como um inteiro e exibido como um número binário. |
| c | O parâmetro é tratado como um inteiro e exibido como um caractere do conjunto de caracteres ASCII. |
| d | O parâmetro é tratado como um inteiro e exibido como um número decimal (com sinal). |
| e | O parâmetro é tratado como um número em notação científica (por exemplo, 1.2e+2). A especificação da precisão representa o número de caracteres após o ponto decimal. |
| E | Como o especificador e, mas escreve uma letra maiúscula (por exemplo, 1.2E+2). |
| f | O parâmetro é considerado um número de ponto flutuante e exibido como um número de ponto flutuante (dependendo da localidade). |
| F | O parâmetro é considerado um número de ponto flutuante e exibido como um número de ponto flutuante (independentemente da localidade). |
| g | Formato geral. Seja P a precisão, se não for zero, 6 se a precisão não for especificada ou 1 se a precisão for zero. Então, se uma conversão por meio de E tiver um expoente de X: Se P > X ≥ -4, a conversão é feita com o especificador f e precisão P - (X + 1). Caso contrário, como com o especificador e e precisão P - 1. |
| G | Como o especificador g, mas usa E e F. |
| o | O parâmetro é considerado um inteiro e exibido como um número octal. |
| s | O parâmetro é considerado uma string e exibido. |
| u | O parâmetro é considerado um inteiro e exibido como um número decimal sem sinal. |
| x | O parâmetro é considerado um inteiro e exibido como um número hexadecimal (com letras minúsculas). |
| X | O parâmetro é considerado um inteiro e exibido como um número hexadecimal (com letras maiúsculas). |
Atenção: O especificador c ignora o preenchimento e a largura.
Aviso: Tentar usar a combinação de strings com especificação de largura e conjuntos de caracteres que esperam mais de um byte por caractere resulta em comportamentos imprevisíveis.
Variáveis são convertidas para um tipo adequado para o especificador:
| Tipo | Especificador |
|---|---|
| String | s |
| Inteiro | d, u, c, o, x, X, b |
| Float | g, G, e, E, f, F |
Entrada STR1..STR#
A entrada ou as múltiplas entradas definem o valor a ser substituído na string especificada na entrada FORMAT.
Saída
Retorna a string gerada.