Firebirds SQL-Sprachführer 4.0 | Spezialfunktionen Für DECFLOAT

Prozedurale SQL-Anweisungen (PSQL)Aggregatfunktionen

`NORMALIZE_DECFLOAT()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

DECFLOAT

Syntax

NORMALIZE_DECFLOAT (decfloat_value)

Table 1. `NORMALIZE_DECFLOAT`-Funktionsparameter
Parameter	Beschreibung
decfloat_value	Wert oder Ausdruck vom Typ `DECFLOAT`, oder Cast-kompatibel mit `DECFLOAT`

NORMALIZE_DECFLOAT nimmt ein einzelnes DECFLOAT-Argument und gibt es in seiner einfachsten Form zurück.Das bedeutet, dass für jeden Wert ungleich Null nachfolgende Nullen mit entsprechender Exponentenkorrektur entfernt werden.

Beispiele für `NORMALIZE_DECFLOAT`

-- Gibt 12 zurück
select normalize_decfloat(12.00)
from rdb$database;

-- Gibt 1.2E+2 zurück
select normalize_decfloat(120)
from rdb$database;

`QUANTIZE()`

Verfügbar in

DSQL, PSQL

Syntax

QUANTIZE (decfloat_value, exp_value)

Table 1. `QUANTIZE`-Funktionsparameter
Parameter	Beschreibung
decfloat_value	Wert oder Ausdruck zum Quantisieren;muss vom Typ `DECFLOAT` sein oder Cast-kompatibel mit `DECFLOAT`
exp_value	Wert oder Ausdruck, der für seinen Exponenten verwendet werden soll;muss vom Typ `DECFLOAT` sein oder Cast-kompatibel mit `DECFLOAT`

QUANTIZE gibt einen DECFLOAT-Wert zurück, der in Wert und Vorzeichen (außer Rundung) gleich decfloat_value ist und der einen Exponenten hat, der gleich dem Exponenten von exp_value ist.Der Rückgabewert ist DECFLOAT(16), wenn beide Argumente DECFLOAT(16) sind, andernfalls ist der Ergebnistyp DECFLOAT(34).

Note

Der Zielexponent ist der Exponent, der im Speicherformat Decimal64 oder Decimal128 von DECFLOAT von exp_value verwendet wird.Dies ist nicht unbedingt dasselbe wie der Exponent, der in Tools wie isql angezeigt wird.Zum Beispiel ist der Wert '1.23E+2' Koeffizient '123' und Exponent '0', während '1.2' Koeffizient '12' und Exponent '-1' ist.

Wenn der Exponent von decfloat_value größer als der von exp_value ist, wird der Koeffizient von decfloat_value mit einer Zehnerpotenz multipliziert und sein Exponent verringert, ist der Exponent kleiner, dann wird sein Koeffizient mit dem aktuellen decfloat-Rundungsmodus gerundet, und seine Exponent wird erhöht.

Wenn es nicht möglich ist, den Zielexponenten zu erreichen, weil der Koeffizient die Zielgenauigkeit (16 oder 34 Dezimalstellen) überschreiten würde, wird entweder ein Fehler “Decfloat float invalid operation” ausgegeben oder NaN zurückgegeben (je nach aktuellem) Konfiguration der decfloat Traps).

Es gibt fast keine Einschränkungen für den exp_value.In fast allen Anwendungen erzeugt NaN/sNaN/Infinity jedoch eine Ausnahme (sofern dies nicht durch die aktuelle decfloat-Traps-Konfiguration erlaubt ist), NULL lässt die Funktion NULL zurückgeben und so weiter.

Beispiele für `QUANTIZE`

select v, pic, quantize(v, pic) from examples;

     V    PIC QUANTIZE
====== ====== ========
  3.16  0.001    3.160
  3.16   0.01     3.16
  3.16    0.1      3.2
  3.16      1        3
  3.16   1E+1     0E+1
  -0.1      1       -0
     0   1E+5     0E+5
   316    0.1    316.0
   316      1      316
   316   1E+1   3.2E+2
   316   1E+2     3E+2

`TOTALORDER()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

SMALLINT

Syntax

TOTALORDER (decfloat1, decfloat2)

Table 1. `TOTALORDER`-Funktionsparameter
Parameter	Beschreibung
decfloatn	Wert oder Ausdruck vom Typ `DECFLOAT`, oder Cast-kompatibel mit `DECFLOAT`

TOTALORDER vergleicht zwei DECFLOAT-Werte einschließlich aller Sonderwerte.Der Vergleich ist genau und gibt ein SMALLINT zurück, eines der folgenden:

`-1`	Erster Wert is kleiner als der zweite
`0`	Werte sind identisch
`1`	Erster Wert ist größer als der zweite

Für TOTALORDER-Vergleiche werden die DECFLOAT-Werte wie folgt geordnet:

-NaN < -sNaN < -INF < -0.1 < -0.10 < -0 < 0 < 0.10 < 0.1 < INF < sNaN < NaN

Siehe auch

[fblangref40-scalarfuncs-comparedecfloat-de]

Kryptografische Funktionen

`DECRYPT()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY oder BLOB

Syntax

DECRYPT ( encrypted_input
  USING <algorithm> [MODE <mode>]
  KEY key
  [IV iv] [<ctr_type>] [CTR_LENGTH ctr_length]
  [COUNTER initial_counter] )

!! Vgl. auch die Syntax von <<fblangref40-scalarfuncs-encrypt-de,ENCRYPT>> für weitere Details !!

Table 1. `DECRYPT`-Funktionsparameter
Parameter	Beschreibung
encrypted_input	Verschlüsselte Eingabe als Blob oder (binärer) String
Siehe auch [fblangref40-scalarfuncs-tbl-encrypt-de] für weitere Parameter

DECRYPT entschlüsselt Daten mit einer symmetrischen Verschlüsselung.

Note

Größen von Datenstrings (wie encrypted_input, key und iv) müssen die Anforderungen des ausgewählten Algorithmus und Modus erfüllen.
Diese Funktion gibt BLOB SUB_TYPE BINARY zurück, wenn das erste Argument ein BLOB ist, und VARBINARY für alle anderen Text- und Binärtypen.
Wenn es sich bei den verschlüsselten Daten um Text handelte, müssen sie explizit in einen Stringtyp mit entsprechendem Zeichensatz umgewandelt werden.
Die Besonderheiten der verschiedenen Algorithmen werden außerhalb des Rahmens dieser Sprachreferenz betrachtet.Wir empfehlen, im Internet nach weiteren Details zu den Algorithmen zu suchen.

`DECRYPT`-Beispiele

select decrypt(x'0154090759DF' using sober128 key 'AbcdAbcdAbcdAbcd' iv '01234567')
  from rdb$database;
select decrypt(secret_field using aes mode ofb key '0123456701234567' iv init_vector)
  from secure_table;

Siehe auch

[fblangref40-scalarfuncs-encrypt-de], [fblangref40-scalarfuncs-rsadecrypt-de]

`ENCRYPT()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY oder BLOB

Syntax

ENCRYPT ( input
  USING <algorithm> [MODE <mode>]
  KEY key
  [IV iv] [<ctr_type>] [CTR_LENGTH ctr_length]
  [COUNTER initial_counter] )

<algorithm> ::= <block_cipher> | <stream_cipher>

<block_cipher> ::=
    AES | ANUBIS | BLOWFISH | KHAZAD | RC5
  | RC6 | SAFER+ | TWOFISH | XTEA

<stream_cipher> ::= CHACHA20 | RC4 | SOBER128

<mode> ::= CBC | CFB | CTR | ECB | OFB

<ctr_type> ::= CTR_BIG_ENDIAN | CTR_LITTLE_ENDIAN

Table 1. `ENCRYPT`-Funktionsparameter
Parameter	Beschreibung
input	Eingabe zum Verschlüsseln als Blob oder (binäre) Zeichenfolge
algorithm	Der für die Entschlüsselung zu verwendende Algorithmus
mode	Der Algorithmusmodus;nur für Blockchiffren
key	Der Verschlüsselungs-/Entschlüsselungsschlüssel
iv	Initialisierungsvektor oder Nonce;sollte für Blockchiffren in allen Modi außer „ECB“ und für alle Stromchiffren außer „RC4“ angegeben werden
ctr_type	Endianität des Zählers;nur für `CTR`-Modus.Der Standardwert ist "CTR_LITTLE_ENDIAN".
ctr_length	Zählerlänge;nur für `CTR`-Modus.Standard ist die Größe iv.
initial_counter	Anfangszählerwert;nur für `CHACHA20`.Der Standardwert ist `0`.

ENCRYPT kann Daten mit einer symmetrischen Verschlüsselung verschlüsseln.

Note

Diese Funktion gibt BLOB SUB_TYPE BINARY zurück, wenn das erste Argument ein BLOB ist, und VARBINARY für alle anderen Text- und Binärtypen.
Größen von Datenstrings (wie key und iv) müssen die Anforderungen des ausgewählten Algorithmus und Modus erfüllen, siehe Tabelle [fblangref40-scalarfuncs-tbl-encrypt-req-de].
- Im Allgemeinen muss die Größe von iv der Blockgröße des Algorithmus entsprechen
- Für den ECB- und CBC-Modus muss input ein Vielfaches der Blockgröße sein, Sie müssen gegebenenfalls manuell mit Nullen oder Leerzeichen auffüllen.
Die Besonderheiten der verschiedenen Algorithmen und Modi werden außerhalb des Rahmens dieser Sprachreferenz betrachtet.Wir empfehlen, im Internet nach weiteren Details zu den Algorithmen zu suchen.
Obwohl in dieser Sprachreferenz als separate Optionen angegeben, sind CTR_LENGTH und COUNTER in der aktuellen Firebird 4.0-Syntax Aliase.

Table 2. Anforderungen für den Verschlüsselungsalgorithmus
Algorithm	Schlüsselgröße (Bytes)	Blockgröße (Bytes)	Hinweise
Blockchiffren
`AES`	16, 24, 32	16
`ANUBIS`	16 - 40, in 4er-Schritten	16
`BLOWFISH`	8 - 56	8
`KHAZAD`	16	8
`RC5`	8 - 128	8
`RC6`	8 - 128	16
`SAFER+`	16, 24, 32	16
`TWOFISH`	16, 24, 32	16
`XTEA`	16	8
Stream-Chiffren
`CHACHA20`	16, 32	1	Die Nonce-Größe (IV) beträgt 8 oder 12 Byte.Für Nonce-Größe 8 ist initial_counter eine 64-Bit-Ganzzahl, für Größe 12 32-Bit.
`RC4`	5 - 256	1
`SOBER128`	4x	1	Nonce-Größe (IV) beträgt 4y Byte, die Länge ist unabhängig von der Schlüsselgröße.

`ENCRYPT`-Beispiele

select encrypt('897897' using sober128 key 'AbcdAbcdAbcdAbcd' iv '01234567')
  from rdb$database;

Siehe auch

[fblangref40-scalarfuncs-decrypt-de], [fblangref40-scalarfuncs-rsaencrypt-de]

