Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

9.4. cách đọc kèo bóng đá chức năng và toán tử

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 nhauText. 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).

Lưu ý

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 đáoTextNế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
cách đọc kèo bóng đá || cách đọc kèo bóng đá Text Concatenation 'Post' || 'gresql' PostgreSQL
cách đọc kèo bóng đá || Không cách đọc kèo bóng đáhoặcKhông cách đọc kèo bóng đá || cách đọc kèo bóng đá 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
bit_length (cách đọc kèo bóng đá) int số bit trong cách đọc kèo bóng đá bit_length ('jose') 32
char_length (cách đọc kèo bóng đá)hoặcký tự_length (cách đọc kèo bóng đá) int số lượng ký tự trong cách đọc kèo bóng đá char_length ('jose') 4
Hạ (cách đọc kèo bóng đá) Text Chuyển đổi cách đọc kèo bóng đá thành chữ thường Hạ ('Tom') Tom
octet_length (cách đọc kèo bóng đá) int Số byte trong cách đọc kèo bóng đá octet_length ('jose') 4
Lớp phủ (cách đọc kèo bóng đáĐặtcách đọc kèo bóng đátừint[choint]) Text thay thế con Lớp phủ ('txxxxas' đặt 'hom' từ 2 cho 4) Thomas
vị trí (Subringincách đọc kèo bóng đá) int Vị trí của cách đọc kèo bóng đá con được chỉ định vị trí ('om' trong 'Thomas') 3
Subring (cách đọc kèo bóng đá[từint] [choint]) Text Trích xuất cách đọc kèo bóng đá con Subring ('Thomas' từ 2 cho 3) Hom
Subring (cách đọc kèo bóng đátừmẫu) 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
Subring (cách đọc kèo bóng đátừmẫuchoEscape) 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
Trim ([Dẫn đầu | Trailing |] [ký tự] từcách đọc kèo bóng đá) 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
Trim ([Dẫn đầu | Trailing |] [từ]cách đọc kèo bóng đá[, ký tự]) Text Cú pháp không chuẩn choTrim () Trim (cả hai từ 'yxtomxx', 'xyz') Tom
trên (cách đọc kèo bóng đá) 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
ASCII (cách đọc kèo bóng đá) 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
btrim (cách đọc kèo bóng đá Text[, ký tự Text]) 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
chr (int) 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
Concat (str "Any"[,str "bất kỳ"[, ...]]) 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
concat_ws (SEP Text, str "Any"[,str "Any"[, ...]]) 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
Chuyển đổi (cách đọc kèo bóng đá bytea, src_encoding tên, Dest_encoding tên) 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)
convert_from (cách đọc kèo bóng đá bytea, src_encoding tên) 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
convert_to (cách đọc kèo bóng đá Text, Dest_encoding tên) 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
giải mã (cách đọc kèo bóng đá Text, Định dạng Text) 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ạnggiống như trongmã hóa. Decode ('mtizaae =', 'base64') \ x3132330001
mã hóa (Data bytea, Định dạng Text) 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. Escape31674_31740\nnn) và nhân đôi dấu gạch chéo ngược. mã hóa ('123 \ 000 \ 001', 'base64') mtizaae =
Định dạng(Định dạng Text[,Định dạng "Any"[, ...]]) 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
initCap (cách đọc kèo bóng đá) 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
trái (str Text, n int) Text trở lại đầu tiênnký tự trong cách đọc kèo bóng đá. Khinlà tiêu cực, trả về tất cả nhưng cuối cùng |n| ký tự. trái ('abcde', 2) AB
length (cách đọc kèo bóng đá) int Số lượng ký tự trongcách đọc kèo bóng đá LEGN ('Jose') 4
length (cách đọc kèo bóng đá bytea, mã hóa tên) 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
LPAD (cách đọc kèo bóng đá Text, LEGN int[, FILL Text]) Text Điền cách đọc kèo bóng đáocách đọc kèo bóng đáto Longlengthbằ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ơnLEGNSau đó, nó bị cắt ngắn (bên phải). lpad ('hi', 5, 'xy') XYXHI
ltrim (cách đọc kèo bóng đá Text[, ký tự Text]) 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
MD5 (cách đọc kèo bóng đá) 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
parse_ident (đủ điều kiện_identifier Text[,StrictMode BooleanĐúng mặc định]) Text [] Splitđủ điều kiện_identifierthà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
pg_client_encoding () tên Tên mã hóa máy khách hiện tại pg_client_encoding () SQL_ASCII
QUOTE_IDENT (cách đọc kèo bóng đá Text) 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"
quote_literal (cách đọc kèo bóng đá Text) 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_literalTrả về NULL trên đầu cách đọc kèo bóng đáo null; Nếu đối số có thể là null,quote_nullablethường phù hợp hơn. Xem thêmVí dụ 43.1. quote_literal (e'o \ 'reilly') 'O''Reilly'
quote_literal (giá trị AnyEuity) 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 '
QUOTE_NULLABLE (cách đọc kèo bóng đá Text) 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
quote_nullable (giá trị AnyEuity) 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 '
regexp_match (cách đọc kèo bóng đá Text, mẫu Text[,cờ Text]) 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
regexp_matches (cách đọc kèo bóng đá Text, mẫu Text[,cờ Text]) 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

Baz

(2 hàng)
regexp_replace (cách đọc kèo bóng đá Text, mẫu Text, Thay thế Text[,cờ Text]) 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
regexp_split_to_array (cách đọc kèo bóng đá Text, mẫu Text[,cờ Text]) 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
regexp_split_to_table (cách đọc kèo bóng đá Text, mẫu Text[,cờ Text]) 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

Thế giới

(2 hàng)
Lặp lại (cách đọc kèo bóng đá Text, Số int) 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
thay thế (cách đọc kèo bóng đá Text, từ Text, đến Text) 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
đảo ngược (str) Text cách đọc kèo bóng đá đảo ngược. Đảo ngược ('ABCDE') EDCBA
phải (str Text, n int) Text trở lại cuối cùngnký tự trong cách đọc kèo bóng đá. Khinlà tiêu cực, trả về tất cả nhưng đầu tiên |n| ký tự. phải ('abcde', 2) de
RPAD (cách đọc kèo bóng đá Text, length int[, FILL Text]) Text Điền cách đọc kèo bóng đáocách đọc kèo bóng đáđến chiều dàiLEGNBằ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ơnLEGNSau đó, nó bị cắt cụt. rpad ('hi', 5, 'xy') Hixyx
rtrim (cách đọc kèo bóng đá Text[, ký tự Text]) 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
split_part (cách đọc kèo bóng đá Text, Delimiter Text, trường int) Text Splitcách đọc kèo bóng đátrênDelimitervà trả về trường đã cho (đếm từ một) split_part ('abc ~@~ def ~@~ ghi', '~@~', 2) def
strpos (cách đọc kèo bóng đá, Subring) int Vị trí của cách đọc kèo bóng đá con được chỉ định (giống nhưvị trí (Subringincách đọc kèo bóng đá), nhưng lưu ý thứ tự đối số đảo ngược) strpos ('cao', 'ig') 2
Subrtr (cách đọc kèo bóng đá, từ[, Đếm]) Text Trích xuất cách đọc kèo bóng đá con (giống nhưSubring (cách đọc kèo bóng đátừtừchoĐếm)) Subrtr ('Bảng chữ cái', 3, 2) PH
starts_with (cách đọc kèo bóng đá, tiền tố) 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
to_ascii (cách đọc kèo bóng đá Text[, Mã hóa Text]) 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, Latin9Win1250mã hóa) to_ascii ('karel') Karel
to_hex (Số inthoặcBIGINT) 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
dịch (cách đọc kèo bóng đá Text, từ Text, đến Text) 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Định dạngCá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ằngVariadicTừ 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.ConcatConcat_WSreturn null, nhưngĐịnh dạngcoi null là mảng không có phần tử.

Xem thêm hàm tổng hợpString_agginPhầ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_TO_, theo sau là tên mã hóa đích được xử lý tương tự. Do đó, các tên có thể đi chệch khỏi các tên mã hóa thông thường.


9.4.1.Định dạng

hàmĐịnh dạngTạ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ạnglà 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ẫun$WHEREnlà 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_91535WidthTrườ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*n$Để sử dụngnĐố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.

  • icoi 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).

  • Ltrí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 WorldChọ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ụngWidthTrườ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ộtChọ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ạnghà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ạngHà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%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.