マニュアルキャンセル

CSVWrite

検索

最終更新日 : 2025年3月31日

ColdFusion

アプリを開く

CFML リファレンスユーザーガイド
ColdFusion 関数
ColdFusion のタグ
1. ColdFusion タグの概要
2. カテゴリ別の ColdFusion タグ
  1. アプリケーションフレームワークタグ
    1. cfapplication
    2. cfassociate
    3. cferror
    4. cfimport
    5. cfinterface
    6. cflock
    7. CFScript の
    8. cfthread
  2. 通信タグ
  3. データベース操作タグ
  4. データ出力タグ
    1. cfchart
    1. cfchartdata
    2. cfchartseries
    3. cfchartset
    4. cfcol
    5. cfcontent
    6. cfdocument
    7. cfdocumentitem
    8. cfdocumentsection
    9. cfflush
    10. cfheader
    11. cflog
    12. cfoutput
    13. cfpresentation
    14. cfpresentationslide
    15. cfpresenter
    16. cfprocessingdirective
    17. cfprint
    18. cfreport
    19. cfreportparam
    20. cfsilent
    21. cftable
  5. デバッグタグ
    1. cfdump
    2. cftimer
    3. cftrace
  6. 例外処理タグ
    1. cfcatch
    2. cferror
    3. cffinally
    4. cfrethrow
    5. cfthrow
    6. cftry
  7. 拡張タグ
    1. cfchart
    2. cfchartdata
    3. cfchartseries
    4. cfcollection
    5. cfcomponent
    6. cfexecute
    7. cfftp
    8. function
    9. cfindex
    10. cfinterface
    11. cfinvoke
    12. cfinvokeargument
    13. cfobject
    14. cfproperty
    15. cfreport
    16. cfreportparam
    17. cfreturn
    18. cfsearch
    19. cfsharepoint
    20. cfspreadsheet
    21. cfwddx
    22. cfxml
  8. ファイル管理タグ
  9. フロー制御タグ
    1. cfabort
    2. cfbreak
    3. cfcase
    4. cfcontinue
    5. cfdefaultcase
    6. cfelse
    7. cfelseif
    8. cfexecute
    9. cfexit
    10. cfif
    11. cfinclude
    12. cflocation
    13. cfloop
    14. cfrethrow
    15. cfswitch
    16. cfthrow
    17. cftry
  10. フォームタグ
    1. cfapplet
    2. cfcalendar
    3. cffileupload
    4. cfform
    5. cfformgroup
    6. cfformitem
    7. cfgrid
    8. cfgridcolumn
    9. cfgridrow
    10. cfgridupdate
    11. cfinput
    12. cfpdf
    13. cfpdfform
    14. cfpdfformparam
    15. cfpdfparam
    16. cfpdfsubform
    17. cfselect
    18. cfslider
    19. cftextarea
    20. cftree
    21. cftreeitem
  11. インターネットプロトコルタグ
    1. cfajaximport
    2. cfajaxproxy
    3. cfftp
    4. cffeed
    5. cfimap
    6. cfhttp
    7. cfhttpparam
    8. cfldap
    9. cfmail
    10. cfmailparam
    11. cfmailpart
    12. cfpop
    13. cfsprydataset
  12. ページ処理タグ
    1. cfcache
    2. cfcontent
    3. cfflush
    4. cfheader
    5. cfhtmlhead
    6. cfinclude
    7. cfprocessingdirective
    8. cfsetting
    9. cfsilent
  13. セキュリティタグ
  14. 変数操作タグ
    1. cfcookie
    2. cfdump
    3. cfparam
    4. cfregistry
    5. cfsavecontent
    6. cfschedule
    7. cfset
    8. cfsetting
  15. その他のタグ
    1. cfimage
    2. cflog
    3. cfregistry
3. タグ a～b
4. タグ c
5. タグ f
6. タグ g～h
  1. cfgraph
  2. cfgraphdata
  3. cfgrid
  4. cfgridcolumn
  5. cfgridrow
  6. cfgridupdate
  7. cfheader
  8. cfhtmlhead
  9. cfhtmltopdf
  10. cfhtmltopdfitem
  11. cfhttp
  12. cfhttpparam
7. タグ i
  1. cfif
  2. cfimage
  3. cfimap
  4. cfimapfilter
  5. cfimpersonate
  6. cfimport
  7. cfinclude
  8. cfindex
  9. cfinput
  10. cfinsert
  11. cfinterface
  12. cfinvoke
  13. cfinvokeargument
