Ir para o conteúdo

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 pesquisada
  • subStr: 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 string
  • de: 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 pesquisada
  • subStr: 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 linha
  • n: 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 linha
  • n: 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 linha
  • padChar: Uma string a ser usada para preencher os caracteres; se houver mais de um caractere, o primeiro caractere é usado
  • n: 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

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 linha
  • padChar: Uma string a ser usada para preencher os caracteres; se houver mais de um caractere, o primeiro caractere é usado
  • n: 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 dividida
  • delimiter: 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 matriz
  • qualifier: 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 aparada
  • trimChars: 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 linha
  • firstChars: O número de caracteres a serem excluídos da esquerda (início) da string
  • lastChars: 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 URL
  • paramName: 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 character
  • 2: 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