`RSA_DECRYPT()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY

Syntax

RSA_DECRYPT (encrypted_input KEY private_key
  [LPARAM tag_string] [HASH <hash>] [PKCS_1_5])

<hash> ::= MD5 | SHA1 | SHA256 | SHA512

Table 1. `RSA_DECRYPT`-Funktionsparameter
Parameter	Beschreibung
encrypted_input	Input data to decrypt
private_key	Anzuwendender privater Schlüssel, PKCS#1-Format
tag_string	Ein zusätzliches systemspezifisches Tag, um zu identifizieren, welches System die Nachricht verschlüsselt hat;Standard ist `NULL`.Wenn das Tag nicht mit dem übereinstimmt, was während der Verschlüsselung verwendet wurde, wird `RSA_DECRYPT` die Daten nicht entschlüsseln.
hash	Der für OAEP-Padding verwendete Hash;Standard ist `SHA256`.

RSA_DECRYPT entschlüsselt encrypted_input mit dem privaten RSA-Schlüssel und dann entpackt OAEP die resultierenden Daten.

Standardmäßig wird OAEP-Padding verwendet.Die Option „PKCS_1_5“ wechselt zum weniger sicheren PKCS 1.5-Padding.Diese Option wurde in Firebird 4.0.1 eingeführt.

Warning

Die Option PKCS_1_5 dient nur der Abwärtskompatibilität mit Systemen, die PKCS 1.5-Padding verwenden.Aus Sicherheitsgründen sollte es nicht in neuen Projekten verwendet werden.

Note	Diese Funktion gibt VARBINARY` zurück. Wenn es sich bei den verschlüsselten Daten um Text handelte, müssen sie explizit in einen Stringtyp mit entsprechendem Zeichensatz umgewandelt werden.

`RSA_DECRYPT`-Beispiele

Tip	Führen Sie die Beispiele `RSA_PRIVATE` und `RSA_PUBLIC`, [fblangref40-scalarfuncs-rsaencrypt-exmpl-de]-Funktionen zuerst aus.

select cast(rsa_decrypt(rdb$get_context('USER_SESSION', 'msg')
  key rdb$get_context('USER_SESSION', 'private_key')) as varchar(128))
from rdb$database;

Siehe auch

[fblangref40-scalarfuncs-rsaencrypt-de], [fblangref40-scalarfuncs-rsaprivate-de], [fblangref40-scalarfuncs-decrypt-de]

`RSA_ENCRYPT()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY

Syntax

RSA_ENCRYPT (input KEY public_key
  [LPARAM tag_string] [HASH <hash>] [PKCS_1_5])

<hash> ::= MD5 | SHA1 | SHA256 | SHA512

Table 1. `RSA_ENCRYPT`-Funktionsparameter
Parameter	Beschreibung
input	Eingabedaten zum Verschlüsseln
public_key	Öffentlicher Schlüssel zum Anwenden, PKCS#1-Format
tag_string	Ein zusätzliches systemspezifisches Tag, um zu identifizieren, welches System die Nachricht verschlüsselt hat;Standard ist `NULL`.
hash	Der für OAEP-Padding verwendete Hash;Standard ist `SHA256`.

RSA_ENCRYPT füllt input mit dem OAEP-Padding-Schema auf und verschlüsselt es dann mit dem angegebenen öffentlichen RSA-Schlüssel.Diese Funktion wird normalerweise verwendet, um kurze symmetrische Schlüssel zu verschlüsseln, die dann in Blockchiffren verwendet werden, um eine Nachricht zu verschlüsseln.

Standardmäßig wird OAEP-Padding verwendet.Die Option PKCS_1_5 wechselt zum weniger sicheren PKCS 1.5-Padding.Diese Option wurde in Firebird 4.0.1 eingeführt.

Warning

Die Option PKCS_1_5 dient nur der Abwärtskompatibilität mit Systemen, die PKCS 1.5-Padding verwenden.Aus Sicherheitsgründen sollte es nicht in neuen Projekten verwendet werden.

`RSA_ENCRYPT`-Beispiele

Tip	Führen Sie zuerst die Beispiele der Funktionen `RSA_PRIVATE` und `RSA_PUBLIC` aus.

select rdb$set_context('USER_SESSION', 'msg', rsa_encrypt('Some message'
  key rdb$get_context('USER_SESSION', 'public_key'))) from rdb$database;

Siehe auch

[fblangref40-scalarfuncs-rsadecrypt-de], [fblangref40-scalarfuncs-rsapublic-de], [fblangref40-scalarfuncs-encrypt-de]

`RSA_PRIVATE()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY

Syntax

RSA_PRIVATE (key_length)

Table 1. `RSA_PRIVATE`-Funktionsparameter
Parameter	Beschreibung
key_length	Schlüssellänge in Byte;mindestens 4, maximal 1024.Eine Größe von 256 Byte (2048 Bit) oder größer wird empfohlen.

RSA_PRIVATE generiert einen privaten RSA-Schlüssel der angegebenen Länge (in Bytes) im PKCS#1-Format.

Note	Je größer die angegebene Länge, desto länger dauert es, bis die Funktion einen privaten Schlüssel generiert.

`RSA_PRIVATE`-Beispiel

select rdb$set_context('USER_SESSION', 'private_key', rsa_private(256))
  from rdb$database;

Warning

Das Einfügen privater Schlüssel in die Kontextvariablen ist nicht sicher.SYSDBA und Benutzer mit der Rolle RDB$ADMIN oder dem Systemprivileg MONITOR_ANY_ATTACHMENT können alle Kontextvariablen aus allen Anhängen sehen.

Siehe auch

[fblangref40-scalarfuncs-rsapublic-de], [fblangref40-scalarfuncs-rsadecrypt-de]

`RSA_PUBLIC()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY

Syntax

RSA_PUBLIC (private_key)

Table 1. `RSA_PUBLIC`-Funktionsparameter
Parameter	Beschreibung
private_key	Privater RSA-Schlüssel im PKCS#1-Format

RSA_PUBLIC gibt den öffentlichen RSA-Schlüssel im PKCS#1-Format für den bereitgestellten privaten RSA-Schlüssel (auch PKCS#1-Format) zurück.

`RSA_PUBLIC`-Beispiele

Tip	Führen Sie zuerst das Beispiel der Funktion `RSA_PRIVATE` aus.

select rdb$set_context('USER_SESSION', 'public_key',
  rsa_public(rdb$get_context('USER_SESSION', 'private_key'))) from rdb$database;

Siehe auch

[fblangref40-scalarfuncs-rsaprivate-de], [fblangref40-scalarfuncs-rsaencrypt-de]

`RSA_SIGN_HASH()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY

Syntax

RSA_SIGN_HASH (message_digest
  KEY private_key
  [HASH <hash>] [SALT_LENGTH salt_length]
  [PKCS_1_5])

<hash> ::= MD5 | SHA1 | SHA256 | SHA512

Table 1. `RSA_SIGN_HASH`-Funktionsparameter
Parameter	Beschreibung
message_digest	Hash der zu unterschreibenden Nachricht.Der verwendete Hash-Algorithmus sollte mit hash übereinstimmen.
private_key	Privater RSA-Schlüssel im PKCS#1-Format
hash	Hash zum Generieren von PSS-Codierung;Standard ist `SHA256`.Dies sollte der gleiche Hash sein, der zum Generieren von message_digest verwendet wird.
salt_length	Länge des gewünschten Salts in Bytes;Standard ist 8;mindestens 1, maximal 32.Der empfohlene Wert liegt zwischen 8 und 16.

RSA_SIGN_HASH führt die PSS-Kodierung des zu signierenden message_digest durch und signiert mit dem privaten RSA-Schlüssel.

Caution

Diese Funktion erwartet den Hash einer Nachricht (oder Message Digest), nicht die eigentliche Nachricht.Das Argument hash sollte den Algorithmus angeben, der auch verwendet wurde, um diesen Hash zu generieren.

Eine Funktion, die die eigentliche Nachricht zum Hash akzeptiert, könnte in einer zukünftigen Version von Firebird eingeführt werden.

PSS-Enkodierung

Probabilistic Signature Scheme (PSS) ist ein kryptografisches Signaturschema, das speziell entwickelt wurde, um moderne Methoden der Sicherheitsanalyse zu ermöglichen, um zu beweisen, dass seine Sicherheit direkt mit der des RSA-Problems zusammenhängt.Es gibt keinen solchen Beweis für das traditionelle PKCS#1 v1.5-Schema.

`RSA_SIGN_HASH`-Beispiele

Tip	Führen Sie zuerst das Beispiel der Funktion `RSA_PRIVATE` aus.

select rdb$set_context('USER_SESSION', 'msg',
  rsa_sign_hash(crypt_hash('Test message' using sha256)
    key rdb$get_context('USER_SESSION', 'private_key'))) from rdb$database;

Siehe auch

[fblangref40-scalarfuncs-rsaverifyhash-de], [fblangref40-scalarfuncs-rsaprivate-de], [fblangref40-scalarfuncs-crypthash-de]

`RSA_VERIFY_HASH()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

BOOLEAN

Syntax

RSA_VERIFY_HASH (message_digest
  SIGNATURE signature KEY public_key
  [HASH <hash>] [SALT_LENGTH salt_length]
  [PKCS_1_5])

<hash> ::= MD5 | SHA1 | SHA256 | SHA512

Table 1. `RSA_VERIFY`-Funktionsparameter
Parameter	Beschreibung
message_digest	Hash der zu überprüfenden Nachricht.Der verwendete Hash-Algorithmus sollte mit hash übereinstimmen.
signature	Erwartete Signatur von input generiert von `RSA_SIGN_HASH`
public_key	öffentlicher RSA-Schlüssel im PKCS#1-Format, der dem zum Signieren verwendeten privaten Schlüssel entspricht
hash	Hash für den Message Digest;Standard ist `SHA256`.Dies sollte derselbe Hash sein, der zum Generieren von message_digest und in `RSA_SIGN_HASH` verwendet wird
salt_length	Länge des Salts in Bytes;Standard ist 8;mindestens 1, maximal 32.Der Wert muss der in `RSA_SIGN_HASH` verwendeten Länge entsprechen.

RSA_VERIFY_HASH führt die PSS-Kodierung des zu verifizierenden message_digest durch und verifiziert die digitale Signatur unter Verwendung des bereitgestellten öffentlichen RSA-Schlüssels.

Standardmäßig wird OAEP-Padding verwendet.Die Option PKCS_1_5 wechselt zum weniger sicheren PKCS 1.5-Padding.Diese Option wurde in Firebird 4.0.1 eingeführt.

Warning

Die Option PKCS_1_5 dient nur der Abwärtskompatibilität mit Systemen, die PKCS 1.5-Padding verwenden.Aus Sicherheitsgründen sollte es nicht in neuen Projekten verwendet werden.

Caution

Eine Funktion, die die eigentliche Nachricht zum Hash akzeptiert, könnte in einer zukünftigen Version von Firebird eingeführt werden.

`RSA_VERIFY_HASH`-Beispiele

Tip	Führen Sie die Beispiele `RSA_PRIVATE`-, `RSA_PUBLIC`- und [fblangref40-scalarfuncs-rsasignhash-exmpl-de]-Funktionen zuerst aus.

select rsa_verify_hash(
  crypt_hash('Test message' using sha256)
  signature rdb$get_context('USER_SESSION', 'msg')
  key rdb$get_context('USER_SESSION', 'public_key'))
from rdb$database

Siehe auch

[fblangref40-scalarfuncs-rsasignhash-de], [fblangref40-scalarfuncs-rsapublic-de], [fblangref40-scalarfuncs-crypthash-de]

Weitere Funktionen

Funktionen, die in keine andere Kategorie passen.

`MAKE_DBKEY()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