8. タグ j～l
9. タグ m～o
10. タグ p～q
  1. cfparam
  2. cfpdf
  3. cfpdfform
  4. cfpdfformparam
  5. cfpdfparam
  6. cfpdfsubform
  7. cfpod
  8. cfpop
  9. cfpresentation
  10. cfpresentationslide
  11. cfpresenter
  12. cfprint
  13. cfprocessingdirective
  14. cfprocparam
  15. cfprocresult
  16. cfprogressbar
  17. cfproperty
  18. cfquery
  19. cfqueryparam
11. タグ r～s
  1. cfregistry
  2. cfreport
  3. cfreportparam
  4. cfrethrow
  5. cfreturn
  6. cfsavecontent
  7. cfschedule
  8. cfscript
  9. cfsearch
  10. cfselect
  11. cfservlet
  12. cfservletparam
  13. cfset
  14. cfsetting
  15. cfsharepoint
  16. cfsilent
  17. cfslider
  18. cfspreadsheet
  19. cfsprydataset
  20. cfstoredproc
  21. cfswitch
12. タグ t
  1. cftable
  2. cftextarea
  3. cftextinput
  4. cfthread
  5. cfthrow
  6. cftimer
  7. cftooltip
  8. cftrace
  9. cftransaction
  10. cftree
  11. cftreeitem
  12. cftry
13. タグ u～z
  1. cfupdate
  2. cfwddx
  3. cfwebsocket
  4. cfwindow
  5. cfxml
  6. cfzip
  7. cfzipparam
CFML リファレンス
クラウドサービス

説明

ColdFusion オブジェクトを CSV に書き込みます。オブジェクトには、クエリ、構造体の配列、配列の配列、Java 配列の配列、xlsx、csvrecorditerable および csvString を指定できます。

履歴

ColdFusion（2025 リリース）：関数が追加されました。

シンタックス

CSVWrite(data, inputFormat, destinationFilePath [,writeConfiguration])

パラメーター

名前

必須

Type

説明

data

〇

オブジェクト

データの取得元となるクエリ、構造体の配列、配列の配列、Java 配列の配列、xlsx、csvrecorditerable および csvString。

inputFormat

はい

文字列

CSV として書き込む必要がある入力オブジェクトのタイプ。指定できる値は次のとおりです。

csvstring：オブジェクトを csv 文字列として書き込みます。

arrayOfCFArray：オブジェクトを ColdFusion 配列の配列として書き込みます。

arrayofjavaarray：オブジェクトを Java 配列の配列として書き込みます。

arrayofstruct：オブジェクトを ColdFusion 構造体の配列として書き込みます。

query：オブジェクトを ColdFusion クエリとして書き込みます。

xlsx：オブジェクトを ColdFusion Excel オブジェクトとして書き込みます。

csvrecorditerable：大きい CSV（100 MB 以上）からデータを読み取る場合、すべてのレコードを格納するオブジェクトを返すのは困難です。したがって、csvrecorditerable は、レコードを格納せずに、様々な反復可能関数でレコードを解析できるようにするために必要です。次に示します。

next()：レコードを反復処理します。

hasNext()：レコードを反復処理します。

getObject()：反復可能オブジェクトの最初のいくつかの要素を ColdFusion 配列として返します。最大10件のレコードが返されます。

canGetSize()：true または false を返します。

close()：レコードを部分的に反復処理する場合は、このメソッドを呼び出します。

destinationFilePath

いいえ

文字列

CSV を書き込むファイルのパス。

writeConfiguration

いいえ

構造体

CSV ファイルの情報を書き込むための設定が含まれる構造体。構造体では、次の値を使用できます。

キー

値

autoflush

各書き込み操作の後にファイルのバッファを自動的にディスクにフラッシュする必要がある場合は True です。

duplicateHeaderMode

ヘッダー名の重複動作を設定します。有効な値は次のとおりです。

ALLOW_ALL

ALLOW_EMPTY

DISALLOW

delimiter

文字区切りを設定します。

escapeCharacter

エスケープ文字を設定します。

encoding

CSV の値に使用されるエンコーディング。デフォルトは UTF-8 です。次のエンコーディングがサポートされています。

utf-8

iso-8859-1

windows-1252

us- ascii

shift_jis

iso-2022-jp

euc-jp

euc - kr

big5

euc - cn

utf -16

headerComments

