Este tópico descreve a sintaxe, os parâmetros e os valores de retorno das funções de string. Também apresenta exemplos de uso dessas funções.
substr
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | substr(s, i, j) |
| Descrição | Extrai partes de uma string. |
| Parâmetro |
|
| Valor de retorno | Retorna uma substring s[i, j] extraída da string source especificada por s. |
| Exemplo | |
concat
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | concat(s1, ...) |
| Descrição | Concatena strings. |
| Parâmetro | Strings a concatenar. É possível especificar uma ou mais strings. Valores numéricos também são aceitos. |
| Valor de retorno | Retorna a string concatenada. |
| Exemplo | |
upper
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | upper(s) |
| Descrição | Converte uma string para letras maiúsculas. |
| Parâmetro | s: a string a converter. |
| Valor de retorno | Retorna a string especificada pelo parâmetro s em letras maiúsculas. |
| Exemplo | |
lower
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | lower(s) |
| Descrição | Converte uma string para letras minúsculas. |
| Parâmetro | s: a string a converter. |
| Valor de retorno | Retorna a string especificada pelo parâmetro s em letras minúsculas. |
| Exemplo | |
len
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | len(s) |
| Descrição | Obtém o comprimento de uma string. |
| Parâmetro | s: a string a medir. |
| Valor de retorno | Retorna o comprimento da string especificada pelo parâmetro s. Tipo de dado: inteiro. |
| Exemplo | |
byte
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | byte(c) |
| Descrição | Obtém o valor ASCII de um caractere. |
| Parâmetro | c: o caractere cujo valor ASCII obter. Apenas um caractere pode ser especificado. |
| Valor de retorno | Retorna o valor ASCII do caractere especificado. Tipo de dado: numérico. |
| Exemplo | |
match_re
| Recurso | Descrição |
| Sintaxe | match_re(s, p [, o]) |
| Descrição | Verifica se uma string corresponde a uma expressão regular usando o mecanismo Perl Compatible Regular Expressions (PCRE). Para obter mais informações, consulte Sintaxe de expressões regulares PCRE. |
| Parâmetro |
|
| Valor de retorno | Retorna true se a string corresponder ao padrão e false caso contrário. |
| Exemplo | |
capture_re
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | capture_re(s, p [,init]) |
| Descrição | Captura as correspondências de uma string e retorna as substrings correspondentes. Para obter mais informações sobre PCRE, consulte Sintaxe PCRE. |
| Parâmetro |
|
| Valor de retorno | Retorna as substrings correspondentes no tipo dicionário se a string corresponder à expressão regular. Caso contrário, retorna um dicionário vazio. |
| Exemplo | |
gsub_re
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | gsub_re(subject, regex, replace [,option]) |
| Descrição | Substitui todas as correspondências em uma string e retorna a string após a substituição. Para obter mais informações sobre PCRE, consulte Sintaxe PCRE. |
| Parâmetro |
|
| Valor de retorno | Substitui todas as substrings que correspondem ao parâmetro regex especificado no parâmetro subject pelos valores definidos no parâmetro replace e retorna a string resultante. |
| Exemplo | |
split
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | split(s [,sep]) |
| Descrição | Divide uma string em um array de substrings e retorna o array. |
| Parâmetro |
|
| Valor de retorno | Retorna um array de pares chave-valor no tipo dicionário. O valor do parâmetro key é um número que começa em 1, por exemplo, [1]=xx e [2]=y. Se sep for deixado vazio, a string será dividida por caracteres de espaço em branco. Caracteres de espaço em branco incluem espaços e tabulações (\t). |
| Exemplo | |
split_as_key
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | split_as_key(s [,sep]) |
| Descrição | Divide uma string em um array de substrings e retorna o array. |
| Parâmetro |
|
| Valor de retorno | Retorna parâmetros de resposta da mesma forma que a função split(). No entanto, o parâmetro key recebe o nome de cada elemento dividido: Element 1 -> Element 2. |
| Exemplo | |
tohex
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | tohex(s) |
| Descrição | Converte uma string em uma string hexadecimal. |
| Parâmetro | s: a string a converter. |
| Valor de retorno | Retorna uma string hexadecimal convertida a partir da string especificada pelo parâmetro s. |
| Exemplo | |
tostring
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | tostring(a) |
| Descrição | Converte dados de qualquer tipo em uma string. |
| Parâmetro | a: os dados a converter. Tipo de dado: qualquer tipo. |
| Valor de retorno | Retorna uma string convertida a partir do valor especificado pelo parâmetro a. |
| Exemplo | |
tochar
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | tochar(n1, n2, ...) |
| Descrição |
|
| Parâmetro | nX: os inteiros a converter. É possível especificar um ou mais inteiros. |
| Valor de retorno | Retorna uma string convertida a partir de inteiros. |
| Exemplo | |
reverse
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | reverse(str) |
| Descrição | Inverte uma string. |
| Parâmetro | str: a string a inverter. |
| Valor de retorno | Retorna a string invertida. |
| Exemplo | Saída: |
find
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | string.find (s, substr, pos) |
| Descrição | Busca uma substring dentro de uma string especificada. |
| Parâmetro |
|
| Valor de retorno |
|
| Exemplo | Saída: |
format
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | format(fmt, ···) |
| Descrição | Formata os valores de um ou mais parâmetros. A string de formato é o primeiro parâmetro e deve ser uma string. Ela segue a especificação do parâmetro sprintf usado por funções na linguagem de programação C. A sintaxe de uma string de formato é: %[parâmetro][flag][largura do campo][.precisão]especificador.
|
| Parâmetro |
|
| Valor de retorno | Retorna uma string ASCII. |
| Exemplo | Saída: |
tobin
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | tobin(str) |
| Descrição | Converte uma string hexadecimal em uma string ASCII. |
| Parâmetro | str: a string hexadecimal a converter. Não diferencia maiúsculas de minúsculas. |
| Valor de retorno | Retorna uma string ASCII. |
| Exemplo | Saída: |
trim
A tabela a seguir detalha esta função.
| Recurso | Descrição |
| Sintaxe | trim(s, [, loc]) |
| Descrição | Remove todos os caracteres de espaço em branco antes ou depois da string especificada pelo parâmetro s e retorna a string sem esses caracteres. |
| Parâmetro |
|
| Valor de retorno | Retorna a string com os caracteres de espaço em branco especificados removidos. |
| Exemplo | Saída: |