.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PERLKO 1perl"
.TH PERLKO 1perl 2024-02-11 "perl v5.38.2" "Perl Programmers Reference Guide"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
perlko \- 한국어 Perl 안내서
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Perl의 세계에 오신 것을 환영합니다!
.PP
Perl은 가끔 \fB'Practical Extraction and Report Language'\fR라고 하기도 합니다만
다른 널리 알려진 것들 중에서 \fB'Pathologically Eclectic Rubbish Lister'\fR라고
하기도 합니다. 사실 이것은 끼워 맞춘 것이며 Perl이 이것들의 첫 글자를
가져와서 이름을 붙인 것은 아닙니다. Perl의 창시자 Larry가 첫 번째 이름을
먼저 생각했고 널리 알려진 것을 나중에 지었기 때문입니다. 그렇기 때문에
\&\fB'Perl'\fR은 모두 대문자가 아닙니다. 널리 알려진 어떤 것을 가지고 논쟁하는
것은 의미가 없습니다. Larry는 두 개 다 지지합니다.
.PP
가끔 p가 소문자로 작성된 \fB'perl'\fR을 볼 것입니다. P가 대문자로 되어 있는
\&\fB'Perl'\fR은 언어를 참조할 때 쓰이며 \fB'perl'\fR처럼 p가 소문자인 경우는 여러분의
프로그램을 컴파일하고 돌릴 때 사용되는 해석기를 지칭할 때 사용됩니다.
.SH "Perl에 관하여"
.IX Header "Perl에 관하여"
Perl은 본래 문자열 생성을 위해 만들졌지만 지금은 시스템 관리와 웹 개발,
네트워크 프로그래밍, GUI 개발 등을 포함한 여러 분야에서 널리 사용되는
범용 프로그래밍 언어입니다.
.PP
이 언어는 아름다움(아주 작고, 우아하고, 아주 적고)보다
실용적(사용하기 쉽고, 효율적이며, 가능한 최대한)인 것을 지향하고 있습니다.
사용하기 쉽고, 절차적 프로그래밍과 객체 지향 프로그래밍을 모두 지원하고,
강력한 문자열 처리 기능을 내장하고, 세상에서 가장 인상적인 제 3자의 모듈
모음처를 가지고 있다는 것은 Perl의 가장 중요한 특징입니다.
.PP
Perl의 언어적 특징은 \fIpod/perlintro.pod\fR 문서에서 소개합니다.
.PP
이번 릴리스에서 가장 중요한 변화는 \fIpod/perldelta.pod\fR에서 논의합니다.
.PP
또한 다양한 출판사가 출판한 많은 Perl 책은 다양한 주제를 다루고 있습니다.
자세한 정보는 \fIpod/perlbook.pod\fR 문서를 확인하세요.
.SH 설치
.IX Header "설치"
여러분이 비교적 현대의 운영체제를 사용하고 있고 현재 버전의 Perl을
지역적으로 설치하고 싶다면 다음 명령을 실행하세요.
.PP
.Vb 3
\&    ./Configure \-des \-Dprefix=$HOME/localperl
\&    make test
\&    make install
.Ve
.PP
앞의 명령은 여러분의 플랫폼에 맞게 환경을 설정하고 컴파일을 수행한 후,
회기 테스트를 수행한뒤, 홈 디렉터리 하부의 \fIlocalperl\fR 디렉터리에 perl을
설치합니다.
.PP
여러분이 어떠한 문제든 겪게 되거나 사용자 정의 버전 Perl을 설치할 필요가 있다면
현재 배포판에 들어있는 \fIINSTALL\fR 파일 안의 자세한 설명을 읽어야 합니다.
추가적으로 일반적이지 않은 다양한 플랫폼에서 Perl을 빌드하고 사용하는
방법에 대한 도움말과 귀띔이 적혀있는 많은 수의 \fIREADME\fR 파일이 있습니다.
.PP
일단 Perl을 설치하고 나면 \f(CW\*(C`perldoc\*(C'\fR 도구를 이용해 풍부한 문서를 사용할
수 있습니다. 시작하기 위해서 다음 명령을 실행하세요.
.PP
.Vb 1
\&    perldoc perl
.Ve
.SH "실행에 어려움을 겪는다면"
.IX Header "실행에 어려움을 겪는다면"
Perl은 뜨개질에서 부터 로켓 과학까지 모든 분야에서 사용할 수 있는 크고
복잡한 시스템입니다. 여러분이 어려움에 부딪혔을때 그 문제는 이미 다른
사람이 해결했을 가능성이 높습니다. 문서를 모두 확인했는데도 버그가
확실하다면 \f(CW\*(C`perlbug\*(C'\fR 도구를 이용해서 저희에게 버그를 보고해주세요.
\&\f(CW\*(C`perlbug\*(C'\fR에 대한 더 자세한 정보는 \f(CW\*(C`perldoc perlbug\*(C'\fR 또는 \f(CW\*(C`perlbug\*(C'\fR를
명령줄에서 실행해서 확인할 수 있습니다.
.PP
Perl을 사용 가능하게 만들었다 하더라도 Perl은 계속해서 진화하기 때문에
여러분이 맞닥뜨린 버그를 수정했거나 여러분이 유용하다고 생각할법한
새로운 기능이 추가된 좀 더 최신 버전이 있을 수 있습니다.
.PP
여러분은 항상 최신 버전의 perl을 CPAN (Comprehensive Perl Archive Network)
사이트 <http://www.cpan.org/src/> 에서 찾을 수 있습니다.
.PP
perl 소스에 간단한 패치를 등록하고 싶다면 \fIpod/perlhack.pod\fR 문서의
\&\fB"SUPER QUICK PATCH GUIDE"\fR를 살펴보세요.
.PP
그냥 개인적으로 참고하세요.
제가 이것처럼 멋진 물건을 만든다는 것을 여러분이 알기를 바랍니다.
그것은 제 이야기의 \fB"저자(Author)"\fR를 기쁘게하기 때문입니다.
이것이 여러분을 귀찮게 한다면 여러분의 \fB"저작(Authorship)"\fR에
대한 생각을 정정해야 할 수도 있습니다. 하지만 어쨌거나 여러분은
Perl을 사용하는데는 문제가 없답니다. :\-)
.PP
\&\- \fB"저자"\fR로부터.
.SH 인코딩
.IX Header "인코딩"
Perl은 5.8.0판부터 유니코드/ISO 10646에 대해 광범위하게 지원합니다.
유니코드 지원의 일환으로 한중일을 비롯한 세계 각국에서
유니코드 이전에 쓰고 있었고 지금도 널리 쓰이고 있는 수많은 인코딩을
지원합니다. 유니코드는 전 세계에서 쓰이는 모든 언어를 위한
표기 체계(유럽의 라틴 알파벳, 키릴 알파벳, 그리스 알파벳, 인도와 동남 아시아의
브라미 계열 스크립트, 아랍 문자, 히브리 문자, 한중일의 한자, 한국어의 한글,
일본어의 가나, 북미 인디안의 표기 체계 등)를 수용하는 것을 목표로 하고
있기 때문에 기존에 쓰이던  각 언어 및 국가 그리고 운영 체계에 고유한
문자 집합과 인코딩에 쓸 수 있는 모든 글자는 물론이고  기존 문자 집합에서
지원하고 있지 않던 아주 많은 글자를  포함하고 있습니다.
.PP
Perl은 내부적으로 유니코드를 문자 표현을 위해 사용합니다.
보다 구체적으로 말하면 Perl 스크립트 안에서  UTF\-8 문자열을 쓸 수 있고,
각종 함수와 연산자(예를 들어, 정규식, index, substr)가 바이트 단위
대신 유니코드 글자 단위로 동작합니다.
더 자세한 것은 \fIpod/perlunicode.pod\fR 문서를 참고하세요.
유니코드가 널리 보급되기 전에 널리 쓰이고 있었고, 여전히 널리 쓰이고 있는
각국/각 언어별 인코딩으로 입출력을 하고 이들 인코딩으로 된 데이터와 문서를
다루는 것을 돕기 위해 Encode 모듈이 쓰이고 있습니다.
무엇보다 Encode 모듈을 사용하면 수많은 인코딩 사이의 변환을 쉽게 할 수 있습니다.
.SS "Encode 모듈"
.IX Subsection "Encode 모듈"
\fI지원 인코딩\fR
.IX Subsection "지원 인코딩"
.PP
Encode 모듈은 다음과 같은 한국어 인코딩을 지원합니다.
.IP \(bu 4
\&\f(CW\*(C`euc\-kr\*(C'\fR
.Sp
US\-ASCII와 KS X 1001을 같이 쓰는 멀티바이트 인코딩으로 흔히
완성형이라고 불림. KS X 2901과 RFC 1557 참고.
.IP \(bu 4
\&\f(CW\*(C`cp949\*(C'\fR
.Sp
MS-Windows 9x/ME에서 쓰이는 확장 완성형. euc\-kr에 8,822자의
한글 음절을 더한 것임. alias는 uhc, windows\-949, x\-windows\-949,
ks_c_5601\-1987. 맨 마지막 이름은 적절하지 않은 이름이지만, Microsoft
제품에서 CP949의 의미로 쓰이고 있음.
.IP \(bu 4
\&\f(CW\*(C`johab\*(C'\fR
.Sp
KS X 1001:1998 부록 3에서 규정한 조합형. 문자 레퍼토리는 cp949와 마찬가지로
US\-ASCII와  KS X 1001에 8,822자의 한글 음절을 더한 것으로 인코딩 방식은 전혀 다름.
.IP \(bu 4
\&\f(CW\*(C`iso\-2022\-kr\*(C'\fR
.Sp
RFC 1557에서 규정한 한국어 인터넷 메일 교환용 인코딩으로 US\-ASCII와
KS X 1001을 레퍼토리로 하는 점에서 euc\-kr과 같지만 인코딩 방식이 다름.
1997\-8년 경까지 쓰였으나 더 이상 메일 교환에 쓰이지 않음.
.IP \(bu 4
\&\f(CW\*(C`ksc5601\-raw\*(C'\fR
.Sp
KS X 1001(KS C 5601)을 GL(즉, MSB를 0으로 한 경우)에 놓았을 때의 인코딩.
US\-ASCII와 결합하지 않고 단독으로 쓰이는 일은 X11 등에서 글꼴
인코딩(ksc5601.1987\-0. '0'은 GL을 의미함)으로 쓰이는 것을 제외하고는
거의 없음. KS C 5601은 1997년 KS X 1001로 이름을 바꾸었음. 1998년에는 두
글자(유로화 부호와 등록 상표 부호)가 더해졌음.
.PP
\fI변환 예제\fR
.IX Subsection "변환 예제"
.PP
예를 들어, euc-kr 인코딩으로 된 파일을 UTF\-8로 변환하려면
명령줄에서 다음처럼 실행합니다.
.PP
.Vb 1
\&    perl \-Mencoding=euc\-kr,STDOUT,utf8 \-pe1 < file.euc\-kr > file.utf8
.Ve
.PP
반대로 변환할 경우 다음처럼 실행합니다.
.PP
.Vb 1
\&    perl \-Mencoding=utf8,STDOUT,euc\-kr \-pe1 < file.utf8 > file.euc\-kr
.Ve
.PP
이런 변환을 좀더 편리하게 할 수 있도록 도와주는 \fIpiconv\fR가 Perl에
기본으로 들어있습니다. 이 유틸리티는 Encode 모듈을 이용한 순수 Perl
유틸리티로 이름에서 알 수 있듯이 Unix의 \f(CW\*(C`iconv\*(C'\fR를 모델로 한 것입니다.
사용법은 다음과 같습니다.
.PP
.Vb 2
\&   piconv \-f euc\-kr \-t utf8 < file.euc\-kr > file.utf8
\&   piconv \-f utf8 \-t euc\-kr < file.utf8 > file.euc\-kr
.Ve
.PP
\fI모범 사례\fR
.IX Subsection "모범 사례"
.PP
Perl은 기본적으로 내부에서 UTF\-8을 사용하며 Encode 모듈을 통해
다양한 인코딩을 지원하지만 항상 다음 규칙을 지킴으로써 인코딩과
관련한 다양하게 발생할 수 있는 문제의 가능성을 줄이는 것을 추천합니다.
.IP \(bu 4
소스 코드는 항상 UTF\-8 인코딩으로 저장
.IP \(bu 4
소스 코드 상단에 \f(CW\*(C`use utf8;\*(C'\fR 프라그마 사용
.IP \(bu 4
소스 코드, 터미널, 운영체제, 데이터 인코딩을 분리해서 이해
.IP \(bu 4
입출력 파일 핸들에 명시적인 인코딩을 사용
.IP \(bu 4
중복(double) 인코딩을 주의
.PP
\fI유니코드 및 한국어 인코딩 관련 자료\fR
.IX Subsection "유니코드 및 한국어 인코딩 관련 자료"
.IP \(bu 4
perluniintro
.IP \(bu 4
perlunicode
.IP \(bu 4
Encode
.IP \(bu 4
Encode::KR
.IP \(bu 4
encoding
.IP \(bu 4
<https://www.unicode.org/>
.Sp
유니코드 컨소시엄
.IP \(bu 4
<http://std.dkuug.dk/JTC1/SC2/WG2>
.Sp
기본적으로 Unicode와 같은 ISO 표준인  ISO/IEC 10646 UCS(Universal
Character Set)을 만드는 ISO/IEC JTC1/SC2/WG2의 웹 페이지
.IP \(bu 4
<https://www.cl.cam.ac.uk/~mgk25/unicode.html>
.Sp
유닉스/리눅스 사용자를 위한 UTF\-8 및 유니코드 관련 FAQ
.IP \(bu 4
<http://wiki.kldp.org/Translations/html/UTF8\-Unicode\-KLDP/UTF8\-Unicode\-KLDP.html>
.Sp
유닉스/리눅스 사용자를 위한 UTF\-8 및 유니코드 관련 FAQ의 한국어 번역
.SH "Perl 관련 자료"
.IX Header "Perl 관련 자료"
다음은 공식적인 Perl 관련 자료중 일부입니다.
.IP \(bu 4
<https://www.perl.org/>
.Sp
Perl 공식 홈페이지
.IP \(bu 4
<https://www.perl.com/>
.Sp
O'Reilly의 Perl 웹 페이지
.IP \(bu 4
<https://www.cpan.org/>
.Sp
CPAN \- Comprehensive Perl Archive Network, 통합적 Perl 파일 보관 네트워크
.IP \(bu 4
<https://metacpan.org>
.Sp
메타 CPAN
.IP \(bu 4
<https://lists.perl.org/>
.Sp
Perl 메일링 리스트
.IP \(bu 4
<http://blogs.perl.org/>
.Sp
Perl 메타 블로그
.IP \(bu 4
<https://www.perlmonks.org/>
.Sp
Perl 수도승들을 위한 수도원
.IP \(bu 4
<https://www.pm.org/groups/asia.html>
.Sp
아시아 지역 Perl 몽거스 모임
.IP \(bu 4
<http://www.perladvent.org/>
.Sp
Perl 크리스마스 달력
.PP
다음은 Perl을 더 깊게 공부하는데 도움을 줄 수 있는 한국어 관련 사이트입니다.
.IP \(bu 4
<https://perl.kr/>
.Sp
한국 Perl 커뮤니티 공식 포털
.IP \(bu 4
<https://doc.perl.kr/>
.Sp
Perl 문서 한글화 프로젝트
.IP \(bu 4
<https://cafe.naver.com/perlstudy.cafe>
.Sp
네이버 Perl 카페
.IP \(bu 4
<http://www.perl.or.kr/>
.Sp
한국 Perl 사용자 모임
.IP \(bu 4
<https://advent.perl.kr>
.Sp
Seoul.pm Perl 크리스마스 달력 (2010 ~ 2012)
.IP \(bu 4
<http://gypark.pe.kr/wiki/Perl>
.Sp
GYPARK(Geunyoung Park)의 Perl 관련 한글 문서 저장소
.SH 라이센스
.IX Header "라이센스"
\&\fIREADME\fR 파일의 \fB'LICENSING'\fR 항목을 참고하세요.
.SH AUTHORS
.IX Header "AUTHORS"
.IP \(bu 4
Jarkko Hietaniemi <jhi@iki.fi>
.IP \(bu 4
신정식 <jshin@mailaps.org>
.IP \(bu 4
김도형 <keedi@cpan.org>