BINARY(8)

Syntax

MAKE_DBKEY (relation, recnum [, dpnum [, ppnum]])

Table 1. `MAKE_DBKEY`-Funktionsparameter
Parameter	Beschreibung
relation	Relationsname oder Relations-ID
recnum	Datensatznummer.Entweder absolut (wenn dpnum und ppnum fehlen) oder relativ (wenn dpnum vorhanden)
dpnum	Datenseitennummer.Entweder absolut (wenn ppnum nicht vorhanden ist) oder relativ (wenn ppnum vorhanden ist)
ppnum	Seitennummer des Zeigers.

MAKE_DBKEY erstellt einen DBKEY-Wert unter Verwendung eines Beziehungsnamens oder einer ID, einer Datensatznummer und (optional) einer logischen Nummer der Datenseite und der Zeigerseite.

Note

Wenn relation ein Zeichenfolgenausdruck oder ein Literal ist, wird es als Beziehungsname behandelt und die Engine sucht nach der entsprechenden Beziehungs-ID.Bei der Suche wird die Groß-/Kleinschreibung beachtet.Im Fall eines Zeichenfolgenliterals wird die Beziehungs-ID zum Zeitpunkt der Abfragevorbereitung ausgewertet.Im Fall von expression wird die Beziehungs-ID zur Ausführungszeit ausgewertet.Wenn die Relation nicht gefunden werden kann, wird der Fehler isc_relnotdef ausgegeben.
Wenn relation ein numerischer Ausdruck oder ein Literal ist, dann wird es als Relations-ID behandelt und "wie besehen" verwendet, ohne Prüfung gegen bestehende Beziehungen.Wenn der Argumentwert negativ oder größer als die maximal zulässige Beziehungs-ID (derzeit 65535) ist, wird NULL zurückgegeben.
Das Argument recnum stellt eine absolute Datensatznummer in der Relation dar (wenn die nächsten Argumente dpnum und ppnum fehlen) oder eine Datensatznummer relativ zum ersten Datensatz, angegeben durch die nächsten Argumente.
Das Argument dpnum ist eine logische Nummer der Datenseite in der Relation (wenn das nächste Argument ppnum fehlt) oder die Anzahl der Datenseiten relativ zur ersten Datenseite, die durch die angegebene ppnum adressiert wird.
Argument ppnum ist eine logische Nummer der Zeigerseite in der Relation.
Alle Zahlen sind nullbasiert.Der maximal zulässige Wert für dpnum und ppnum ist 2³² (4294967296).Wenn dpnum angegeben ist, kann recnum negativ sein.Wenn dpnum fehlt und recnum negativ ist, wird NULL zurückgegeben.Wenn ppnum angegeben ist, kann dpnum negativ sein.Wenn ppnum fehlt und dpnum negativ ist, wird NULL zurückgegeben.
Wenn eines der angegebenen Argumente NULL ist, ist das Ergebnis ebenfalls NULL.
Das Argument relation wird während der Abfragevorbereitung als INTEGER beschrieben, kann aber von einer Client-Anwendung als VARCHAR oder CHAR überschrieben werden.Die Argumente recnum, dpnum und ppnum werden als BIGINT beschrieben.

Beispiele für `MAKE_DBKEY`

Wählen Sie den Datensatz mit dem Beziehungsnamen aus (beachten Sie, dass der Beziehungsname in Großbuchstaben geschrieben ist)
```
select *
from rdb$relations
where rdb$db_key = make_dbkey('RDB$RELATIONS', 0)
```

Datensatz mit Beziehungs-ID auswählen

select *
from rdb$relations
where rdb$db_key = make_dbkey(6, 0)

Wählen Sie alle Datensätze aus, die sich physisch auf der ersten Datenseite befinden

select *
from rdb$relations
where rdb$db_key >= make_dbkey(6, 0, 0)
and rdb$db_key < make_dbkey(6, 0, 1)

Wählen Sie alle Datensätze aus, die sich physisch auf der ersten Datenseite der 6. Zeigerseite befinden

select *
from SOMETABLE
where rdb$db_key >= make_dbkey('SOMETABLE', 0, 0, 5)
and rdb$db_key < make_dbkey('SOMETABLE', 0, 1, 5)

`RDB$ERROR()`

Verfügbar in

PSQL

Rückgabetyp

Variiert (siehe Tabelle unten)

Syntax

RDB$ERROR (<context>)

<context> ::=
  GDSCODE | SQLCODE | SQLSTATE | EXCEPTION | MESSAGE

Table 1. Kontexte
Kontext	Rückgabetyp	Beschreibung
`GDSCODE`	`INTEGER`	Firebird-Fehlercode, siehe auch `GDSCODE`
`SQLCODE`	`INTEGER`	(veraltet) SQL-Code, siehe auch `SQLCODE`
`SQLSTATE`	`CHAR(5) CHARACTER SET ASCII`	SQLstate, siehe auch `SQLSTATE`
`EXCEPTION`	`VARCHAR(63) CHARACTER SET UTF8`	Name der aktiven benutzerdefinierten Ausnahme oder `NULL`, wenn die aktive Ausnahme eine Systemausnahme ist
`MESSAGE`	`VARCHAR(1024) CHARACTER SET UTF8`	Nachrichtentext der aktiven Ausnahme

RDB$ERROR gibt Daten des angegebenen Kontexts über die aktive PSQL-Ausnahme zurück.Sein Geltungsbereich ist auf Ausnahmebehandlungsblöcke in PSQL beschränkt (WHEN … DO).Außerhalb der Ausnahmebehandlungsblöcke gibt RDB$ERROR immer NULL zurück.Diese Funktion kann nicht aus DSQL aufgerufen werden.

Beispiel für RDB$ERROR

BEGIN
  ...
WHEN ANY DO
  EXECUTE PROCEDURE P_LOG_EXCEPTION(RDB$ERROR(MESSAGE));
END

Siehe auch

Abfangen und Behandeln von Fehlern, GDSCODE, SQLCODE, SQLSTATE

`RDB$GET_TRANSACTION_CN()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

BIGINT

Syntax

RDB$GET_TRANSACTION_CN (transaction_id)

Table 1. `RDB$GET_TRANSACTION_CN`-Funktionsparameter
Parameter	Beschreibung
transaction_id	Transaktions-ID

RDB$GET_TRANSACTION_CN gibt die Commit-Nummer (“CN”) der übergebenen Transaktion zurück.

Wenn der Rückgabewert größer als 1 ist, ist dies der tatsächliche CN der Transaktion, wenn sie nach dem Start der Datenbank festgeschrieben wurde.

Die Funktion kann auch eines der folgenden Ergebnisse zurückgeben, das den Commit-Status der Transaktion angibt:

`-2`	Transaktion ist tot (zurückgerollt)
`-1`	Transaktion ist in der Schwebe
`0`	Transaktion ist aktiv
`1`	Transaktion, die vor dem Start der Datenbank festgeschrieben wurde oder weniger als die älteste interessante Transaktion für die Datenbank ist
`NULL`	Die angegebene Transaktionsnummer ist NULL oder größer als Nächste Transaktion für die Datenbank

Note	Weitere Informationen zu CN finden Sie in den Firebird 4.0 Release Notes.

`RDB$GET_TRANSACTION_CN`-Beispiele

select rdb$get_transaction_cn(current_transaction) from rdb$database;
select rdb$get_transaction_cn(123) from rdb$database;

`RDB$ROLE_IN_USE()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

BOOLEAN

Syntax

RDB$ROLE_IN_USE (role_name)

Table 1. `RDB$ROLE_IN_USE`-Funktionsparameter
Parameter	Beschreibung
role_name	Zeichenfolgenausdruck für die zu prüfende Rolle.Groß-/Kleinschreibung muss mit dem in `RDB$ROLES` gespeicherten Rollennamen übereinstimmen

RDB$ROLE_IN_USE gibt TRUE zurück, wenn die angegebene Rolle für die aktuelle Verbindung aktiv ist, andernfalls FALSE.Im Gegensatz zu CURRENT_ROLE — das nur die explizit angegebene Rolle zurückgibt — kann diese Funktion verwendet werden, um nach Rollen zu suchen, die standardmäßig aktiv sind, oder auf kumulative Rollen, die von einem explizit aktiviert wurden angegebene Rolle.

`RDB$ROLE_IN_USE`-Beispiel

Aktuell aktive Rollen auflisten

select rdb$role_name
from rdb$database
where rdb$role_in_use(rdb$role_name);

Siehe auch

CURRENT_ROLE

`RDB$SYSTEM_PRIVILEGE()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

BOOLEAN

Syntax

RDB$SYSTEM_PRIVILEGE (<sys_privilege>)

<sys_privilege> ::=
  !! Siehe auch CREATE ROLE !!

Table 1. `RDB$SYSTEM_PRIVILEGE`-Funktionsparameter
Parameter	Beschreibung
sys_privilege	Systemprivileg

RDB$SYSTEM_PRIVILEGE akzeptiert einen Systemprivilegnamen und gibt TRUE zurück, wenn der aktuelle Anhang das angegebene Systemprivileg hat, andernfalls FALSE.

`RDB$SYSTEM_PRIVILEGE`-Beispiel

select rdb$system_privilege(user_management) from rdb$database;

Siehe auch

Fein abgestufte Systemprivilegien

Mathematische Funktionen

`ABS()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

Numerisch

Syntax

ABS (number)

Table 1. `ABS`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt den absoluten Wert des Arguments zurück.

`COS()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

COS (angle)

Table 1. `COS`-Funktionsparameter
Parameter	Beschreibung
angle	Ein Winkel im Bogenmaß

Gibt den Kosinus eines Winkels zurück.Das Argument muss im Bogenmaß angegeben werden.

Jedes Ergebnis, das nicht NULL ist, liegt — offensichtlich — im Bereich [-1, 1].

Siehe auch

[fblangref40-scalarfuncs-acos-de], [fblangref40-scalarfuncs-cot-de], [fblangref40-scalarfuncs-sin-de], [fblangref40-scalarfuncs-tan-de]

`COSH()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

COSH (number)

Table 1. `COSH`-Funktionsparameter
Parameter	Beschreibung
number	Eine Zahl eines numerischen Typs

Gibt den hyperbolischen Kosinus des Arguments zurück.

Jedes Ergebnis, das nicht NULL ist, liegt im Bereich [1, INF].

Siehe auch

[fblangref40-scalarfuncs-acosh-de], [fblangref40-scalarfuncs-sinh-de], [fblangref40-scalarfuncs-tanh-de]

`COT()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

COT (angle)

Table 1. `COT`-Funktionsparameter
Parameter	Beschreibung
angle	Ein Winkel im Bogenmaß

Gibt den Kotangens eines Winkels zurück.Das Argument muss im Bogenmaß angegeben werden.

Siehe auch

[fblangref40-scalarfuncs-cos-de], [fblangref40-scalarfuncs-sin-de], [fblangref40-scalarfuncs-tan-de]

`EXP()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

DOUBLE PRECISION

Syntax

EXP (number)

Table 1. `EXP`-Funktionsparameter
Parameter	Beschreibung
number	Eine Zahl eines numerischen Typs

Gibt die natürliche Exponentialfunktion zurück, e^number

