값이나 섹션을 표준 형식의 .ini 파일에 씁니다.
IniWrite, Value, Filename, Section, Key IniWrite, Pairs, Filename, Section
Key의 등호 사인 (=)의 오른쪽에 씌여질 문자열이나 숫자.
텍스트가 길면, 여러 짧은 줄로 자를 수 있습니다. 계속 섹션을 사용하면 되는데, 이렇게 하면 가독성과 유지관리성이 향상됩니다.
[AHK_L 57+]: .ini 파일에 쓸 섹션의 완전한 내용, [SectionName] 헤더는 제외. Key는 생략해야 합니다. Pairs은 빈 줄이 들어 있으면 안 됩니다. 섹션이 이미 존재하면, 마지막 키=값 쌍까지 모조리 덮어쓰기 됩니다. Pairs에는 등호 사인 (=) 없는 줄이 들어 있을 수 있지만, 이렇게 되면 결과는 일관성이 없습니다. 주석을 파일에 쓸 수 있지만, IniRead이 다시 읽을 때 다 걷어내 버립니다.
.ini 파일의 이름, 절대 경로를 지정하지 않으면 %A_WorkingDir%에 있다고 간주됩니다.
.ini 파일에 있는 섹션의 이름, 각 괄호 안에 나타나는 제목 문구입니다 (이 매개변수에 각괄호는 포함하지 않습니다).
.ini 파일에 있는 키 이름.
[v1.1.04+] 이 명령어는 실패시 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.
ErrorLevel은 문제가 있었으면 1 없었으면 0이 설정됩니다.
65,535 문자가 넘는 값을 파일에 쓸 수는 있지만, 그 결과는 일관성이 없으므로 보통 IniRead 또는 다른 어플리케이션에서 올바르게 읽어 들일 수 없습니다.
표준 ini 파일의 모습은 다음과 같습니다:
[SectionName] Key=Value
새 파일은 AutoHotkey 버전에 따라 시스템의 기본 ANSI 코드페이지 또는 UTF-16으로 생성됩니다. UTF-16 파일은 빈 줄로 시작하는 듯 보일 수 있습니다. 첫 줄에 UTF-16 바이트 순서 표식이 들어 있기 때문입니다. 우회책은 아래를 참조하십시오.
유니코드: IniRead와 IniWrite는 외부 함수 GetPrivateProfileString와 WritePrivateProfileString에 의존하여 값을 읽고 씁니다. 이 함수들은 유니코드를 오직 UTF-16 파일만 지원합니다; 다른 모든 파일은 시스템의 기본 ANSI 코드 페이지를 사용한다고 간주합니다. 유니코드 스크립트에서, IniWrite은 각 새 파일에 UTF-16을 사용합니다. 이게 싫다면, IniWrite를 호출하기 전에 파일이 존재하는지 먼저 확인하십시오. 예를 들어:
FileAppend,, NonUnicode.ini, CP0 ; 마지막 매개변수는 대부분의 경우 선택적입니다.
IniWrite, 이것이 새 값입니다, C:\Temp\myfile.ini, section2, key