指定した値に設定されたヘッダーコメントを設定します。コメントは、ヘッダーの前の先頭に印刷されます。

ignoreHeaderCase

パーサーのケースマッピングの動作を設定します。名前／値にアクセスする場合は True。変更を行わない場合は False。デフォルトは True です。

nullString

CSVwrite では nullString によって、指定された文字列が null 値に置き換えられます。

quoteCharacter

引用文字を設定します。

quoteMode

引用モードを設定します。有効な値は次のとおりです。

ALL_NON_NULL

MINIMAL

NON_NUMERIC

NONE

readCSVConfig

CSV 読み取り設定オプション。関連するプロパティを追加します。

recordSeparator

CSV レコードを区切る文字。例えば、カンマや /n などです。

skipHeaderRecord

ファイルの先頭で、指定した数のレコード／行を無視します。値はブーリアンである必要があります。

trailingDelimiter

末尾に区切り記号を追加する場合は True。デフォルト値は False です。

trim

前後の空白をトリミングする場合は true。デフォルトは True です。

次のマトリックスは、サポートされている様々な出力形式を示しています。

parameters

ArrayofCFArray

ArrayofJavaArray

xlsx

csvrecorditable

csvString

ArrayOfStruct

query

autoflush=false

〇

はい

〇

はい

〇

はい

〇

autoflush=true

〇

はい

〇

はい

〇

はい

〇

delimiter

〇

はい

〇

はい

〇

はい

〇

duplicateHeaderMode = ALLOW_ALL

〇

はい

〇

はい

〇

はい

〇

duplicateHeaderMode = ALLOW_EMPTY

〇

はい

〇

はい

〇

はい

〇

duplicateHeaderMode = DISALLOW

〇

はい

〇

はい

〇

はい

〇

escapeCharacter

〇

はい

〇

はい

〇

はい

〇

CommentMarker を使用した headerComments

〇

はい

〇

はい

〇

はい

〇

nullString

〇

はい

〇

quoteCharacter

〇

はい

〇

はい

〇

はい

〇

QuoteMode=All

〇

はい

〇

はい

〇

はい

〇

QuoteMode=ALL_Non_Null

〇

はい

〇

はい

〇

はい

〇

QuoteMode=Minimal

〇

はい

〇

はい

〇

はい

〇

QuoteMode=Non_Numeric

〇

はい

〇

はい

〇

はい

〇

QuoteMode=None

〇

はい

〇

はい

〇

はい

〇

readCSVConfig

〇

record separator

〇

はい

〇

はい

〇

はい

〇

skipHeaderRecord=false

〇

はい

〇

はい

〇

はい

〇

skipHeaderRecord=true

〇

はい

〇

はい

〇

はい

〇

trailingDelimiter=false

〇

はい

〇

はい

〇

はい

〇

trailingDelimiter=true

〇

はい

〇

はい

〇

はい

〇

trim

〇

はい

〇

はい

〇

はい

〇

例：クエリオブジェクトからの CSV の書き込み

<cfquery name=&quot;queryResult&quot; datasource=&quot;art&quot;> 
    SELECT * 
    FROM ART 