Siehe auch

[fblangref40-scalarfuncs-ln-de]

`FLOOR()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

BIGINT für genaue numerische number, oder DOUBLE PRECISION für fließkommagenaue number

Syntax

FLOOR (number)

Table 1. `FLOOR`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt die größte ganze Zahl zurück, die kleiner oder gleich dem Argument ist.

Siehe auch

[fblangref40-scalarfuncs-ceil-de], [fblangref40-scalarfuncs-round-de], [fblangref40-scalarfuncs-trunc-de]

`LN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

LN (number)

Table 1. `LN`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt den natürlichen Logarithmus des Arguments zurück.

Ein Fehler wird ausgegeben, wenn das Argument negativ oder 0 ist.

Siehe auch

[fblangref40-scalarfuncs-exp-de], [fblangref40-scalarfuncs-log-de], [fblangref40-scalarfuncs-log10-de]

`LOG()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

LOG (x, y)

Table 1. `LOG`-Funktionsparameter
Parameter	Beschreibung
x	Basis.Ein Ausdruck eines numerischen Typs
y	Ein Ausdruck eines numerischen Typs

Gibt den x-basierten Logarithmus von y zurück.

Wenn eines der Argumente 0 oder kleiner ist, wird ein Fehler ausgegeben.(Vor 2.5 würde dies NaN, +/-INF oder 0 ergeben, abhängig von den genauen Werten der Argumente.)
Wenn beide Argumente 1 sind, wird NaN zurückgegeben.
Wenn x = 1 und y < 1 ist, wird -INF zurückgegeben.
Wenn x = 1 und y > 1 ist, wird INF zurückgegeben.

Siehe auch

[fblangref40-scalarfuncs-power-de], [fblangref40-scalarfuncs-ln-de], [fblangref40-scalarfuncs-log10-de]

`LOG10()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

LOG10 (number)

Table 1. `LOG10`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt den 10-basierten Logarithmus des Arguments zurück.

Ein Fehler wird ausgegeben, wenn das Argument negativ oder 0 ist.(In Versionen vor 2.5 würden solche Werte zu NaN bzw. -INF führen.)

Siehe auch

[fblangref40-scalarfuncs-power-de], [fblangref40-scalarfuncs-ln-de], [fblangref40-scalarfuncs-log-de]

`MOD()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

SMALLINT, INTEGER oder BIGINT je nach Typ von a.Wenn a ein Gleitkommatyp ist, ist das Ergebnis ein BIGINT.

Syntax

MOD (a, b)

Table 1. `MOD`-Funktionsparameter
Parameter	Beschreibung
a	Ein Ausdruck eines numerischen Typs
b	Ein Ausdruck eines numerischen Typs

Gibt den Rest einer ganzzahligen Division zurück.

Nicht ganzzahlige Argumente werden vor der Division gerundet.“mod(7.5, 2.5)” ergibt also 2 (“mod(8, 3)”), nicht 0.

`PI()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

PI ()

Gibt eine Annäherung an den Wert von pi zurück.

`ACOS()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

ACOS (number)

Table 1. `ACOS`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs im Bereich [-1, 1]

Gibt den Arkuskosinus des Arguments zurück.

Das Ergebnis ist ein Winkel im Bereich [0, pi].

Siehe auch

[fblangref40-scalarfuncs-cos-de], [fblangref40-scalarfuncs-asin-de], [fblangref40-scalarfuncs-atan-de]

`POWER()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

POWER (x, y)

Table 1. `POWER`-Funktionsparameter
Parameter	Beschreibung
x	Ein Ausdruck eines numerischen Typs
y	Ein Ausdruck eines numerischen Typs

Gibt x hoch y (x^y) zurück.

Siehe auch

[fblangref40-scalarfuncs-exp-de], [fblangref40-scalarfuncs-log-de], [fblangref40-scalarfuncs-log10-de], [fblangref40-scalarfuncs-sqrt-de]

`RAND()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

RAND ()

Gibt eine Zufallszahl zwischen 0 und 1 zurück.

`ROUND()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

INTEGER, (skaliert) BIGINT oder DOUBLE PRECISION

Syntax

ROUND (number [, scale])

Table 1. `ROUND`-Funktionsparameter
Parameter	Description
number	Ein Ausdruck eines numerischen Typs
scale	Eine ganze Zahl, die die Anzahl der Nachkommastellen angibt, auf die gerundet werden soll, z. B.: 2 zum Runden auf das nächste Vielfache von 0,01 1 zum Runden auf das nächste Vielfache von 0,1 0 zum Runden auf die nächste ganze Zahl -1 zum Runden auf das nächste Vielfache von 10 -2 zum Runden auf das nächste Vielfache von 100

Rundet eine Zahl auf die nächste ganze Zahl.Wenn der Bruchteil genau '0,5' ist, wird bei positiven Zahlen nach oben und bei negativen Zahlen nach unten gerundet.Mit dem optionalen Argument scale kann die Zahl auf Zehnerpotenzen (Zehner, Hunderter, Zehntel, Hundertstel usw.) statt auf ganze Zahlen gerundet werden.

Important

Wenn Sie an das Verhalten der externen Funktion ROUND gewöhnt sind, beachten Sie bitte, dass die Funktion internal von Null immer auf Hälften rundet, d.h. bei negativen Zahlen nach unten.

`ROUND`-Beispiele

Wenn das Argument scale vorhanden ist, hat das Ergebnis normalerweise die gleiche Skalierung wie das erste Argument:

ROUND(123.654, 1) -- Ergebnis 123.700 (not 123.7)
ROUND(8341.7, -3) -- Ergebnis 8000.0 (not 8000)
ROUND(45.1212, 0) -- Ergebnis 45.0000 (not 45)

Andernfalls ist die Ergebnisskalierung 0:

ROUND(45.1212) -- Ergebnis 45

Siehe auch

[fblangref40-scalarfuncs-ceil-de], [fblangref40-scalarfuncs-floor-de], [fblangref40-scalarfuncs-trunc-de]

`SIGN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

SMALLINT

Syntax

SIGN (number)

Table 1. `SIGN`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt das Vorzeichen des Arguments zurück: -1, 0 oder 1.

`SIN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

SIN (angle)

Table 1. `SIN`-Funktionsparameter
Parameter	Beschreibung
angle	Ein Winkel im Bogenmaß

Gibt den Sinus eines Winkels zurück.Das Argument muss im Bogenmaß angegeben werden.

Jedes Ergebnis, das nicht NULL ist, liegt — offensichtlich — im Bereich [-1, 1].

Siehe auch

[fblangref40-scalarfuncs-asin-de], [fblangref40-scalarfuncs-cos-de], [fblangref40-scalarfuncs-cot-de], [fblangref40-scalarfuncs-tan-de]

`SINH()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

SINH (number)

Table 1. `SINH`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt den hyperbolischen Sinus des Arguments zurück.

Siehe auch

[fblangref40-scalarfuncs-asinh-de], [fblangref40-scalarfuncs-cosh-de], [fblangref40-scalarfuncs-tanh-de]

`SQRT()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

SQRT (number)

Table 1. `SQRT`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt die Quadratwurzel des Arguments zurück.

Wenn number negativ ist, wird ein Fehler ausgegeben.

Siehe auch

[fblangref40-scalarfuncs-power-de]

`TAN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

TAN (angle)

Table 1. `TAN`-Funktionsparameter
Parameter	Beschreibung
angle	Ein Winkel im Bogenmaß

Gibt den Tangens eines Winkels zurück.Das Argument muss im Bogenmaß angegeben werden.

Siehe auch

[fblangref40-scalarfuncs-atan-de], [fblangref40-scalarfuncs-atan2-de], [fblangref40-scalarfuncs-cos-de], [fblangref40-scalarfuncs-cot-de], [fblangref40-scalarfuncs-sin-de], TAN()

`TANH()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

TANH (number)

Table 1. `TANH`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt den hyperbolischen Tangens des Arguments zurück.

Aufgrund von Rundungen liegt jedes Ergebnis, das nicht NULL ist, im Bereich [-1, 1] (mathematisch ist es <-1, 1>).

Siehe auch

[fblangref40-scalarfuncs-atanh-de], [fblangref40-scalarfuncs-cosh-de], TANH()

`TRUNC()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

INTEGER, (scaled) BIGINT or DOUBLE PRECISION

Syntax

TRUNC (number [, scale])

Table 1. `TRUNC`-Funktionsparameter
Parameter	Description
number	Ein Ausdruck eines numerischen Typs
scale	Eine ganze Zahl, die die Anzahl der Dezimalstellen angibt, auf die abgeschnitten werden soll, z. B.: 2 zum Abschneiden auf das nächste Vielfache von 0,01 1 zum Abschneiden auf das nächste Vielfache von 0,1 0 zum Abschneiden auf die nächste ganze Zahl -1 zum Abschneiden auf das nächste Vielfache von 10 -2 zum Abschneiden auf das nächste Vielfache von 100

Gibt den ganzzahligen Teil einer Zahl zurück.Mit dem optionalen Argument scale kann die Zahl auf Zehnerpotenzen (Zehner, Hunderter, Zehntel, Hundertstel usw.) statt auf ganze Zahlen gekürzt werden.

Note

Wenn das Argument scale vorhanden ist, hat das Ergebnis normalerweise die gleiche Skala wie das erste Argument, z.
- TRUNC(789.2225, 2) gibt 789.2200 (nicht 789.22) zurück
- TRUNC(345.4, -2) gibt 300.0 (nicht 300) zurück
- TRUNC(-163.41, 0) gibt -163.00 (nicht -163) zurück
Andernfalls ist die Ergebnisskala 0:
- TRUNC(-163.41) gibt -163 zurück

Important

Wenn Sie an das Verhalten der externen Funktion TRUNCATE gewöhnt sind, beachten Sie bitte, dass die interne Funktion TRUNC immer gegen Null abschneidet, d.h. für negative Zahlen nach oben.

Siehe auch

[fblangref40-scalarfuncs-ceil-de], [fblangref40-scalarfuncs-floor-de], [fblangref40-scalarfuncs-round-de]

`ACOSH()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

DOUBLE PRECISION

Syntax

ACOSH (number)

Table 1. `ACOSH`-Funktionsparameter
Parameter	Beschreibung
number	Jeder Nicht-`NULL`-Wert im Bereich [1, INF].

Gibt den inversen hyperbolischen Kosinus des Arguments zurück.

Das Ergebnis liegt im Bereich [0, INF].

Siehe auch

[fblangref40-scalarfuncs-cosh-de], [fblangref40-scalarfuncs-asinh-de], [fblangref40-scalarfuncs-atanh-de]

`ASIN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

ASIN (number)

Table 1. `ASIN`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs im Bereich [-1, 1]

Gibt den Arkussinus des Arguments zurück.

Das Ergebnis ist ein Winkel im Bereich [-pi/2, pi/2].

Siehe auch

[fblangref40-scalarfuncs-sin-de], [fblangref40-scalarfuncs-acos-de], [fblangref40-scalarfuncs-atan-de]

`ASINH()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

DOUBLE PRECISION

Syntax

ASINH (number)

Table 1. `ASINH`-Funktionsparameter
Parameter	Beschreibung
number	Jeder Nicht-`NULL`-Wert im Bereich [-INF, INF].

Gibt den inversen hyperbolischen Sinus des Arguments zurück.

