Funzioni, operatori e parole chiave
6.1.3 Funzioni carattere
6.1.3.1 Asc
Descrizione
Restituisce il valore ASCII di un carattere Gruppo di funzioni
Carattere Sintassi
int Asc(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
Qualsiasi stringa stringa
Note
Se stringa contiene più di un carattere, la funzione restituisce il valore ASCII del primo carattere nella stringa.
Esempi
Asc("A")restituisce 65.
Asc("ab")restituisce 97.
Asc([Paese])restituisce 85 se il valore di [Paese] è "US".
6.1.3.2 Car
Funzioni, operatori e parole chiave
Descrizione
Restituisce il carattere associato a un codice ASCII Gruppo di funzioni
Carattere Sintassi
stringa Car(codice_ASCII)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Numero
Un codice ASCII codice_ASCII
Note
Se numero è un valore decimale, la funzione ignora le cifre decimali.
Esempio s
Car(123)restituisce "{".
6.1.3.3 Concatenamento
Descrizione
Concatena (unisce) due stringhe di caratteri.
Gruppo di funzioni Carattere
Sintassi
stringa Concatenamento(prima_stringa;seconda_stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La prima stringa.
prima_stringa
Sì Stringa
La seconda stringa.
seconda_stringa
Note
È anche possibile utilizzare l'operatore '+' per concatenare le stringhe.
("Primo" + "Secondo")restituisce "Primo Secondo"
("Primo" + "Secondo" + "Terzo")restituisce "Primo Secondo Terzo".
È possibile utilizzare il concatenamento per inserire dimensioni multiple in una funzione di aggregazione.
Ad esempio, Conteggio([Responsabile vendite]+[Trimestre]+[Località]) è equivalente alla sintassi Conteggio(<Responsabile vendite>,<Trimestre>,<Località>) ammessa da Desktop Intelligence.
Esempi
Concatenamento("Primo ";"Secondo")restituisce "Primo Secondo".
Concatenamento("Primo ";Concatenamento("Secondo ";"Terzo"))restituisce "Primo Secondo Terzo".
6.1.3.4 Ricopia
Descrizione
Crea una stringa ripetendo la stringa n volte Gruppo di funzioni
Carattere Sintassi
stringa Ricopia(stringa_ripetizione;num_ripetizioni)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da ripetere.
stringa_ripetizione
Sì Numero
Il numero di ripetizioni num_ripetizioni
Esempi
Ricopia ("New York";2)restituisce "New York New York".
6.1.3.5 FormatoData
Descrizione
Formatta una data sulla base di un formato indicato
Funzioni, operatori e parole chiave
Gruppo di funzioni
La data da formattare data
Sì Stringa
Il formato da applicare formato_stringa
Note
• Il formato dell'output dipende dal formato della data applicato alla cella.
• Le stringhe di formattazione dei colori, ad esempio [Rosso], [Blu] e così via, non possono essere applicate alla funzione FormatoData.
Esempi
FormatoData(DataCorrente();"dd/MM/yyyy")restituisce "15/12/2005" se la data corrente è 15 dicembre 2005.
6.1.3.6 FormatoNumero
Descrizione
Formatta un numero sulla base di un formato indicato Gruppo di funzioni
Carattere
Il numero da formattare numero
Sì Stringa
Il formato da applicare formato_stringa
Note
• Il formato dell'output dipende dal formato dei numeri applicato alla cella.
• Le stringhe di formattazione dei colori, ad esempio [Rosso], [Blu] e così via, non possono essere applicate alla funzione FormatoNumero.
Esempi
FormatoNumero([Fatturato];"#,##.00")restituisce 835.420,00 se [Fatturato] è 835,420.
6.1.3.7 CodificaHTML
Descrizione
Applica le regole di codifica dell'HTML a una stringa Gruppo di funzioni
Carattere Sintassi
stringa CodificaHTML(html)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
Una stringa HTML html
Esempi
CodificaHTML("http://www.sap.com")restituisce "http%3A%2F%2Fwww%2Esap%2Ecom ".
6.1.3.8 Maiuscola
Descrizione
Imposta in maiuscolo la prima lettera di una stringa Gruppo di funzioni
Carattere Sintassi
stringa Maiuscola(stringa) Funzioni, operatori e parole chiave
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa a cui applicare il maius-colo
stringa
Esempi
Maiuscola("questa affermazione sembra evidente") restituisce "Questa affermazione sembra evidente".
6.1.3.9 Sinistra
Descrizione
Restituisce i caratteri più a sinistra di una stringa.
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione restituisce i primi caratteri dell'inizio logico della stringa.
Gruppo di funzioni Carattere
Sintassi
stringa Sinistra(stringa;num_car)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì stringa
La stringa di input.
stringa
Sì numero
Il numero di caratteri da restituire dall'inizio della stringa.
num_car
Esempio
Sinistra([Paese];2)restituisce "Fr" se il valore della variabile [Paese] è "Francia".
6.1.3.10 RiempiSpaziASinistra
Descrizione
Completa una stringa alla sinistra con un'altra stringa.
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione riempie la stringa prima dell'inizio logico con i caratteri di un'altra stringa.
Gruppo di funzioni Carattere
Sintassi
stringa RiempiSpaziASinistra(stringa_allungata;lunghezza;stringa_sinistra)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa originale stringa_allungata
Sì Numero
La lunghezza della stringa di output lunghezza
Sì Stringa
La stringa da aggiungere all'inizio di stringa_allungata
stringa_sinistra
Note
• Se lunghezza è minore del totale della lunghezza di stringa_sinistra e stringa_allungata, il valore di stringa_sinistra viene troncato.
• Se lunghezza è minore o uguale alla lunghezza di stringa_allungata, la funzione restituisce il valore di stringa_allungata.
• Se lunghezza è maggiore del totale della lunghezza di stringa_allungata e stringa_sini stra, il valore di stringa_sinistra viene ripetuto o parzialmente ripetuto le volte necessarie fino a raggiungere il valore di "lunghezza".
Esempi
RiempiSpaziASinistra("York",;8,"New ") restituisce "New York".
RiempiSpaziASinistra("York";6;"New ")restituisce "NeYork"
RiempiSpaziASinistra("York";11;"New ")restituisce "New NewYork"
RiempiSpaziASinistra("New ";2;"York")restituisce "New".
6.1.3.11 EliminaSpaziASinistra
Funzioni, operatori e parole chiave
Descrizione
Elimina gli spazi iniziali da una stringa.
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione rimuove i primi spazi dall'inizio logico della stringa.
Gruppo di funzioni Carattere
Sintassi
stringa EliminaSpaziASinistra(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da cui si vogliono eliminare gli spazi.
stringa_tagliata
Esempi
EliminaSpaziASinistra([Paese])restituisce "Francia" se il valore della variabile [Paese] è "
Francia".
6.1.3.12 Lunghezza
Descrizione
Restituisce il numero di caratteri di una stringa di caratteri.
Gruppo di funzioni Carattere
Sintassi
int Lunghezza(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa di input.
stringa
Esempi
Lunghezza([Cognome])restituisce 5 se il valore della variabile [Cognome] è "Smith".
6.1.3.13 Minuscole
Descrizione
Converte una stringa in lettere minuscole.
Gruppo di funzioni Carattere
Sintassi
stringa Minuscole(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da convertire in minu-scole
stringa
Esempi
Minuscole("New York")restituisce "new york".
6.1.3.14 Confronta
Descrizione
Determina se una stringa corrisponde a un criterio di ricerca.
Gruppo di funzioni Carattere
Sintassi
booleano Confronta(stringa_test;criterio) Funzioni, operatori e parole chiave
Input
La stringa da confrontare con il criterio di ricerca
stringa_test
Sì stringa
Il criterio di ricerca criterio
Note
• Il criterio di ricerca può contenere i caratteri jolly "*" (sostituisce un insieme di caratteri) o "?"
(sostituisce un carattere).
Esempi
Confronta([Paese];"F*")restituisce vero se il valore della variabile [Paese} è "Francia".
Confronta([Paese];"?S?") restituisce vero se il valore della variabile [Paese] è "USA".
Confronta("New York";"P*")restituisce falso.
6.1.3.15 Pos
Descrizione
Restituisce la posizione iniziale di una sequenza di testo in una stringa Gruppo di funzioni
Carattere
La stringa da verificare per il criterio di ricerca
stringa_test
Sì stringa
Il criterio di ricerca criterio
Note
• Se la sequenza ricorre più di una volta, Pos restituisce la posizione della prima occorrenza.
Esempi
Pos("New York";"Ne")restituisce 1.
Pos("New York, New York";"Ne")restituisce 1.
Pos("New York"; "York")restituisce 5.
6.1.3.16 Sostituisci
Descrizione
Sostituisce una parte di una stringa di caratteri con un'altra stringa di caratteri.
Gruppo di funzioni Carattere
Sintassi
stringa Sostituisci(sostituisci_in;stringa_sostituita;sostituisci_con)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì stringa
La stringa in cui viene sostituito il testo
sostituisci_in
Sì stringa
Il testo da sostituire stringa_sostituita
Sì stringa
Il testo che sostituisce stringa_so stituita
sostituisci_con
Esempi
Sostituisci("New YORK";"ORK";"ork")restituisce "New York".
6.1.3.17 Destra
Descrizione
Restituisce i caratteri più a destra di una stringa (quelli alla fine della stringa).
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione restituisce i primi caratteri dell'inizio logico della stringa.
Gruppo di funzioni Carattere
Sintassi
Funzioni, operatori e parole chiave
Input
Il numero di caratteri della stringa da restituire, a partire da destra
num_car
Esempi
Destra([Paese];2) restituisce "ia" se [Paese] è "Francia".
6.1.3.18 RiempiSpaziADestra
Descrizione
Completa una stringa alla destra con un'altra stringa (aggiungendo una stringa all'inizio della stringa originale).
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione aggiunge una stringa ai primi caratteri dell'inizio logico della stringa.
Gruppo di funzioni Carattere
La stringa originale stringa_allungata
Sì Numero
La lunghezza della stringa di output lunghezza
Sì Stringa
La stringa da aggiungere alla fine di stringa_allungata
stringa_destra
Note
• Se lunghezza è minore del totale della lunghezza di stringa_destra e stringa_allungata, il valore di stringa_destra viene troncato.
• Se lunghezza è minore o uguale alla lunghezza di stringa_allungata, la funzione restituisce il valore di stringa_allungata.
• Se lunghezza è maggiore del totale della lunghezza di stringa_allungata e stringa_destra, il valore di stringa_destra viene ripetuto o parzialmente ripetuto le volte necessarie fino a raggiungere il valore di "lunghezza".
Esempi
RiempiSpaziADestra("New ",;8,"York") restituisce "New York"
RiempiSpaziADestra("New ",; 6,"York") restituisce "New Yo"
RiempiSpaziADestra("New ";11;"York")restituisce "New YorkYor"
RiempiSpaziADestra("New ";2;"York")restituisce "New".
6.1.3.19 EliminaSpaziADestra
Descrizione
Elimina gli spazi finali da una stringa.
Nota:
Se le impostazioni locali selezionate per l'interfaccia sono configurate sulla lingua araba (visualizzazione e lettura da destra a sinistra), questa funzione elimina lo spazio finale dalla fine logica della stringa.
Gruppo di funzioni Carattere
Sintassi
stringa EliminaSpaziADestra(stringa_tagliata)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da cui si vogliono eliminare gli spazi.
stringa_tagliata
Esempi
EliminaSpaziADestra([Paese])restituisce "Francia" se [Paese] è "Francia".
6.1.3.20 Sottostringa
Funzioni, operatori e parole chiave
Descrizione
Restituisce parte di una stringa Gruppo di funzioni
Carattere
La posizione iniziale della stringa estratta
inizio
Sì Numero
La lunghezza della stringa estratta.
lunghezza
Esempi
Sottostringa ("Gran Bretagna";1;5)restituisce "Gran".
Sottostringa ("Gran Bretagna";7;7) restituisce "Bretagna".
6.1.3.21 EliminaSpazi
Descrizione
Elimina gli spazi iniziali e finali da una stringa Gruppo di funzioni
Carattere
La stringa da cui si vogliono eliminare gli spazi.
stringa
Esempi
EliminaSpazi(" Gran Bretagna ")restituisce "Gran Bretagna".
6.1.3.22 Maiuscole
Descrizione
Converte una stringa in lettere maiuscole Gruppo di funzioni
Carattere Sintassi
stringa Maiuscole(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da convertire stringa
Esempi
Maiuscole("New York")restituisce "NEW YORK".
6.1.3.23 CodificaURL
Descrizione
Applica le regole di codifica dell'URL a una stringa Gruppo di funzioni
Carattere Sintassi
stringa CodificaURL(html)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
L'URL da codificare html
Esempi
CodificaURL("http://www.sap.com")restituisce "http%3A%2F%2Fwww%2Esap%2Ecom".
Funzioni, operatori e parole chiave
6.1.3.24 TuttoMaiuscole
Descrizione
Mette la lettera maiuscola all'inizio di tutte le parole di una stringa Gruppo di funzioni
Carattere Sintassi
stringa TuttoMaiuscole(stringa)
Input
Obbligatorio Tipo
Descrizione Parametro
Sì Stringa
La stringa da convertire in maiu-scolo
stringa
Esempi
TuttoMaiuscole("Fatturato di vendita per marzo")restituisce "Fatturato di vendita per marzo".