Funções de String¶
As funções de string são o mecanismo para a manipulação de strings em scripts.
CountSubString
¶
Declaração¶
int CountSubString(string str, string subStr)
Sintaxe¶
CountSubString(<str>, <subStr>)
Parâmetros Necessários¶
str:
Uma string a ser pesquisadasubStr:
A string a ser pesquisada
Descrição¶
Retorna o número de vezes que uma substring aparece em uma string.
Exemplos¶
CountSubString("Mississippi", "iss"); // Returns 2
DQuote
¶
Declaração¶
string DQuote(string str)
Sintaxe¶
DQuote(<str>)
Parâmetros Necessários¶
str:
Uma string com aspas duplas
Descrição¶
Coloca uma string entre aspas duplas e retorna o resultado. As aspas duplas incorporadas não são escapadas.
Exemplos¶
DQuote("any str"); // Returns ""any str""
DQuote('any "text" str');
// Returns ""any "text" str"" -- note that the embedded double quotes are not escaped
Nota
O par externo de aspas duplas nos exemplos acima é a indicação de um tipo de dados string e não é retornado como parte da própria string.
Format
¶
Declaração¶
string Format(string formatStr, type de)
Sintaxe¶
Format(<formatStr>, <de>)
Parâmetros Necessários¶
formatStr:
A string de formato para ser usado ao formatar a stringde:
Um elemento de dados; se necessário, será convertido em uma string antes de ser formatado
Descrição¶
Retorna uma string no formato especificado por uma string de formato.
A especificação do formato é a mesma usada nas Funções de data e hora; veja sua seção em strings de formato. É semelhante à biblioteca C padrão printf
especificação de formato.
Esta função pode ser usada para definir o formato de saída para um destino. É útil quando o formato de saída padrão do Jitterbit para um tipo de dados (como data ou duplo) não é o desejado. A chamada para o Format
a função deve ser a última chamada em uma fórmula de mapeamento para que seja o valor mapeado.
Exemplos¶
Format("'%5d'", 2); // Returns "' 2'"
Index
¶
Declaração¶
int Index(string str, string subStr[, int n])
Sintaxe¶
Index(<str>, <subStr>[, <n>])
Parâmetros Necessários¶
str:
Uma string a ser pesquisadasubStr:
A string a ser pesquisada
Parâmetros Opcionais¶
n:
A instância específica de interesse se houver mais de uma correspondência
Descrição¶
Retorna a posição de uma substring dentro de uma string.
Nos casos em que a substring aparece mais de uma vez na string principal, o terceiro argumento (n
) é usado para determinar qual instância específica da substring é de interesse.
- Se
n
<
0
, a contagem de instâncias começa no final da string principal. - Se
|n|
>
o número máximo de vezes que a substring aparece na string principal, a função retorna -1.
Caso contrário, a função retorna a posição do primeiro caractere da substring dentro da string principal (começando na posição 0).
Casos especiais a considerar:
- N = 0 retorna o mesmo resultado que n = 1
- Se
subStr
é uma string vazia (""
):- n >= 0 sempre retorna 0
- n \< 0 sempre retorna
Length(str)
Exemplos¶
Index("Mississippi", "s"); // Returns 2
// When called with only two arguments
// the optional third argument defaults to 1,
// resulting in the index of the first match being returned
Index("Mississippi", "iss", 3); // Returns -1
// Searching for the 3rd instance of "iss" within Mississippi
Index("Mississippi", "si", 2); // Returns 6
// The 2nd instance of the sub-string
// "si" starts at position 6 as the
// first letter "M" starts at position 0
Index("Mississippi", "", 1); // Returns 0
Index("Mississippi", "", -1); // Returns 11
IsValidString
¶
Declaração¶
bool IsValidString(string str)
Sintaxe¶
IsValidString(<str>)
Parâmetros Necessários¶
str:
Uma string a ser validada
Descrição¶
Retorna true se cada caractere em uma string for válido. Os caracteres válidos são os códigos ASCII de 32 a 126, inclusive, e qualquer caractere de avanço de linha (LF), retorno de carro (CR) ou aba (TAB).
Exemplos¶
IsValidString("An Invalid String™");
// Returns 0 (false), as the trademark symbol in this font is a code greater than 128
IsValidString("A Valid Broken
String");
// Returns 1 (true)
Left
¶
Declaração¶
string Left(string str, int n)
Sintaxe¶
Left(<str>, <n>)
Parâmetros Necessários¶
str:
Uma linhan:
O número de caracteres da extremidade esquerda a serem retornados
Descrição¶
devoluções n
caracteres de uma string, contando a partir da esquerda (o começo) de uma string.
Veja também o Mid
e Right
funções.
Nota
Se a string for uma string numérica que começa com um zero à esquerda, ela deve ser colocada entre aspas ou será interpretada como um número inteiro e um índice de caractere inicial diferente pode resultar.
Exemplos¶
Left("01234567890", 4);
// Returns "0123"
LPad
¶
Declaração¶
string LPad(string str, int n)
Sintaxe¶
LPad(<str>, <n>)
Parâmetros Necessários¶
str:
Uma linhan:
O número de caracteres da extremidade esquerda a serem retornados
Descrição¶
Adiciona espaços à esquerda (no início) de uma string até que a string contenha n
personagens. Strings contendo n
ou mais caracteres são truncados para n
personagens.
LPad(str, -n)
é o mesmo que RPad(str, n)
. Veja o RPad
função.
Exemplos¶
LPad("01234567", 9);
// Returns " 01234567"
// Adds one space to the left side
// of the original string
LPad("1234567890", 9);
// Returns "123456789"
LPadChar
¶
Declaração¶
string LPadChar(string str, string padChar, int n)
Sintaxe¶
LPadChar(<str>, <padChar>, <n>)
Parâmetros Necessários¶
str:
Uma linhapadChar:
Uma string a ser usada para preencher os caracteres; se houver mais de um caractere, o primeiro caractere é usadon:
O número de caracteres da extremidade esquerda a serem retornados
Descrição¶
Adiciona um caractere de preenchimento à esquerda (no início) de uma string até que a string contenha n
personagens. Strings contendo n
ou mais caracteres são truncados para n
personagens.
LPadChar(str, " ", n)
é o mesmo que LPad(str, n)
. Veja o LPad
função.
Exemplos¶
LPadChar(1234567, "0", 10);
// Returns "0001234567"
LPadChar(1234567, ".0", 10);
// Returns "...1234567"
LTrim
¶
Declaração¶
string LTrim(string str)
Sintaxe¶
LTrim(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Remove espaços em branco (espaços, tabulações) da esquerda (início) de uma string e retorna os caracteres restantes.
Exemplos¶
LTrim(" Hello World! ");
// Returns "Hello World! "
LTrim(" Hello World!");
// Removes the leading tab character
// and returns "Hello World!"
LTrimChars
¶
Declaração¶
string LTrimChars(string str, string trimChars)
Sintaxe¶
LTrimChars(<str>, <trimChars>)
Parâmetros Necessários¶
str:
Uma string a ser aparada a partir da esquerda (começo)**trimChars:
** Uma string de caracteres de corte a serem correspondidos; a ordem não importa
Descrição¶
Remove todos os caracteres iniciais em uma string da esquerda (o início) que correspondem aos caracteres de corte e retorna os caracteres restantes.
Essa função testa cada caractere inicial de uma string, começando na borda esquerda, e verifica se ele é encontrado nos caracteres de corte. Em caso afirmativo, ele é removido e o processo é repetido até que não haja mais correspondência.
Isso pode ser usado para aparar caracteres diferentes dos caracteres de espaço em branco padrão, como aparar dois-pontos à esquerda.
Veja também o RTrimChars
e TrimChars
funções.
Exemplos¶
LTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg::"
LTrimChars("// This is a comment", " /");
// Returns "This is a comment"
LTrimChars("// This is a comment", "/ ");
// Returns "This is a comment"
LTrimChars("// This is a comment", "/");
// Returns " This is a comment"
LTrimChars("// This is a comment", " ");
// Returns "// This is a comment"
// Returns the string unchanged as a space
// was not a leading character
Mid
¶
Declaração¶
string Mid(string str, int m, int n)
Sintaxe¶
Mid(<str>, <m>, <n>)
Parâmetros Necessários¶
-
str:
Uma string da qual extrair uma substring -
m
: A posição do caractere inicial baseado em zero para começar a extrair a substring -
n:
O comprimento (número de caracteres) da substring a ser extraída
Descrição¶
Retorna uma parte de uma string, começando com o caractere na posição m
por um comprimento de n
personagens.
Veja também o Left
e Right
funções.
Nota
Se a string for uma string numérica que começa com um zero à esquerda, ela deve ser colocada entre aspas ou será interpretada como um número inteiro e um índice de caractere inicial diferente pode resultar.
Exemplos¶
Mid("Jitterbit", 2, 3);
// Returns "tte"
Mid("01234567890", 7, 3);
// Returns "789"
// Passing the same string as an
// integer with a leading zero
// returns a different result
Mid(01234567890, 7, 3);
// Returns "890"
ParseURL
¶
Declaração¶
array ParseURL(string url)
Sintaxe¶
ParseURL(<url>)
Parâmetros Necessários¶
url:
Uma string contendo um URL para análise
Descrição¶
Analisa uma string de URL e retorna uma matriz de valores decodificados. Os valores são marcados para que possam ser recuperados por índice ou por nome de campo.
Ao recuperar valores do resultado, o caso de um nome de campo é ignorado. Veja também o URLDecode
e URLEncode
funções.
Exemplos¶
url = "http://hostname/user?email=john1990%40example.com&name=John%20Smith";
arr = ParseURL(url);
email = arr[0];
// "email" will be john1990@example.com
email = arr["email"];
// same as previous
name = arr["name"];
// "name" will be "John Smith"
name = arr["Name"];
// Same as previous;
// case is ignored for field names
Quote
¶
Declaração¶
string Quote(string str)
Sintaxe¶
Quote(<str>)
Parâmetros Necessários¶
str:
Uma string com aspas simples
Descrição¶
Coloca uma string entre aspas simples e retorna o resultado. Aspas simples incorporadas não são escapadas.
Exemplos¶
Quote("Any string");
// Returns "'Any string'"
Quote("Ain't escaped");
// Returns "'Ain't escaped'" -- note that the embedded quote is not escaped
Nota
O par externo de aspas duplas nos exemplos acima é a indicação de um tipo de dados string e não é retornado como parte da própria string.
RegExMatch
¶
Declaração¶
int RegExMatch(string str, string exp[, type var1,... type varN])
Sintaxe¶
RegExMatch(<str>, <exp>[, <var1>,... <varN>])
Parâmetros Necessários¶
-
str:
Uma string com aspas simples -
exp:
Uma expressão regular que consiste em grupos
Parâmetros Opcionais¶
var1...varN:
Um ou mais nomes de variáveis, para corresponder às subexpressões marcadas da expressão
Descrição¶
Corresponde a uma expressão regular com uma string de entrada, armazena as subexpressões marcadas em variáveis e retorna o número de correspondências.
Retorna o número total de subexpressões marcadas (que podem ser mais ou menos que o número de variáveis realmente fornecidas). Quaisquer correspondências adicionais que excedam o número de variáveis fornecidas são descartadas. Se não houver correspondências, -1
é devolvido.
A expressão regular segue a Sintaxe da biblioteca de expressão regular Boost. É uma variação da sintaxe de expressão regular Perl.
Os caracteres Unicode, incluindo símbolos como emoji, devem ser correspondidos usando seus caracteres literais e não usando sequências de escape Unicode. Por exemplo, o intervalo "[😀-🤯]"
(U+1F600 a U+1F92F) captura com sucesso o símbolo 🤔 (U+1F914) no meio.
Veja também o RegExReplace
função.
Exemplos¶
result = RegExMatch("[abc]", "(\\[)(.*)(\\])", "dummy", "value");
// Sets the global variable "$dummy" to "[".
// Sets the global variable "$value" to "abc".
// Returns 3 because the character "]"
// also matched the last sub-expression.
// However, as there are only two variable names,
// the last match is not saved to a variable.
Nota
"\"
(barra invertida) deve ser escapada em strings literais, pois é o caractere de escape. Para usar um "\"
, use uma barra invertida dupla: "\\"
.
RegExReplace
¶
Declaração¶
string RegExReplace(string str, string exp, string format)
Sintaxe¶
RegExReplace(<str>, <exp>, <format>)
Parâmetros Necessários¶
-
str:
Uma string a ser pesquisada e todas as substrings correspondentes substituídas -
exp:
A expressão regular na Sintaxe da biblioteca de expressão regular Boost para ser usado para corresponder a substrings da string -
format:
Uma string de formato na Sintaxe de string de formato estendido de reforço
Descrição¶
Substitui todas as substrings em uma string que correspondem a uma expressão, usando um formato especificado para substituir cada substring. Todas as seções da string que não correspondem à expressão são passadas para a string retornada inalterada.
A expressão regular segue a Sintaxe da biblioteca de expressão regular Boost. É uma variação da sintaxe de expressão regular Perl.
Os caracteres Unicode, incluindo símbolos como emoji, devem ser correspondidos usando seus caracteres literais e não usando sequências de escape Unicode. Por exemplo, o intervalo "[😀-🤯]"
(U+1F600 a U+1F92F) captura com sucesso o símbolo 🤔 (U+1F914) no meio.
A string de formato segue a Sintaxe de String de Formato Estendida Boost. Se a string de formato for uma string vazia (""
) então uma correspondência não produzirá nenhum resultado para essa substring.
Veja também RegExMatch
função.
Exemplos¶
// To remove any whitespace from a string:
RegExReplace(" t e st ss s", "\\s", "");
// Returns "testsss"
// To swap the order of sub-strings:
RegExReplace("abc(first)123(second)xyz",
"(.*)(\\(.*\\))(.*)(\\(.*\\))(.*)",
"\\1aaa\\4\\2\\3\\5");
// Returns "abcaaa(second)(first)123xyz"
// To pass backslashes in matches, multiple instances may be required.
// In the "r" example, three backslashes are used and then doubled.
// The first two backslashes convert into a single backslash,
// which then escapes the next backslash.
// All three backslashes are then doubled for Jitterbit script.
s = "test\\ing"; // "test\ing";
t = RegExReplace(s, "\\\\", "!"); // "test\ing" -> "test!ing"
r = RegExReplace(t, "!", "\\\\\\"); // "test!ing" -> "test\\ing"
Nota
"\"
(barra invertida) deve ser escapada em strings literais, pois é o caractere de escape. Para usar um "\"
, use uma barra invertida dupla: "\\"
.
Replace
¶
Declaração¶
string Replace(string str, string old, string new)
Sintaxe¶
Replace(<str>, <old>, <new>)
Parâmetros Necessários¶
-
str:
Uma string a ser pesquisada e as substrings correspondentes substituídas -
old:
Uma string a ser usada para a correspondência -
new:
Uma string a ser usada como substituição para quaisquer correspondências encontradas
Descrição¶
Pesquisa uma string por substrings correspondentes ao argumento "antigo" e substitui uma substring correspondente pelo argumento "novo".
Para operações de pesquisa e substituição mais complexas, consulte o RegExReplace
função.
Exemplos¶
Replace("Monday Tuesday", "day", "day night,");
// Returns "Monday night, Tuesday night,"
Right
¶
Declaração¶
string Right(string str, int n)
Sintaxe¶
Right(<str>, <n>)
Parâmetros Necessários¶
-
str:
Uma linha -
n:
O número de caracteres da extremidade direita a serem retornados
Descrição¶
devoluções n
caracteres de uma string, contando a partir da direita (o final) de uma string.
Veja também o Left
e Mid
funções.
Nota
Se a string for uma string numérica que começa com um zero à esquerda, ela deve ser colocada entre aspas ou será interpretada como um número inteiro e um índice de caractere inicial diferente pode resultar.
Exemplos¶
Right("01234567890",4);
// Returns "7890"
RPad
¶
Declaração¶
string RPad(string s, int n)
Sintaxe¶
string RPad(string s, int n)
Parâmetros Necessários¶
-
str:
Uma linha -
n:
O número de caracteres da extremidade direita a serem retornados
Descrição¶
Adiciona espaços à direita (no final) de uma string até que a string contenha n
personagens. Strings contendo n
ou mais caracteres são truncados para n
personagens.
RPad(str, -n)
é o mesmo que LPad(str, n)
. Veja o LPad
função.
Exemplos¶
RPad("01234567",9);
// Returns "01234567 "
RPadChar
¶
Declaração¶
string RPadChar(string str, string padChar, int n)
Sintaxe¶
RPadChar(<str>, <padChar>, <n>)
Parâmetros Necessários¶
str:
Uma linhapadChar:
Uma string a ser usada para preencher os caracteres; se houver mais de um caractere, o primeiro caractere é usadon:
O número de caracteres da extremidade direita a serem retornados
Descrição¶
Adiciona um caractere de preenchimento à direita (no final) de uma string até que a string contenha n
personagens. Strings contendo n
ou mais caracteres são truncados para n
personagens.
RPadChar(str, " ", n)
é o mesmo que RPad(str, n)
. Veja o RPad
função.
Exemplos¶
RPadChar(1234567, "0", 10);
// Returns "1234567000"
RTrim
¶
Declaração¶
string RTrim(string str)
Sintaxe¶
RTrim(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Remove espaços em branco (espaços, tabulações) à direita (final) de uma string e retorna os caracteres restantes.
Exemplos¶
RTrim(" Hello World! ");
// Returns " Hello World!"
RTrim("Hello World! ");
// Removes the trailing tab character
// and returns "Hello World!"
RTrimChars
¶
Declaração¶
string RTrimChars(string str, string trimChars)
Sintaxe¶
RTrimChars(<str>, <trimChars>)
Parâmetros Necessários¶
str:
Uma corda, a ser aparada a partir da direita (final)**trimChars:
** Uma string de caracteres de corte a serem correspondidos; a ordem não importa
Descrição¶
Remove quaisquer caracteres à direita em uma string do final que correspondam aos caracteres de corte e retorna os caracteres restantes.
Essa função testa cada caractere à direita de uma string, começando na borda direita, e verifica se ele é encontrado nos caracteres de corte. Em caso afirmativo, ele é removido e o processo é repetido até que não haja mais correspondência.
Isso pode ser usado para aparar caracteres diferentes dos caracteres de espaço em branco padrão, como aparar dois-pontos à direita.
Veja também o LTrimChars
e TrimChars
funções.
Exemplos¶
RTrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "::StartMsg :: Hello :: EndMsg"
RTrimChars("// This is a comment //", " /");
// Returns "// This is a comment"
RTrimChars("// This is a comment //", "/");
// Returns "// This is a comment "
RTrimChars("// This is a comment //", " ");
// Returns "// This is a comment //"
// Returns the string unchanged as a space
// was not a trailing character
Split
¶
Declaração¶
array Split(string str, string delimiter)
Sintaxe¶
Split(<str>, <delimiter>)
Parâmetros Necessários¶
str:
Uma string a ser divididadelimiter:
Uma string de a ser correspondida como a divisão entre cada elemento da matriz
Descrição¶
Divide uma string usando uma string delimitadora, retornando o resultado como uma matriz.
Retorna o resultado em um array de tamanho igual ao número de delimitadores mais um. Se a expressão terminar com o delimitador, o tamanho do array é igual ao número de delimitadores (o último valor vazio é ignorado). Se a string não contiver delimitadores, uma matriz de tamanho um será retornada contendo a string original.
Exemplos¶
arr = Split("Donald,Minnie,Goofy", ",");
donald = arr[0];
minnie = arr[1];
goofy = arr[2];
Split("Donald.,Minnie.,Goofy.,", ".,");
// Returns the array {Donald, Minnie, Goofy}
Este exemplo converte um endereço IP ("10.6.10.1"
) para um único inteiro (168167937
):
// Logic: (first octet * 16777216) + (second octet * 65536) +
// (third octet * 256) + (fourth octet)
ip = "10.6.10.1";
ipList = Split(ip, ".");
(Int(ipList[0]) * 16777216) + (Int(ipList[1]) * 65536) +
(Int(ipList[2]) * 256) + (Int(ipList[3]));
SplitCSV
¶
Declaração¶
array Split(string str[, string delimiter, int qualifier])
Sintaxe¶
Split(<str>[, <delimiter>, <qualifier>])
Parâmetros Necessários¶
str:
Uma string a ser dividida
Parâmetros Opcionais¶
delimiter:
Uma string de a ser correspondida como a divisão entre cada elemento da matrizqualifier:
Uma string de a ser correspondida como a divisão entre cada elemento da matriz
Descrição¶
Divide uma string formatada em CSV e retorna uma matriz com os valores de colunas individuais.
Por padrão, o delimitador é uma vírgula (,) e o qualificador de string é uma aspa dupla ("). Isso pode ser alterado especificando o segundo e o terceiro argumentos opcionais, respectivamente.
Nota
Os parâmetros opcionais (delimitador e qualificador) podem ser especificados com um inteiro correspondente ao código ASCII do delimitador ou caractere qualificador.
Exemplos¶
arr = SplitCSV('"Donald","Minnie ""The Mouse""", Goofy');
donald = arr[0];
// Returns "Donald"
minnie = arr[1];
// Returns "Minnie ""The Mouse"""
goofy = arr[2];
// Returns "Goofy"
StringLength
¶
Declaração¶
int StringLength(string str)
array StringLength(array arr)
Sintaxe¶
StringLength(string str)
StringLength(array arr)
Parâmetros Necessários¶
-
str:
(Primeira forma) Uma string -
arr:
(Segunda forma) Uma matriz
Descrição¶
Retorna o comprimento de uma string.
A função retorna uma matriz se o argumento for uma matriz, com cada elemento da matriz retornada com o comprimento do elemento correspondente da matriz do argumento. O Length
a função retorna o comprimento de uma matriz em vez do comprimento dos elementos individuais.
Exemplos¶
arr = {a="abcd", b="e"};
StringLength(arr);
// Returns the array {4,1}
Length(arr);
// Returns 2
ToLower
¶
Declaração¶
string ToLower(string str)
Sintaxe¶
ToLower(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Converte todos os caracteres ASCII maiúsculos (A a Z, ASCII 65 a 90) em uma string para letras minúsculas.
Exemplos¶
ToLower("Hello World!");
// Returns "hello world!"
ToProper
¶
Declaração¶
string ToProper(string str)
Sintaxe¶
ToProper(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Converte uma string para maiúsculas e minúsculas (a primeira letra de cada palavra sendo maiúscula). Isso é diferente do caso do título, que apenas coloca em maiúscula palavras selecionadas e mais longas em uma string.
Aviso
O ToProper()
função é tal que nomes como "mccartney"
começando com "mc"
são apenas convertidos corretamente para "McCartney"
se a palavra for precedida por um caractere de espaço. Para ter uma string que começa com "mc"
como "mccartney, paul"
convertido corretamente para "McCartney, Paul"
, use um código como este para adicionar um espaço anterior e removê-lo imediatamente:
s = "mccartney, paul";
s = Right( ToProper( " " + s), Length(s));
Exemplos¶
ToProper("bob dylan");
// Returns "Bob Dylan"
ToProper("arthur c. Clarke");
// Returns "Arthur C. Clarke"
ToProper("Peter o'toole");
// Returns "Peter O'Toole"
ToUpper
¶
Declaração¶
string ToUpper(string <str>)
Sintaxe¶
ToUpper(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Converte todos os caracteres ASCII minúsculos (a a z, ASCII 97 a 122) em uma string para maiúsculos.
Exemplos¶
ToUpper("Hello World!");
// Returns "HELLO WORLD!"
Trim
¶
Declaração¶
string Trim(string str)
Sintaxe¶
Trim(<str>)
Parâmetros Necessários¶
str:
Uma linha
Descrição¶
Remove os espaços em branco do início e do fim de uma string e retorna os caracteres restantes.
Exemplos¶
Trim(" Hello World! ");
// Returns "Hello World!"
TrimChars
¶
Declaração¶
string TrimChars(string str, string trimChars)
Sintaxe¶
TrimChars(<str>, <trimChars>)
Parâmetros Necessários¶
str:
Uma corda a ser aparadatrimChars:
Uma string de caracteres de corte a serem correspondidos; a ordem não importa
Descrição¶
Remove qualquer caractere inicial ou final em uma string que corresponda aos caracteres de corte e retorna os caracteres restantes.
Essa função testa cada caractere inicial e final de uma string e verifica se ele é encontrado nos caracteres de corte. Em caso afirmativo, ele é removido e o processo é repetido até que não haja mais correspondências.
Isso pode ser usado para aparar caracteres diferentes dos caracteres de espaço em branco padrão, como aparar dois-pontos.
Veja também o LTrimChars
e RTrimChars
funções.
Exemplos¶
TrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg"
TrimChars("/* This is a comment */", " /*");
// Returns "This is a comment"
Truncate
¶
Declaração¶
string Truncate(string str, int firstChars, int lastChars)
Sintaxe¶
Truncate(<str>, <firstChars>, <lastChars>)
Parâmetros Necessários¶
str:
Uma linhafirstChars:
O número de caracteres a serem excluídos da esquerda (início) da stringlastChars:
O número de caracteres a serem excluídos à direita (final) da string
Descrição¶
Exclui firstChar
caracteres da esquerda (o começo) e lastChars
caracteres da direita (final) de uma string e retorna a string restante.
Veja também o Left
e Right
funções.
Exemplos¶
Truncate("a,b,c,", 2, 1);
// Returns "b,c"
URLDecode
¶
Declaração¶
string URLDecode(string url, string paramName)
Sintaxe¶
URLDecode(<url>, <paramName>)
Parâmetros Necessários¶
url:
Uma string contendo um URLparamName:
O nome de um parâmetro na URL cujo valor deve ser retornado
Descrição¶
Analisa uma string de URL e retorna o valor decodificado do parâmetro de URL com o nome especificado. As maiúsculas e minúsculas do nome são ignoradas. Se o nome não for encontrado nos parâmetros da URL, uma string vazia (""
) é retornado.
Veja também o ParseURL
e URLEncode
funções.
Exemplos¶
url = "http://hostname/user?email=john1990%40gmail.com&name=John%20Smith";
URLDecode(url, "name");
// Returns "John Smith"
URLEncode
¶
Declaração¶
string URLEncode(string str[, int encodingOption])
Sintaxe¶
URLEncode(<str>[, <encodingOption>])
Parâmetros Necessários¶
url:
Uma string contendo um valor a ser codificado seguindo as regras de RFC 1738
Parâmetros Opcionais¶
encodingOption:
Um inteiro (0 - 3) que especifica a codificação a ser usada. O valor padrão é 0. Veja a lista abaixo.
Descrição¶
Codifica uma string seguindo RFC 1738.
Os valores válidos para a opção de codificação opcional são:
0:
Codificação de URL padrão. Codifica caracteres de controle ASCII, caracteres não ASCII, caracteres "reservados" e caracteres "inseguros". Esta é a codificação padrão se a opção for omitida.1:
Não codifique caracteres "inseguros": " \< ;> ; # % { } | \ ^ \~ [ ] ` and the space character2:
Don't encode "reserved" characters: ; / ? : @ & =3:
Don't encode "unsafe" characters and "reserved" characters
These characters are considered "safe" and are never encoded: $ - _ . + ! * ' ( ) ,
See also the ParseURL
and funções URLDecode
.
Exemplos¶
value1 = "FIRST#"; value2 = "<LAST>";
url = "http://hostname/get_doc?" +
"name1=" + URLEncode(value1) +
"&name2=" + URLEncode(value2);
// Returns
// http://hostname/get_doc?name1=FIRST%23&name2=%3CLAST%3E