Das Ergebnis liegt im Bereich [-INF, INF].

Siehe auch

[fblangref40-scalarfuncs-sinh-de], [fblangref40-scalarfuncs-acosh-de], [fblangref40-scalarfuncs-atanh-de]

`ATAN()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

ATAN (number)

Table 1. `ATAN`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Die Funktion ATAN gibt den Arkustangens des Arguments zurück.Das Ergebnis ist ein Winkel im Bereich <-pi/2, pi/2>.

Siehe auch

[fblangref40-scalarfuncs-atan2-de], [fblangref40-scalarfuncs-tan-de], [fblangref40-scalarfuncs-acos-de], [fblangref40-scalarfuncs-asin-de]

`ATAN2()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

DOUBLE PRECISION

Syntax

ATAN2 (y, x)

Table 1. `ATAN2`-Funktionsparameter
Parameter	Beschreibung
y	Ein Ausdruck eines numerischen Typs
x	Ein Ausdruck eines numerischen Typs

Gibt den Winkel zurück, dessen Sinus-zu-Cosinus-Verhältnis durch die beiden Argumente gegeben ist und dessen Sinus- und Kosinus-Vorzeichen den Vorzeichen der Argumente entsprechen.Dies ermöglicht Ergebnisse über den gesamten Kreis, einschließlich der Winkel -pi/2 und pi/2.

Das Ergebnis ist ein Winkel im Bereich [-pi, pi].
Wenn x negativ ist, ist das Ergebnis pi, wenn y 0 ist, und -pi, wenn y -0 ist.
Wenn sowohl y als auch x 0 sind, ist das Ergebnis bedeutungslos.Ein Fehler wird ausgegeben, wenn beide Argumente 0 sind.

Eine vollständig äquivalente Beschreibung dieser Funktion ist die folgende: ATAN2(y, x) ist der Winkel zwischen der positiven X-Achse und der Linie vom Ursprung zum Punkt (x, y).Damit ist auch klar, dass ATAN2(0, 0) undefiniert ist.
Wenn x größer als 0 ist, ist ATAN2(y, x) dasselbe wie ATAN(y/x).
Wenn sowohl Sinus als auch Kosinus des Winkels bereits bekannt sind, gibt ATAN2(sin, cos) den Winkel an.

`ATANH()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

DOUBLE PRECISION

Syntax

ATANH (number)

Table 1. `ATANH`-Funktionsparameter
Parameter	Beschreibung
number	Jeder Nicht-`NULL`-Wert im Bereich <-1, 1>.

Gibt den inversen hyperbolischen Tangens des Arguments zurück.

Das Ergebnis ist eine Zahl im Bereich [-INF, INF].

Siehe auch

[fblangref40-scalarfuncs-tanh-de], [fblangref40-scalarfuncs-acosh-de], [fblangref40-scalarfuncs-asinh-de]

`CEIL()`, `CEILING()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen (Betrifft nur CEILING)

Ergebnistyp

BIGINT für exakte numerische Zahl oder DOUBLE PRECISION für Gleitkomma-Zahl

Syntax

CEIL[ING] (number)

Table 1. `CEIL[ING]`-Funktionsparameter
Parameter	Beschreibung
number	Ein Ausdruck eines numerischen Typs

Gibt die kleinste ganze Zahl zurück, die größer oder gleich dem Argument ist.

Siehe auch

[fblangref40-scalarfuncs-floor-de], [fblangref40-scalarfuncs-round-de], [fblangref40-scalarfuncs-trunc-de]

String- und Binärfunktionen

`ASCII_CHAR()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

CHAR(1) CHARACTER SET NONE

Syntax

ASCII_CHAR (code)

Table 1. `ASCII_CHAR`-Funktionsparameter
Parameter	Beschreibung
code	Eine ganze Zahl im Bereich von 0 bis 255

Gibt das ASCII-Zeichen zurück, das der im Argument übergebenen Zahl entspricht.

Important

Wenn Sie das Verhalten des ASCII_CHAR-UDF gewohnt sind, das einen leeren String zurückgibt, wenn das Argument 0 ist, beachten Sie bitte, dass die interne Funktion hier korrekt ein Zeichen mit dem ASCII-Code 0 zurückgibt.

`HEX_DECODE()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARBINARY oder BLOB

Syntax

HEX_DECODE (hex_data)

Table 1. `HEX_DECODE`-Funktionsparameter
Parameter	Beschreibung
hex_data	Hex-kodierte Daten

HEX_DECODE decodiert einen String mit Hex-codierten Daten und gibt den decodierten Wert als VARBINARY oder BLOB entsprechend der Eingabe zurück.Wenn die Länge des Typs von hex_data kein Vielfaches von 2 ist, wird zur Vorbereitungszeit ein Fehler ausgegeben.Wenn die Länge des Wertes von hex_data kein Vielfaches von 2 ist, wird zur Ausführungszeit ein Fehler ausgegeben.

Wenn die Eingabe nicht 'BLOB' ist, wird die Länge des resultierenden Typs als 'type_length / 2' berechnet, wobei type_length die maximale Länge in Zeichen des Eingabetyps ist.

Beispiel für `HEX_DECODE`

select cast(hex_decode('48657861646563696D616C') as varchar(12))
from rdb$database;

CAST
============
Hexadecimal

Siehe auch

[fblangref40-scalarfuncs-hexencode-de], [fblangref40-scalarfuncs-base64decode-de]

`HEX_ENCODE()`

Verfügbar in

DSQL, PSQL

Rückgabetyp

VARCHAR CHARACTER SET ASCII oder BLOB SUB_TYPE TEXT CHARACTER SET ASCII

Syntax

HEX_ENCODE (binary_data)

Table 1. `HEX_ENCODE`-Funktionsparameter
Parameter	Beschreibug
binary_data	Binäre Daten (oder anderweitig in Binär umwandelbar) zum Codieren

HEX_ENCODE codiert binary_data mit Hex und gibt den codierten Wert als VARCHAR CHARACTER SET ASCII oder BLOB SUB_TYPE TEXT CHARACTER SET ASCII entsprechend der Eingabe zurück.

Wenn die Eingabe nicht 'BLOB' ist, wird die Länge des resultierenden Typs als 'type_length * 2' berechnet, wobei type_length die maximale Länge in Bytes des Eingabetyps ist.Überschreitet diese Länge die maximale Länge von VARCHAR, gibt die Funktion ein BLOB zurück.

Beispiel für `HEX_ENCODE`

select hex_encode('Hexadecimal')
from rdb$database;

HEX_ENCODE
======================
48657861646563696D616C

Siehe auch

[fblangref40-scalarfuncs-hexdecode-de], [fblangref40-scalarfuncs-base64encode-de]

`LEFT()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR oder BLOB

Syntax

LEFT (string, length)

Table 1. `LEFT`-Funktionsparameter
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs
length	Ganzzahliger Ausdruck.Definiert die Anzahl der zurückzugebenden Zeichen

Gibt den äußersten linken Teil der Argumentzeichenfolge zurück.Die Anzahl der Zeichen wird im zweiten Argument angegeben.

Diese Funktion unterstützt vollständig Text-BLOBs jeder Länge, einschließlich solcher mit einem Multi-Byte-Zeichensatz.
Wenn string ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(n) mit n der Länge des Eingabestrings.
Wenn das Argument length die Stringlänge überschreitet, wird der Eingabestring unverändert zurückgegeben.
Wenn das Argument length keine ganze Zahl ist, wird Banker-Rundung (auf gerade) angewendet, d. h. 0,5 wird zu 0, 1,5 wird zu 2, 2,5 wird zu 2, 3,5 wird zu 4 usw.

Siehe auch

[fblangref40-scalarfuncs-right-de]

`LOWER()`

Verfügbar in

DSQL, ESQL, PSQL

Möglicher Namenskonflikt

YES → Lesen Sie die Details unten

Ergebnistyp

(VAR)CHAR, (VAR)BINARY oder BLOB

Syntax

LOWER (string)

Table 1. `LOWER`-FunktionsparameterS
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs

Gibt das Äquivalent der Eingabezeichenfolge in Kleinbuchstaben zurück.Das genaue Ergebnis hängt vom Zeichensatz ab.Bei ASCII oder NONE beispielsweise werden nur ASCII-Zeichen kleingeschrieben;mit OCTETS wird der gesamte String unverändert zurückgegeben.Seit Firebird 2.1 unterstützt diese Funktion auch Text-BLOBs beliebiger Länge und beliebigem Zeichensatz.

Note

Namenskonflikt

Da LOWER ein reserviertes Wort ist, hat die interne Funktion Vorrang, auch wenn die externe Funktion mit diesem Namen ebenfalls deklariert wurde.Um die (minderwertige!) externe Funktion aufzurufen, verwenden Sie doppelte Anführungszeichen und die genaue Großschreibung, wie in "LOWER"(string).

`LOWER`-Beispiele

select Sheriff from Towns
  where lower(Name) = 'cooper''s valley'

Siehe auch

[fblangref40-scalarfuncs-upper-de]

`LPAD()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

VARCHAR oder BLOB

Syntax

LPAD (str, endlen [, padstr])

Table 1. `LPAD`-Funktionsparameter
Parameter	Beschreibung
str	Ein Ausdruck eines String-Typs
endlen	Länge der Ausgabezeichenfolge
padstr	Das Zeichen oder die Zeichenfolge, die verwendet werden soll, um die Quellzeichenfolge bis zur angegebenen Länge aufzufüllen.Standard ist Leerzeichen (“`' '`”)

Füllt eine Zeichenfolge mit der linken Maustaste mit Leerzeichen oder mit einer vom Benutzer angegebenen Zeichenfolge auf, bis eine bestimmte Länge erreicht ist.

Diese Funktion unterstützt vollständig Text BLOBs jeder Länge und jedes beliebigen Zeichensatzes.
Wenn str ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(endlen).
Wenn padstr angegeben ist und gleich '' (leerer String) ist, findet kein Auffüllen statt.
Wenn endlen kleiner als die aktuelle Stringlänge ist, wird der String auf endlen gekürzt, auch wenn padstr der leere String ist.

Note	In Firebird 2.1-2.1.3 waren alle Nicht-`BLOB`-Ergebnisse vom Typ `VARCHAR(32765)`, was es ratsam machte, sie auf eine bescheidenere Größe umzuwandeln.Dies ist nicht mehr der Fall.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Obwohl es versucht, den Speicherverbrauch zu begrenzen, kann dies die Leistung beeinträchtigen, wenn es um große BLOBs geht.

`LPAD`-Beispiele

lpad ('Hello', 12)               -- Ergebnis '       Hello'
lpad ('Hello', 12, '-')          -- Ergebnis '-------Hello'
lpad ('Hello', 12, '')           -- Ergebnis 'Hello'
lpad ('Hello', 12, 'abc')        -- Ergebnis 'abcabcaHello'
lpad ('Hello', 12, 'abcdefghij') -- Ergebnis 'abcdefgHello'
lpad ('Hello', 2)                -- Ergebnis 'He'
lpad ('Hello', 2, '-')           -- Ergebnis 'He'
lpad ('Hello', 2, '')            -- Ergebnis 'He'

Siehe auch

[fblangref40-scalarfuncs-rpad-de]

