La función Sustituir sustituye caracteres individuales por otros caracteres individuales.
La sustitución se realiza a nivel de carácter individual y no a nivel de serie. Cada aparición de un carácter se sustituye con el carácter de sustitución especificado, tal como se muestra en el siguiente ejemplo:
- la lista de caracteres que deben sustituirse equivale a 'abc'
- la lista o caracteres de sustitución equivalen a 'ABC'
- la serie de entrada es igual a 'aWWWbYYYYcPPPPabc'
La serie resultante equivale a ''AWWWBYYYYCPPPPABC', porque la sustitución se realiza a nivel de carácter, es decir, se sustituye cada carácter. (Si la sustitución se ha realizado a nivel de serie, la serie resultante debería ser igual a 'aWWWbYYYYcPPPPABC'.)
Parámetro: input
La serie que debe buscar caracteres para sustituirlos. El valor de este parámetro puede ser facilitado por un nodo de origen, el resultado de otra función o un valor especificado por el usuario.
Parámetro: fromChars
Una lista de caracteres que deben sustituirse. Si necesita reemplazar varios caracteres, estos deberían estar listados sin ninguna separación. El valor de este parámetro puede ser facilitado por un nodo de origen, el resultado de otra función o un valor especificado por el usuario.
Parámetro: toChars
Una lista de caracteres que deben utilizarse como sustituciones. Liste los caracteres de sustitución en este parámetro siguiendo el mismo orden que los caracteres que deben sustituirse en el parámetro
fromChars porque el primer carácter del parámetro
fromChars es sustituido por el primer carácter del parámetro
toChars y así sucesivamente.
Para más información, consulte el ejemplo 2. El valor de este parámetro puede ser facilitado por un nodo de origen, el resultado de otra función o un valor que especifique.
Nota: No puede sustituir directamente un único carácter con una serie vacía porque el parámetro
toChars no puede ser una serie vacía, es decir, una serie sin caracteres. Para obtener un método alternativo, consulte el ejemplo 3.
Devuelve: serie
El resultado de sustituir todas las apariciones de caracteres en el segundo parámetro (fromChars) que se encuentran en el primer parámetro (input) con los caracteres coincidentes en el tercer parámetro (toChars).
Ejemplo 1
Este ejemplo muestra una simple sustitución de caracteres uno a uno tal como se muestra en la siguiente figura:
El resultado del tiempo de ejecución al ejecutar esta función es la siguiente serie:
Una lista de chArActers
Todos los caracteres a en minúsculas se sustituyen por caracteres A en mayúsculas.
Nota: En este ejemplo, el parámetro de entrada está codificado para un valor específico.
Normalmente, esta valor se sustituye con un nodo de origen en una correlación.
Ejemplo 2
En este ejemplo, el primer carácter del parámetro
fromChars es sustituido por el primer carácter del parámetro
toChars, el segundo carácter del parámetro
fromChars es sustituido por el segundo carácter del parámetro
toChars y así sucesivamente. La sustitución de distintos caracteres se muestra en la siguiente figura:
En este ejemplo, los caracteres no numéricos (especificados al final del parámetro fromChars) se eliminan de la serie de número de teléfono. Todos los caracteres numéricos se sustituyen con el mismo carácter numérico; por ejemplo, el carácter 1 se sustituye por el carácter 1. Los otros caracteres no numéricos al final de fromChars no tienen un carácter de sustitución especificado en toChars, por lo que se eliminan de la serie devuelta.
El resultado del tiempo de ejecución al ejecutar esta función es la siguiente serie:
000238882349940Nota: En este ejemplo, el parámetro de entrada está codificado para un valor específico.
Normalmente, esta valor se sustituye con un nodo de origen en una correlación.
Ejemplo 3
Este ejemplo muestra un método alternativo a esta limitación en la que no se puede sustituir un carácter único por una serie vacía. Esta limitación existe porque el parámetro
toChars no se puede establecer en una serie vacía, es decir, una serie sin caracteres. Puede utilizar un método alternativo para solucionar esta limitación facilitando un carácter ficticio como un guión (-) que no se encuentre en el parámetro
input.
Por ejemplo, podría especificar los siguientes valores para los parámetros de la función
Sustituir tal como se muestra en el siguiente figura:
En este ejemplo, el parámetro de entrada es igual a '1 2 3' (1, espacio, 2, espacio, 3), el parámetro fromChars es igual a to '- ' (guión, espacio) y el parámetro toChars es igual a '-' (guión). Durante el tiempo de ejecución, la función Sustituir con estos valores quita los espacios del parámetro de entrada y el resultado del tiempo de ejecución es la siguiente serie:
123
Atención: Cuando especifique las series en el campo Valor del recuadro de diálogo Propiedades de función, no introduzca las comillas. Introduzca únicamente el guión y el espacio y nos los caracteres de comillas.
Nota: En este ejemplo, el parámetro de entrada está codificado para un valor específico.
Normalmente, esta valor se sustituye con un nodo de origen en una correlación.