Phần này mô tả các chức năng và toán tử để kiểm tra và thao tác các giá trị cách đọc kèo bóng đá. cách đọc kèo bóng đá trong bối cảnh này bao gồm các giá trị của các loạiNhân vật
, Nhân vật khác nhau
vàText
. Trừ khi có ghi chú khác, tất cả các chức năng được liệt kê dưới đây hoạt động trên tất cả các loại này, nhưng hãy cảnh giác với các tác động tiềm năng của việc sử dụng không gian tự động khi sử dụngký tự
Loại. Một số chức năng cũng tồn tại nguyên bản cho các loại cách đọc kèo bóng đá bit.
SQLXác định một số hàm cách đọc kèo bóng đá sử dụng các từ khóa, thay vì dấu phẩy, để phân tách các đối số. Chi tiết trongBảng 9.8. PostgreSQLCũng cung cấp các phiên bản của các chức năng này sử dụng cú pháp gọi chức năng thông thường (xemBảng 9.9).
trướcPostgreSQL12679_12841Text
. Những sự ép buộc đó đã được gỡ bỏ vì chúng thường xuyên gây ra những hành vi đáng ngạc nhiên.||
) Vẫn chấp nhận đầu vào không cách đọc kèo bóng đá, miễn là ít nhất một đầu vào thuộc loại cách đọc kèo bóng đá, như trongBảng 9.8. Đối với các trường hợp khác, hãy chèn một sự ép buộc rõ ràng cách đọc cách đọc kèo bóng đáoText
Nếu bạn cần sao chép hành vi trước đó.
Bảng 9.8.SQLChức năng cách đọc kèo bóng đá tử
function | Return Type | Mô tả | Ví dụ | result |
---|---|---|---|---|
|
Text |
Concatenation | 'Post' || 'gresql' |
PostgreSQL |
hoặc
|
Text |
Kết nối cách đọc kèo bóng đá với một đầu vào không cách đọc kèo bóng đá | 'Giá trị:' || 42 |
Giá trị: 42 |
|
int |
số bit trong cách đọc kèo bóng đá | bit_length ('jose') |
32 |
hoặc
|
int |
số lượng ký tự trong cách đọc kèo bóng đá | char_length ('jose') |
4 |
|
Text |
Chuyển đổi cách đọc kèo bóng đá thành chữ thường | Hạ ('Tom') |
Tom |
|
int |
Số byte trong cách đọc kèo bóng đá | octet_length ('jose') |
4 |
|
Text |
thay thế con | Lớp phủ ('txxxxas' đặt 'hom' từ 2 cho 4) |
Thomas |
|
int |
Vị trí của cách đọc kèo bóng đá con được chỉ định | vị trí ('om' trong 'Thomas') |
3 |
|
Text |
Trích xuất cách đọc kèo bóng đá con | Subring ('Thomas' từ 2 cho 3) |
Hom |
|
Text |
Trích xuất cách đọc kèo bóng đá con phù hợp với biểu thức chính quy POSIX. Nhìn thấyPhần 9.7Để biết thêm thông tin về khớp mẫu. | Subring ('Thomas' từ '... $') |
mas |
|
Text |
Trích xuất Subring khớpSQLBiểu thức chính quy. Nhìn thấyPhần 9.7Để biết thêm thông tin về khớp mẫu. | Subring ('Thomas' từ '%#"O_A#" _' cho '#') |
OMA |
|
Text |
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự khỏiký tự (một không gian theo mặc định) từ đầu, kết thúc hoặc cả hai đầu (cả là mặc định) củacách đọc kèo bóng đá |
Trim (cả 'xyz' từ 'yxtomxx') |
Tom |
|
Text |
Cú pháp không chuẩn choTrim () |
Trim (cả hai từ 'yxtomxx', 'xyz') |
Tom |
|
Text |
Chuyển đổi cách đọc kèo bóng đá thành trường hợp trên | trên ('tom') |
Tom |
Các hàm thao tác cách đọc kèo bóng đá bổ sung có sẵn và được liệt kê trongBảng 9.9. Một số trong số chúng được sử dụng nội bộ để thực hiệnSQL-Standard Chức năng cách đọc kèo bóng đá được liệt kê trongBảng 9.8.
Bảng 9.9. Các chức năng cách đọc kèo bóng đá khác
function | Loại trả lại | Mô tả | Ví dụ | result |
---|---|---|---|---|
|
int |
ASCIIMã của ký tự đầu tiên của đối số. VìUTF8Trả về điểm mã Unicode của ký tự. Đối với các mã hóa multibyte khác, đối số phải làASCIIký tự. | ascii ('x') |
120 |
|
Text |
Xóa cách đọc kèo bóng đá dài nhất chỉ bao gồm các ký tự trongký tự (một không gian theo mặc định) từ đầu và cuối củacách đọc kèo bóng đá |
btrim ('xyxtrimyyx', 'xyz') |
Trim |
|
Text |
ký tự với mã đã cho. VìUTF8Đối số được coi là điểm mã Unicode. Đối với các mã hóa multibyte khác, đối số phải chỉ địnhASCIIký tự. Ký tự null (0) không được phép vì các loại dữ liệu văn bản không thể lưu trữ byte đó. | CHR (65) |
A |
|
Text |
Concatenate các biểu diễn văn bản của tất cả các đối số. Các đối số null bị bỏ qua. | Concat ('abcde', 2, null, 22) |
ABCDE222 |
|
Text |
Concatenate tất cả trừ đối số đầu tiên với các dấu phân cách. Đối số đầu tiên được sử dụng làm cách đọc kèo bóng đá phân tách. | Concat_ws (',', 'abcde', 2, null, 22) |
ABCDE, 2,22 |
|
bytea |
Chuyển đổi cách đọc kèo bóng đá thànhDest_encoding . Mã hóa gốc được chỉ định bởisrc_encoding . Thecách đọc kèo bóng đá phải hợp lệ trong mã hóa này. Chuyển đổi có thể được xác định bởiTạo chuyển đổi . Ngoài ra có một số chuyển đổi được xác định trước.Bảng 9.10để chuyển đổi có sẵn. |
Chuyển đổi ('text_in_utf8', 'utf8', 'latin1') |
text_in_utf8 được đại diện trong mã hóa Latin-1 (ISO 8859-1) |
|
Text |
Chuyển đổi cách đọc kèo bóng đá thành mã hóa cơ sở dữ liệu. Mã hóa gốc được chỉ định bởisrc_encoding . Thecách đọc kèo bóng đá phải có hiệu lực trong mã hóa này. |
Convert_from ('text_in_utf8', 'utf8') |
text_in_utf8 được biểu thị trong mã hóa cơ sở dữ liệu hiện tại |
|
bytea |
Chuyển đổi cách đọc kèo bóng đá thànhDest_encoding . |
convert_to ('một số văn bản', 'utf8') |
Một số văn bản được đại diện trong mã hóa UTF8 |
|
bytea |
Giải mã dữ liệu nhị phân từ biểu diễn văn bản trongcách đọc kèo bóng đá . Tùy chọn choĐịnh dạng giống như trongmã hóa . |
Decode ('mtizaae =', 'base64') |
\ x3132330001 |
|
Text |
Mã hóa dữ liệu nhị phân thành biểu diễn văn bản. Các định dạng được hỗ trợ là:base64 , Hex , Escape . Escape 31674_31740\ nnn ) và nhân đôi dấu gạch chéo ngược. |
mã hóa ('123 \ 000 \ 001', 'base64') |
mtizaae = |
|
Text |
Định dạng đối số theo cách đọc kèo bóng đá định dạng. Chức năng này tương tự như hàm CSprintf . Nhìn thấyPhần 9.4.1. |
Định dạng ('Xin chào %s, %1 $ s', 'thế giới') |
Hello World, World |
|
Text |
Chuyển đổi chữ cái đầu tiên của mỗi từ sang trường hợp trên và phần còn lại thành chữ thường. Các từ là cách đọc kèo bóng đá các ký tự chữ và số được phân tách bằng các ký tự không phải là ký tự. | initCap ('Hi Thomas') |
Hi Thomas |
|
Text |
trở lại đầu tiênn ký tự trong cách đọc kèo bóng đá. Khin là tiêu cực, trả về tất cả nhưng cuối cùng |n | ký tự. |
trái ('abcde', 2) |
AB |
|
int |
Số lượng ký tự trongcách đọc kèo bóng đá |
LEGN ('Jose') |
4 |
|
int |
số lượng ký tự trongcách đọc kèo bóng đá Trong đã chomã hóa . Thecách đọc kèo bóng đá phải hợp lệ trong mã hóa này. |
LEGN ('Jose', 'UTF8') |
4 |
|
Text |
Điền cách đọc kèo bóng đáocách đọc kèo bóng đá to Longlength bằng cách đọc kèo bóng đá dành các ký tựFILL (một không gian theo mặc định). Nếucách đọc kèo bóng đá đã dài hơnLEGN Sau đó, nó bị cắt ngắn (bên phải). |
lpad ('hi', 5, 'xy') |
XYXHI |
|
Text |
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự khỏiký tự (một khoảng trống theo mặc định) từ khi bắt đầucách đọc kèo bóng đá |
ltrim ('zzzytest', 'xyz') |
test |
|
Text |
Tính toán băm MD5 củacách đọc kèo bóng đá , trả về kết quả trong thập lục phân |
MD5 ('ABC') |
900150983CD24FB0 D6963F7D28E17F72 |
|
Text [] |
Splitđủ điều kiện_identifier thành một mảng các định danh, xóa bất kỳ trích dẫn nào của các định danh riêng lẻ. Theo mặc định, các ký tự bổ sung sau khi định danh cuối cùng được coi là một lỗi;Sai , sau đó các ký tự phụ như vậy bị bỏ qua. .Tên [] . |
parse_ident ('"someschema" .sometable') |
someschema, somesable |
|
tên |
Tên mã hóa máy khách hiện tại | pg_client_encoding () |
SQL_ASCII |
|
Text |
Trả về cách đọc kèo bóng đá đã cho được trích dẫn phù hợp để được sử dụng làm định danh trong mộtSQLcách đọc kèo bóng đá câu lệnh. Báo giá chỉ được thêm vào nếu cần thiết (nghĩa là, nếu cách đọc kèo bóng đá chứa các ký tự không nhận dạng hoặc sẽ được xếp lại trường hợp).Ví dụ 43.1. | quote_ident ('foo Bar') |
"Foo Bar" |
|
Text |
Trả về cách đọc kèo bóng đá đã cho được trích dẫn phù hợp để được sử dụng như một cách đọc kèo bóng đá theo nghĩa đen trong mộtSQLcách đọc kèo bóng đá câu lệnh. Các trích dẫn đơn và dấu gạch chéo được nhúng được nhân đôi đúng cách.quote_literal Trả về NULL trên đầu cách đọc kèo bóng đáo null; Nếu đối số có thể là null,quote_nullable thường phù hợp hơn. Xem thêmVí dụ 43.1. |
quote_literal (e'o \ 'reilly') |
'O''Reilly' |
|
Text |
Hãy ép buộc giá trị đã cho đến văn bản và sau đó trích dẫn nó theo nghĩa đen. Các tài liệu đơn và dấu gạch chéo được nhúng được nhân đôi đúng cách đọc kèo bóng đá. | quote_literal (42.5) |
'42 .5 ' |
|
Text |
Trả về cách đọc kèo bóng đá đã cho được trích dẫn phù hợp để được sử dụng làm cách đọc kèo bóng đá theo nghĩa đen trong mộtSQLcách đọc kèo bóng đá câu lệnh; hoặc, nếu đối số là null, hãy trả vềnull . Các trích dẫn đơn và dấu gạch chéo được nhúng được nhân đôi đúng cách đọc kèo bóng đá.Ví dụ 43.1. |
quote_nullable (null) |
null |
|
Text |
ép buộc giá trị đã cho đến văn bản và sau đó trích dẫn nó theo nghĩa đen; hoặc, nếu đối số là null, hãy trả vềNULL . Các tài liệu đơn và dấu gạch chéo được nhúng được nhân đôi đúng cách đọc kèo bóng đá. |
quote_nullable (42.5) |
'42 .5 ' |
|
Text [] |
44120_44219cách đọc kèo bóng đá . Nhìn thấyPhần 9.7.3Để biết thêm thông tin. |
regexp_match ('foobarbequebaz', '(bar) (beque)') |
Bar, Beque |
|
Text SetOf [] |
45122_45211cách đọc kèo bóng đá . Nhìn thấyPhần 9.7.3Để biết thêm thông tin. |
regexp_matches ('foobarbequebaz', 'ba.', 'G') |
Bar
|
|
Text |
Thay thế (s) khớp với biểu thức chính quy POSIX. Nhìn thấyPhần 9.7.3Để biết thêm thông tin. | regexp_replace ('Thomas', '. [Mn] a.', 'M') |
THM |
|
Text [] |
Splitcách đọc kèo bóng đá Sử dụng biểu thức chính quy POSIX làm dấu phân cách đọc kèo bóng đá. Nhìn thấyPhần 9.7.3Để biết thêm thông tin. |
regexp_split_to_array ('Hello World', '\ s+') |
xin chào, thế giới |
|
Setof Text |
Splitcách đọc kèo bóng đá Sử dụng biểu thức chính quy POSIX làm dấu phân cách đọc kèo bóng đá. Nhìn thấyPhần 9.7.3Để biết thêm thông tin. |
regexp_split_to_table ('Hello World', '\ s+') |
xin chào
|
|
Text |
Lặp lạicách đọc kèo bóng đá được chỉ địnhSố của thời gian |
lặp lại ('pg', 4) |
PGPGPGPG |
|
Text |
Thay thế tất cả các lần xuất hiện trongcách đọc kèo bóng đá của cách đọc kèo bóng đá contừ Với cách đọc kèo bóng đá conđến |
thay thế ('abcdefabcdef', 'cd', 'xx') |
abxxefaBxxef |
|
Text |
cách đọc kèo bóng đá đảo ngược. | Đảo ngược ('ABCDE') |
EDCBA |
|
Text |
trở lại cuối cùngn ký tự trong cách đọc kèo bóng đá. Khin là tiêu cực, trả về tất cả nhưng đầu tiên |n | ký tự. |
phải ('abcde', 2) |
de |
|
Text |
Điền cách đọc kèo bóng đáocách đọc kèo bóng đá đến chiều dàiLEGN Bằng cách đọc kèo bóng đá nối thêm các ký tựFILL (một không gian theo mặc định). Nếucách đọc kèo bóng đá đã dài hơnLEGN Sau đó, nó bị cắt cụt. |
rpad ('hi', 5, 'xy') |
Hixyx |
|
Text |
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự khỏiký tự (một khoảng trống theo mặc định) từ cuốicách đọc kèo bóng đá |
rtrim ('testxxzx', 'xyz') |
test |
|
Text |
Splitcách đọc kèo bóng đá trênDelimiter và trả về trường đã cho (đếm từ một) |
split_part ('abc ~@~ def ~@~ ghi', '~@~', 2) |
def |
|
int |
Vị trí của cách đọc kèo bóng đá con được chỉ định (giống nhưvị trí ( , nhưng lưu ý thứ tự đối số đảo ngược) |
strpos ('cao', 'ig') |
2 |
|
Text |
Trích xuất cách đọc kèo bóng đá con (giống nhưSubring ( ) |
Subrtr ('Bảng chữ cái', 3, 2) |
PH |
|
bool |
Trả về đúng nếucách đọc kèo bóng đá bắt đầu bằngtiền tố . |
starts_with ('bảng chữ cái', 'alph') |
T |
|
Text |
Chuyển đổicách đọc kèo bóng đá đếnASCIITừ mã hóa khác (chỉ hỗ trợ chuyển đổi từLatin1 , Latin2 , Latin9 vàWin1250 mã hóa) |
to_ascii ('karel') |
Karel |
|
Text |
Chuyển đổiSố với biểu diễn thập lục phân tương đương của nó |
TO_HEX (2147483647) |
7fffffff |
|
Text |
Bất kỳ ký tự nào trongcách đọc kèo bóng đá phù hợp với một ký tự trongtừ Đặt được thay thế bằng ký tự tương ứng trongđến Đặt. Nếu nhưtừ dài hơnđến , Sự xuất hiện của các ký tự phụ trongtừ bị xóa. |
dịch ('12345', '143', 'ax') |
A2X5 |
TheConcat
, Concat_WS
vàĐịnh dạng
Các hàm là variadic, do đó có thể truyền các giá trị được nối hoặc định dạng thành một mảng được đánh dấu bằngVariadic
Từ khóa (xemPhần 38.5.5). Các yếu tố của mảng được đối xử như thể chúng là các đối số thông thường riêng biệt cho hàm.Concat
vàConcat_WS
return null, nhưngĐịnh dạng
coi null là mảng không có phần tử.
Xem thêm hàm tổng hợpString_agg
inPhần 9.20.
Bảng 9.10. Chuyển đổi tích hợp
Tên chuyển đổi[A] | Mã hóa nguồn | Mã hóa đích |
---|---|---|
ASCII_TO_MIC |
SQL_ASCII |
Mule_Internal |
ASCII_TO_UTF8 |
SQL_ASCII |
UTF8 |
BIG5_TO_EUC_TW |
Big5 |
EUC_TW |
BIG5_TO_MIC |
Big5 |
Mule_Internal |
BIG5_TO_UTF8 |
Big5 |
UTF8 |
EUC_CN_TO_MIC |
EUC_CN |
Mule_Internal |
EUC_CN_TO_UTF8 |
EUC_CN |
UTF8 |
EUC_JP_TO_MIC |
EUC_JP |
MULE_INTERNAL |
EUC_JP_TO_SJIS |
EUC_JP |
SJIS |
EUC_JP_TO_UTF8 |
EUC_JP |
UTF8 |
EUC_KR_TO_MIC |
EUC_KR |
Mule_Internal |
EUC_KR_TO_UTF8 |
EUC_KR |
UTF8 |
EUC_TW_TO_BIG5 |
EUC_TW |
Big5 |
EUC_TW_TO_MIC |
EUC_TW |
Mule_Internal |
EUC_TW_TO_UTF8 |
EUC_TW |
UTF8 |
GB18030_TO_UTF8 |
GB18030 |
UTF8 |
GBK_TO_UTF8 |
GBK |
UTF8 |
ISO_8859_10_TO_UTF8 |
Latin6 |
UTF8 |
ISO_8859_13_TO_UTF8 |
Latin7 |
UTF8 |
ISO_8859_14_TO_UTF8 |
Latin8 |
UTF8 |
ISO_8859_15_TO_UTF8 |
Latin9 |
UTF8 |
ISO_8859_16_TO_UTF8 |
Latin10 |
UTF8 |
ISO_8859_1_TO_MIC |
Latin1 |
Mule_Internal |
ISO_8859_1_TO_UTF8 |
Latin1 |
UTF8 |
ISO_8859_2_TO_MIC |
Latin2 |
Mule_Internal |
ISO_8859_2_TO_UTF8 |
Latin2 |
UTF8 |
ISO_8859_2_TO_WINDOWS_1250 |
Latin2 |
Win1250 |
ISO_8859_3_TO_MIC |
Latin3 |
Mule_Internal |
ISO_8859_3_TO_UTF8 |
Latin3 |
UTF8 |
ISO_8859_4_TO_MIC |
Latin4 |
MULE_INTERNAL |
ISO_8859_4_TO_UTF8 |
Latin4 |
UTF8 |
ISO_8859_5_TO_KOI8_R |
ISO_8859_5 |
KOI8R |
ISO_8859_5_TO_MIC |
ISO_8859_5 |
Mule_Internal |
ISO_8859_5_TO_UTF8 |
ISO_8859_5 |
UTF8 |
ISO_8859_5_TO_WINDows_1251 |
ISO_8859_5 |
Win1251 |
ISO_8859_5_TO_WINDOWS_866 |
ISO_8859_5 |
Win866 |
ISO_8859_6_TO_UTF8 |
ISO_8859_6 |
UTF8 |
ISO_8859_7_TO_UTF8 |
ISO_8859_7 |
UTF8 |
ISO_8859_8_TO_UTF8 |
ISO_8859_8 |
UTF8 |
ISO_8859_9_TO_UTF8 |
Latin5 |
UTF8 |
Johab_to_utf8 |
Johab |
UTF8 |
KOI8_R_TO_ISO_8859_5 |
KOI8R |
ISO_8859_5 |
KOI8_R_TO_MIC |
KOI8R |
Mule_Internal |
KOI8_R_TO_UTF8 |
KOI8R |
UTF8 |
KOI8_R_TO_WINDOWS_1251 |
KOI8R |
Win1251 |
KOI8_R_TO_WINDOWS_866 |
KOI8R |
Win866 |
KOI8_U_TO_UTF8 |
KOI8U |
UTF8 |
MIC_TO_ASCII |
Mule_Internal |
SQL_ASCII |
MIC_TO_BIG5 |
Mule_Internal |
Big5 |
MIC_TO_EUC_CN |
MULE_INTERNAL |
EUC_CN |
MIC_TO_EUC_JP |
Mule_Internal |
EUC_JP |
MIC_TO_EUC_KR |
MULE_INTERNAL |
EUC_KR |
MIC_TO_EUC_TW |
MULE_INTERNAL |
EUC_TW |
MIC_TO_ISO_8859_1 |
MULE_INTERNAL |
Latin1 |
MIC_TO_ISO_8859_2 |
Mule_Internal |
Latin2 |
MIC_TO_ISO_8859_3 |
MULE_INTERNAL |
Latin3 |
MIC_TO_ISO_8859_4 |
MULE_INTERNAL |
Latin4 |
MIC_TO_ISO_8859_5 |
Mule_Internal |
ISO_8859_5 |
MIC_TO_KOI8_R |
Mule_Internal |
KOI8R |
MIC_TO_SJIS |
Mule_Internal |
SJIS |
MIC_TO_WINDows_1250 |
Mule_Internal |
Win1250 |
MIC_TO_WINDows_1251 |
Mule_Internal |
Win1251 |
MIC_TO_WINDows_866 |
MULE_INTERNAL |
Win866 |
SJIS_TO_EUC_JP |
SJIS |
EUC_JP |
SJIS_TO_MIC |
SJIS |
Mule_Internal |
SJIS_TO_UTF8 |
SJIS |
UTF8 |
Windows_1258_TO_UTF8 |
Win1258 |
UTF8 |
UHC_TO_UTF8 |
UHC |
UTF8 |
UTF8_TO_ASCII |
UTF8 |
SQL_ASCII |
UTF8_TO_BIG5 |
UTF8 |
Big5 |
UTF8_TO_EUC_CN |
UTF8 |
EUC_CN |
UTF8_TO_EUC_JP |
UTF8 |
EUC_JP |
UTF8_TO_EUC_KR |
UTF8 |
EUC_KR |
UTF8_TO_EUC_TW |
UTF8 |
EUC_TW |
UTF8_TO_GB18030 |
UTF8 |
GB18030 |
UTF8_TO_GBK |
UTF8 |
GBK |
UTF8_TO_ISO_8859_1 |
UTF8 |
Latin1 |
UTF8_TO_ISO_8859_10 |
UTF8 |
Latin6 |
UTF8_TO_ISO_8859_13 |
UTF8 |
Latin7 |
UTF8_TO_ISO_8859_14 |
UTF8 |
Latin8 |
UTF8_TO_ISO_8859_15 |
UTF8 |
Latin9 |
UTF8_TO_ISO_8859_16 |
UTF8 |
Latin10 |
UTF8_TO_ISO_8859_2 |
UTF8 |
Latin2 |
UTF8_TO_ISO_8859_3 |
UTF8 |
Latin3 |
UTF8_TO_ISO_8859_4 |
UTF8 |
Latin4 |
UTF8_TO_ISO_8859_5 |
UTF8 |
ISO_8859_5 |
UTF8_TO_ISO_8859_6 |
UTF8 |
ISO_8859_6 |
UTF8_TO_ISO_8859_7 |
UTF8 |
ISO_8859_7 |
UTF8_TO_ISO_8859_8 |
UTF8 |
ISO_8859_8 |
UTF8_TO_ISO_8859_9 |
UTF8 |
Latin5 |
UTF8_TO_JOHAB |
UTF8 |
Johab |
UTF8_TO_KOI8_R |
UTF8 |
KOI8R |
UTF8_TO_KOI8_U |
UTF8 |
KOI8U |
UTF8_TO_SJIS |
UTF8 |
SJIS |
UTF8_TO_WINDows_1258 |
UTF8 |
Win1258 |
UTF8_TO_UHC |
UTF8 |
UHC |
UTF8_TO_WINDows_1250 |
UTF8 |
Win1250 |
UTF8_TO_WINDows_1251 |
UTF8 |
Win1251 |
UTF8_TO_WINDows_1252 |
UTF8 |
Win1252 |
UTF8_TO_WINDows_1253 |
UTF8 |
Win1253 |
UTF8_TO_WINDows_1254 |
UTF8 |
Win1254 |
UTF8_TO_WINDows_1255 |
UTF8 |
Win1255 |
UTF8_TO_WINDows_1256 |
UTF8 |
Win1256 |
UTF8_TO_WINDows_1257 |
UTF8 |
Win1257 |
UTF8_TO_WINDows_866 |
UTF8 |
Win866 |
UTF8_TO_WINDows_874 |
UTF8 |
Win874 |
Windows_1250_TO_ISO_8859_2 |
Win1250 |
Latin2 |
Windows_1250_TO_MIC |
Win1250 |
MULE_INTERNAL |
Windows_1250_TO_UTF8 |
Win1250 |
UTF8 |
Windows_1251_TO_ISO_8859_5 |
Win1251 |
ISO_8859_5 |
Windows_1251_TO_KOI8_R |
Win1251 |
KOI8R |
Windows_1251_TO_MIC |
Win1251 |
MULE_INTERNAL |
Windows_1251_TO_UTF8 |
Win1251 |
UTF8 |
Windows_1251_TO_WINDows_866 |
Win1251 |
Win866 |
Windows_1252_TO_UTF8 |
Win1252 |
UTF8 |
Windows_1256_TO_UTF8 |
Win1256 |
UTF8 |
Windows_866_TO_ISO_8859_5 |
Win866 |
ISO_8859_5 |
Windows_866_TO_KOI8_R |
Win866 |
KOI8R |
Windows_866_TO_MIC |
Win866 |
MULE_INTERNAL |
Windows_866_TO_UTF8 |
Win866 |
UTF8 |
Windows_866_TO_WINDows_1251 |
Win866 |
win |
Windows_874_TO_UTF8 |
Win874 |
UTF8 |
EUC_JIS_2004_TO_UTF8 |
EUC_JIS_2004 |
UTF8 |
UTF8_TO_EUC_JIS_2004 |
UTF8 |
EUC_JIS_2004 |
shift_jis_2004_to_utf8 |
Shift_Jis_2004 |
UTF8 |
UTF8_TO_SHIFT_JIS_2004 |
UTF8 |
shift_jis_2004 |
EUC_JIS_2004_TO_SHIFT_JIS_2004 |
EUC_JIS_2004 |
Shift_Jis_2004 |
shift_jis_2004_to_euc_jis_2004 |
shift_jis_2004 |
EUC_JIS_2004 |
[A]88297_88469 |
Định dạng
hàmĐịnh dạng
Tạo định dạng đầu ra theo cách đọc kèo bóng đá định dạng, theo kiểu tương tự như hàm CSprintf
.
Định dạng
(Định dạng
Text
[,Định dạng
"bất kỳ"
[, ...]])
Định dạng
là một cách đọc kèo bóng đá định dạng chỉ định cách thức kết quả nên được định dạng. Văn bản trong cách đọc kèo bóng đá định dạng được sao chép trực tiếp vào kết quả, ngoại trừ trong đóđịnh dạng xác định định dạngđược sử dụng. Các nhà xác định định dạng đóng vai trò là người giữ chỗ trong cách đọc kèo bóng đá, xác định cách các đối số chức năng tiếp theo nên được định dạng và chèn vào kết quả.Định dạng
Đối số được chuyển đổi thành văn bản theo các quy tắc đầu ra thông thường cho loại dữ liệu của nó, sau đó được định dạng và chèn vào cách đọc kèo bóng đá kết quả theo trình xác định định dạng (s).
Định dạng định dạng được giới thiệu bởi A%
ký tự và có biểu mẫu
%[vị trí
] [cờ
] [Width
]loại
Trường hợp các trường thành phần:
vị trí
(Tùy chọn)Một cách đọc kèo bóng đá của biểu mẫu
WHEREn
$n
là chỉ mục của đối số để in. Chỉ mục 1 có nghĩa là đối số đầu tiên sauĐịnh dạng
. Nếuvị trí
bị bỏ qua, mặc định là sử dụng đối số tiếp theo theo trình tự.
cờ
(Tùy chọn)Tùy chọn bổ sung kiểm soát cách đọc kèo bóng đá định dạng đầu ra của định dạng. Hiện tại cờ được hỗ trợ duy nhất là dấu trừ (-
91432_91535Width
Trường cũng được chỉ định.
Width
(Tùy chọn)Chỉ địnhTối thiểuSố lượng ký tự sẽ sử dụng để hiển thị đầu ra của nhà xác định định dạng. Đầu ra được đệm ở bên trái hoặc bên phải (tùy thuộc cách đọc kèo bóng đáo-
cờ) với khoảng trống khi cần thiết để lấp đầy chiều rộng. Một chiều rộng quá nhỏ không gây ra sự cắt ngắn của đầu ra, nhưng chỉ đơn giản là bị bỏ qua.*
) để sử dụng đối số hàm tiếp theo làm chiều rộng; hoặc một cách đọc kèo bóng đá của biểu mẫu*
Để sử dụngn
$n
Đối số chức năng là chiều rộng.
Nếu chiều rộng xuất phát từ một đối số hàm, đối số đó được tiêu thụ trước khi đối số được sử dụng cho giá trị của nhà xác định định dạng. Nếu đối số chiều rộng âm, kết quả sẽ được căn chỉnh (như thể-
Cờ đã được chỉ định) trong một trường có độ dàiabs
(Width
).
loại
(bắt buộc)Loại chuyển đổi định dạng để sử dụng để tạo ra đầu ra của nhà xác định định dạng. Các loại sau được hỗ trợ:
S
Định dạng giá trị đối số dưới dạng cách đọc kèo bóng đá đơn giản. Giá trị null được coi là một cách đọc kèo bóng đá trống.
i
coi giá trị đối số là định danh SQL, trích dẫn gấp đôi nếu cần thiết. Đó là một lỗi cho giá trị là null (tương đương vớiQUOTE_IDENT
).
L
trích dẫn giá trị đối số dưới dạng SQL theo nghĩa đen. Giá trị null được hiển thị dưới dạng cách đọc kèo bóng đánull
, không có báo giá (tương đương vớiQUOTE_NULLABLE
).
Ngoài các nhà xác định định dạng được mô tả ở trên, cách đọc kèo bóng đá đặc biệt%%
Có thể được sử dụng để xuất ra một chữ%
ký tự.
Đây là một số ví dụ về chuyển đổi định dạng cơ bản:
Chọn định dạng ('Xin chào %S', 'Thế giới');Kết quả:Hello World
Chọn định dạng ('Kiểm tra %s, %s, %s, %%', 'một', 'hai', 'ba');Kết quả:Kiểm tra một, hai, ba, %
Chọn định dạng ('chèn cách đọc kèo bóng đáo %i giá trị ( %l)', 'foo Bar', e'o \ 'reilly');Kết quả:Chèn cách đọc kèo bóng đáo các giá trị "Foo Bar" ('O''Reilly')
94961_95042Kết quả:Chèn cách đọc kèo bóng đáo các giá trị vị trí ('C: \ Tệp chương trình')
Đây là các ví dụ sử dụngWidth
Trường và-
cờ:
Chọn định dạng ('|%10s |', 'foo');Kết quả:| foo |
Chọn định dạng ('|%-10s |', 'foo');Kết quả:| foo |
Chọn định dạng ('|%*s |', 10, 'foo');Kết quả:| foo |
Chọn định dạng ('|%*s |', -10, 'foo');Kết quả:| foo |
Chọn định dạng ('|%-*s |', 10, 'foo');Kết quả:| foo |
Chọn định dạng ('|% -*s |', -10, 'foo');Kết quả:| foo |
Những ví dụ này cho thấy việc sử dụngvị trí
Trường:
Chọn định dạng ('Kiểm tra %3 $ s, %2 $ s, %1 $ s', 'một', 'hai', 'ba');Kết quả:Kiểm tra ba, hai, một
Chọn định dạng ('|%*2 $ s |', 'foo', 10, 'bar');Kết quả:| Bar |
Chọn định dạng ('|%1 $*2 $ s |', 'foo', 10, 'Bar');Kết quả:| foo |
Không giống như hàm C tiêu chuẩnSprintf
, PostgreSQL'SĐịnh dạng
hàm cho phép định dạng định dạng có và không cóvị trí
Các trường được trộn trong cùng một cách đọc kèo bóng đá định dạng. Một định dạng định dạng mà không cóvị trí
Trường luôn sử dụng đối số tiếp theo sau khi đối số cuối cùng được tiêu thụ. Ngoài ra,Định dạng
Hàm không yêu cầu tất cả các đối số chức năng được sử dụng trong cách đọc kèo bóng đá định dạng. Ví dụ:
Chọn định dạng ('Kiểm tra %3 $ s, %2 $ s, %s', 'một', 'hai', 'ba');Kết quả:Kiểm tra ba, hai, ba
The%I
và%L
Định dạng định dạng đặc biệt hữu ích để xây dựng các câu lệnh SQL động một cách đọc kèo bóng đá an toàn. Nhìn thấyVí dụ 43.1.