`OCTET_LENGTH()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

INTEGER

Syntax

OCTET_LENGTH (string)

Table 1. `OCTET_LENGTH`-Funktionsparameter
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs

Gibt die Länge des Eingabestrings in Bytes (Oktetts) an.Bei Mehrbyte-Zeichensätzen kann dies kleiner sein als die Anzahl der Zeichen mal der “formalen” Anzahl von Bytes pro Zeichen, wie in RDB$CHARACTER_SETS gefunden.

Note

Bei Argumenten vom Typ CHAR oder BINARY berücksichtigt diese Funktion die gesamte formale Stringlänge (d.h. die deklarierte Länge eines Feldes oder einer Variablen).Wenn Sie die “logische” Bytelänge erhalten möchten, ohne die abschließenden Leerzeichen zu zählen, rechts-TRIM das Argument vor der Übergabe an OCTET_LENGTH.

BLOB-Unterstützung

Seit Firebird 2.1 unterstützt diese Funktion vollständig Text-BLOBs jeder Länge und jedes beliebigen Zeichensatzes.

`OCTET_LENGTH`-Beispiele

select octet_length('Hello!') from rdb$database
-- Ergebnis 6

select octet_length(_iso8859_1 'Grüß di!') from rdb$database
-- Ergebnis 8: ü und ß belegen in ISO8859_1 jeweils ein Byte

select octet_length
  (cast (_iso8859_1 'Grüß di!' as varchar(24) character set utf8))
from rdb$database
-- Ergebnis 10: ü und ß belegen in UTF8 jeweils zwei Byte

select octet_length
  (cast (_iso8859_1 'Grüß di!' as char(24) character set utf8))
from rdb$database
-- Ergebnis 26: alle 24 CHAR-Positionen zählen, und zwei davon sind 2-Byte

Siehe auch

[fblangref40-scalarfuncs-bit-length-de], [fblangref40-scalarfuncs-char-length-de]

`OVERLAY()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR oder BLOB

Syntax

OVERLAY (string PLACING replacement FROM pos [FOR length])

Table 1. `OVERLAY`-Funktionsparameter
Parameter	Beschreibung
string	Die Zeichenfolge, in die die Ersetzung erfolgt
replacement	Ersetzende Zeichenkette
pos	Die Position, von der aus ersetzt wird (Ausgangsposition)
length	Die Anzahl der zu überschreibenden Zeichen

OVERLAY() überschreibt einen Teil eines Strings mit einem anderen String.Standardmäßig entspricht die Anzahl der aus der Hostzeichenfolge entfernten (überschriebenen) Zeichen der Länge der Ersetzungszeichenfolge.Mit dem optionalen vierten Argument kann eine andere Anzahl von Zeichen zum Entfernen angegeben werden.

Diese Funktion unterstützt BLOBs beliebiger Länge.
Wenn string oder replacement ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(n) mit n der Summe der Längen von string und replacement.
Wie bei SQL-Stringfunktionen üblich, ist pos 1-basiert.
Wenn pos hinter dem Ende von string steht, wird replacement direkt nach string platziert.
Wenn die Anzahl der Zeichen von pos bis zum Ende von string kleiner ist als die Länge von replacement (oder als das length-Argument, falls vorhanden), wird string an pos abgeschnitten und replacement dahinter platziert.
Eine “FOR 0”-Klausel bewirkt, dass replacement einfach in string eingefügt wird.
Wenn ein Argument NULL ist, ist das Ergebnis NULL.
Wenn pos oder length keine ganze Zahl ist, wird Banker-Rundung (auf-gerade) angewendet, d. h. 0,5 wird zu 0, 1,5 wird zu 2, 2,5 wird zu 2, 3,5 wird zu 4 usw.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Dies kann die Leistung beeinträchtigen, wenn es um große BLOBs geht.

`OVERLAY`-Beispiele

overlay ('Goodbye' placing 'Hello' from 2)   -- Ergebnis 'GHelloe'
overlay ('Goodbye' placing 'Hello' from 5)   -- Ergebnis 'GoodHello'
overlay ('Goodbye' placing 'Hello' from 8)   -- Ergebnis 'GoodbyeHello'
overlay ('Goodbye' placing 'Hello' from 20)  -- Ergebnis 'GoodbyeHello'

overlay ('Goodbye' placing 'Hello' from 2 for 0) -- Ergebnis 'GHellooodbye'
overlay ('Goodbye' placing 'Hello' from 2 for 3) -- Ergebnis 'GHellobye'
overlay ('Goodbye' placing 'Hello' from 2 for 6) -- Ergebnis 'GHello'
overlay ('Goodbye' placing 'Hello' from 2 for 9) -- Ergebnis 'GHello'

overlay ('Goodbye' placing '' from 4)        -- Ergebnis 'Goodbye'
overlay ('Goodbye' placing '' from 4 for 3)  -- Ergebnis 'Gooe'
overlay ('Goodbye' placing '' from 4 for 20) -- Ergebnis 'Goo'

overlay ('' placing 'Hello' from 4)          -- Ergebnis 'Hello'
overlay ('' placing 'Hello' from 4 for 0)    -- Ergebnis 'Hello'
overlay ('' placing 'Hello' from 4 for 20)   -- Ergebnis 'Hello'

Siehe auch

[fblangref40-scalarfuncs-replace-de]

`POSITION()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

INTEGER

Syntax

  POSITION (substr IN string)
| POSITION (substr, string [, startpos])

Table 1. `POSITION`-Funktionsparameter
Parameter	Beschreibung
substr	Der Teilstring, dessen Position gesucht werden soll
string	Der zu suchende String
startpos	Die Position in string, an der die Suche beginnen soll

Gibt die (1-basierte) Position des ersten Vorkommens einer Teilzeichenfolge in einer Hostzeichenfolge zurück.Mit dem optionalen dritten Argument beginnt die Suche an einem bestimmten Offset, wobei alle Übereinstimmungen ignoriert werden, die früher in der Zeichenfolge auftreten können.Wenn keine Übereinstimmung gefunden wird, ist das Ergebnis 0.

Note

Das optionale dritte Argument wird nur in der zweiten Syntax (Komma-Syntax) unterstützt.
Die leere Zeichenfolge wird als Teilzeichenfolge jeder Zeichenfolge betrachtet.Wenn also substr '' (leerer String) ist und string nicht NULL ist, ist das Ergebnis:
- 1 wenn startpos nicht angegeben ist;
- startpos wenn startpos innerhalb von string liegt;
- 0, wenn startpos hinter dem Ende von string liegt.
Hinweis: Ein Fehler in Firebird 2.1 - 2.1.3 und 2.5.0 führt dazu, dass POSITION immer 1 zurückgibt, wenn substr der leere String ist.Dies ist in 2.1.4 und 2.5.1 behoben.
Diese Funktion unterstützt vollständig Text-BLOBs jeder Größe und jedes Zeichensatzes.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Dies kann die Leistung beeinträchtigen, wenn es um große BLOBs geht.

`POSITION`-Beispiele

position ('be' in 'To be or not to be')   -- Ergebnis 4
position ('be', 'To be or not to be')     -- Ergebnis 4
position ('be', 'To be or not to be', 4)  -- Ergebnis 4
position ('be', 'To be or not to be', 8)  -- Ergebnis 17
position ('be', 'To be or not to be', 18) -- Ergebnis 0
position ('be' in 'Alas, poor Yorick!')   -- Ergebnis 0

Siehe auch

[fblangref40-scalarfuncs-substring-de]

`REPLACE()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR oder BLOB

Syntax

REPLACE (str, find, repl)

Table 1. `REPLACE`-Funktionsparameter
Parameter	Beschreibung
str	Die Zeichenfolge, in der die Ersetzung erfolgen soll
find	Die Zeichenfolge, nach der gesucht werden soll
repl	Die Ersatzzeichenfolge

Ersetzt alle Vorkommen einer Teilzeichenfolge in einer Zeichenfolge.

Diese Funktion unterstützt vollständig Text BLOBs jeder Länge und jedes beliebigen Zeichensatzes.
Wenn ein Argument ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(n) mit n, das aus den Längen von str, find und repl so berechnet wird, dass auch die maximal mögliche Anzahl von Ersetzungen das Feld nicht überläuft.
Wenn find der leere String ist, wird str unverändert zurückgegeben.
Wenn repl der leere String ist, werden alle Vorkommen von find aus str gelöscht.
Wenn ein Argument NULL ist, ist das Ergebnis immer NULL, auch wenn nichts ersetzt worden wäre.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Dies kann die Leistung beeinträchtigen, wenn es um große BLOBs geht.

`REPLACE`-Beispiele

replace ('Billy Wilder',  'il', 'oog') -- Ergebnis 'Boogly Woogder'
replace ('Billy Wilder',  'il',    '') -- Ergebnis 'Bly Wder'
replace ('Billy Wilder',  null, 'oog') -- Ergebnis NULL
replace ('Billy Wilder',  'il',  null) -- Ergebnis NULL
replace ('Billy Wilder', 'xyz',  null) -- Ergebnis NULL (!)
replace ('Billy Wilder', 'xyz', 'abc') -- Ergebnis 'Billy Wilder'
replace ('Billy Wilder',    '', 'abc') -- Ergebnis 'Billy Wilder'

Siehe auch

[fblangref40-scalarfuncs-overlay-de], [fblangref40-scalarfuncs-substring-de], [fblangref40-scalarfuncs-position-de], [fblangref40-scalarfuncs-char-length-de]

`REVERSE()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR

Syntax

REVERSE (string)

Table 1. `REVERSE`-Funktionsparameter
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs

Gibt eine Zeichenfolge rückwärts zurück.

`REVERSE`-Beispiele

reverse ('spoonful')            -- Ergebnis 'lufnoops'
reverse ('Was it a cat I saw?') -- Ergebnis '?was I tac a ti saW'

Tip

Diese Funktion ist sehr praktisch, wenn Sie nach String-Endungen gruppieren, suchen oder sortieren möchten, z.B. beim Umgang mit Domainnamen oder E-Mail-Adressen:

create index ix_people_email on people
  computed by (reverse(email));

select * from people
  where reverse(email) starting with reverse('.br');

`ASCII_VAL()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

SMALLINT

Syntax

ASCII_VAL (ch)

Table 1. `ASCII_VAL`-Funktionsparameter
Parameter	Beschreibung
ch	Ein String vom Datentyp `[VAR]CHAR` oder ein Text `BLOB` mit der maximalen Größe von 32.767 Bytes

Gibt den ASCII-Code des übergebenen Zeichens zurück.

Wenn das Argument ein String mit mehr als einem Zeichen ist, wird der ASCII-Code des ersten Zeichens zurückgegeben.
Wenn das Argument ein leerer String ist, wird 0 zurückgegeben.
Wenn das Argument NULL ist, wird NULL zurückgegeben.
Wenn das erste Zeichen der Argumentzeichenfolge aus mehreren Byte besteht, wird ein Fehler ausgegeben.(Ein Fehler in Firebird 2.1 - 2.1.3 und 2.5.0 führt zu einem Fehler, wenn beliebiges Zeichen in der Zeichenfolge aus mehreren Byte besteht.Dies ist in den Versionen 2.1.4 und 2.5.1 behoben.)

