Retorna o maior número possível de caracteres desde o início de uma string até um delimitador sem exceder max_length. Se a string já estiver dentro de max_length, a função retornará a string exatamente como foi transmitida.
A contagem é sempre feita na direção natural da localidade do anunciante. Por exemplo, se o idioma do anunciante for o inglês, essa função conta da esquerda para a direita.
Sintaxe
reduce_words(string, max_length, delimiter, [delimiter], ...)
Saiba mais sobre a sintaxe das funções.
Parâmetros
- string: um atributo de string de inventário como
DESCRIPTION
ou uma string estática dentro de aspas, como "Minha incrível loja de sapatos"
Saiba mais sobre referências a atributos de inventário. - max_length: o número máximo de caracteres na string de saída. Pode ser qualquer uma das seguintes opções:
- 0 (zero).
- Um número inteiro positivo, como 5.
- Uma expressão ou uma função de inventário que retorna um número positivo.
- delimiter: um caractere único como " ", uma string estática como "loja" ou um atributo de string de inventário como
BRAND
. Se você especificar mais de um delimitador, a função usará aquele que produzir a maior string respeitando o valor de max_length.
Exemplos
-
reduce_words("Minha incrível loja de calçados", 10, " ")
retorna "Minha incrível". Para calcular essa string, a função segue estas etapas:-
Encontra a última ocorrência do delimitador, ou seja, o espaço entre "shoe" e "store".
-
Conta 10 caracteres para trás e confere se atingiu o início da string.
-
Neste exemplo, a função não atinge o começo, então move-se para a instância anterior do delimitador, o espaço entre "great" e "shoes", e conta 10 caracteres para trás.
-
A função atinge o início da string antes de terminar a contagem, então retorna tudo o que precede o delimitador.
-
reduce_words(DESCRIPTION, 15, " and")
. Se o feed de inventário especificar "Preço baixo e variedade" para o atributoDESCRIPTION
, essa função retornará "Preço baixo". O delimitador inclui um espaço antes de "and". Se não houvesse esse espaço no delimitador, a função retornaria "Preço baixo ".reduce_words(DESCRIPTION, 15, " ")
. Se o feed de inventário especificar "Preço baixo" para a atribuiçãoDESCRIPTION
, a função retornará "Preço baixo".