AutoHotKey(오토핫키) 설명서 FileRead

Posted by 발전소장
2014. 8. 14. 00:30 AutoHotKey/Commands

FileRead

텍스트 파일의 전내용을 변수에 읽어들인다

FileRead, OutputVar, Filename

Parameters

OutputVar 읽어들인 내용을 격납하는 변수명.
FileName대상이 되는 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
파일명의 전에 「*t 」(을)를 붙이면, 파일을 텍스트로서 읽어들인다.이 때,CR+LF의LF에의 자동변역을 한다.다만, 많은 경우CR+LF인 채에서도 문제는 없다.
파일명의 전에 「*m」에 이어 수치를 지정하면, 파일의 선두로부터 수치로 지정한 아르바이트수만큼이 읽힌다.(례:「*m1024 %filename%」)

ErrorLevel

정상 종료하면 「0」, 무엇인가 문제가 있으면 「1」

Remarks

파일이 존재하지 않는, 다른 어플리케이션이 읽어내 금지로 열려 있는, 메모리가 부족한, 파일 사이즈가1GB이상 있는 등의 경우, 읽어들여에 실패해ErrorLevel(은)는 「1」(이)가 된다.

#MaxMem그리고 설정한 사이즈보다 큰 파일도, 모두 메모리상에 읽힌다.

null문자(0x00)(을)를 포함한 파일도, 모든 내용이 읽힌다.
변수의 내용 문자열로서 액세스 할 수 있는 것은 최초의null문자 이전의 부분만큼이지만,DllCall등을 사용하는 것으로 모든 내용에 액세스 할 수 있다.

Related

file-reading loop, FileReadLine, FileGetSize, FileAppend, IniRead, Sort

Example(s)

FileRead, OutputVar, C:\My Documents\My File.txt


AutoHotKey(오토핫키) 설명서 FileMoveDir

Posted by 발전소장
2014. 8. 14. 00:30 AutoHotKey/Commands

FileMoveDir

폴더를 이동한다

FileMoveDir, Source, Dest [, Flag]

Parameters

인수명설명
Source 이동원의 폴더명.
마지막 「\」(은)는 포함하지 않는다.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
Dest 이동처의 폴더명.
마지막 「\」(은)는 포함하지 않는다.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
Flag 「2」(을)를 지정하면, 동명의 파일이 존재했을 때에 덧쓰기를 실시한다.
생략시나 「0」(을)를 지정했을 경우는, 동명의 파일이 존재했을 때는 카피하지 않는다.
「1」(을)를 지정하면, 동명의 파일을 덧쓰기한다.그러나,Dest하지만Source(와)과 다른 드라이브에 폴더로서 벌써 존재하고 있으면, 덧쓰기하지 않고 그 폴더내로 이동해 버린다.
또 「R」(을)를 지정하면, 파일이 사용중으로 이동할 수 없는등의 문제로 이동할 수 없는 파일이 있을 때, 모든 조작을 캔슬한다.이것은 rename에 의해서 실현되므로, 다른 드라이브간으로의 카피에서는 사용할 수 없다.

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

이동처의 폴더가 벌써 존재해,Flag인수가 「1」의 경우,Source그리고 지정한 폴더를Dest그리고 지정한 폴더안으로 이동한다.

키보드나 마우스의 훅을 이용하고 있는 경우, 처리중에 조작을 받아들일 수 없게 되는 일이 있다.

Related

FileCopyDir, FileCopy, FileMove, FileDelete, File-loops

Example(s)

FileMoveDir, C:\My Folder, D:\My Folder
FileMoveDir, C:\My Folder, C:\My Folder (renamed), 1


AutoHotKey(오토핫키) 설명서 FileMove

Posted by 발전소장
2014. 8. 14. 00:29 AutoHotKey/Commands

FileMove

파일을 이동·rename 한다

FileMove, SourcePattern, DestPattern [, Flag]

Parameters

인수명설명
SourcePattern 파일명 혹은 와일드 카드.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
DestPattern 이동 후의 파일명 혹은 와일드 카드. 상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
Flag 「1」(을)를 지정하면, 동명의 파일이 존재했을 때에 덧쓰기를 실시한다.
생략시나 「0」(을)를 지정했을 경우는, 동명의 파일이 존재했을 때는 이동하지 않는다.

