SETENCODING  
説明

Form スコープ変数値と URL スコープ変数値の文字エンコード (文字セット) を設定します。フォーム入力用の文字エンコードや URL の文字エンコードが UTF-8 エンコードでない場合に使用します。

 
戻り値

なし。

 
カテゴリ

各国語対応関数、システム関数

 
関数のシンタックス
SetEncoding(scope_name,charset)
 
関連項目

GetEncoding、cfcontent、cfprocessingdirective、URLDecode、URLEncodedFormat、『ColdFusion MX 開発ガイド』の第17章の「グローバル化アプリケーションの開発」 の「ロケール」

 
ヒストリ

ColdFusion MX: この関数が追加されました。

 
パラメータ

 
使用方法

この関数は、フォーム入力の文字エンコードや URL の文字エンコードが UTF-8 エンコードでない場合に使用します。たとえば、中国語 (Traditional) の文字には多くの場合 Big5 エンコードが使用されます。この関数は URL 変数や Form 変数をリセットするので、(通常は Application.cfm ページまたは "Application.cfc" ファイルで) これらの変数を使用する前にこの関数を呼び出す必要があります。この関数を最初に呼び出すことにより、これらの変数の文字が誤って解釈されることも回避できます。

文字エンコードの詳細については、次の Web ページを参照してください。

  • www.w3.org/International/O-charset.html には、文字エンコードと Web に関する全般的な情報や、いくつかの有用なリンクがあります。
  • www.iana.org/assignments/character-sets には、インターネットで使用され、Internet Assigned Numbers Authority によって管理されている文字セット名の完全なリストが掲載されています。
  • java.sun.com/j2se/1.4.1/docs/guide/intl/encoding.doc.html には、Java 1.4.1 が解釈できる文字エンコード (つまりデフォルトの ColdFusion 設定で解釈できる文字エンコード) のリストがあります。Sun Java 2 Platform, Standard Edition, v 1.4.1 に準拠していない JVM を使用している場合には、サポートされているロケールが異なることがあります。このリストで使われているのは Java の内部名です。IANA 文字エンコード名ではありません。SetEncoding の charset パラメータや、ColdFusion のその他の属性およびパラメータでは、通常は IANA 文字エンコード名を使用します。Java では、標準的な IANA 名から内部名への変換が必要に応じて自動的に行われます。
 
<!--- この例では、2 つのフィールドの内容の送信と解釈を、
      big5 エンコードされたテキストとして実行します。これらのフォームフィールドは URL 変数として受信され
ます。
      このフォームでは GET メソッドを使用しているためです。 --->
<cfcontent type="text/html; charset=big5">
<form action='#cgi.script_name#' method='get'>
<input name='xxx' type='text'>
<input name='yyy' type='text'>
<input type="Submit" value="送信">
</form>

<cfif IsDefined("URL.xxx")>
<cfscript>
   SetEncoding("url", "big5");
   WriteOutput("URL.XXX: " & URL.xxx & "<br>");
   WriteOutput("URL.YYY: " & URL.yyy & "<br>");
    theEncoding = GetEncoding("URL");
    WriteOutput("URL 変数のデコードに使用されたのは '" & 
theEncoding & "' エンコードです。"); 
</cfscript>
</cfif>

SCOPE_NAME  
CHARSET  
文字エンコードです。スコープ変数のテキストがこの方式でエンコードされます。一般的に使用さ れる値を次に示します。
  • utf-8
  • iso-8859-1
  • windows-1252
  • us-ascii
  • shift_jis
  • iso-2022-jp
  • euc-jp
  • euc-kr
  • big5
  • euc-cn
  • utf-16