</cfquery> 
<cfscript> 
    theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteQuery.csv&quot;; 
    // CSV を書き込みます
    CSVWrite(queryResult,&quot;query&quot;,#theFile#) 
</cfscript>

例：構造体の配列からの CSV の書き込み

<cfset employees = []> 

 <!--- 最初の従業員の構造体を作成します ---> 
<cfset employee1 = structNew()> 
<cfset employee1.name = &quot;John Doe&quot;> 
<cfset employee1.age = &quot;30&quot;> 
<cfset employee1.position = &quot;Developer&quot;> 
<cfset arrayAppend(employees, employee1)> 


<!--- 2 番目の従業員の構造体を作成します ---> 

<cfset employee2 = structNew()> 
<cfset employee2.name = &quot;Jane Smith&quot;> 
<cfset employee2.age = &quot;25&quot;> 
<cfset employee2.position = &quot;Designer&quot;> 
<cfset arrayAppend(employees, employee2)> 

<!--- 3 番目の従業員の構造体を作成します ---> 
<cfset employee3 = structNew()> 
<cfset employee3.name = &quot;Mike Johnson&quot;> 
<cfset employee3.age = &quot;28&quot;> 
<cfset employee3.position = &quot;Manager&quot;> 
<cfset arrayAppend(employees, employee3)> 

<!--- <cfdump var=#employees# > ---> 

<cfscript> 
    theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteAoS.csv&quot;; 
    CSVWrite(employees,&quot;arrayofstruct&quot;,#theFile#) 
</cfscript>

例：CSV 文字列としての別の CSV からの書き込み

<cfscript> 
    theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;outputCSVString.csv&quot;; // ソース CSV を書き込むための CSV 
    theFile2=GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; // ソース CSV 
    value = CSVRead(#theFile2#,&quot;csvstring&quot;) // ソース CSV を読み込みます 
    CSVWrite(value,&quot;csvstring&quot;,#theFile#) // ソース CSV を csvstring として宛先 CSV に書き込みます 
</cfscript>

例：ColdFusion での構造体の配列からの CSV の書き込み

<cfset people = []> 

 <cfset person1 = { 
    &quot;name&quot; = &quot;John&quot;, 
    &quot;age&quot; = &quot;30&quot;, 
    &quot;city&quot; = &quot;New York&quot; 
}> 

<cfset person2 = { 
    &quot;name&quot; = &quot;Emily&quot;, 
    &quot;age&quot; = &quot;25&quot;, 
    &quot;city&quot; = &quot;Los Angeles&quot; 
}> 

<cfset arrayAppend(people, person1)> 
<cfset arrayAppend(people, person2)> 

<cfscript> 
    //cp = [&quot;name&quot;, &quot;age&quot;, &quot;city&quot;] 
    theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;csvWriteArrayOfStructs.csv&quot;; 
    CSVWrite(people,&quot;arrayofstruct&quot;,#theFile#) 
</cfscript>

例：csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteCSVRI.csv&quot;; 
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    writedump(#csvObj#) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#)  
</cfscript>

例： delimiter を使用した csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteCSVRIDelimiter.csv&quot;; 
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;delimiter&quot;:&quot;:&quot;}) 
</cfscript>

詳細な例

構造体の値 - {"quoteMode":"ALL","quoteCharacter":"'"} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteCSVRIStruct.csv&quot;;      
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;quoteMode&quot;:&quot;ALL&quot;,&quot;quoteCharacter&quot;:&quot;'&quot;}) 
</cfscript>

構造体の値 - {"delimiter":";","quoteMode":"NONE","quoteCharacter":"'","escapeCharacter":"-"} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteCSVRIStruct.csv&quot;;      
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;delimiter&quot;:&quot;;&quot;,&quot;quoteMode&quot;:&quot;NONE&quot;,&quot;quoteCharacter&quot;:&quot;'&quot;,&quot;escapeCharacter&quot;:&quot;-&quot;}) 
</cfscript>

構造体の値 - {"quoteMode":"MINIMAL","quoteCharacter":"'"} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;customers-100.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteCSVRIStruct.csv&quot;;        
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;quoteMode&quot;:&quot;MINIMAL&quot;,&quot;quoteCharacter&quot;:&quot;'&quot;}) 
</cfscript>

構造体の値 - {"header":"#test#","skipHeaderRecord":true} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;TestDataFile.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWrite_pos6_6_1.csv&quot;; 
    header=['2021','Level 1','99999','All industries','Dollars (millions)','H07'] 
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;header&quot;:&quot;#test#&quot;,&quot;skipHeaderRecord&quot;:true}) 
</cfscript>

構造体の値 - {"header":"#header#","skipHeaderRecord":true} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;TestDataFile.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteHeader.csv&quot;; 
    header=['2021','Level 1','99999','All industries','Dollars (millions)','H07'] 
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;header&quot;:&quot;#header#&quot;,&quot;skipHeaderRecord&quot;:true}) 
</cfscript>

構造体の値 - {"header":"#header#","skipHeaderRecord":false} を持つ csvrecorditerable からの CSV の書き込み

<cfscript> 
    csvfile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;TestDataFile.csv&quot;; 
    thefile = GetDirectoryFromPath(GetCurrentTemplatePath()) & &quot;spreadsheetCSVWriteHeader.csv&quot;; 
    header=['2021','Level 1','99999','All industries','Dollars (millions)','H07'] 
    csvObj = csvread(#csvfile#,&quot;csvrecorditerable&quot;) 
    CSVWrite(csvObj,&quot;csvrecorditerable&quot;,#theFile#,{&quot;header&quot;:&quot;#header#&quot;,&quot;skipHeaderRecord&quot;:false}) 
</cfscript>

ヘルプをすばやく簡単に入手

新規ユーザーの場合