Funciones de Cadena¶

Las funciones de cadena son el mecanismo para la manipulación de cadenas en secuencias de comandos.

CountSubString¶

Declaración¶

int CountSubString(string str, string subStr)

Sintaxis¶

CountSubString(<str>, <subStr>)

Parámetros Requeridos¶

• str: Una cadena para buscar
• subStr: La cadena con la que buscar

Descripción¶

Devuelve el número de veces que aparece una subcadena en una cadena.

Ejemplos¶

CountSubString("Mississippi", "iss"); // Returns 2

DQuote¶

Declaración¶

string DQuote(string str)

Sintaxis¶

DQuote(<str>)

Parámetros Requeridos¶

• str: Una cadena entre comillas dobles

Descripción¶

Coloca una cadena entre comillas dobles y devuelve el resultado. Las comillas dobles incrustadas no se escapan.

Ejemplos¶

DQuote("any str"); // Returns ""any str""

DQuote('any "text" str');
// Returns ""any "text" str"" -- note that the embedded double quotes are not escaped

Format¶

Declaración¶

string Format(string formatStr, type de)

Sintaxis¶

Format(<formatStr>, <de>)

Parámetros Requeridos¶

• formatStr: La cadena de formato que se utilizará al formatear la cadena
• de: Un elemento de datos; si es necesario, se convertirá en una cadena antes de formatearlo

Descripción¶

Devuelve una cadena en el formato especificado por una cadena de formato.

La especificación de formato es la misma que se utiliza en las Funciones de fecha y hora; consulte su sección sobre cadenas de formato. Es similar a la biblioteca C estándar especificación de formato printf.

Esta función se puede utilizar para configurar el formato de salida de un objetivo. Es útil cuando el formato de salida predeterminado de Jitterbit para un tipo de datos (como fecha o doble) no es el deseado. El llamado a la Format La función debe ser la última llamada en una fórmula de mapeo para que sea el valor mapeado.

Ejemplos¶

Format("'%5d'", 2); // Returns "'    2'"

Index¶

Declaración¶

int Index(string str, string subStr[, int n])

Sintaxis¶

Index(<str>, <subStr>[, <n>])

Parámetros Requeridos¶

• str: Una cadena para buscar
• subStr: La cadena con la que buscar

Parámetros Opcionales¶

• n: La instancia específica de interés si hay más de una coincidencia.

Descripción¶

Devuelve la posición de una subcadena dentro de una cadena.

En los casos en que la subcadena aparece más de una vez en la cadena principal, el tercer argumento (n) se utiliza para determinar qué instancia específica de la subcadena es de interés.

• Si n < 0, el recuento de instancias comienza desde el final de la cadena principal.
• Si |n| > el número máximo de veces que aparece la subcadena en la cadena principal, la función devuelve -1.

De lo contrario, la función devuelve la posición del primer carácter de la subcadena dentro de la cadena principal (comenzando en la posición 0).

Casos especiales a considerar:

• n = 0 devuelve el mismo resultado que n = 1

• Si subStr es una cadena vacía (""):

  • n >= 0 siempre devuelve 0

  • n < 0 siempre regresa Length(str)

Ejemplos¶

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¶

Declaración¶

bool IsValidString(string str)

Sintaxis¶

IsValidString(<str>)

Parámetros Requeridos¶

• str: Una cadena para validar

Descripción¶

Devuelve verdadero si cada carácter de una cadena es válido. Los caracteres válidos son los códigos ASCII del 32 al 126 inclusive y cualquiera de los caracteres de avance de línea (LF), retorno de carro (CR) o pestaña (TAB).

Ejemplos¶

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¶

Declaración¶

string Left(string str, int n)

Sintaxis¶

Left(<str>, <n>)

Parámetros Requeridos¶

• str: Una cuerda
• n: El número de caracteres del extremo izquierdo que se devolverán

Descripción¶

Devoluciones n caracteres de una cadena, contando desde la izquierda (el principio) de una cadena.

Ver también el Mid y Right funciones.

Ejemplos¶

Left("01234567890", 4);
// Returns "0123"

LPad¶

Declaración¶

string LPad(string str, int n)

Sintaxis¶

LPad(<str>, <n>)

Parámetros Requeridos¶

• str: Una cuerda
• n: El número de caracteres del extremo izquierdo que se devolverán

Descripción¶

Agrega espacios a la izquierda (el comienzo) de una cadena hasta que la cadena contenga n caracteres. Cadenas que contienen n o más caracteres se truncan a n caracteres.