`RIGHT()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

VARCHAR oder BLOB

Syntax

RIGHT (string, length)

Table 1. `RIGHT`-Funktionsparameter
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs
length	Integer.Definiert die Anzahl der zurückzugebenden Zeichen

Gibt den ganz rechten Teil der Argumentzeichenfolge zurück.Die Anzahl der Zeichen wird im zweiten Argument angegeben.

Diese Funktion unterstützt Text BLOB`s' beliebiger Länge, hat aber einen Fehler in den Versionen 2.1 - 2.1.3 und 2.5.0, der dazu führt, dass es bei Text BLOB``s fehlschlägt, die größer als 1024 Bytes sind, die ein Multi haben -Byte-Zeichensatz.Dies wurde in den Versionen 2.1.4 und 2.5.1 behoben.
Wenn string ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(n) mit n der Länge des Eingabestrings.
Wenn das Argument length die Stringlänge überschreitet, wird der Eingabestring unverändert zurückgegeben.
Wenn das Argument Länge keine ganze Zahl ist, wird Banker-Rundung (auf-gerade) angewendet, d. h. 0,5 wird zu 0, 1,5 wird zu 2, 2,5 wird zu 2, 3,5 wird zu 4 usw.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Dies kann die Leistung beeinträchtigen, wenn es um große BLOBs geht.

Siehe auch

[fblangref40-scalarfuncs-left-de], [fblangref40-scalarfuncs-substring-de]

`RPAD()`

Verfügbar in

DSQL, PSQL

Möglicher Namenskonflikt

YES → Details lesen

Ergebnistyp

VARCHAR oder BLOB

Syntax

RPAD (str, endlen [, padstr])

Table 1. `RPAD`-Funktionsparameter
Parameter	Beschreibung
str	Ein Ausdruck eines String-Typs
endlen	Länge der Ausgabezeichenfolge
endlen	Das Zeichen oder die Zeichenfolge, die verwendet werden soll, um die Quellzeichenfolge bis zur angegebenen Länge aufzufüllen.Standard ist Leerzeichen (`' '`)

Füllt eine Zeichenfolge mit der rechten Maustaste mit Leerzeichen oder mit einer vom Benutzer angegebenen Zeichenfolge auf, bis eine bestimmte Länge erreicht ist.

Diese Funktion unterstützt vollständig Text BLOBs jeder Länge und jedes beliebigen Zeichensatzes.
Wenn str ein BLOB ist, ist das Ergebnis ein BLOB.Andernfalls ist das Ergebnis ein VARCHAR(endlen).
Wenn padstr angegeben ist und gleich '' (leerer String) ist, findet kein Auffüllen statt.
Wenn endlen kleiner als die aktuelle Stringlänge ist, wird der String auf endlen gekürzt, auch wenn padstr der leere String ist.

Note	In Firebird 2.1-2.1.3 waren alle Nicht-`BLOB`-Ergebnisse vom Typ `VARCHAR(32765)`, was es ratsam machte, sie auf eine bescheidenere Größe umzuwandeln.Dies ist nicht mehr der Fall.

Warning

`RPAD`-Beispiele

rpad ('Hello', 12)               -- Ergebnis 'Hello       '
rpad ('Hello', 12, '-')          -- Ergebnis 'Hello-------'
rpad ('Hello', 12, '')           -- Ergebnis 'Hello'
rpad ('Hello', 12, 'abc')        -- Ergebnis 'Helloabcabca'
rpad ('Hello', 12, 'abcdefghij') -- Ergebnis 'Helloabcdefg'
rpad ('Hello', 2)                -- Ergebnis 'He'
rpad ('Hello', 2, '-')           -- Ergebnis 'He'
rpad ('Hello', 2, '')            -- Ergebnis 'He'

Siehe auch

[fblangref40-scalarfuncs-lpad-de]

`SUBSTRING()`

Verfügbar in

DSQL, PSQL

Ergebnistyps

VARCHAR oder BLOB

Syntax

SUBSTRING ( <substring-args> )

<substring-args> ::=
    str FROM startpos [FOR length]
  | str SIMILAR <similar-pattern> ESCAPE <escape>

<similar-pattern> ::=
  <similar-pattern-R1>
  <escape> " <similar-pattern-R2> <escape> "
  <similar-pattern-R3>

Table 1. `SUBSTRING`-Funktionsparameter
Parameter	Beschreibung
str	Ein Ausdruck eines String-Typs
startpos	Ganzzahliger Ausdruck, die Position, von der aus mit dem Abrufen der Teilzeichenfolge begonnen werden soll
length	Die Anzahl der abzurufenden Zeichen nach dem startpos
similar-pattern	Muster für reguläre SQL-Ausdrücke, um nach der Teilzeichenfolge zu suchen
escape	Escape-Zeichen

Gibt die Teilzeichenfolge einer Zeichenfolge beginnend an der angegebenen Position zurück, entweder bis zum Ende der Zeichenfolge oder mit einer bestimmten Länge, oder extrahiert eine Teilzeichenfolge mithilfe eines Musters für reguläre SQL-Ausdrücke.

Wenn ein Argument NULL ist, ist das Ergebnis auch NULL.

Warning

Bei Verwendung auf einem BLOB muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Obwohl es versucht, den Speicherverbrauch zu begrenzen, kann dies die Leistung beeinträchtigen, wenn es um große BLOBs geht.

Positionsbezogener `SUBSTRING`

In ihrer einfachen Positionsform (mit FROM) gibt diese Funktion den Teilstring ab der Zeichenposition startpos zurück (das erste Zeichen ist 1).Ohne das Argument FOR gibt es alle verbleibenden Zeichen in der Zeichenfolge zurück.Bei FOR gibt es length Zeichen oder den Rest des Strings zurück, je nachdem welcher kürzer ist.

Seit Firebird 4.0 kann startpos kleiner als 1 sein.Wenn startpos kleiner als 1 ist, verhält sich Teilzeichenfolge so, als ob die Zeichenfolge 1 - startpos zusätzliche Positionen vor dem eigentlichen ersten Zeichen an Position 1 hätte.Die Länge wird von diesem imaginären Anfang der Zeichenfolge aus betrachtet, sodass die resultierende Zeichenfolge kürzer als die angegebene Länge oder sogar leer sein kann.

Die Funktion unterstützt vollständig binäre und Text BLOBs beliebiger Länge und mit jedem Zeichensatz.Wenn str ein BLOB ist, ist das Ergebnis auch ein BLOB.Bei jedem anderen Argumenttyp ist das Ergebnis ein VARCHAR.

Bei Nicht-BLOB-Argumenten entspricht die Breite des Ergebnisfelds immer der Länge von str, unabhängig von startpos und length.substring('pinhead' from 4 for 2) gibt also ein VARCHAR(7) zurück, das den String 'he' enthält.

Beispiele

insert into AbbrNames(AbbrName)
  select substring(LongName from 1 for 3) from LongNames;

select substring('abcdef' from 1 for 2) from rdb$database;
-- Ergebnis: 'ab'

select substring('abcdef' from 2) from rdb$database;
-- Ergebnis: 'bcdef'

select substring('abcdef' from 0 for 2) from rdb$database;
-- Ergebnis: 'a'
-- und NICHT 'ab', da "nichts" an Position 0 existiert

select substring('abcdef' from -5 for 2) from rdb$database;
-- Egebnis: ''
-- length endet vor dem eigentlichen Anfang des Strings

Regulärer Ausdruck `SUBSTRING`

In der Form des regulären Ausdrucks (mit SIMILAR) gibt die Funktion SUBSTRING einen Teil des Strings zurück, der einem Muster eines regulären SQL-Ausdrucks entspricht.Wenn keine Übereinstimmung gefunden wird, wird NULL zurückgegeben.