ErrorLevel

이동에 실패한 파일의 수가 된다

Remarks

파일을 그 파일 자신에게 이동하려고 했을 경우는, 반드시 성공으로 간주해진다.

다른 드라이브간으로의 이동은, 카피와 삭제의 동작에 의해서 행해진다.

폴더를 이동하려면 ,FileMoveDir(을)를 사용한다.

Related

FileCopy, FileCopyDir, FileMoveDir, FileDelete

Example(s)

FileMove, C:\My Documents\List1.txt, D:\Main Backup\    ; Move the file without renaming it.
FileMove, C:\File Before.txt, C:\File After.txt   ; Rename a single file.
FileMove, C:\Folder1\*.txt, D:\New Folder\*.bkp    ; Move and rename files to a new extension.

; The following example moves all files and folders inside a folder to a different folder:
ErrorCount := MoveFilesAndFolders("C:\My Folder\*.*", "D:\Folder to receive all files & folders")
if ErrorCount <> 0
	MsgBox %ErrorCount% files/folders could not be moved.

MoveFilesAndFolders(SourcePattern, DestinationFolder, DoOverwrite = false)
; Moves all files and folders matching SourcePattern into the folder named DestinationFolder and
; returns the number of files/folders that could not be moved. This function requires v1.0.38+
; because it uses FileMoveDir's mode 2.
{
	if DoOverwrite = 1
		DoOverwrite = 2  ; See FileMoveDir for description of mode 2 vs. 1.
	; First move all the files (but not the folders):
	FileMove, %SourcePattern%, %DestinationFolder%, %DoOverwrite%
	ErrorCount := ErrorLevel
	; Now move all the folders:
	Loop, %SourcePattern%, 2  ; 2 means "retrieve folders only".
	{
		FileMoveDir, %A_LoopFileFullPath%, %DestinationFolder%\%A_LoopFileName%, %DoOverwrite%
		ErrorCount += ErrorLevel
		if ErrorLevel  ; Report each problem folder by name.
			MsgBox Could not move %A_LoopFileFullPath% into %DestinationFolder%.
	}
	return ErrorCount
}


AutoHotKey(오토핫키) 설명서 FileInstall

Posted by 발전소장
2014. 8. 14. 00:29 AutoHotKey/Commands

FileInstall

스크립트를Ahk2Exe.exe그리고 실행 파일화할 때, 지정 파일을 실행 파일내에 묻는다

FileInstall, Source, Dest, Flag

Parameters

인수명설명
Source 묻는 파일의 패스.
상대 패스로 지정했을 경우는,#Include그리고 사용되는 것과 같은 기준 디렉토리로부터의 패스가 된다.
「"」(으)로 둘러싸거나 변수나 환경 변수를 포함하거나 와일드 카드를 포함하거나 할 수 없다.
상대 패스로 지정되었을 경우는, 스크립트가 있는 디렉토리(A_ScriptDir)(으)로부터의 상대 패스로 간주해진다.
Dest 묻은 파일을 해동하는 패스.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
변수나 환경 변수를 포함할 수도 있다.「%TEMP%」환경 변수를 사용하면, 시스템 공통의 일시파일용 폴더에 해동할 수 있다.
Flag 「1」(을)를 지정하면,Dest그리고 지정한 파일이 벌써 존재해도 덧쓰기한다.
생략시나 「0」(을)를 지정했을 경우는, 파일이 벌써 존재하고 있을 때는 해동하지 않는다.

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

커멘드명과Source인수는, 반드시 같은 행에 기술해야 한다.

스크립트에 이 커멘드가 포함되어 있으면, 실행 파일화 시에Source그리고 지정된 파일을 묻는다.
실행 파일화 된 스크립트가 실행될 때에, 파묻힌 파일은Source그리고 지정한 패스에 전개된다.

파일은, 압축·암호화해 파묻힌다.