LPad(str, -n) es lo mismo que RPad(str, n). Ver el RPad función.

Ejemplos¶

LPad("01234567", 9);
// Returns " 01234567"
// Adds one space to the left side
// of the original string

LPad("1234567890", 9);
// Returns "123456789"

LPadChar¶

Declaración¶

string LPadChar(string str, string padChar, int n)

Sintaxis¶

LPadChar(<str>, <padChar>, <n>)

Parámetros Requeridos¶

• str: Una cuerda
• padChar: Una cadena que se utilizará para rellenar caracteres; si hay más de un carácter, se utiliza el primero
• n: El número de caracteres del extremo izquierdo que se devolverán

Descripción¶

Agrega un carácter de relleno a la izquierda (el comienzo) de una cadena hasta que la cadena contenga n caracteres. Cadenas que contienen n o más caracteres se truncan a n caracteres.

LPadChar(str, " ", n) es lo mismo que LPad(str, n). Ver el LPad función.

Ejemplos¶

LPadChar(1234567, "0", 10);
// Returns "0001234567"
LPadChar(1234567, ".0", 10);
// Returns "...1234567"

LTrim¶

Declaración¶

string LTrim(string str)

Sintaxis¶

LTrim(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Elimina los espacios en blanco (espacios, tabulaciones) de la izquierda (el principio) de una cadena y devuelve los caracteres restantes.

Ejemplos¶

LTrim(" Hello World!  ");
// Returns "Hello World!  "

LTrim("    Hello World!");
// Removes the leading tab character
// and returns "Hello World!"

LTrimChars¶

Declaración¶

string LTrimChars(string str, string trimChars)

Sintaxis¶

LTrimChars(<str>, <trimChars>)

Parámetros Requeridos¶

• str: Una cuerda para recortar desde la izquierda (el principio)**
  
• trimChars: Una cadena de caracteres de recorte que deben coincidir; El orden no importa

Descripción¶

Elimina los caracteres iniciales de una cadena desde la izquierda (el principio) que coinciden con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter inicial de una cadena, comenzando en el borde izquierdo, y ve si se encuentra en los caracteres de recorte. Si es así, se elimina y se repite el proceso hasta que ya no haya coincidencias.

Esto se puede utilizar para recortar caracteres distintos de los espacios en blanco predeterminados, como recortar los dos puntos iniciales.

Ver también el RTrimChars y TrimChars funciones.

Ejemplos¶

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¶

Declaración¶

string Mid(string str, int m, int n)

Sintaxis¶

Mid(<str>, <m>, <n>)

Parámetros Requeridos¶

• str: Una cadena de la cual extraer una subcadena

• m: La posición del carácter inicial de base cero para comenzar a extraer la subcadena

• n: La longitud (número de caracteres) de la subcadena que se extraerá

Descripción¶

Devuelve una parte de una cadena, comenzando con el carácter en la posición m por una longitud de n caracteres.

Ver también el Left y Right funciones.

Ejemplos¶

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¶

Declaración¶

array ParseURL(string url)

Sintaxis¶

ParseURL(<url>)

Parámetros Requeridos¶

• url: Una cadena que contiene una URL para analizar

Descripción¶

Analiza una cadena de URL y devuelve una matriz de valores decodificados. Los valores están etiquetados para que puedan recuperarse por índice o por nombre de campo.

Al recuperar valores del resultado, se ignora el caso del nombre de un campo. Ver también el URLDecode y URLEncode funciones.

Ejemplos¶

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¶

Declaración¶

string Quote(string str)

Sintaxis¶

Quote(<str>)

Parámetros Requeridos¶

• str: Una cadena entre comillas simples

Descripción¶

Coloca una cadena entre comillas simples y devuelve el resultado. Las comillas simples incrustadas no se escapan.

Ejemplos¶

Quote("Any string");
// Returns "'Any string'"

Quote("Ain't escaped");
// Returns "'Ain't escaped'" -- note that the embedded quote is not escaped.

RegExMatch¶

Declaración¶

int RegExMatch(string str, string exp[, type var1,... type varN])

Sintaxis¶

RegExMatch(<str>, <exp>[, <var1>,... <varN>])

Parámetros Requeridos¶

• str: Una cadena entre comillas simples

• exp: Una expresión regular que consta de grupos.

Parámetros Opcionales¶

• var1...varN: Uno o más nombres de variables, que deben coincidir con las subexpresiones marcadas de la expresión.

Descripción¶

Hace coincidir una expresión regular con una cadena de entrada, almacena las subexpresiones marcadas en variables y devuelve el número de coincidencias.

Devuelve el número total de subexpresiones marcadas (que podría ser mayor o menor que el número de variables realmente proporcionadas). Cualquier coincidencia adicional que supere el número de variables proporcionadas se descarta. Si no hay coincidencias, -1 es regresado.

La expresión regular sigue la sintaxis de biblioteca de expresiones regulares Boost. Es una variación de la sintaxis de expresión regular de Perl.

Los caracteres Unicode, incluidos símbolos como emoji, deben coincidir utilizando sus caracteres literales y no utilizando secuencias de escape Unicode. Por ejemplo, el rango "[😀-🤯]" (U+1F600 a U+1F92F) captura con éxito el símbolo 🤔 (U+1F914) en el medio.

Ver también el RegExReplace función.

Ejemplos¶

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.

RegExReplace¶

Declaración¶

string RegExReplace(string str, string exp, string format)

Sintaxis¶

RegExReplace(<str>, <exp>, <format>)

Parámetros Requeridos¶

• str: Una cadena que se buscará y se reemplazarán las subcadenas coincidentes

• exp: La expresión regular en Aumentar la sintaxis de la biblioteca de expresiones regulares que se utilizará para hacer coincidir las subcadenas de la cadena

• format: Una cadena de formato en la Sintaxis de cadena de formato extendido de Boost

Descripción¶

Reemplaza todas las subcadenas de una cadena que coinciden con una expresión, utilizando un formato específico para reemplazar cada subcadena. Cualquier sección de la cadena que no coincida con la expresión se pasa a la cadena devuelta sin cambios.

La expresión regular sigue la sintaxis de biblioteca de expresiones regulares Boost. Es una variación de la sintaxis de expresión regular de Perl.

Los caracteres Unicode, incluidos símbolos como emoji, deben coincidir utilizando sus caracteres literales y no utilizando secuencias de escape Unicode. Por ejemplo, el rango "[😀-🤯]" (U+1F600 a U+1F92F) captura con éxito el símbolo 🤔 (U+1F914) en el medio.

La cadena de formato sigue la Sintaxis de cadena de formato extendido Boost. Si la cadena de formato es una cadena vacía ("") entonces una coincidencia no produce ningún resultado para esa subcadena.

Ver también el RegExMatch función.

Ejemplos¶

// 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"

Replace¶

Declaración¶

string Replace(string str, string old, string new)

Sintaxis¶

Replace(<str>, <old>, <new>)

Parámetros Requeridos¶

• str: Una cadena que se buscará y se reemplazarán las subcadenas coincidentes

• old: Una cadena que se utilizará para el partido.

• new: Una cadena que se utilizará como reemplazo de cualquier coincidencia encontrada.

Descripción¶

Busca en una cadena subcadenas que coincidan con el argumento "antiguo" y reemplaza una subcadena coincidente con el argumento "nuevo".

Para operaciones de búsqueda y reemplazo más complejas, consulte la RegExReplace función.

Ejemplos¶

Replace("Monday Tuesday", "day", "day night,");
// Returns "Monday night, Tuesday night,"

Right¶

Declaración¶

string Right(string str, int n)

Sintaxis¶

Right(<str>, <n>)

Parámetros Requeridos¶

• str: Una cuerda

• n: El número de caracteres del extremo derecho que se devolverán

Descripción¶

Devoluciones n caracteres de una cadena, contando desde la derecha (el final) de una cadena.

Ver también el Left y Mid funciones.

Ejemplos¶

Right("01234567890",4);
// Returns "7890"

RPad¶

Declaración¶

string RPad(string s, int n)

Sintaxis¶

string RPad(string s, int n)

Parámetros Requeridos¶

• str: Una cuerda

• n: El número de caracteres del extremo derecho que se devolverán

Descripción¶

Agrega espacios a la derecha (el final) de una cadena hasta que la cadena contenga n caracteres. Cadenas que contienen n o más caracteres se truncan a n caracteres.

RPad(str, -n) es lo mismo que LPad(str, n). Ver el LPad función.

Ejemplos¶

RPad("01234567",9);
// Returns "01234567 "

RPadChar¶

Declaración¶

string RPadChar(string str, string padChar, int n)

Sintaxis¶

RPadChar(<str>, <padChar>, <n>)

Parámetros Requeridos¶

• str: Una cuerda
• padChar: Una cadena que se utilizará para rellenar caracteres; si hay más de un carácter, se utiliza el primero
• n: El número de caracteres del extremo derecho que se devolverán

Descripción¶

Agrega un carácter de relleno a la derecha (el final) de una cadena hasta que la cadena contenga n caracteres. Cadenas que contienen n o más caracteres se truncan a n caracteres.

RPadChar(str, " ", n) es lo mismo que RPad(str, n). Ver el RPad función.

Ejemplos¶

RPadChar(1234567, "0", 10);
// Returns "1234567000"

RTrim¶

Declaración¶

string RTrim(string str)

Sintaxis¶

RTrim(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Elimina los espacios en blanco (espacios, tabulaciones) de la derecha (el final) de una cadena y devuelve los caracteres restantes.

Ejemplos¶

RTrim(" Hello World!  ");
// Returns " Hello World!"

RTrim("Hello World!    ");
// Removes the trailing tab character
// and returns "Hello World!"

RTrimChars¶

Declaración¶

string RTrimChars(string str, string trimChars)

Sintaxis¶

RTrimChars(<str>, <trimChars>)

Parámetros Requeridos¶

• str: Una cuerda, que se recortará desde la derecha (el extremo)**
  
• trimChars:** Una cadena de caracteres de recorte que deben coincidir; El orden no importa

Descripción¶

Elimina los caracteres finales de una cadena desde el final que coinciden con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter final de una cadena, comenzando en el borde derecho, y ve si se encuentra en los caracteres de recorte. Si es así, se elimina y se repite el proceso hasta que ya no haya coincidencias.

Esto se puede utilizar para recortar caracteres distintos de los espacios en blanco predeterminados, como recortar los dos puntos finales.

Ver también el LTrimChars y TrimChars funciones.

Ejemplos¶

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¶

Declaración¶

array Split(string str, string delimiter)

Sintaxis¶

Split(<str>, <delimiter>)

Parámetros Requeridos¶

• str: Una cadena para dividir
• delimiter: Una cadena que debe coincidir como división entre cada elemento de la matriz

Descripción¶

Divide una cadena usando una cadena delimitadora y devuelve el resultado como una matriz.

Devuelve el resultado en una matriz de tamaño igual al número de delimitadores más uno. Si la expresión termina con el delimitador, el tamaño de la matriz es igual al número de delimitadores (se ignora el último valor vacío). Si la cadena no contiene delimitadores, se devuelve una matriz de tamaño uno que contiene la cadena original.

Ejemplos¶

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 ejemplo convierte una dirección IP ("10.6.10.1") a un solo número entero (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¶

Declaración¶

array Split(string str[, string delimiter, int qualifier])

Sintaxis¶

Split(<str>[, <delimiter>, <qualifier>])

Parámetros Requeridos¶

• str: Una cadena para dividir

Parámetros Opcionales¶

• delimiter: Una cadena que debe coincidir como división entre cada elemento de la matriz
• qualifier: Una cadena que debe coincidir como división entre cada elemento de la matriz

Descripción¶

Divide una cadena con formato CSV y devuelve una matriz con los valores de las columnas individuales.

De forma predeterminada, el delimitador es una coma (,) y el calificador de cadena es una comilla doble ("). Esto se puede cambiar especificando el segundo y tercer argumento opcionales respectivamente.

Ejemplos¶

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¶

Declaración¶

int StringLength(string str)

array StringLength(array arr)

Sintaxis¶

StringLength(string str)

StringLength(array arr)

Parámetros Requeridos¶

• str: (Primera forma) Una cadena

• arr: (Segunda forma) Una matriz

Descripción¶

Devuelve la longitud de una cadena.

La función devuelve una matriz si el argumento es una matriz, y cada elemento de la matriz devuelta tiene la longitud del elemento correspondiente de la matriz de argumentos. El Length La función devuelve la longitud de una matriz en lugar de la longitud de los elementos individuales.

Ejemplos¶

arr = {a="abcd", b="e"};

StringLength(arr);
// Returns the array {4,1}

Length(arr);
// Returns 2

ToLower¶

Declaración¶

string ToLower(string str)

Sintaxis¶

ToLower(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Convierte todos los caracteres ASCII en mayúsculas (A a Z, ASCII 65 a 90) en una cadena a minúsculas.

Ejemplos¶

ToLower("Hello World!");
// Returns "hello world!"

ToProper¶

Declaración¶

string ToProper(string str)

Sintaxis¶

ToProper(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Convierte una cadena a mayúsculas y minúsculas (la primera letra de cada palabra está en mayúscula). Esto es distinto del caso de título, que solo pone en mayúscula las palabras seleccionadas y más largas en una cadena.

s = "mccartney, paul";
s = Right( ToProper( " " + s), Length(s));

Ejemplos¶

ToProper("bob dylan");
// Returns "Bob Dylan"
ToProper("arthur c. Clarke");
// Returns "Arthur C. Clarke"
ToProper("Peter o'toole");
// Returns "Peter O'Toole"

ToUpper¶

Declaración¶

string ToUpper(string <str>)

Sintaxis¶

ToUpper(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Convierte todos los caracteres ASCII en minúscula (a a z, ASCII 97 a 122) en una cadena a mayúsculas.

Ejemplos¶

ToUpper("Hello World!");
// Returns "HELLO WORLD!"

Trim¶

Declaración¶

string Trim(string str)

Sintaxis¶

Trim(<str>)

Parámetros Requeridos¶

• str: Una cuerda

Descripción¶

Elimina los espacios en blanco del principio y el final de una cadena y devuelve los caracteres restantes.

Ejemplos¶

Trim(" Hello World! ");
// Returns "Hello World!"

TrimChars¶

Declaración¶

string TrimChars(string str, string trimChars)

Sintaxis¶

TrimChars(<str>, <trimChars>)

Parámetros Requeridos¶

• str: Una cuerda para recortar
• trimChars: Una cadena de caracteres de recorte que deben coincidir; El orden no importa

Descripción¶

Elimina los caracteres iniciales o finales de una cadena que coinciden con los de los caracteres de recorte y devuelve los caracteres restantes.

Esta función prueba cada carácter inicial y final de una cadena y ve si se encuentra en los caracteres de recorte. Si es así, se elimina y se repite el proceso hasta que ya no haya coincidencias.

Esto se puede utilizar para recortar caracteres distintos de los espacios en blanco predeterminados, como recortar dos puntos.

Ver también el LTrimChars y RTrimChars funciones.

Ejemplos¶

TrimChars("::StartMsg :: Hello :: EndMsg::", ":");
// Returns "StartMsg :: Hello :: EndMsg"

TrimChars("/* This is a comment */", " /*");
// Returns "This is a comment"

Truncate¶

Declaración¶

string Truncate(string str, int firstChars, int lastChars)

Sintaxis¶

Truncate(<str>, <firstChars>, <lastChars>)

Parámetros Requeridos¶

• str: Una cuerda
• firstChars: El número de caracteres que se eliminarán desde la izquierda (el principio) de la cadena.
• lastChars: El número de caracteres que se eliminarán desde la derecha (el final) de la cadena.

Descripción¶

Elimina firstChar personajes de la izquierda (el principio) y lastChars caracteres de la derecha (el final) de una cadena y devuelve la cadena restante.

Ver también el Left y Right funciones.

Ejemplos¶

Truncate("a,b,c,", 2, 1);
// Returns "b,c"

URLDecode¶

Declaración¶

string URLDecode(string url, string paramName)

Sintaxis¶

URLDecode(<url>, <paramName>)

Parámetros Requeridos¶

• url: Una cadena que contiene una URL
• paramName: El nombre de un parámetro en la URL cuyo valor se devolverá

Descripción¶

Analiza una cadena de URL y devuelve el valor decodificado del parámetro de URL con el nombre especificado. Se ignora el caso del nombre. Si el nombre no se encuentra en los parámetros de la URL, una cadena vacía ("") es regresado.

Ver también el ParseURL y URLEncode funciones.

Ejemplos¶

url = "http://hostname/user?email=john1990%40gmail.com&name=John%20Smith";
URLDecode(url, "name");
// Returns "John Smith"

URLEncode¶

Declaración¶

string URLEncode(string str[, int encodingOption])

Sintaxis¶

URLEncode(<str>[, <encodingOption>])

Parámetros Requeridos¶

• url: Una cadena que contiene un valor codificado siguiendo las reglas de RFC 1738

Parámetros Opcionales¶

• encodingOption: Un número entero (0 - 3) que especifica la codificación que se utilizará. El valor predeterminado es 0. Consulte la lista a continuación.

Descripción¶

Codifica una cadena siguiendo RFC 1738.

Los valores válidos para la opción de codificación opcional son:

• 0: Codificación de URL estándar. Codifica caracteres de control ASCII, caracteres no ASCII, caracteres "reservados" y caracteres "inseguros". Esta es la codificación predeterminada si se omite la opción.
• 1: No 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 analizarURL and Funciones URLDecode.

Ejemplos¶

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