Das Muster "SIMILAR" wird aus drei Mustern für reguläre SQL-Ausdrücke gebildet, R1, R2 und R3.Das gesamte Muster hat die Form R1 || '<Escape>"' || R2 || '<Escape>"' || R3, wobei <escape> das in der ESCAPE-Klausel definierte Escape-Zeichen ist.R2 ist das Muster, das mit der zu extrahierenden Teilzeichenfolge übereinstimmt, und wird zwischen doppelten Anführungszeichen mit Escapezeichen eingeschlossen (<escape>", zB “#"” mit Escape-Zeichen ‘ ##+’).R1 entspricht dem Präfix des Strings und R3 dem Suffix des Strings.Sowohl R1 als auch R3 sind optional (sie können leer sein), aber das Muster muss mit der gesamten Zeichenfolge übereinstimmen.Mit anderen Worten, es reicht nicht aus, ein Muster anzugeben, das nur die zu extrahierende Teilzeichenfolge findet.

Tip

Die mit Escapezeichen versehenen doppelten Anführungszeichen um R2 können mit der Definition einer einzelnen Erfassungsgruppe in einer gängigeren Syntax für reguläre Ausdrücke wie PCRE verglichen werden.Das heißt, das vollständige Muster entspricht R1(R2)R3, das mit der gesamten Eingabezeichenfolge übereinstimmen muss, und die Erfassungsgruppe ist die zurückzugebende Teilzeichenfolge.

Note	Wenn einer von R1, R2 oder R3 keine Zeichenfolge der Länge Null ist und nicht das Format eines regulären SQL-Ausdrucks hat, wird eine Ausnahme ausgelöst.

Das vollständige Format für reguläre SQL-Ausdrücke wird in Syntax: Reguläre SQL-Ausdrücke beschrieben

Beispiele

substring('abcabc' similar 'a#"bcab#"c' escape '#')  -- bcab
substring('abcabc' similar 'a#"%#"c' escape '#')     -- bcab
substring('abcabc' similar '_#"%#"_' escape '#')     -- bcab
substring('abcabc' similar '#"(abc)*#"' escape '#')  -- abcabc
substring('abcabc' similar '#"abc#"' escape '#')     -- <null>

Siehe auch

[fblangref40-scalarfuncs-position-de], [fblangref40-scalarfuncs-left-de], [fblangref40-scalarfuncs-right-de], [fblangref40-scalarfuncs-char-length-de], SIMILAR TO

`TRIM()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR or BLOB

Syntax

TRIM ([<adjust>] str)

<adjust> ::=  {[<where>] [what]} FROM

<where> ::=  BOTH | LEADING | TRAILING

Table 1. `TRIM`-Funktionsparameter
Parameter	Beschreibung
str	Ein Ausdruck eines String-Typs
where	Die Position, aus der der Teilstring entfernt werden soll — `BOTH` \| `LEADING` \| `TRAILING`.`BOTH` ist die Standardeinstellung
what	Die Teilzeichenfolge, die am Anfang, am Ende oder auf beiden Seiten der Eingabezeichenfolge str entfernt werden soll (mehrmals bei mehreren Übereinstimmungen).Standardmäßig ist es Leerzeichen (`' '`)

Entfernt führende und/oder nachgestellte Leerzeichen (oder optional andere Zeichenfolgen) aus der Eingabezeichenfolge.Seit Firebird 2.1 unterstützt diese Funktion vollständig Text-BLOBs jeder Länge und jedes beliebigen Zeichensatzes.

Note	Wenn str ein `BLOB` ist, ist das Ergebnis ein `BLOB`.Andernfalls ist es ein `VARCHAR(n)` mit n der formalen Länge von str.

Warning

Bei Verwendung auf einem 'BLOB' muss diese Funktion möglicherweise das gesamte Objekt in den Speicher laden.Dies kann die Leistung beeinträchtigen, wenn es um große BLOBs geht.

`TRIM`-Beispiele

select trim ('  Waste no space   ') from rdb$database
-- Ergebnis 'Waste no space'

select trim (leading from '  Waste no space   ') from rdb$database
-- Ergebnis 'Waste no space   '

select trim (leading '.' from '  Waste no space   ') from rdb$database
-- Ergebnis '  Waste no space   '

select trim (trailing '!' from 'Help!!!!') from rdb$database
-- Ergebnis 'Help'

select trim ('la' from 'lalala I love you Ella') from rdb$database
-- Ergebnis ' I love you El'

select trim ('la' from 'Lalala I love you Ella') from rdb$database
-- Ergebnis 'Lalala I love you El'

`UPPER()`

Verfügbar in

DSQL, ESQL, PSQL

Ergebnistyp

(VAR)CHAR, (VAR)BINARY oder BLOB

Syntax

UPPER (str)

Table 1. `UPPER`-Funktionsparameter
Parameter	Beschreibung
str	Ein Ausdruck eines String-Typs

Gibt das Äquivalent der Eingabezeichenfolge in Großbuchstaben zurück.Das genaue Ergebnis hängt vom Zeichensatz ab.Bei ASCII oder NONE beispielsweise werden nur ASCII-Zeichen groß geschrieben;mit dem Zeichensatz OCTETS/(VAR)BINARY wird der gesamte String unverändert zurückgegeben.Seit Firebird 2.1 unterstützt diese Funktion auch Text-BLOBs beliebiger Länge und beliebigem Zeichensatz.

`UPPER`-Beispiele

select upper(_iso8859_1 'Débâcle')
from rdb$database
-- Ergebnis 'DÉBÂCLE' (vor Firebird 2.0: 'DéBâCLE')

select upper(_iso8859_1 'Débâcle' collate fr_fr)
from rdb$database
-- Ergebnis 'DEBACLE', nach französischen Großbuchstabenregeln

Siehe auch

[fblangref40-scalarfuncs-lower-de]

`BASE64_DECODE()`

Verfügbar in

DSQL, PSQL

Egebnistyp

VARBINARY oder BLOB

Syntax

BASE64_DECODE (base64_data)

Table 1. `BASE64_DECODE`-Funktionsparameter
Parameter	Beschreibung
base64_data	Base64-codierte Daten, aufgefüllt mit `=` auf Vielfaches von 4

BASE64_DECODE decodiert einen String mit base64-codierten Daten und gibt den decodierten Wert je nach Eingabe als VARBINARY oder BLOB zurück.Wenn die Länge des Typs von base64_data kein Vielfaches von 4 ist, wird zur Vorbereitungszeit ein Fehler ausgegeben.Wenn die Länge des Werts von base64_data kein Vielfaches von 4 ist, wird zur Ausführungszeit ein Fehler ausgegeben.

Wenn die Eingabe nicht BLOB ist, wird die Länge des resultierenden Typs als type_length * 3 / 4 berechnet, wobei type_length die maximale Länge in Zeichen des Eingabetyps ist.

Beispiel für `BASE64_DECODE`

select cast(base64_decode('VGVzdCBiYXNlNjQ=') as varchar(12))
from rdb$database;

CAST
============
Test base64

Siehe auch

[fblangref40-scalarfuncs-base64encode-de], [fblangref40-scalarfuncs-hexdecode-de]

`BASE64_ENCODE()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

VARCHAR CHARACTER SET ASCII oder BLOB SUB_TYPE TEXT CHARACTER SET ASCII

Syntax

BASE64_ENCODE (binary_data)

Table 1. `BASE64_ENCODE`-Funktionsparameter
Parameter	Beschreibung
binary_data	Binäre Daten (oder anderweitig in Binär umwandelbar) zum Codieren

BASE64_ENCODE codiert binary_data mit base64 und gibt den codierten Wert je nach Eingabe als VARCHAR CHARACTER SET ASCII oder BLOB SUB_TYPE TEXT CHARACTER SET ASCII zurück.Der zurückgegebene Wert wird mit ‘=’ aufgefüllt, sodass seine Länge ein Vielfaches von 4 ist.

Wenn die Eingabe nicht 'BLOB' ist, wird die Länge des resultierenden Typs berechnet als 'type_length * 4 / 3', aufgerundet auf ein Vielfaches von vier, wobei type_length die maximale Länge in Bytes des Eingabetyps ist.Überschreitet diese Länge die maximale Länge von VARCHAR, gibt die Funktion ein BLOB zurück.

Beispiel für `BASE64_ENCODE`

select base64_encode('Test base64')
from rdb$database;

BASE64_ENCODE
================
VGVzdCBiYXNlNjQ=

Siehe auch

[fblangref40-scalarfuncs-base64decode-de], [fblangref40-scalarfuncs-hexencode-de]

`BIT_LENGTH()`

Verfügbar in

DSQL, PSQL

Ergebnistyp

INTEGER

Syntax

BIT_LENGTH (string)

Table 1. `BIT_LENGTH`-Funktionsparameter
Parameter	Beschreibung
string	Ein Ausdruck eines String-Typs

Gibt die Länge des Eingabestrings in Bits an.Bei Mehrbyte-Zeichensätzen kann dies kleiner sein als die Anzahl der Zeichen mal 8 mal die “formale” Anzahl von Bytes pro Zeichen wie in RDB$CHARACTER_SETS gefunden.

Note

Bei Argumenten vom Typ CHAR berücksichtigt diese Funktion die gesamte formale Stringlänge (d.h. die deklarierte Länge eines Feldes oder einer Variablen).Wenn Sie die “logische” Bitlänge erhalten möchten, ohne die abschließenden Leerzeichen zu zählen, rechts-TRIM das Argument vor der Übergabe an BIT_LENGTH.

BLOB-Unterstützung

Seit Firebird 2.1 unterstützt diese Funktion vollständig Text-BLOBs jeder Länge und jedes beliebigen Zeichensatzes.

`BIT_LENGTH`-Beispiele

select bit_length('Hello!') from rdb$database
-- Ergebnis 48

select bit_length(_iso8859_1 'Grüß di!') from rdb$database
-- Ergebnis 64: ü und ß belegen in ISO8859_1 jeweils ein Byte

select bit_length
  (cast (_iso8859_1 'Grüß di!' as varchar(24) character set utf8))
from rdb$database
-- Ergebnis 80: ü und ß belegen in ISO8859_1 jeweils ein Byte

select bit_length
  (cast (_iso8859_1 'Grüß di!' as char(24) character set utf8))
from rdb$database
-- Ergebnis 208: alle 24 CHAR-Positionen zählen, und zwei davon sind 16-Bit

Siehe auch

[fblangref40-scalarfuncs-octet-length-de], [fblangref40-scalarfuncs-char-length-de]

NORMALIZE_DECFLOAT()

NORMALIZE_DECFLOAT()

Beispiele für NORMALIZE_DECFLOAT

QUANTIZE()

Beispiele für QUANTIZE

TOTALORDER()

Kryptografische Funktionen

DECRYPT()

DECRYPT-Beispiele

ENCRYPT()

ENCRYPT-Beispiele

RSA_DECRYPT()

RSA_DECRYPT-Beispiele

RSA_ENCRYPT()

RSA_ENCRYPT-Beispiele

RSA_PRIVATE()

RSA_PRIVATE-Beispiel

RSA_PUBLIC()

RSA_PUBLIC-Beispiele

RSA_SIGN_HASH()

RSA_SIGN_HASH-Beispiele

RSA_VERIFY_HASH()

RSA_VERIFY_HASH-Beispiele

Weitere Funktionen

MAKE_DBKEY()

Beispiele für MAKE_DBKEY

RDB$ERROR()

Beispiel für RDB$ERROR

RDB$GET_TRANSACTION_CN()

RDB$GET_TRANSACTION_CN-Beispiele

RDB$ROLE_IN_USE()

RDB$ROLE_IN_USE-Beispiel

RDB$SYSTEM_PRIVILEGE()

RDB$SYSTEM_PRIVILEGE-Beispiel

Mathematische Funktionen

ABS()

COS()

COSH()

COT()

EXP()

FLOOR()

LN()

LOG()

LOG10()

MOD()

PI()

ACOS()

POWER()

RAND()

ROUND()

ROUND-Beispiele

SIGN()

SIN()

SINH()

SQRT()

TAN()

TANH()

TRUNC()

ACOSH()

ASIN()

ASINH()

ATAN()

ATAN2()

ATANH()

CEIL(), CEILING()

String- und Binärfunktionen

ASCII_CHAR()

HEX_DECODE()

Beispiel für HEX_DECODE

HEX_ENCODE()

Beispiel für HEX_ENCODE

LEFT()

LOWER()

LOWER-Beispiele

LPAD()

LPAD-Beispiele

OCTET_LENGTH()

OCTET_LENGTH-Beispiele

OVERLAY()

OVERLAY-Beispiele

`NORMALIZE_DECFLOAT()`

Beispiele für `NORMALIZE_DECFLOAT`

`QUANTIZE()`

Beispiele für `QUANTIZE`

`TOTALORDER()`

`DECRYPT()`

`DECRYPT`-Beispiele

`ENCRYPT()`

`ENCRYPT`-Beispiele

`RSA_DECRYPT()`

`RSA_DECRYPT`-Beispiele

`RSA_ENCRYPT()`

`RSA_ENCRYPT`-Beispiele

`RSA_PRIVATE()`

`RSA_PRIVATE`-Beispiel

`RSA_PUBLIC()`

`RSA_PUBLIC`-Beispiele

`RSA_SIGN_HASH()`

`RSA_SIGN_HASH`-Beispiele

`RSA_VERIFY_HASH()`

`RSA_VERIFY_HASH`-Beispiele

`MAKE_DBKEY()`

Beispiele für `MAKE_DBKEY`

`RDB$ERROR()`

`RDB$GET_TRANSACTION_CN()`

`RDB$GET_TRANSACTION_CN`-Beispiele

`RDB$ROLE_IN_USE()`

`RDB$ROLE_IN_USE`-Beispiel

`RDB$SYSTEM_PRIVILEGE()`

`RDB$SYSTEM_PRIVILEGE`-Beispiel

`ABS()`

`COS()`

`COSH()`

`COT()`

`EXP()`

`FLOOR()`

`LN()`

`LOG()`

`LOG10()`

`MOD()`

`PI()`

`ACOS()`

`POWER()`

`RAND()`

`ROUND()`

`ROUND`-Beispiele

`SIGN()`

`SIN()`

`SINH()`

`SQRT()`

`TAN()`

`TANH()`

`TRUNC()`

`ACOSH()`

`ASIN()`

`ASINH()`

`ATAN()`

`ATAN2()`

`ATANH()`

`CEIL()`, `CEILING()`

`ASCII_CHAR()`

`HEX_DECODE()`

Beispiel für `HEX_DECODE`

`HEX_ENCODE()`

Beispiel für `HEX_ENCODE`

`LEFT()`

`LOWER()`

`LOWER`-Beispiele

`LPAD()`

`LPAD`-Beispiele

`OCTET_LENGTH()`

`OCTET_LENGTH`-Beispiele

`OVERLAY()`

`OVERLAY`-Beispiele

`POSITION()`

`POSITION`-Beispiele

`REPLACE()`

`REPLACE`-Beispiele

`REVERSE()`

`REVERSE`-Beispiele