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ị soi kèo bóng đá truoctran. soi kèo bóng đá truoctran trong bối cảnh này bao gồm các giá trị của các loạiký tự
, Nhân vật khác nhau
vàText
. Ngoại trừ nơi được ghi nhận, các chức năng soi kèo bóng đá truoctran tử này được tuyên bố chấp nhận và trả lại loạiText
. Họ sẽ thay thế cho nhau chấp nhậnNhân vật khác nhau
Đối số. Giá trị của loạiNhân vật
sẽ được chuyển đổi thànhText
Trước khi chức năng hoặc toán tử được áp dụng, dẫn đến việc tước bất kỳ khoảng trống nào trongký tự
Giá trị.
SQLXác định một số hàm soi kèo bóng đá truoctran 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.9. 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.10).
Toán tử nối soi kèo bóng đá truoctran (||
) sẽ chấp nhận đầu vào không soi kèo bóng đá truoctran, miễn là ít nhất một đầu vào là loại soi kèo bóng đá truoctran, như trongBảng 9.9. Đối với các trường hợp khác, việc chèn một sự ép buộc rõ ràng soi kèo bóng đá truoctranoText
Có thể được sử dụng để có đầu vào không soi kèo bóng đá truoctran được chấp nhận.
Bảng 9.9.SQLsoi kèo bóng đá truoctran Chức năng và toán tử
Hàm/toán tử Mô tả Ví dụ (s) |
---|
Concatenates hai soi kèo bóng đá truoctran.
|
Chuyển đổi đầu vào không soi kèo bóng đá truoctran thành văn bản, sau đó kết hợp hai soi kèo bóng đá truoctran. (Đầu vào không soi kèo bóng đá truoctran không thể thuộc loại mảng, vì điều đó sẽ tạo ra sự mơ hồ với mảng
|
Xóa soi kèo bóng đá truoctran dài nhất chỉ chứa các ký tự trong
|
Kiểm tra xem soi kèo bóng đá truoctran có ở dạng chuẩn hóa Unicode được chỉ định hay không. Tùy chọn
|
Trả về số bit trong soi kèo bóng đá truoctran (8 lần
|
Trả về số lượng ký tự trong soi kèo bóng đá truoctran.
|
Chuyển đổi soi kèo bóng đá truoctran thành tất cả các chữ thường, theo các quy tắc của địa phương của cơ sở dữ liệu.
|
Mở rộng
|
Xóa soi kèo bóng đá truoctran dài nhất chỉ chứa các ký tự trong
|
Chuyển đổi soi kèo bóng đá truoctran thành biểu mẫu chuẩn hóa Unicode được chỉ định. Tùy chọn
|
Trả về số byte trong soi kèo bóng đá truoctran.
|
Trả về số byte trong soi kèo bóng đá truoctran. Vì phiên bản này của chức năng chấp nhận loại
|
Thay thế soi kèo bóng đá truoctran con của
|
Trả về chỉ mục bắt đầu đầu tiên của được chỉ định
|
Mở rộng
|
Xóa soi kèo bóng đá truoctran dài nhất chỉ chứa các ký tự trong
|
trích xuất soi kèo bóng đá truoctran con của
|
trích xuất biểu thức thông thường phù hợp với soi kèo bóng đá truoctran con đầu tiên; nhìn thấyPhần 9.7.3.
|
Trích xuất khớp nối đầu tiênSQLBiểu thức chính quy; nhìn thấyPhần 9.7.2. Mẫu đầu tiên đã được chỉ định kể từ SQL: 2003;
|
Xóa soi kèo bóng đá truoctran dài nhất chỉ chứa các ký tự trong
|
Đây là cú pháp không chuẩn cho
|
Chuyển đổi soi kèo bóng đá truoctran thành tất cả các trường hợp trên, theo các quy tắc của ngôn ngữ của cơ sở dữ liệu.
|
Các hàm và toán tử thao tác soi kèo bóng đá truoctran bổ sung có sẵn và được liệt kê trongBảng 9.10. (Một số trong số này được sử dụng nội bộ để thực hiệnSQL-Standard Chức năng soi kèo bóng đá truoctran được liệt kê trongBảng 9.9.) Ngoài ra còn có các toán tử khớp mẫu, được mô tả trongPhần 9.7soi kèo bóng đá truoctran tử cho tìm kiếm toàn văn bản, được mô tả trongChương 12.
Bảng 9.10. Các chức năng soi kèo bóng đá truoctran và toán tử khác
Chức năng/Toán tử Mô tả Ví dụ (s) |
---|
Trả về true nếu soi kèo bóng đá truoctran thứ nhất bắt đầu với soi kèo bóng đá truoctran thứ hai (tương đương với
|
Trả về mã số của ký tự đầu tiên của đối số. TRONGUTF8Mã hóa, trả về điểm mã Unicode của ký tự. Trong các mã hóa multibyte khác, đối số phải làASCIIký tự.
|
Trả về ký tự với mã đã cho. TRONGUTF8Mã hóa đối số được coi là điểm mã Unicode. Trong các mã hóa multibyte khác, đối số phải chỉ định mộtASCIIký tự.
|
Kết hợp 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.
|
Kết hợp 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 soi kèo bóng đá truoctran phân tách và không nên null.
|
Định dạng đối số theo soi kèo bóng đá truoctran định dạng; nhìn thấyPhần 9.4.1. Chức năng này tương tự như hàm C
|
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à soi kèo bóng đá truoctran 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ự.
|
trả về đầu tiên
|
Trả về số lượng ký tự trong soi kèo bóng đá truoctran.
|
Tính toán MD5Hashcủa đối số, với kết quả được viết bằng thập lục phân.
|
chia tách
|
Trả về tên mã hóa máy khách hiện tại.
|
Trả về soi kèo bóng đá truoctran đã cho được trích dẫn phù hợp để được sử dụng làm định danh trong mộtSQLsoi kèo bóng đá truoctran câu lệnh. Báo giá chỉ được thêm vào nếu cần thiết (nghĩa là, nếu soi kèo bóng đá truoctran 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.
|
Trả về soi kèo bóng đá truoctran đã cho được trích dẫn phù hợp để được sử dụng làm soi kèo bóng đá truoctran theo nghĩa đen trong mộtSQLsoi kèo bóng đá truoctran 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.
|
Chuyển đổi giá trị đã cho thành 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.
|
Trả về soi kèo bóng đá truoctran đã cho được trích dẫn phù hợp để được sử dụng làm soi kèo bóng đá truoctran theo nghĩa đen trong mộtSQLsoi kèo bóng đá truoctran câu lệnh; hoặc, nếu đối số là null, trả về
|
Chuyển đổi giá trị đã cho thành văn bản và sau đó trích dẫn nó theo nghĩa đen; hoặc, nếu đối số là null, trả về
|
Trả về số lần biểu thức chính quy POSIX
|
Trả về vị trí trong
|
Kiểm tra xem một trận đấu của biểu thức chính quy POSIX
|
Trả về các soi kèo bóng đá truoctran con trong trận đấu đầu tiên của biểu thức chính quy POSIX
|
Trả về các soi kèo bóng đá truoctran con trong trận đấu đầu tiên của biểu thức chính quy POSIX
Bar |
Thay thế soi kèo bóng đá truoctran con là kết hợp đầu tiên với biểu thức chính quy POSIX
|
Thay thế phần phụ đó là
|
chia tách
|
chia tách
Xin chào |
Trả về phần phụ trong
|
lặp lại
|
Thay thế tất cả các lần xuất hiện trong
|
đảo ngược thứ tự của các ký tự trong soi kèo bóng đá truoctran.
|
Trả về cuối cùng
|
chia tách
|
Trả về đúng nếu
|
chia tách
|
chia tách
XX |
Trả về chỉ mục bắt đầu đầu tiên của được chỉ định
|
trích xuất soi kèo bóng đá truoctran con của
|
Chuyển đổi
|
Chuyển đổi số thành đại diện thập lục phân tương đương của nó.
|
Thay thế từng ký tự trong
|
Đánh giá các ký tự Unicode đã thoát trong đối số. Ký tự unicode có thể được chỉ định là Nếu mã hóa máy chủ không phải là UTF-8, điểm mã Unicode được xác định bởi một trong các soi kèo bóng đá truoctran thoát này được chuyển đổi thành mã hóa máy chủ thực tế; một lỗi được báo cáo nếu điều đó là không thể. Hàm này cung cấp một (không chuẩn) thay thế cho các hằng số soi kèo bóng đá truoctran với unicode thoát (xemPhần 4.1.2.3).
|
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.6). 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,21và các chức năng chuyển đổi giữa các soi kèo bóng đá truoctran vàbytea
gõ soi kèo bóng đá truoctranoBảng 9.13.
Định dạng
#hàmĐịnh dạng
Tạo định dạng đầu ra theo soi kèo bóng đá truoctran đị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 soi kèo bóng đá truoctran định dạng chỉ định cách thức kết quả nên được định dạng. Văn bản trong soi kèo bóng đá truoctran đị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 soi kèo bóng đá truoctran, 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 soi kèo bóng đá truoctran 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 ở đâu:
vị trí
(Tùy chọn)Một soi kèo bóng đá truoctran 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 đầu ra của định dạng định dạng được định dạng. Hiện tại cờ được hỗ trợ duy nhất là dấu trừ (-
) Điều này sẽ khiến đầu ra của định dạng được sử dụng lại. Điều này không có tác dụng trừ khiWidth
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 dạng định dạng. Đầu ra được đệm ở bên trái hoặc bên phải (tùy thuộc soi kèo bóng đá truoctrano-
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 soi kèo bóng đá truoctran 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 đến 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
(Yêu cầu)Loại chuyển đổi định dạng để sử dụng để tạo ra đầu ra của trì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 soi kèo bóng đá truoctran đơn giản. Giá trị null được coi là một soi kèo bóng đá truoctran trống.
i
Xử lý 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 soi kèo bóng đá truoctrannull
, 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, soi kèo bóng đá truoctran đặ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 soi kèo bóng đá truoctrano %I Giá trị ( %L)', 'Foo Bar', E'o \ 'Reilly');Kết quả:Chèn soi kèo bóng đá truoctrano các giá trị "Foo Bar" ('O''Reilly')
83628_83709Kết quả:Chèn soi kèo bóng đá truoctrano 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 hiển thị 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 soi kèo bóng đá truoctran đị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 soi kèo bóng đá truoctran đị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 an toàn. Nhìn thấyVí dụ 43.1.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớpMẫu nàyĐể báo cáo vấn đề tài liệu.