s_skaidocsTài liệu
Theme›Filters›Math Filters

Math Filters

Tài liệu theo cú pháp Lingo/Django. Cuộn xuống để đọc đầy đủ hướng dẫn; chọn tên trong danh sách để đến phần tương ứng.

Không phát triển lại tính năng có sẵnCác tên tham khảo từ Liquid được ánh xạ sang Lingo hoặc helper Skai. Chỉ những khả năng còn thiếu mới có badge “Đang phát triển”.

Danh sách đặc tả

THAM KHẢODÙNG TRONG SKAITRẠNG THÁI
ceilceilĐang phát triển
floorfloorĐang phát triển
roundfloatformatCó sẵn · tái sử dụng
plustoán tử +Có sẵn · tái sử dụng
minustoán tử -Có sẵn · tái sử dụng
timestoán tử *Có sẵn · tái sử dụng
divided_bytoán tử /Có sẵn · tái sử dụng
modulotoán tử %Có sẵn · tái sử dụng

Quy ước cú pháp, bảo mật và trạng thái →

Tham khảo danh mục: Haravan. Đặc tả Skai được biên soạn độc lập theo Lingo.

ceil

Đang phát triển

Làm tròn lên. Bản thiết kế v0.1 để review trước khi triển khai, chưa phải API phát hành.

Chưa khả dụngVí dụ minh họa thiết kế, không phải cú pháp đã hoạt động. Chỉ lập trình sau khi chốt kiểu dữ liệu, lỗi và kiểm thử.

Hợp đồng sử dụng

Đầu vàonumber hữu hạn
Tham sốKhông có
Đầu rainteger

Bổ sung mới; cú pháp và hành vi bên dưới là đề xuất, chưa khả dụng.

CÚ PHÁP ĐỀ XUẤT · CHƯA CHẠY TRÊN RUNTIME
{{ 2.2|ceil }}
KẾT QUẢ MONG MUỐN · ĐẶC TẢ
3

Trường hợp biên và an toàn

Ceil(-2.2) = -2; từ chối NaN và vô cực.

Tiêu chí nghiệm thu

  • Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
  • Sai tham số phải trả lỗi có tên filter/tag; preview hiển thị vị trí lỗi, production không lộ nội bộ.
  • Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
  • Kiểm thử escaping và profile runtime trước khi công bố cho theme.

Nguồn & quyết định chuyển đổi

Tên tham khảo: ceil. Hợp đồng và ví dụ là đề xuất riêng cho Skai, không sao chép contract Liquid.

Nguồn tham khảo Haravan · Quy ước đặc tả Skai

Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.

floor

Đang phát triển

Làm tròn xuống. Bản thiết kế v0.1 để review trước khi triển khai, chưa phải API phát hành.

Chưa khả dụngVí dụ minh họa thiết kế, không phải cú pháp đã hoạt động. Chỉ lập trình sau khi chốt kiểu dữ liệu, lỗi và kiểm thử.

Hợp đồng sử dụng

Đầu vàonumber hữu hạn
Tham sốKhông có
Đầu rainteger

Bổ sung mới; cú pháp và hành vi bên dưới là đề xuất, chưa khả dụng.

CÚ PHÁP ĐỀ XUẤT · CHƯA CHẠY TRÊN RUNTIME
{{ 2.8|floor }}
KẾT QUẢ MONG MUỐN · ĐẶC TẢ
2

Trường hợp biên và an toàn

Floor(-2.2) = -3; không ép chuỗi thành số âm thầm.

Tiêu chí nghiệm thu

  • Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
  • Sai tham số phải trả lỗi có tên filter/tag; preview hiển thị vị trí lỗi, production không lộ nội bộ.
  • Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
  • Kiểm thử escaping và profile runtime trước khi công bố cho theme.

Nguồn & quyết định chuyển đổi

Tên tham khảo: floor. Hợp đồng và ví dụ là đề xuất riêng cho Skai, không sao chép contract Liquid.

Nguồn tham khảo Haravan · Quy ước đặc tả Skai

Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.

floatformat

Có sẵn · tái sử dụng

Làm tròn số. Dùng khả năng hiện có, không tạo alias hoặc triển khai engine trùng chức năng.

Phạm vi hỗ trợCó trong thư viện Lingo hoặc helper Skai không đồng nghĩa được phép trong mọi runtime. Chính sách allowlist vẫn áp dụng; không tự mở quyền trong thay đổi tài liệu này.

Hợp đồng sử dụng

