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 Necesarios
str
: Una cadena que se buscarásubStr
: La cadena con la que se realizará la búsqueda
Descripción
Devuelve la cantidad 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 Necesarios
str
: Una cadena que se pondrá 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
Nota
El par exterior de comillas dobles en los ejemplos anteriores es la indicación de un tipo de datos de cadena y no se devuelve como parte de la cadena en sí.
Format
Declaración
string Format(string formatStr, type de)
Sintaxis
Format(<formatStr>, <de>)
Parámetros Necesarios
formatStr
: La cadena de formato que se utilizará al formatear la cadenade
: 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 del 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 especificación de formato de la biblioteca C estándar printf
.
Esta función se puede utilizar para establecer el formato de salida de un destino. Es útil cuando el formato de salida predeterminado de Jitterbit para un tipo de datos (como fecha o doble) no es el deseado. La llamada a la función 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 Necesarios
str
: Una cadena que se buscarásubStr
: La cadena con la que se realizará la búsqueda
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 los 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 tener en cuenta:
- n = 0 devuelve el mismo resultado que n = 1
- Si
subStr
es una cadena vacía (""
):- n >= 0 siempre devuelve 0
- n \< 0 siempre devuelve
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 Necesarios
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 cualquier carácter 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 Necesarios
str
: Una cadenan
: La cantidad de caracteres que se devolverán desde el extremo izquierdo
Descripción
Devoluciones n
caracteres de una cadena, contando desde la izquierda (el principio) de la cadena.
Véase también Mid
y Right
funciones.
Nota
Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede generarse un índice de carácter inicial diferente.
Ejemplos
Left("01234567890", 4);
// Returns "0123"
LPad
Declaración
string LPad(string str, int n)
Sintaxis
LPad(<str>, <n>)
Parámetros Necesarios
str
: Una cadenan
: La cantidad de caracteres que se devolverán desde el extremo izquierdo
Descripción
Agrega espacios a la izquierda (al principio) de una cadena hasta que la cadena contenga n
caracteres. Cadenas que contienen n
o más caracteres se truncan a n
personajes.
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 Necesarios
str
: Una cadenapadChar
: Una cadena que se utilizará para rellenar caracteres; si hay más de un carácter, se utiliza el primeron
: La cantidad de caracteres que se devolverán desde el extremo izquierdo
Descripción
Agrega un carácter de relleno a la izquierda (al principio) de una cadena hasta que la cadena contenga n
caracteres. Cadenas que contienen n
o más caracteres se truncan a n
personajes.
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 Necesarios
str
: Una cadena
Descripción
Elimina los espacios en blanco (espacios, tabulaciones) de la izquierda (al 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 Necesarios
str
: Una cadena que se debe recortar desde la izquierda (el principio)**trimChars
:** Una cadena de caracteres de recorte que se deben combinar; el orden no importa
Descripción
Elimina cualquier carácter inicial de una cadena desde la izquierda (el principio) que coincida con los caracteres de recorte y devuelve los caracteres restantes.
Esta función prueba cada carácter inicial de una cadena, comenzando por el borde izquierdo, y ve si se encuentra entre los caracteres de recorte. Si es así, se elimina y el proceso se repite hasta que ya no haya una coincidencia.
Esto se puede utilizar para recortar caracteres que no sean los caracteres de espacio en blanco predeterminados, como recortar los dos puntos iniciales.
Vea también la 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 Necesarios
-
str
: Una cadena de la que se extraerá una subcadena -
m
: La posición inicial del carácter basado en cero para comenzar a extraer la subcadena -
n
: La longitud (número de caracteres) de la subcadena que se va a extraer
Descripción
Devuelve una parte de una cadena, comenzando con el carácter en la posición m
por una longitud de n
personajes.
Véase también el Left
y Right
funciones.
Nota
Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede generarse un índice de carácter inicial diferente.
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 Necesarios
url
: Una cadena que contiene una URL para analizar
Descripción
Analiza una cadena URL y devuelve una matriz de valores decodificados. Los valores se etiquetan para que se puedan recuperar por índice o por nombre de campo.
Al recuperar valores del resultado, se ignoran las mayúsculas y minúsculas del nombre de campo. Consulte también 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 Necesarios
str
: Una cadena que se pondrá 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
Nota
El par exterior de comillas dobles en los ejemplos anteriores es la indicación de un tipo de datos de cadena y no se devuelve como parte de la cadena en sí.
RegExMatch
Declaración
int RegExMatch(string str, string exp[, type var1,... type varN])
Sintaxis
RegExMatch(<str>, <exp>[, <var1>,... <varN>])
Parámetros Necesarios
-
str
: Una cadena con la que se realizará la comparación -
exp
: Una expresión regular que consta de grupos
Parámetros Opcionales
var1...varN
: Uno o más nombres de variables, que se deben corresponder con las subexpresiones marcadas de la expresión
Descripción
Coincide 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 puede ser mayor o menor que el número de variables realmente suministradas). Cualquier coincidencia adicional que exceda el número de variables suministradas se descarta. Si no hay coincidencias, -1
Se devuelve.
La expresión regular sigue la sintaxis de la biblioteca de expresiones regulares de Boost. Es una variación de la sintaxis de expresión regular de Perl.
Los caracteres Unicode, incluidos los símbolos como los 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.
Nota
Las expresiones regulares deben cubrir toda la cadena de entrada para que cuenten para el número total de coincidencias. Por ejemplo, si "My input string"
se suministra como cadena de entrada, utilizando "^My"
como retornará la expresión regular 0
. Usando "^My.*"
Volverá 1
.
Véase 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.
Nota
"\"
(barra invertida) debe escaparse en cadenas literales ya que es el carácter de escape. Para utilizar una "\"
, utilice una barra invertida doble: "\\"
.
RegExReplace
Declaración
string RegExReplace(string str, string exp, string format)
Sintaxis
RegExReplace(<str>, <exp>, <format>)
Parámetros Necesarios
-
str
: Una cadena que se buscará y en la que se reemplazarán las subcadenas que coincidan -
exp
: La expresión regular en la sintaxis de la biblioteca de expresiones regulares de Boost que se utilizará para hacer coincidir subcadenas de la cadena -
format
: Una cadena de formato en la Sintaxis de cadena de formato extendida de Boost
Descripción
Reemplaza todas las subcadenas de una cadena que coinciden con una expresión, utilizando un formato especificado 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 la biblioteca de expresiones regulares de Boost. Es una variación de la sintaxis de expresión regular de Perl.
Los caracteres Unicode, incluidos los símbolos como los emoji, deben coincidir utilizando sus caracteres literales y no utilizando secuencias de escape Unicode. Por ejemplo, el rango "[😀-🤯]"
(U+1F600 a U+1F92F) captura correctamente el símbolo 🤔 (U+1F914) en el medio.
La cadena de formato sigue la Sintaxis de cadena de formato extendida de Boost. Si la cadena de formato es una cadena vacía (""
) entonces una coincidencia no produce ningún resultado para esa subcadena.
Véase también 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"
Nota
"\"
(barra invertida) debe escaparse en cadenas literales ya que es el carácter de escape. Para utilizar una "\"
, utilice una barra invertida doble: "\\"
.
Replace
Declaración
string Replace(string str, string old, string new)
Sintaxis
Replace(<str>, <old>, <new>)
Parámetros Necesarios
-
str
: Se buscará una cadena y se reemplazarán las subcadenas coincidentes -
old
: Una cadena que se utilizará para la coincidencia -
new
: Una cadena que se utilizará como reemplazo para 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 Necesarios
-
str
: Una cadena -
n
: La cantidad de caracteres que se devolverán desde el extremo derecho
Descripción
Devoluciones n
caracteres de una cadena, contando desde la derecha (el final) de la cadena.
Véase también Left
y Mid
funciones.
Nota
Si la cadena es una cadena numérica que comienza con un cero inicial, debe estar entre comillas o se interpretará como un número entero y puede generarse un índice de carácter inicial diferente.
Ejemplos
Right("01234567890",4);
// Returns "7890"
RPad
Declaración
string RPad(string s, int n)
Sintaxis
string RPad(string s, int n)
Parámetros Necesarios
-
str
: Una cadena -
n
: La cantidad de caracteres que se devolverán desde el extremo derecho
Descripción
Agrega espacios a la derecha (al final) de una cadena hasta que la cadena contenga n
caracteres. Cadenas que contienen n
o más caracteres se truncan a n
personajes.
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 Necesarios
str
: Una cadenapadChar
: Una cadena que se utilizará para rellenar caracteres; si hay más de un carácter, se utiliza el primeron
: La cantidad de caracteres que se devolverán desde el extremo derecho
Descripción
Agrega un carácter de relleno a la derecha (al final) de una cadena hasta que la cadena contenga n
caracteres. Cadenas que contienen n
o más caracteres se truncan a n
personajes.
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 Necesarios
str
: Una cadena
Descripción
Elimina los espacios en blanco (espacios, tabulaciones) de la derecha (al 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 Necesarios
str
: Una cadena que se debe recortar desde la derecha (el final)**trimChars
:** Una cadena de caracteres de recorte que se deben combinar; el orden no importa
Descripción
Elimina cualquier carácter final de una cadena que coincida con los caracteres de recorte y devuelve los caracteres restantes.
Esta función prueba cada carácter final de una cadena, comenzando por el borde derecho, y ve si se encuentra entre los caracteres de recorte. Si es así, se elimina y el proceso se repite hasta que ya no haya una coincidencia.
Esto se puede utilizar para recortar caracteres que no sean los caracteres de espacio en blanco predeterminados, como recortar los dos puntos finales.
Vea también la 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 Necesarios
str
: Una cadena que se va a dividirdelimiter
: Una cadena que se utilizará como división entre cada elemento de la matriz
Descripción
Divide una cadena utilizando 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 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 Necesarios
str
: Una cadena que se va a dividir
Parámetros Opcionales
delimiter
: Una cadena que se utilizará como división entre cada elemento de la matrizqualifier
: Una cadena que se utilizará 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 cada columna.
De manera 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.
Nota
Los parámetros opcionales (delimitador y calificador) se pueden especificar con un número entero correspondiente al código ASCII del carácter delimitador o calificador.
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 Necesarios
-
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. 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 Necesarios
str
: Una cadena
Descripción
Convierte todos los caracteres ASCII en mayúsculas (A a Z, ASCII 65 a 90) de una cadena a minúsculas.
Ejemplos
ToLower("Hello World!");
// Returns "hello world!"
ToProper
Declaración
string ToProper(string str)
Sintaxis
ToProper(<str>)
Parámetros Necesarios
str
: Una cadena
Descripción
Convierte una cadena a mayúsculas y minúsculas (la primera letra de cada palabra se escribe en mayúscula). Esto es distinto del caso del título, que solo escribe en mayúsculas las palabras seleccionadas y más largas de una cadena.
Advertencia
La ToProper()
La función es tal que nombres como "mccartney"
Empezando con "mc"
sólo se convierten correctamente a "McCartney"
Si la palabra está precedida por un carácter de espacio, para tener una cadena que comience con "mc"
como "mccartney, paul"
convertido correctamente a "McCartney, Paul"
, use un código como este para agregar un espacio anterior y luego eliminarlo inmediatamente:
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 Necesarios
str
: Una cadena
Descripción
Convierte todos los caracteres ASCII en minúscula (a a z, ASCII 97 a 122) de una cadena a mayúsculas.
Ejemplos
ToUpper("Hello World!");
// Returns "HELLO WORLD!"
Trim
Declaración
string Trim(string str)
Sintaxis
Trim(<str>)
Parámetros Necesarios
str
: Una cadena
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 Necesarios
str
: Una cadena que se va a recortartrimChars
: Una cadena de caracteres de recorte que se deben combinar; el orden no importa
Descripción
Elimina cualquier carácter inicial o final de una cadena que coincida con 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 entre los caracteres de recorte. Si es así, se elimina y el proceso se repite hasta que ya no haya coincidencias.
Esto se puede utilizar para recortar caracteres que no sean los caracteres de espacio en blanco predeterminados, como recortar dos puntos.
Vea también la 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 Necesarios
str
: Una cadenafirstChars
: La cantidad de caracteres que se eliminarán desde la izquierda (el principio) de la cadenalastChars
: La cantidad 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 desde la derecha (el final) de una cadena y devuelve la cadena restante.
Véase también 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 Necesarios
url
: Una cadena que contiene una URLparamName
: El nombre de un parámetro en la URL cuyo valor se devolverá
Descripción
Analiza una cadena URL y devuelve el valor decodificado del parámetro URL con el nombre especificado. Se ignoran las mayúsculas y minúsculas del nombre. Si el nombre no se encuentra en los parámetros de la URL, se devuelve una cadena vacía (""
) se devuelve.
Véase 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 Necesarios
url
: Una cadena que contiene un valor a codificar 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 que sigue 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 "no seguros". Esta es la codificación predeterminada si se omite la opción.1
: No 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 Analizar URL
and `Funciones de 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