표준 형식의 .ini 파일로부터 섹션 이름의 리스트 또는 섹션, 값을 읽습니다.
IniRead, OutputVar, Filename, Section, Key [, Default] IniRead, OutputVarSection, Filename, Section IniRead, OutputVarSectionNames, Filename
열람된 값을 저장할 변수의 이름. 변수를 열람할 수 없으면, 변수는 Default 매개변수가 가리키는 값이 설정됩니다 (아래에 기술함).
[AHK_L 57+]: Key 매개변수를 생략하면 전체 섹션을 읽을 수 있습니다. 주석과 빈 줄은 생략됩니다. 오직 섹션에서 앞 쪽 65,533 문자만 열람됩니다.
[AHK_L 57+]: Key와 Section 매개변수를 모두 생략하면 섹션 이름을 라인피드로 (`n) 구분한 리스트를 열람할 수 있습니다.
.ini 파일의 이름, 절대 경로를 지정하지 않으면 %A_WorkingDir%에 있다고 간주됩니다.
.ini 파일에 있는 섹션 이름, 각 괄호 안에 나타나는 제목 문구 (이 매개변수에 각괄호는 포함되지 않습니다).
.ini 파일에 있는 키 이름.
요청된 키가 발견되지 않으면 OutputVar에 저장할 값. 생략되면, 단어 ERROR가 기본값입니다. 빈 값 (빈 문자열)을 저장하려면, %A_Space%를 지정하십시오.
[AHK_L 57+]: Key가 생략되면 이 매개변수는 사용되지 않습니다.
ErrorLevel는 이 명령어로 설정되지 않습니다. 문제가 있었다면, OutputVar에는 위에 기술한 바와 같이 Default 값이 설정됩니다.
운영 체제는 자동으로 열람된 문자열에서 앞 뒤 스페이스/탭을 생략합니다. 이를 방지하려면, 문자열을 홑따옴표 또는 겹따옴표로 둘러 싸십시오. 가장 바깥쪽 홑따옴표 또는 겹따옴표도 생략됩니다. 그러나 따옴표 안의 스페이스는 유지됩니다.
65,535 문자보다 긴 값은 결과가 일관성이 없을 가능성이 높습니다.
표준 ini 파일의 모습은 다음과 같습니다:
[SectionName] Key=Value
유니코드: IniRead와 IniWrite는 외부 함수 GetPrivateProfileString와 WritePrivateProfileString에 의존해 값을 읽고 씁니다. 이런 함수들은 유니코드를 UTF-16 파일만 지원합니다; 다른 모든 파일은 시스템의 기본 ANSI 코드 페이지를 사용한다고 간주됩니다.
IniDelete, IniWrite, RegRead, 파일-읽기 회돌이, FileRead
IniRead, OutputVar, C:\Temp\myfile.ini, section2, key MsgBox, 값은 %OutputVar%입니다.