Đầu vàonumber
Tham sốdigits: integer; ví dụ 2
Đầu rastring số đã định dạng

Tái sử dụng floatformat cho nhu cầu hiển thị làm tròn; không phát triển filter round mới.

VÍ DỤ LINGO / SKAI
{{ 2.5|floatformat:2 }}
KẾT QUẢ MINH HỌA
2.50

Trường hợp biên và an toàn

Dùng để hiển thị, không tính lại số tiền. Không tạo round alias hoặc thay đổi cách làm tròn của Lingo.

Tiêu chí nghiệm thu

  • Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
  • Khóa hành vi của implementation hiện tại bằng test; không sửa ngữ nghĩa để khớp Liquid.
  • Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
  • Kiểm thử escaping và profile runtime trước khi công bố cho theme.

Nguồn & quyết định chuyển đổi

Tên tham khảo: round. Dùng tên/cú pháp Lingo hoặc helper Skai ghi ở đầu trang, không tạo alias tương thích Liquid.

Nguồn tham khảo Haravan · Quy ước đặc tả Skai

Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.

toán tử +

Có sẵn · tái sử dụng

Cộng giá trị. Dùng khả năng hiện có, không tạo alias hoặc triển khai engine trùng chức năng.

Phạm vi hỗ trợCó trong thư viện Lingo hoặc helper Skai không đồng nghĩa được phép trong mọi runtime. Chính sách allowlist vẫn áp dụng; không tự mở quyền trong thay đổi tài liệu này.

toán tử + · thay plus

Đầu vàonumber
Tham sốToán hạng bên phải: number
Đầu ranumber

Ưu tiên toán tử Lingo sẵn có, chưa đề xuất alias plus.

VÍ DỤ LINGO / SKAI
{{ 12 + 3 }}
KẾT QUẢ MINH HỌA
15

Trường hợp biên và an toàn

Không tự ép chuỗi giá có dấu phân cách thành số; kiểm tra overflow.

toán tử - · thay minus

Đầu vàonumber
Tham sốToán hạng bên phải: number
Đầu ranumber

Ưu tiên toán tử Lingo sẵn có, chưa đề xuất alias minus.

VÍ DỤ LINGO / SKAI
{{ 12 - 3 }}
KẾT QUẢ MINH HỌA
9

Trường hợp biên và an toàn

Không tự ép chuỗi giá có dấu phân cách thành số; kiểm tra overflow.

toán tử * · thay times

Đầu vàonumber
Tham sốToán hạng bên phải: number
Đầu ranumber

Ưu tiên toán tử Lingo sẵn có, chưa đề xuất alias times.

VÍ DỤ LINGO / SKAI
{{ 12 * 3 }}
KẾT QUẢ MINH HỌA
36

Trường hợp biên và an toàn

Không tự ép chuỗi giá có dấu phân cách thành số; kiểm tra overflow.

toán tử / · thay divided_by

Đầu vàonumber
Tham sốToán hạng bên phải: number
Đầu ranumber

Ưu tiên toán tử Lingo sẵn có, chưa đề xuất alias divided_by.

VÍ DỤ LINGO / SKAI
{{ 12 / 3 }}
KẾT QUẢ MINH HỌA
4

Trường hợp biên và an toàn

Chia cho 0 phải có kiểm thử lỗi, tuyệt đối không dùng kết quả hiển thị để cập nhật giá. Quy tắc chia số nguyên giữ theo Lingo.

toán tử % · thay modulo

Đầu vàonumber
Tham sốToán hạng bên phải: number
Đầu ranumber

Ưu tiên toán tử Lingo sẵn có, chưa đề xuất alias modulo.

VÍ DỤ LINGO / SKAI
{{ 12 % 5 }}
KẾT QUẢ MINH HỌA
2

Trường hợp biên và an toàn

Chia cho 0 phải có kiểm thử lỗi, tuyệt đối không dùng kết quả hiển thị để cập nhật giá. Quy tắc chia số nguyên giữ theo Lingo.

Tiêu chí nghiệm thu

  • Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
  • Khóa hành vi của implementation hiện tại bằng test; không sửa ngữ nghĩa để khớp Liquid.
  • Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
  • Kiểm thử escaping và profile runtime trước khi công bố cho theme.

Nguồn & quyết định chuyển đổi

Tên tham khảo: plus, minus, times, divided_by, modulo. Dùng tên/cú pháp Lingo hoặc helper Skai ghi ở đầu trang, không tạo alias tương thích Liquid.

Nguồn tham khảo Haravan · Quy ước đặc tả Skai

Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.