실행 파일화 되어 있지 않은 스크립트로 이 커멘드가 실행되면,Source그리고 지정한 파일이Dest에 카피된다.
이것에 의해, 실행 파일로 하지 않고 실행 파일화 후와 같은 상태로 테스트를 실시할 수 있다.

Related

FileCopy, #Include

Example(s)

 FileInstall, C:\My Documents\My File.txt, %ProgramFiles%\My Application\Readme.txt, 1


AutoHotKey(오토핫키) 설명서 FileGetVersion

Posted by 발전소장
2014. 8. 14. 00:28 AutoHotKey/Commands

FileGetVersion

프로그램 파일의 버젼 정보를 취득

FileGetVersion, OutputVar [, Filename] 

Parameters

인수명설명
OutputVar 취득한 정보를 격납하는 변수명
Filename 정보를 취득하는 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
생략시는, 제일 안쪽의File-Loop그리고 대상이 되고 있는 파일이 대상이 된다.

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

버젼 정보를 포함하지 않는 파일에서는,OutputVar(은)는 비운다.

Related

FileGetAttrib, FileSetAttrib, FileGetTime, FileSetTime, FileGetSize, File-loop

Example(s)

FileGetVersion, version, C:\My Application.exe
FileGetVersion, version, %ProgramFiles%\AutoHotkey\AutoHotkey.exe


AutoHotKey(오토핫키) 설명서 FileGetTime

Posted by 발전소장
2014. 8. 14. 00:27 AutoHotKey/Commands

FileGetTime

파일의 타임 스탬프를 취득

FileGetTime, OutputVar [, Filename, WhichTime]

Parameters

인수명설명
OutputVar 결과를 격납하는 변수명
Filename 타임 스탬프를 취득하는 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
생략시는, 제일 안쪽의File-Loop그리고 대상이 되고 있는 파일이 대상이 된다.
WhichTime 어느 타임 스탬프를 취득할까.
M
최종 갱신 일시(디폴트)
C
작성 일시
A
최종 액세스 일시

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

최종 액세스 일시는NTFS에서만 취득 가능.

일자 시각은YYYYMMDDHH24MISS의 서식에서 취득된다.

Related

FileSetTime, If var is [not] type, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, File-loop, EnvAdd, EnvSub

Example(s)

FileGetTime, OutputVar, C:\My Documents\test.doc ; Retrieves the modification time by default. 
FileGetTime, OutputVar, C:\My Documents\test.doc, C ; Retrieves the creation time.


AutoHotKey(오토핫키) 설명서 FileGetSize

Posted by 발전소장
2014. 8. 14. 00:27 AutoHotKey/Commands

FileGetSize

파일의 사이즈를 취득

FileGetSize, OutputVar [, Filename, Units] 

Parameters

인수명설명
OutputVar 결과를 격납하는 변수명
Filename 사이즈를 취득하는 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
생략시는, 제일 안쪽의File-Loop그리고 대상이 되고 있는 파일이 대상이 된다.
Units 「K」(을)를 지정하면 킬로바이트 단위, 「M」(을)를 지정하면메가바이트 단위로 취득.
소수점 이하는 사사오입 된다.
생략시는 아르바이트 단위.

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

FileName에 디렉토리를 지정했을 경우의 동작은 시스템에 의존한다.
통상은0(이)가 된다.

Related

FileGetAttrib, FileSetAttrib, FileGetTime, FileSetTime, FileGetVersion, File-loop

Example(s)

FileGetSize, size, C:\My Documents\test.doc ; Retrieve the size in bytes.
FileGetSize, size, C:\My Documents\test.doc, K ; Retrieve the size in Kbytes.


AutoHotKey(오토핫키) 설명서 FileGetShortcut

Posted by 발전소장
2014. 8. 14. 00:26 AutoHotKey/Commands

FileGetShortcut

쇼트 컷(.lnk)의 각종 정보를 취득한다

FileGetShortcut, LinkFile [, OutTarget, OutDir, OutArgs, OutDescription, OutIcon, OutIconNum, OutRunState]

Parameters

