값이나 섹션을 표준 형식의 .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으로 생성됩니다.
유니코드: IniRead와 IniWrite는 외부 함수 GetPrivateProfileString와 WritePrivateProfileString에 의존해 값을 읽고 씁니다. 이런 함수들은 유니코드를 UTF-16 파일만 지원합니다; 다른 모든 파일은 시스템의 기본 ANSI 코드 페이지를 사용한다고 간주됩니다. 유니코드 스크립트에서, IniWrite은 각 새 파일에 UTF-16을 사용합니다. 이게 싫다면, IniWrite를 호출하기 전에 파일이 존재하는지 먼저 확인하십시오. 예를 들어:
FileAppend,, NonUnicode.ini, CP0 ; 마지막 매개변수는 대부분의 경우 선택적입니다.