AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
目的
URL 中不容許的已選取字元以其跳出值來置換,即所謂的 URL 編碼。
格式
@DTW_URLESCSEQ(stringIn, stringOut)
@DTW_rURLESCSEQ(stringIn)
參數
資料類型 | 參數 | 使用 | 說明 |
---|---|---|---|
字串 | stringIn | IN | 一個變數或文字字串。 |
字串 | stringOut | OUT | 一個包含輸入字串的變數, 該輸入字串具有 URL 中不允許的字元, 會由它們的十六進位跳出值來置換。 |
回覆碼
回覆碼 | 說明 |
---|---|
-1001 | 伺服器無法處理 Net.Data 的配置記憶體要求。 |
1003 | 函數呼叫上傳遞的參數數目不正確。 |
1005 | 函數呼叫上傳遞的參數必須是字串變數,但卻是不同的變數類型。 |
1006 | 文字字串傳遞給函數呼叫中的參數, 但此參數必須是輸出參數。 |
用法注意事項
您可以使用這個函數,將表 57中列示的任何字元傳送到另一個巨集或 HTML 區塊。
字元 | 名稱 | 程式碼 |
SPACE | 空格 | %20 |
" | 雙引號 | %22 |
# | 號碼記號 | %23 |
% | 百分比 | %25 |
& | & 記號 | %26 |
+ | 加 | %2B |
\ | 反斜線 | %2F |
: | 冒號 | %3A |
; | 分號 | %3B |
< | 小於 | %3C |
= | 等於 | %3D |
> | 大於 | %3E |
? | 問號 | %3F |
@ | At 記號 | %40 |
[ | 左方括弧 | %5B |
/ | 斜線 | %5C |
] | 右方括弧 | %5D |
^ | Carat | %5E |
{ | 左大括弧 | %7B |
| | 直線 | %7C |
} | 右大括弧 | %7D |
~ | 波型符號 | %7E |
範例
範例 1: 以跳出值置換 string1 中的 & 符號與空格,並將結果指定到 string2
@DTW_URLESCSEQ(string1,string2)
範例 2:以跳出碼置換空格與 & 符號。
@DTW_rURLESCSEQ("Guys & Dolls")
範例 3:在 ROW 區塊中使用 DTW_rURLESCSEQ, 並以跳出碼置換空格和 'at' 字元。
%ROW{ <p><a href="fullRpt.mac/input ?name=@DTW_rURLESCSEQ(V1)&email=@DTW_rULRESCSEQ(V2)"> $(V1)</a> %}
<p><a href="fullrpt.mac/input?name=Patrick%20O'Brien &email="obrien%40ibm.com">Patrick O'Brien</a></p>
當應用程式使用者按一下名稱 "Patrick O'Brien" 時, 指定給名稱和電子郵件位址的值會在 URL 查詢字串中矩陣式排列, 這會導致 Net.Data 執行 fullrpt.mac 巨集的輸入區段。