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
. Ngoại trừ nơi được ghi nhận, các chức năng cách đọc kèo bóng đá 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 cách đọc kèo bó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 trongNhân vật
Giá trị.
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.9.PostgreSQLCũng cung cấp các phiên bản của các cách đọc kèo bóng đá này sử dụng cú pháp gọi cách đọc kèo bóng đá thông thường (xemBảng 9.10).
Toán tử nối cách đọc kèo bóng đá (||
) sẽ 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 là loại cách đọc kèo bóng đá, 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 cách đọc kèo bóng đáoText
Có thể được sử dụng để có đầu vào không cách đọc kèo bóng đá được chấp nhận.
Bảng 9.9.SQLChức năng và toán tử cách đọc kèo bóng đá
Hàm/toán tử Mô tả Ví dụ |
---|
Concatenates hai cách đọc kèo bóng đá.
|
Chuyển đổi đầu vào không cách đọc kèo bóng đá thành văn bản, sau đó kết hợp hai cách đọc kèo bóng đá. (Đầu vào không cách đọc kèo bóng đá không thể thuộc loại mảng, vì điều đó sẽ tạo ra sự mơ hồ với mảng
|
Kiểm tra xem cách đọc kèo bóng đá có ở dạng chuẩn hóa Unicode được chỉ định hay không. Tùy chọn
|
Trả về số bit trong cách đọc kèo bóng đá (8 lần
|
Trả về số lượng ký tự trong cách đọc kèo bóng đá.
|
Chuyển đổi cách đọc kèo bóng đá 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.
|
Chuyển đổi cách đọc kèo bóng đá thành biểu mẫu chuẩn hóa Unicode được chỉ định. Tùy chọn
|
Trả về số byte trong cách đọc kèo bóng đá.
|
Trả về số byte trong cách đọc kèo bóng đá. Vì phiên bản này của chức năng chấp nhận loại
|
Thay thế cách đọc kèo bóng đá con của
|
Trả về chỉ mục bắt đầu đầu tiên của được chỉ định
|
trích xuất cách đọc kèo bóng đá con của
|
Trích xuất biểu thức chính quy POSIX đầu tiên phù hợp với POSIX; 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 cách đọc kèo bóng đá 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 cách đọc kèo bóng đá thành tất cả các trường hợp trên, theo các quy tắc của Locale của cơ sở dữ liệu.
|
Các hàm và toán tử thao tác cách đọc kèo bóng đá 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 cách đọc kèo bóng đá được liệt kê trongBảng 9.9.) Ngoài ra còn có cách đọc kèo bóng đá toán tử khớp mẫu, được mô tả trongPhần 9.7cách đọc kèo bóng đá 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 cách đọc kèo bóng đá và toán tử khác
cách đọc kèo bóng đá/Toán tử Mô tả Ví dụ |
---|
Trả về true nếu cách đọc kèo bóng đá thứ nhất bắt đầu bằng cách đọc kèo bóng đá 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ách đọc kèo bóng đá mã hóa multibyte khác, đối số phải làASCIIký tự.
|
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự trong
|
Trả về ký tự với mã đã cho. TRONGUTF8Mã hóa đối số được coi là điểm mã Unicode. Trong cách đọc kèo bóng đá mã hóa multibyte khác, đối số phải chỉ định mộtASCIIký tự.
|
Kết hợp cách đọc kèo bóng đá biểu diễn văn bản của tất cả cách đọc kèo bóng đá đối số. cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá phân tách và không nên null.
|
Định dạng đối số theo cách đọc kèo bóng đá định dạng; nhìn thấyPhần 9.4.1. cách đọc kèo bóng đá này tương tự như hàm C
|
Chuyển đổi chữ cái đầu tiên của mỗi từ thành 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ự.
|
trả về đầu tiên
|
Trả về số lượng ký tự trong cách đọc kèo bóng đá.
|
Mở rộng
|
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự trong
|
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ề 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.
|
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. 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ách đọc kèo bóng đá tài liệu đơn và dấu gạch chéo được nhúng được nhân đôi đúng cách.
|
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, 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 cách đọc kèo bóng đá con trong trận đấu đầu tiên của biểu thức chính quy POSIX
|
Trả về cách đọc kèo bóng đá con trong trận đấu đầu tiên của biểu thức chính quy POSIX
Bar |
Thay thế cách đọc kèo bóng đá con là kết hợp đầu tiên với biểu thức chính quy POSIX
|
Thay thế cách đọc kèo bóng đá con 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ách đọc kèo bóng đá lần xuất hiện trong
|
đảo ngược thứ tự của các ký tự trong cách đọc kèo bóng đá.
|
Trả về cuối cùng
|
Mở rộng
|
Xóa cách đọc kèo bóng đá dài nhất chỉ chứa các ký tự trong
|
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 cách đọc kèo bóng đá 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ách đọc kèo bóng đá 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 cách đọc kèo bóng đá 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ố cách đọc kèo bóng đá với unicode thoát (xemPhần 4.1.2.3).
|
TheConcat
,Concat_WS
vàĐịnh dạng
cách đọc kèo bóng đá hàm là Variadic, do đó có thể truyền cách đọc kèo bóng đá giá trị được nối hoặc được định dạng dưới dạng một mảng được đánh dấu bằngVariadic
Từ khóa (xemPhần 38.5.6). cách đọc kèo bóng đá yếu tố của mảng được đối xử như thể chúng là cách đọc kèo bóng đá đố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 cách đọc kèo bóng đá vàbytea
gõ cách đọc kèo bóng đáoBảng 9.13.
Đị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ách đọc kèo bóng đá 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 đầ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 công bằng. Đ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à 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ố cách đọc kèo bó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
(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ách đọc kèo bóng đá 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
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 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')
83183_83264Kế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ách đọc kèo bóng đá 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ách đọc kèo bóng đá 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 phù hợpMẫu nàyĐể báo cáo vấn đề tài liệu.