參考手冊

DTW_URLESCSEQ


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)

參數

表 55. DTW_URLESCSEQ 參數
資料類型 參數 使用 說明
字串 stringIn IN 一個變數或文字字串。
字串 stringOut OUT 一個包含輸入字串的變數, 該輸入字串具有 URL 中不允許的字元, 會由它們的十六進位跳出值來置換。

回覆碼

表 56. DTW_URLESCSEQ 回覆碼
回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1003 函數呼叫上傳遞的參數數目不正確。
1005 函數呼叫上傳遞的參數必須是字串變數,但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數, 但此參數必須是輸出參數。

用法注意事項

您可以使用這個函數,將表 57中列示的任何字元傳送到另一個巨集或 HTML 區塊。


表 57. URL 的字元跳出值
字元 名稱 程式碼
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>
%}

當應用程式使用者按一下名稱 "Patrick O'Brien" 時, 指定給名稱和電子郵件位址的值會在 URL 查詢字串中矩陣式排列, 這會導致 Net.Data 執行 fullrpt.mac 巨集的輸入區段。


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]