인수명설명
LinkFile 정보를 취득하고 싶은 쇼트 컷의 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
OutTarget 쇼트 컷의 링크 앞의 파일 패스가 격납되는 변수명을 지정.
OutDir 쇼트 컷이 실행될 때의 작업 폴더가 격납되는 변수명을 지정.
OutArgs 링크 앞 가운데, 인수의 부분이 격납되는 변수명을 지정.
OutDescription 코멘트가 격납되는 변수명을 지정
OutIcon 쇼트 컷 파일에 표시되는 아이콘을 포함한 파일의 풀 패스가 격납되는 변수명을 지정.
OutIconNum 프로그램 파일중의 몇번째의 아이콘을 쇼트 컷의 아이콘으로 할지가 격납되는 변수명을 지정.
OutRunState 쇼트 컷의 프롭퍼티의 「실행시의 크기」의 부분이 격납되는 변수명을 지정.
이하의 어떤 것인가가 된다.
1
통상의 윈도우(디폴트)
3
최대화
7
최소화

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

OutTarget이후의 생략 된 인수에 대응하는 정보는 취득되지 않는다.

Related

FileCreateShortcut, SplitPath

Example(s)

FileSelectFile, file,,, Pick a shortcut to analyze., Shortcuts (*.lnk)
if file =
	return
FileGetShortcut, %file%, OutTarget, OutDir, OutArgs, OutDesc, OutIcon, OutIconNum, OutRunState
Transform, OutDir, Deref, %OutDir%  ; Resolve any environment variables, such as %WinDir%.
MsgBox %OutTarget%`n%OutDir%`n%OutArgs%`n%OutDesc%`n%OutIcon%`n%OutIconNum%`n%OutRunState%


AutoHotKey(오토핫키) 설명서 FileGetAttrib

Posted by 발전소장
2014. 8. 14. 00:26 AutoHotKey/Commands

FileGetAttrib

파일의 속성을 취득

FileGetAttrib, OutputVar [, Filename]

Parameters

인수명설명
OutputVar 결과를 격납하는 변수명
Filename 속성을 취득하는 파일명.
상대 패스로 지정했을 경우는,%A_WorkingDir%(을)를 기준으로 한 패스가 된다.
생략시는, 제일 안쪽의File-Loop그리고 대상이 되고 있는 파일이 대상이 된다.

ErrorLevel

성공시는 「0」, 실패시는 「1」.

Remarks

결과는, 이하의 문자를 연결한 것.

R = 독해 전용
A = 어카이브(archive)
S = 시스템
H = 은폐 파일
N = 통상
D = 디렉토리
O = 오프 라인
C = 압축
T = 일시파일

결과가 특정의 속성을 가지고 있을까를 조사하려면 ,IfInString커멘드를 사용하는 등 한다.

Related

FileSetAttrib, FileGetTime, FileSetTime, FileGetSize, FileGetVersion, File-loop

Example(s)

 FileGetAttrib, OutputVar, C:\New Folder 


AutoHotKey(오토핫키) 설명서 FileExist()

Posted by 발전소장
2014. 8. 14. 00:25 AutoHotKey/Commands

FileExist()

파일이 존재할지의 체크와 속성의 취득을 실시할 수 있는 함수.

FileExist(FilePattern)

Parameters

인수명설명
FilePattern조사하고 싶은 파일의 패스를 문자열로 지정한다
구체적인 파일명외, 와일드 카드 문자로서 「*」 「?」(이)가 사용할 수 있다.
상대 패스를 지정했을 경우,A_WorkingDir(으)로부터의 상대 패스로 간주해진다.

Remarks

돌아가 값은, 이하의 문자를 연결한 것.
이것은FileGetAttrib커멘드로 사용되는 것과 동일하다.
R = 독해 전용
A = 어카이브(archive)
S = 시스템
H = 은폐 파일
N = 통상
D = 디렉토리
O = 오프 라인
C = 압축
T = 일시파일

FilePattern에 일치하는 파일이 존재하지 않는 경우는, 길이 제로의 공문자열이 돌려주어진다.
파일이 존재하지만, 어떤 속성도 붙지 않은 경우는 「X」(이)가 된다.

Related

IfExist, FileGetAttrib

Examples

if(FileExist("data.txt")){
	FileRead,DATA,data.txt
}