fuzzy74 Mon Feb 26 12:12:50 2001 EDT Modified files: /phpdoc/kr/functions imap.xml Log: english -> korean translated by taeyoung,Jin.
Index: phpdoc/kr/functions/imap.xml diff -u phpdoc/kr/functions/imap.xml:1.2 phpdoc/kr/functions/imap.xml:1.3 --- phpdoc/kr/functions/imap.xml:1.2 Fri Jan 12 06:16:39 2001 +++ phpdoc/kr/functions/imap.xml Mon Feb 26 12:12:50 2001 @@ -1,33 +1,31 @@ <reference id="ref.imap"> - <title>IMAP, POP3 and NNTP functions</title> + <title>IMAP, POP3 그리고 NNTP 함수</title> <titleabbrev>IMAP</titleabbrev> <partintro> <simpara> - To get these functions to work, you have to compile PHP with - <option role="configure">--with-imap</option>. That requires the - c-client library to be installed. Grab the latest version from - <ulink url="&url.imap;">&url.imap;</ulink> and compile it. Then - copy <filename>c-client/c-client.a</filename> to - <filename>/usr/local/lib/libc-client.a</filename> or some other - directory on your link path and copy + 이 함수를 작동시키려면, <option role="configure">--with-imap</option> + 옵션으로 PHP를 컴파일해야 한다. 이 옵션은 c-client +라이브러리가 요구된다. + <ulink url="&url.imap;">&url.imap;</ulink>으로부터 최신 버전을 +내려받아 + 컴파일 하시오. 그리고 <filename>c-client/c-client.a</filename>파일을 + <filename>/usr/local/lib/libc-client.a</filename>로,또는 다른 링크 +경로에 + 복사하시오. <filename>c-client/rfc822.h</filename>, - <filename>mail.h</filename> and <filename>linkage.h</filename> to - <filename>/usr/local/include</filename> or some other directory in - your include path. + <filename>mail.h</filename> 과 <filename>linkage.h</filename>를 + <filename>/usr/local/include</filename>이나 다른 include경로에 + 복사하시오. </simpara> <simpara> - Note that these functions are not limited to the - <acronym>IMAP</acronym> protocol, despite their name. The - underlying c-client library also supports <acronym>NNTP</acronym>, - <acronym>POP3</acronym> and local mailbox access methods. + 이 함수는 그 이름에도 불구하고, <acronym>IMAP</acronym> +프로토콜에만 + 한정되어 있지 않다. 이함수의 기초를 이루는 c-client +라이브러리는 또한 + <acronym>NNTP</acronym>, <acronym>POP3</acronym> 그리고 로컬 메일함 + 접근 메쏘드를 지원한다. </simpara> <para> - This document can't go into detail on all the topics touched by - the provided functions. Further information is provided by the - documentation of the c-client library source - (<filename>docs/internal.txt</filename>). and the following RFC - documents: + 이 문서는 여기서 제공되는 함수에 관계된 모든 주제를 설명 +할 수는 없다. + 더 자세한 정보는 c-client 라이브러리 소스의 문서에 제공된다 + (<filename>docs/internal.txt</filename>). + 그리고 다음 RFC 문서들도 이와 관련된 정보를 제공한다: <itemizedlist> <listitem> <simpara> @@ -76,10 +74,10 @@ </simpara> </listitem> </itemizedlist> - A detailed overview is also available in the books + 더 자세한 사항은 David Wood씨가 저술한 <ulink url="&url.email.book;">Programming Internet Email</ulink> - by David Wood and <ulink url="&url.imap.book;">Managing - IMAP</ulink> by Dianna Mullet & Kevin Mullet. + 과 Dianna Mullet씨와 Kevin Mullet씨가 같이 저술한 + <ulink url="&url.imap.book;">Managing IMAP</ulink>를 참고하시오. </para> </partintro> @@ -87,7 +85,7 @@ <refnamediv> <refname>imap_append</refname> <refpurpose> - Append a string message to a specified mailbox + 특정 메일박스에 문자열 메시지를 덧붙인다. </refpurpose> </refnamediv> <refsect1> @@ -104,18 +102,17 @@ </funcprototype> </funcsynopsis> <para> - Returns true on sucess, false on error. + 성공하면 true를 에러가 발생하면 false를 리턴한다. </para> <para> - <function>imap_append</function> appends a string message to the - specified mailbox <parameter>mbox</parameter>. If the optional - <parameter>flags</parameter> is specified, writes the - <parameter>flags</parameter> to that mailbox also. + <function>imap_append</function>함수는 특정 + 메일박스<parameter>mbox</parameter>에 문자열 메시지를 덧붙인다. + 선택적 인수<parameter>flags</parameter>가 부여되면, + <parameter>flags</parameter>도 그 메일박스에 쓴다. </para> <para> - When talking to the Cyrus IMAP server, you must use "\r\n" as - your end-of-line terminator instead of "\n" or the operation will - fail. + Cyrus IMAP 서버에 접근할 때에는, end-of-line terminator로 "\n" +대신에 + "\r\n"을 사용해야 한다. 그렇지 않으면 실패할 것이다. </para> <para> <example> @@ -147,7 +144,7 @@ <refentry id="function.imap-base64"> <refnamediv> <refname>imap_base64</refname> - <refpurpose>Decode BASE64 encoded text</refpurpose> + <refpurpose>BASE64로 엔코딩된 텍스트를 디코딩한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -158,9 +155,11 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_base64</function> function decodes BASE-64 encoded - text (see <ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, - Section 6.8). The decoded message is returned as a string. + <function>imap_base64</function>함수는 BASE-64로 엔코딩되어 있는 + 텍스트를 디코딩해준다 + (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>의 + Section 6.8을 보라). + 디코딩된 메시지가 문자열로 리턴되어 진다. </para> <para> See also <function>imap_binary</function>. @@ -172,7 +171,7 @@ <refentry id="function.imap-body"> <refnamediv> <refname>imap_body</refname> - <refpurpose>Read the message body</refpurpose> + <refpurpose>메시지의 본문을 읽어온다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -189,6 +188,11 @@ numbered <parameter> msg_number</parameter> in the current mailbox. The optional <parameter>flags</parameter> are a bit mask with one or more of the following: + <function>imap_body</function>함수는 메시지의 본문을 리턴한다. + 즉, 현재메일박스의 <parameter> msg_number</parameter>번째의 메시지 + 의 본문을 읽어 오게 된다. + 선택적 인수 <parameter>flags</parameter>는 다음 리스트의 +비트마스크 + 가 된다: <itemizedlist> <listitem> <simpara> @@ -209,11 +213,11 @@ </itemizedlist> </para> <para> - <function>imap_body</function> will only return a verbatim copy of the - message body. To extract single parts of a multipart MIME-encoded - message you have to use <function>imap_fetchstructure</function> to - analyze its structure and <function>imap_fetchbody</function> to - extract a copy of a single body component. + <function>imap_body</function>함수는 메시지 본문을 완전히 복사해 +올 것이다. + multipart MIME-encoded 메시지의 한 부분을 뽑아내기 위해서는 + 본문의 구조를 분석하는 +<function>imap_fetchstructure</function>함수와 + 한개의 본문 구성요소의 복사물을 뽑아오는 + <function>imap_fetchbody</function>함수를 이용해야 한다. </para> </refsect1> </refentry> @@ -221,7 +225,7 @@ <refentry id="function.imap-check"> <refnamediv> <refname>imap_check</refname> - <refpurpose>Check current mailbox</refpurpose> + <refpurpose>현재 메일 박스를 체크한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -232,13 +236,11 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on - failure. + 현재 메일 박스에 대한 정보를 리턴한다. 실패하면 FALSE를 +리턴한다. </para> <para> - The <function>imap_check</function> function checks the current - mailbox status on the server and returns the information in an - object with following properties: + <function>imap_check</function> 함수는 서버에서 현재 메일박스의 + 상태를 체크하고 다음 속성을 갖는 객체로 정보를 리턴한다: </para> <para> <itemizedlist> @@ -275,7 +277,7 @@ <refentry id="function.imap-close"> <refnamediv> <refname>imap_close</refname> - <refpurpose>Close an IMAP stream</refpurpose> + <refpurpose>IMAP 스트림을 닫는다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -289,10 +291,10 @@ </funcprototype> </funcsynopsis> <para> - Close the imap stream. Takes an optional - <parameter>flag</parameter> CL_EXPUNGE, which will silently - expunge the mailbox before closing, removing all messages marked for - deletion. + imap 스트림을 닫는다. + 선택적 인수 <parameter>flag</parameter>를 CL_EXPUNGE로 세팅하면, + 스트림을 닫기 전에 조용히(silently) 메일 박스를 지울 것이다. + 삭제 마크된 메시지만 모두 삭제한다. </para> </refsect1> </refentry> @@ -300,7 +302,7 @@ <refentry id="function.imap-createmailbox"> <refnamediv> <refname>imap_createmailbox</refname> - <refpurpose>Create a new mailbox</refpurpose> + <refpurpose>새 메일 박스를 만든다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -312,12 +314,13 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_createmailbox</function> creates a new mailbox - specified by <parameter>mbox</parameter>. Names containing - international characters should be encoded by <function>imap_utf7_encode</function> + <function>imap_createmailbox</function>는 + <parameter>mbox</parameter>인수에 주어진 이름으로 새 메일 박스를 +만든다. + 국제적인 문자들을 포함한 이름이면 +<function>imap_utf7_encode</function> + 함수로 인코딩되어야 한다. </para> <para> - Returns true on success and false on error. + 성공하면 true를 실패하면 false를 리턴한다. </para> <para> See also <function>imap_renamemailbox</function>, @@ -382,7 +385,7 @@ <refnamediv> <refname>imap_delete</refname> <refpurpose> - Mark a messge for deletion from current mailbox + 현재 메일 박스에서 삭제될 메시지를 표시한다 </refpurpose> </refnamediv> <refsect1> @@ -398,19 +401,17 @@ </funcprototype> </funcsynopsis> <para> - Returns true. + true를 리턴한다. </para> <para> - <function>imap_delete</function> function marks message pointed - by <parameter>msg_number</parameter> for deletion. The optional - <parameter>flags</parameter> parameter only has a single option, - <parameter>FT_UID</parameter>, which tells the function to treat - the <parameter>msg_number</parameter> argument as a - <parameter>UID</parameter>. Messages marked for deletion will - stay in the mailbox until either - <function>imap_expunge</function> is called or - <function>imap_close</function> is called with the optional - parameter CL_EXPUNGE. + <function>imap_delete</function>함수는 + <parameter>msg_number</parameter>번의 메시지를 지움 표시 한다. + 선택적 인수<parameter>flags</parameter>는 오직 하나의 옵션만 +있다. + 즉, <parameter>msg_number</parameter>를 <parameter>UID</parameter>로 + 취급할것인지 함수에게 알려주는 <parameter>FT_UID</parameter>의 +옵션만 있다. + 지움 표시된 메시지는 <function>imap_expunge</function>함수나 + CL_EXPUNGE 옵션을 갖는 <function>imap_close</function> 함수가 +불려지기 + 전까지는 삭제되지 않는다. </para> <para> <example> @@ -437,7 +438,7 @@ <refentry id="function.imap-deletemailbox"> <refnamediv> <refname>imap_deletemailbox</refname> - <refpurpose>Delete a mailbox</refpurpose> + <refpurpose>메일 박스를 지운다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -449,12 +450,12 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_deletemailbox</function> deletes the specified - mailbox (see <function>imap_open</function> for the format - of <parameter>mbox</parameter> names). + <function>imap_deletemailbox</function>함수는 특정 메일 박스를 + 지운다 (<parameter>mbox</parameter> 이름의 형식을 알려면 + <function>imap_open</function>함수를 보시오). </para> <para> - Returns true on success and false on error. + 성공하면 true를 실패하면 false를 리턴한다. </para> <para> See also <function>imap_createmailbox</function>, @@ -468,7 +469,7 @@ <refentry id="function.imap-expunge"> <refnamediv> <refname>imap_expunge</refname> - <refpurpose>Delete all messages marked for deletion</refpurpose> + <refpurpose>지움 표시된 모든 메시지를 완전히 +삭제한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -479,10 +480,10 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_expunge</function> deletes all the messages marked - for deletion by <function>imap_delete</function>, - <function>imap_mail_move</function>, or - <function>imap_setflag_full</function>. + <function>imap_expunge</function>함수는 <function>imap_delete</function>, + <function>imap_mail_move</function> 또는 + <function>imap_setflag_full</function>함수에 의해 지움 표시된 모든 + 메시지를 완전히 삭제한다. </para> <para> Returns true. @@ -494,7 +495,7 @@ <refnamediv> <refname>imap_fetchbody</refname> <refpurpose> - Fetch a particular section of the body of the message + 메시지의 본문중에서 특정 부분을 페치한다 </refpurpose> </refnamediv> <refsect1> @@ -511,15 +512,16 @@ </funcprototype> </funcsynopsis> <para> - This function causes a fetch of a particular section of the body - of the specified messages as a text string and returns that text - string. The section specification is a string of integers - delimited by period which index into a body part list as per the - IMAP4 specification. Body parts are not decoded by this function. + 이 함수는 지정된 메시지의 본문중에서 특정 섹션을 텍스트 +문자열로 페치하고, + 그 텍스트 문자열을 가져온다. + 섹션의 요구사양(specification)은 IMAP 4 요구사양(specification)대로 + 바디 부분(body part) 목록의 색인으로 구분되는 + 단락의 정수(integer)문자열이다. + 본문 각 부분들은 이 함수에 의해 디코딩되지 않는다. </para> <para> - The options for <function>imap_fetchbody</function> is a bitmask - with one or more of the following: + <function>imap_fetchbody</function>함수에 대한 옵션은 다음 리스트의 + 하나 이상의 비트 마스크(bitmask)값이다: <itemizedlist> <listitem> <simpara> @@ -546,7 +548,7 @@ <refnamediv> <refname>imap_fetchstructure</refname> <refpurpose> - Read the structure of a particular message + 특별한 메시지의 구조체를 읽어온다 </refpurpose> </refnamediv> <refsect1> @@ -564,19 +566,18 @@ </funcprototype> </funcsynopsis> <para> - This function fetches all the structured information for a given - message. The optional <parameter>flags</parameter> parameter only - has a single option, <parameter>FT_UID</parameter>, which tells - the function to treat the <parameter>msg_number</parameter> - argument as a <parameter>UID</parameter>. The returned object - includes the envelope, internal date, size, flags and body - structure along with a similar object for each mime - attachement. The structure of the returned objects is as follows: + 이 함수는 주어진 메시지의 구조화된 모든 정보를 페치한다. + 선택적 인수<parameter>flags</parameter>는 오직 하나의 옵션만 +있다. + 즉, <parameter>msg_number</parameter>를 <parameter>UID</parameter>로 + 취급할것인지 함수에게 알려주는 <parameter>FT_UID</parameter>의 +옵션만 있다. + 리턴된 객체는 envelope, internal date, size, flags와 각 +mime첨부파일과 + 비슷한 객체를 갖는 본문 구조체이다. + 리턴되는 객체의 구조는 다음과 같다: </para> <para> <table> <title> - Returned Objects for <function>imap_fetchstructure</function> + <function>imap_fetchstructure</function>에 의해 리턴되는 객체 </title> <tgroup cols="2"> <tbody> @@ -713,7 +714,7 @@ <refentry id="function.imap-headerinfo"> <refnamediv> <refname>imap_headerinfo</refname> - <refpurpose>Read the header of the message</refpurpose> + <refpurpose>메시지의 머릿글을 읽어온다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -732,7 +733,7 @@ </paramdef> </funcsynopsis> <para> - This function returns an object of various header elements. + 이 함수는 다양한 머릿글 구성요소의 객체를 가져온다. </para> <para> <informalexample> @@ -856,7 +857,7 @@ <refentry id="function.imap-rfc822-parse-headers"> <refnamediv> <refname>imap_rfc822_parse_headers</refname> - <refpurpose>Parse mail headers from a string</refpurpose> + <refpurpose>문자열에서 메일 헤더를 해석한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -870,9 +871,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns an object of various header elements, - similar to <function>imap_header</function>, except without the - flags and other elements that come from the IMAP server. + 이함수는 다양한 헤더 구성요소의 객체를 돌려준다. + <function>imap_header</function>함수와 비슷하지만, + flags 인수를 갖지 않는 것이 다르다. </para> </refsect1> </refentry> @@ -881,7 +882,7 @@ <refnamediv> <refname>imap_headers</refname> <refpurpose> - Returns headers for all messages in a mailbox + 메일박스에서 모든 메시지의 헤더를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -895,6 +896,8 @@ <para> Returns an array of string formatted with header info. One element per mail message. + 헤더 정보를 갖는 형식화된 문자열의 배열을 돌려준다. + 각 메일 메시지당 하나의 배열요소를 갖는다. </para> </refsect1> </refentry> @@ -902,7 +905,7 @@ <refentry id="function.imap-listmailbox"> <refnamediv> <refname>imap_listmailbox</refname> - <refpurpose>Read the list of mailboxes</refpurpose> + <refpurpose>메일박스의 목록을 읽어온다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -918,6 +921,10 @@ Returns an array containing the names of the mailboxes. See <function>imap_getmailboxes</function> for a description of <parameter>ref</parameter> and <parameter>pattern</parameter>. + 메일박스의 이름을 포함한 배열을 돌려준다. + 더 자세한 것은 + <parameter>ref</parameter>과 <parameter>pattern</parameter>의 + <function>imap_getmailboxes</function>를 보라 </para> <para> <example> @@ -945,8 +952,7 @@ <refnamediv> <refname>imap_getmailboxes</refname> <refpurpose> - Read the list of mailboxes, returning detailed information on - each one + 메일박스의 목록을 읽어오고, 각 메일박스에 대한 상세한 +정보를 돌려준다. </refpurpose> </refnamediv> <refsect1> @@ -960,13 +966,13 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of objects containing mailbox information. Each - object has the attributes <parameter>name</parameter>, specifying - the full name of the mailbox; <parameter>delimiter</parameter>, - which is the hierarchy delimiter for the part of the hierarchy - this mailbox is in; and - <parameter>attributes</parameter>. <parameter>Attributes</parameter> - is a bitmask that can be tested against: + 메일박스 정보를 포함하는 객체의 배열을 돌려준다. 각 +객체는 + 다음 속성을 갖는다. + 메일박스의 완전한 이름을 갖는 <parameter>name</parameter>속성; + 메일 박스안에 포함된 분류체계(hierarchy)의 부분을 위한 + 분류체계 한정자(hirerarchy delimiter) +<parameter>delimiter</parameter>속성; + 그리고 <parameter>attributes</parameter>. <parameter>Attributes</parameter> + 속성은 다음에 대해서 테스트될 수 있는 +비트마스크(bitmask)값이다: <itemizedlist> <listitem> <simpara> @@ -994,27 +1000,27 @@ </itemizedlist> </para> <para> - Mailbox names containing international Characters outside the - printable ASCII range will be encoded and may be decoded by - <function>imap_utf7_decode</function>. - </para> - <para> - <parameter>ref</parameter> should normally be just the server - specification as described in <function>imap_open</function>, and - <parameter>pattern</parameter> specifies where in the mailbox - hierarchy to start searching. If you want all mailboxes, pass - '*' for <parameter>pattern</parameter>. - </para> - <para> - There are two special characters you can pass as part of the - <parameter>pattern</parameter>: '*' and '%'. '*' means to return - all mailboxes. If you pass <parameter>pattern</parameter> as '*', - you will get a list of the entire mailbox hierarchy. '%' means to - return the current level only. '%' as the - <parameter>pattern</parameter> parameter will return only the top - level mailboxes; '~/mail/%' on UW_IMAPD will return every mailbox - in the ~/mail directory, but none in subfolders of that - directory. + 메일 박스 이름이 출력가능한 아스키(ASCII)코드 범위 밖의 + 국제적인 문자를 포함한다면 인코딩해야 할것이고, + <function>imap_utf7_decode</function>함수로 디코딩해야 할것이다. + </para> + <para> + <parameter>ref</parameter>인수는 <function>imap_open</function>함수 + 에서와 같이 서버의 사양이면 된다.그리고 +<parameter>pattern</parameter> + 인수는 검색을 시작할 메일 박스의 위치이다. + 모든 메일 박스에 적용시키려면 +<parameter>pattern</parameter>인수에 + '*'라고 하면 된다. + </para> + <para> + <parameter>pattern</parameter>인수로 쓸 수 있는 두개의 특별한 + 문자들이 있다 : '*' 과 '%'문자이다. + '*'은 모든 메일박스를 돌려줌을 의미한다. + <parameter>pattern</parameter>인수에 '*'를 쓰면 모든 메일 박스 + 체계(hierarchy) + 의 목록을 얻을 수 있다. '%'는 현재 레벨만을 돌려준다는 걸 +의미한다. + <parameter>pattern</parameter>인수에 '%'를 쓰면 최상위 레벨의 +메일박스 + 만을 돌려줄 것이다; UW_IMAPD에 관해 '~/mail/%'을 쓰면 ~/mail +디렉토리의 + 모든 메일 박스를 돌려주지만, 하위디렉토리는 포함되지 +않는다. </para> <para> <example> @@ -1049,7 +1055,7 @@ <refentry id="function.imap-listsubscribed"> <refnamediv> <refname>imap_listsubscribed</refname> - <refpurpose>List all the subscribed mailboxes</refpurpose> + <refpurpose>subscribed된 모든 메일박스의 목록을 +보여준다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1062,10 +1068,9 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of all the mailboxes that you have - subscribed. This is almost identical to - <function>imap_listmailbox</function>, but will only return - mailboxes the user you logged in as has subscribed. + subscribed된 모든 메일박스의 배열을 돌려준다. 이함수는 거의 + <function>imap_listmailbox</function>함수와 동일하다. + 단지 로그인 한 유저가 subscribed한 메일박스만 돌려줄 뿐이다. </para> </refsect1> </refentry> @@ -1073,7 +1078,7 @@ <refentry id="function.imap-getsubscribed"> <refnamediv> <refname>imap_getsubscribed</refname> - <refpurpose>List all the subscribed mailboxes</refpurpose> + <refpurpose>subscribed된 모든 메일 박스의 목록을 +보여준다.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1086,9 +1091,8 @@ </funcprototype> </funcsynopsis> <para> - This function is identical to - <function>imap_getmailboxes</function>, except that it only - returns mailboxes that the user is subscribed to. + <function>imap_getmailboxes</function>함수와 동일하다. + 단 유저가 subscribed한 메일박스만 돌려줄 뿐이다. </para> </refsect1> </refentry> @@ -1096,7 +1100,7 @@ <refentry id="function.imap-mail-copy"> <refnamediv> <refname>imap_mail_copy</refname> - <refpurpose>Copy specified messages to a mailbox</refpurpose> + <refpurpose>메일박스에 특정 메시지를 복사한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1112,16 +1116,16 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error. + 성공하면 true를 에러가 발생하면 false를 돌려준다. </para> <para> - Copies mail messages specified by <parameter>msglist</parameter> - to specified mailbox. <parameter>msglist</parameter> is a range - not just message numbers (as described in - <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). + <parameter>msglist</parameter>인수에 의해 지정된 메일 메시지를 + 특정 메일 박스에 복사한다.<parameter>msglist</parameter>인수는 + 메시지 번호만이 아니라 범위도 된다 + (<ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>문서에 기술 +되어있다). </para> <para> - Flags is a bitmask of one or more of + Flags인수는 다음 옵션들의 비트 마스트(bitmask)값이다. <itemizedlist> <listitem> <simpara> @@ -1142,7 +1146,7 @@ <refentry id="function.imap-mail-move"> <refnamediv> <refname>imap_mail_move</refname> - <refpurpose>Move specified messages to a mailbox</refpurpose> + <refpurpose>메일박스에 특정 메시지를 이동시킨다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1158,13 +1162,13 @@ </funcprototype> </funcsynopsis> <para> - Moves mail messages specified by <parameter>msglist</parameter> - to specified mailbox. <parameter>msglist</parameter> is a range - not just message numbers (as described in - <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). + <parameter>msglist</parameter>인수에 의해 지정된 메일 메시지를 + 특정 메일 박스에 이동시킨다.<parameter>msglist</parameter>인수는 + 메시지 번호만이 아니라 범위도 된다 + (<ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>문서에 기술 +되어있다). </para> <para> - Flags is a bitmask and may contain the single option + Flags인수는 비트마스크(bitmask)값이고 오직 하나의 옵션만을 +갖는다 <itemizedlist> <listitem> <simpara> @@ -1174,7 +1178,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + 성공하면 true를 에러가 발생하면 false를 리턴한다. </para> </refsect1> </refentry> @@ -1183,7 +1187,7 @@ <refnamediv> <refname>imap_num_msg</refname> <refpurpose> - Gives the number of messages in the current mailbox + 현재 메일박스의 메시지 갯수를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -1195,7 +1199,7 @@ </funcprototype> </funcsynopsis> <para> - Return the number of messages in the current mailbox. + 현재 메일박스의 메시지 갯수를 돌려준다. </para> </refsect1> </refentry> @@ -1203,8 +1207,7 @@ <refentry id="function.imap-num-recent"> <refnamediv> <refname>imap_num_recent</refname> - <refpurpose>Gives the number of recent messages in current - mailbox</refpurpose> + <refpurpose>현재 메일박스의 새로운 메시지 갯수를 +돌려준다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1215,7 +1218,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the number of recent messages in the current mailbox. + 현재 메일박스의 새로운 메시지 갯수를 돌려준다. </para> </refsect1> </refentry> @@ -1224,6 +1227,7 @@ <refnamediv> <refname>imap_open</refname> <refpurpose>Open an IMAP stream to a mailbox</refpurpose> + <refpurpose>메일박스에 IMAP 스트림(stream)을 연다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1239,24 +1243,21 @@ </funcprototype> </funcsynopsis> <para> - Returns an IMAP stream on success and false on error. This - function can also be used to open streams to POP3 and NNTP - servers, but some functions and features are not available - on IMAP servers. - </para> - <para> - A mailbox name consists of a server part and a mailbox path on - this server. The special name INBOX stands for the current users - personal mailbox. The server part, which is enclosed in '{' and - '}', consists of the servers name or ip address, a protocol - secification (beginning with '/') and an optional port specifier - beginnung with ':'. The server part is mandatory in all mailbox - parameters. Mailbox names that contain international characters - besides those in the printable ASCII space have to be encoded - with <function>imap_utf7_encode</function>. + 성공하면 IMAP 스트림(stream)을 돌려주고 에러가 발생하면 +false를 넘겨준다. + 이 함수는 POP3나 NNTP서버의 스트림(stream)을 열 때에도 +사용된다. + 하지만 어떤 함수나 특성은 IMAP 서버에 적용되지 않는다. </para> <para> - The options are a bit mask with one or more of the following: + 메일박스의 이름은 서버와 관련한 서버 부분과 메일박스 +경로로 구성된다. + 특별한 이름을 갖는 INBOX는 현재 유저의 개인 메일박스이다. + 서버 부분은 '{'과 '}'로 둘려싸여지고, 서버의 이름이나 ip +주소, 프로토콜 + 사양('/'로 시작하는곳) 그리고 ':'로 시작하는 선택적인 +포트로 구성된다. + 서버 부분은 모든 메일박스의 필수 인수이다. 메일박스 +이름이 출력가능한 + 아스키(ASCII)범위를 벗어난 국제적인 문자를 포함하면 + <function>imap_utf7_encode</function>함수로 인코딩되어야 한다. + </para> + <para> + 옵션은 다음을 한개이상 포함하는 비트마스크(bit mask)값이다. <itemizedlist> <listitem> <simpara> @@ -1283,27 +1284,29 @@ </itemizedlist> </para> <para> - To connect to an IMAP server running on port 143 on the - local machine, do the following: + 로컬 머신의 143포트에서 서비스되고 있는 IMAP서버에 +접속하려면, + 다음과 같이 하시오: <informalexample> <programlisting role="php"> $mbox = imap_open ("{localhost:143}INBOX", "user_id", "password"); </programlisting> </informalexample> - To connect to a POP3 server on port 110 on the local server, use: + 로컬 머신의 110포트에서 서비스되고 있는 POP3서버에 +접속하려면, + 다음과 같이 하시오: <informalexample> <programlisting role="php"> $mbox = imap_open ("{localhost/pop3:110}INBOX", "user_id", "password"); </programlisting> </informalexample> - To connect to an NNTP server on port 119 on the local server, use: + 로컬 머신의 119포트에서 서비스되고 있는 NNTP서버에 +접속하려면, + 다음과 같이 하시오: <informalexample> <programlisting role="php"> $nntp = imap_open ("{localhost/nntp:119}comp.test", "", ""); </programlisting> </informalexample> - To connect to a remote server replace "localhost" with the name - or the IP address of the server you want to connect to. + 원격 서버에 접속하려면 "localhost"대신에 접속할 +원격의서버의 서버이름 + 또는 아이피 주소를 쓰시오. </para> <para> <example> @@ -1343,7 +1346,7 @@ <refentry id="function.imap-ping"> <refnamediv> <refname>imap_ping</refname> - <refpurpose>Check if the IMAP stream is still active</refpurpose> + <refpurpose>IMAP 스트림(stream)이 아직 사용가능한지 +체크한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1355,14 +1358,16 @@ </funcsynopsis> <para> Returns true if the stream is still alive, false otherwise. + 스트림(stream)이 아직 살아있다면 true를 리턴하고, 그외에는 +false를 리턴한다 </para> <para> - <function>imap_ping</function> function pings the stream to see - it is still active. It may discover new mail; this is the - preferred method for a periodic "new mail check" as well as a - "keep alive" for servers which have inactivity timeout. - (As PHP scripts do not tend to run that long, i can hardly - imagine that this function will be usefull to anyone.) + <function>imap_ping</function>함수는 스트림(stream)이 아직 +사용가능한지 + 보기 위해 스트림에 핑(ping)을 한다. 이 함수는 새로운 +메일을 발견한다; + 이 함수는 주기적인 "새로운 메일 점검"은 물론 +타임아웃(timeout)을 + 갖는 서버에게 "접속 유지"를 위한 방법으로 선호된다. + ( PHP 스크립트는 오랜 시간동안 실행되지 않기 때문에, 나는 + 이 함수가 거의 유용하지 않을 것이라고 생각한다. ) + </para> </refsect1> </refentry> @@ -1370,7 +1375,7 @@ <refentry id="function.imap-renamemailbox"> <refnamediv> <refname>imap_renamemailbox</refname> - <refpurpose>Rename an old mailbox to new mailbox</refpurpose> + <refpurpose>메일박스의 이름을 바꾼다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1383,18 +1388,17 @@ </funcprototype> </funcsynopsis> <para> - This function renames on old mailbox to new mailbox (see - <function>imap_open</function> for the format of - <parameter>mbox</parameter> names). + 이 함수는 메일박스의 이름을 +바꾼다(<parameter>mbox</parameter>이름의 + 형식은 <function>imap_open</function>함수를 보면 알수 있다) </para> <para> - Returns true on success and false on error. + 성공하면 true를 리턴하고 에러가 발생하면 false를 리턴한다. </para> <para> - See also <function>imap_createmailbox</function>, - <function>imap_deletemailbox</function>, and - <function>imap_open</function> for the format of - <parameter>mbox</parameter>. + <parameter>mbox</parameter>형식에 대해서는 또한 + <function>imap_createmailbox</function>함수, + <function>imap_deletemailbox</function>함수, 그리고 + <function>imap_open</function>함수를 보시오. </para> </refsect1> </refentry> @@ -1402,7 +1406,7 @@ <refentry id="function.imap-reopen"> <refnamediv> <refname>imap_reopen</refname> - <refpurpose>Reopen IMAP stream to new mailbox</refpurpose> + <refpurpose>새로운 메일박스에 IMAP 스트림(stream)을 다시 +연다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1417,11 +1421,11 @@ </funcprototype> </funcsynopsis> <para> - This function reopens the specified stream to a new mailbox on - an IMAP or NNTP server. + 이 함수는 IMAP 또는 NNTP 서버에서 새로운 메일박스에 특정 +스트림(stream)을 + 다시 연다. </para> <para> - The options are a bit mask with one or more of the following: + 옵션은 다음의 한개 이상의 비트마스트(bit mask)값이다: <itemizedlist> <listitem> <simpara> @@ -1450,7 +1454,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + 성공하면 true를 리턴하고 에러가 발생하면 false를 리턴한다. </para> </refsect1> </refentry> @@ -1458,7 +1462,7 @@ <refentry id="function.imap-subscribe"> <refnamediv> <refname>imap_subscribe</refname> - <refpurpose>Subscribe to a mailbox</refpurpose> + <refpurpose>메일 박스에 Subscribe한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1470,10 +1474,10 @@ </funcprototype> </funcsynopsis> <para> - Subscribe to a new mailbox. + 새로운 메일박스를 Subscribe한다. </para> <para> - Returns true on success and false on error. + 성공하면 true를 리턴하고 에러가 발생하면 false를 리턴한다. </para> </refsect1> </refentry> @@ -1482,7 +1486,7 @@ <refnamediv> <refname>imap_undelete</refname> <refpurpose> - Unmark the message which is marked deleted + 지움 표시된 메시지의 지움 표시를 제거한다 </refpurpose> </refnamediv> <refsect1> @@ -1495,12 +1499,12 @@ </funcprototype> </funcsynopsis> <para> - This function removes the deletion flag for a specified message, - which is set by <function>imap_delete</function> or - <function>imap_mail_move</function>. + 이함수는 특정 메시지의 지움 플래그(deletion flag)를 제거한다. + 여기서 특정 메시지는 <function>imap_delete</function>함수나 + <function>imap_mail_move</function>함수에 의해서 지움 표시된 +메시지이다. </para> <para> - Returns true on success and false on error. + 성공하면 true를 리턴하고 에러가 발생하면 false를 리턴한다. </para> </refsect1> </refentry> @@ -1508,7 +1512,7 @@ <refentry id="function.imap-unsubscribe"> <refnamediv> <refname>imap_unsubscribe</refname> - <refpurpose>Unsubscribe from a mailbox</refpurpose> + <refpurpose>메일박스를 Unsubscribe한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1520,10 +1524,10 @@ </funcprototype> </funcsynopsis> <para> - Unsubscribe from a specified mailbox. + 특정 메일박스에서 Unsubscribe한다. </para> <para> - Returns true on success and false on error. + 성공하면 true를 리턴하고 에러가 발생하면 false를 리턴한다. </para> </refsect1> </refentry> @@ -1531,8 +1535,7 @@ <refentry id="function.imap-qprint"> <refnamediv> <refname>imap_qprint</refname> - <refpurpose>Convert a quoted-printable string to an 8 bit - string</refpurpose> + <refpurpose>quoted-printable 문자열을 8비트 문자열로 +변환한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1543,15 +1546,14 @@ </funcprototype> </funcsynopsis> <para> - Convert a quoted-printable string to an 8 bit string (according - to <ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section - 6.7). + quoted-printable 문자열을 8비트 문자열로 변환한다 . + (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7에 따라) </para> <para> - Returns an 8 bit (binary) string. + 8비트(binary) 문자열을 돌려준다. </para> <para> - See also <function>imap_8bit</function>. + <function>imap_8bit</function>함수도 보시오. </para> </refsect1> </refentry> @@ -1560,7 +1562,7 @@ <refnamediv> <refname>imap_8bit</refname> <refpurpose> - Convert an 8bit string to a quoted-printable string + 8비트 문자열을 quoted-printable 문자열로 변환한다 </refpurpose> </refnamediv> <refsect1> @@ -1572,15 +1574,14 @@ </funcprototype> </funcsynopsis> <para> - Convert an 8bit string to a quoted-printable string (according to - <ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section - 6.7). + 8비트 문자열을 quoted-printable 문자열로 변환한다. + (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section 6.7에 따라) </para> <para> - Returns a quoted-printable string. + quoted-printable 문자열을 돌려준다. </para> <para> - See also <function>imap_qprint</function>. + <function>imap_qprint</function>함수도 보시오. </para> </refsect1> </refentry> @@ -1589,7 +1590,7 @@ <refnamediv> <refname>imap_binary</refname> <refpurpose> - Convert an 8bit string to a base64 string + 8비트 문자열을 base64문자열로 변환한다 </refpurpose> </refnamediv> <refsect1> @@ -1601,14 +1602,14 @@ </funcprototype> </funcsynopsis> <para> - Convert an 8bit string to a base64 string (according to <ulink - url="&url.rfc;rfc2045.html">RFC2045</ulink>, Section 6.8). + 8비트 문자열을 base64문자열로 변환한다. + (<ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, Section 6.8에 따라) </para> <para> - Returns a base64 string. + base64 문자열을 돌려준다. </para> <para> - See also <function>imap_base64</function>. + <function>imap_base64</function>도 보시오. </para> </refsect1> </refentry> @@ -1617,8 +1618,7 @@ <refnamediv> <refname>imap_scanmailbox</refname> <refpurpose> - Read the list of mailboxes, takes a string to search for in the - text of the mailbox + 메일박스의 텍스트중에서 검색 문자열을 갖는 메일박스의 +목록을 읽어 온다 </refpurpose> </refnamediv> <refsect1> @@ -1633,13 +1633,11 @@ </funcprototype> </funcsynopsis> <para> - Returns an array containing the names of the mailboxes that have - <parameter>string</parameter> in the text of the mailbox. - This function is similar to <function>imap_listmailbox</function>, - but it will additionally check for the presence of the string - <parameter>content</parameter> inside the mailbox data. - See <function>imap_getmailboxes</function> for a description - of <parameter>ref</parameter> and <parameter>pattern</parameter>. + 메일박스의 텍스트중에서 <parameter>string</parameter>의 문자열을 + 갖는 메일박스 이름을 포함하는 배열을 돌려준다. + 이함수는 <function>imap_listmailbox</function>함수와 유사하다, + 단지 메일박스 데이터중에서 <parameter>content</parameter>문자열의 + 존재를 체크하는 것만 추가되었다. </para> </refsect1> </refentry> @@ -1647,7 +1645,7 @@ <refentry id="function.imap-mailboxmsginfo"> <refnamediv> <refname>imap_mailboxmsginfo</refname> - <refpurpose>Get information about the current mailbox</refpurpose> + <refpurpose>현재 메일박스에 관한 정보를 가져온다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1658,16 +1656,14 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on - failure. + 현재 메일박스에 관한 정보를 돌려준다. 실패하면 FALSE를 +리턴한다. </para> <para> - The <function>imap_mailboxmsginfo</function> function checks the - current mailbox status on the server. It is similar to - <function>imap_status</function>, but will additionally sum up the - size of all messages in the mailbox, which will take some additional - time to execute. It returns the information - in an object with following properties. + <function>imap_mailboxmsginfo</function>함수는 서버에서 현재 +메일박스의 + 상태를 점검한다. 이 함수는 <function>imap_status</function>함수와 +유사하다. + 단지 메일박스안의 모든 메시지 사이즈의 총량을 내는 것이 +추가되었다. + 이것은 곧 총량을 내기위해 실행할 추가적인 시간이 +걸린다는 것을 의미한다. + 다음 속성을 갖는 객체로 정보를 돌려준다. </para> <para> <table> @@ -1747,8 +1743,7 @@ <refnamediv> <refname>imap_rfc822_write_address</refname> <refpurpose> - Returns a properly formatted email address given the mailbox, - host, and personal info. + 주어진 메일박스, 호스트, 개인 정보로 적절히 형식화된 +이메일 주소를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -1764,9 +1759,9 @@ </funcprototype> </funcsynopsis> <para> - Returns a properly formatted email address as defined in - <ulink url="&url.rfc;rfc822.html">RFC822</ulink> - given the mailbox, host, and personal info. + <ulink url="&url.rfc;rfc822.html">RFC822</ulink>문서에 정의된대로 + 주어진 메일박스, 호스트, 개인 정보로 적절하게 형식화된 +이메일 주소를 + 돌려준다. </para> <para> <example> @@ -1782,7 +1777,7 @@ <refentry id="function.imap-rfc822-parse-adrlist"> <refnamediv> <refname>imap_rfc822_parse_adrlist</refname> - <refpurpose>Parses an address string</refpurpose> + <refpurpose>주소 문자열을 해석한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1796,10 +1791,9 @@ </funcprototype> </funcsynopsis> <para> - This function parses the address string as defined in - <ulink url="&url.rfc;rfc822.html">RFC822</ulink> and - for each address, returns an array of objects. - The objects properties are: + 이 함수는 <ulink url="&url.rfc;rfc822.html">RFC822</ulink>문서에 +정의된대로 + 각 주소에 대해 주소 문자열을 해석하고 객체의 문자열을 +돌려준다. + 객체의 속성은 다음과 같다: </para> <para> <itemizedlist> @@ -1849,7 +1843,7 @@ <refentry id="function.imap-setflag-full"> <refnamediv> <refname>imap_setflag_full</refname> - <refpurpose>Sets flags on messages</refpurpose> + <refpurpose>메시지에서 플래그(flags)를 셋(set)한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1863,16 +1857,16 @@ </funcprototype> </funcsynopsis> <para> - This function causes a store to add the specified flag to the - flags set for the messages in the specified sequence. + 이 함수는 지정된 일련번호의 메시지에서 지정된 +플래그(flag)에 + 플래그 셋(flags set)을 추가한다. </para> <para> - The flags which you can set are "\\Seen", "\\Answered", - "\\Flagged", "\\Deleted", "\\Draft", and "\\Recent" (as defined - by RFC2060). + 셋(set)할 수 있는 플래그(flags)는 "\\Seen", "\\Answered", + "\\Flagged", "\\Deleted", "\\Draft", 과 "\\Recent"이다. + (RFC2060 문서에 정의된대로) </para> <para> - The options are a bit mask with one or more of the following: + 옵션은 다음에서 한개 이상의 비트마스트(bit mask)값이다: <informalexample> <literallayout> ST_UID The sequence argument contains UIDs instead of @@ -1901,7 +1895,7 @@ <refentry id="function.imap-clearflag-full"> <refnamediv> <refname>imap_clearflag_full</refname> - <refpurpose>Clears flags on messages</refpurpose> + <refpurpose>메시지에서 플래그(flags)를 +클리어(clear)한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1919,12 +1913,14 @@ <para> This function causes a store to delete the specified flag to the flags set for the messages in the specified sequence. - The flags which you can unset are "\\Seen", "\\Answered", - "\\Flagged", "\\Deleted", "\\Draft", and "\\Recent" (as defined - by RFC2060). + 이 함수는 지정된 일련번호의 메시지에서 지정된 +플래그(flag)에 + 플래그 셋(flags set)을 제거한다. + 언셋(unset)할 수 있는 플래그(flags)는 "\\Seen", "\\Answered", + "\\Flagged", "\\Deleted", "\\Draft", 과 "\\Recent"이다. + (RFC2060 문서에 정의된대로) </para> <para> - The options are a bit mask with one or more of the following: + 옵션은 다음의 한개 이상의 비트마스크(bit mask) 값이다: <informalexample> <literallayout> ST_UID The sequence argument contains UIDs instead of @@ -1938,7 +1934,7 @@ <refentry id="function.imap-sort"> <refnamediv> <refname>imap_sort</refname> - <refpurpose>Sort an array of message headers</refpurpose> + <refpurpose>메시지 헤더의 배열을 정렬한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1952,14 +1948,14 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of message numbers sorted by the given - parameters. + 주어진 인수로 정렬된 메시지 번호의 배열을 돌려준다. </para> <para> - <parameter>Reverse</parameter> is 1 for reverse-sorting. + <parameter>Reverse</parameter>인수는 역정렬(reverse-sorting)하기 +위해서는 + 1의 값을 갖는다. </para> <para> - Criteria can be one (and only one) of the following: + 기준(Criteria)은 다음중 하나(오직 하나)가 될 수 있다: <informalexample> <literallayout> SORTDATE message Date @@ -1973,7 +1969,7 @@ </informalexample> </para> <para> - The flags are a bitmask of one or more of the following: + 플래그(flags)는 다음중 하나이상의 비트마스크(bitmask)값이다: <informalexample> <literallayout> SE_UID Return UIDs instead of sequence numbers @@ -1987,7 +1983,7 @@ <refentry id="function.imap-fetchheader"> <refnamediv> <refname>imap_fetchheader</refname> - <refpurpose>Returns header for a message</refpurpose> + <refpurpose>메시지에서 헤더를 돌려준다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2000,13 +1996,12 @@ </funcprototype> </funcsynopsis> <para> - This function causes a fetch of the complete, unfiltered - <ulink url="&url.rfc;rfc822.html">RFC822</ulink> - format header of the specified message as a text string and - returns that text string. + 이 함수는 지정된 메시지에서 전체의(complete), +필터링되지않은(unfiltered) + <ulink url="&url.rfc;rfc822.html">RFC822</ulink>형식의 헤더를 + 텍스트 문자열로 페치하고, 그 텍스트 문자열을 돌려준다. </para> <para> - The options are: + 옵션은 다음과 같다: <informalexample> <literallayout> FT_UID The msgno argument is a UID @@ -2028,8 +2023,7 @@ <refnamediv> <refname>imap_uid</refname> <refpurpose> - This function returns the UID for the given message sequence - number + 이 함수는 주어진 메시지의 일련번호(sequence number)에 대한 +UID를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2042,11 +2036,10 @@ </funcprototype> </funcsynopsis> <para> - This function returns the UID for the given message sequence - number. An UID is an unique identifier that will not change over - time while a message sequence number may change whenever the - content of the mailbox changes. This function is the inverse of - <function>imap_msgno</function>. + 이 함수는 주어진 메시지 일련번호(sequence number)에 대한 UID를 +돌려준다. + UID는 메일박스의 내용이 변화될 때마다 바뀌는 메시지 +일련번호에 반하여 + 시간에 따라 바뀌지 않는 유일한 구별값(identifier)이다. + 이 함수는 <function>imap_msgno</function>함수의 반대이다. </para> </refsect1> </refentry> @@ -2056,8 +2049,7 @@ <refnamediv> <refname>imap_msgno</refname> <refpurpose> - This function returns the message sequence number for the given - UID + 이 함수는 주어진 UID값에 대해 메시지 일련번호(sequence +number)을 넘겨준다 </refpurpose> </refnamediv> <refsect1> @@ -2070,8 +2062,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns the message sequence number for the given - UID. It is the inverse of <function>imap_uid</function>. + 이 함수는 주어진 UID값에 대해 메시지 일련번호(sequence +number)을 넘겨준다 + <function>imap_uid</function>함수의 반대이다. </para> </refsect1> </refentry> @@ -2080,8 +2072,7 @@ <refnamediv> <refname>imap_search</refname> <refpurpose> - This function returns an array of messages matching the given - search criteria + 이 함수는 주어진 검색 기준(criteria)에 부합되는 메시지의 +배열을 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2095,11 +2086,11 @@ </funcprototype> </funcsynopsis> <para> - This function performs a search on the mailbox currently opened - in the given imap stream. <parameter>criteria</parameter> is a - string, delimited by spaces, in which the following keywords are - allowed. Any multi-word arguments (eg. FROM "joey smith") must be - quoted. + 이 함수는 주어진 imap 스트림(stream)안의 현재 열려있는 +메일박스에서 + 검색을 수행한다. <parameter>criteria</parameter>인수는 문자열이다. + 공백(spaces)에 의해 구별(delimited)되고,아래의 +키워드(keywords)가 허용된다. + 두 단어 이상의 변수(arguments) (예를 들면, FROM "joey smith" )는 + 따옴표(quoted) 처리해야 한다. <itemizedlist> <listitem> <simpara> @@ -2226,15 +2217,16 @@ </itemizedlist> </para> <para> - For example, to match all unanswered messages sent by Mom, you'd - use: "UNANSWERED FROM mom". Searches appear to be case - insensitive. This list of criteria is from a reading of the UW - c-client source code and may be uncomplete or - inaccurate (see also RFC2060, section 6.4.4). + 예를 들어 Mom으로 부터 받은 아직 읽지 않은 모든 메시지를 +검색하려면, + 다음과 같이 하면 된다: "UNANSWERED FROM mom". 검색은 대소문자 +구별을 + 하지 않는 것처럼 보인다. 검색기준의 목록은 UW c-client source +code에 + 달려있어서 불완전하거나 부정확할 수 있다. + (RFC2060, section 6.4.4 도 보시라). </para> <para> - Valid values for flags are SE_UID, which causes the returned - array to contain UIDs instead of messages sequence numbers. + 플래그(flags)에 대한 유효한 값은 SE_UID이다. + 이것은 메시지 일련번호(sequence number)대신에 UID를 포함하는 + 배열을 돌려준다. </para> </refsect1> </refentry> @@ -2243,8 +2235,8 @@ <refnamediv> <refname>imap_last_error</refname> <refpurpose> - This function returns the last IMAP error (if any) that occurred - during this page request + 이 함수는 현재 페이지 요구(page request) 동안에 발생한 + IMAP 에러(물론 있다면)의 가장 나중것을 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2256,11 +2248,10 @@ </funcprototype> </funcsynopsis> <para> - This function returns the full text of the last IMAP error - message that occurred on the current page. The error stack is - untouched; calling <function>imap_last_error</function> - subsequently, with no intervening errors, will return the same - error. + 이 함수는 현재 페이지에서 발생한 가장 나중의 IMAP 에러 +메시지를 + 텍스트로 돌려준다; 에러 스택(error stack)은 건들지 않는다; + 아무 에러도 없는데, <function>imap_last_error</function>함수를 + 이어서 부르면 같은 에러를 돌려줄것이다. </para> </refsect1> </refentry> @@ -2269,9 +2260,9 @@ <refnamediv> <refname>imap_errors</refname> <refpurpose> - This function returns all of the IMAP errors (if any) that have - occurred during this page request or since the error stack was - reset. + 이 함수는 현재 페이지 요구(page request)동안에, 또는 + 에러 스택(error stack)이 리셋(reset)된 이후에 발생한 + IMAP 에러(물론 있다면)를 모두 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2283,11 +2274,11 @@ </funcprototype> </funcsynopsis> <para> - This function returns an array of all of the IMAP error messages - generated since the last <function>imap_errors</function> call, - or the beginning of the page. When - <function>imap_errors</function> is called, the error stack is - subsequently cleared. + 이 함수는 가장 나중의 <function>imap_errors</function>함수의 호출 + 이후, 또는 페이지의 시작때부터 발생한 모든 IMAP 에러 +메시지들의 + 배열을 돌려준다. + <function>imap_errors</function>함수가 호출되면, 에러 스택(error +stack) + 은 즉시 클리어(clear)된다. </para> </refsect1> </refentry> @@ -2296,9 +2287,9 @@ <refnamediv> <refname>imap_alerts</refname> <refpurpose> - This function returns all IMAP alert messages (if any) that have - occurred during this page request or since the alert stack was - reset + 이 함수는 현재 페이지 요구(page request)동안이나,또는 + 경고 스택(alert stack)이 리셋(reset)된 이후에 발생한 +경고(alert)메시지 + (물론 있다면) 모두를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2310,12 +2301,12 @@ </funcprototype> </funcsynopsis> <para> - This function returns an array of all of the IMAP alert messages - generated since the last <function>imap_alerts</function> call, - or the beginning of the page. When - <function>imap_alerts</function> is called, the alert stack is - subsequently cleared. The IMAP specification requires that these - messages be passed to the user. + 이 함수는 가장 나중의 <function>imap_alerts</function>함수의 호출 + 이후, 또는 페이지의 시작때부터 발생한 모든 IMAP 경고 +메시지들의 + 배열을 돌려준다. + <function>imap_alerts</function>함수가 호출되면, 경고 스택(alert +stack) + 은 즉시 클리어(clear)된다. IMAP 사양에서는 이 메시지가 +유저에게 넘겨질것을 + 요구하는 바이다. </para> </refsect1> </refentry> @@ -2324,8 +2315,7 @@ <refnamediv> <refname>imap_status</refname> <refpurpose> - This function returns status information on a mailbox other than - the current one + 이 함수는 현재 메일박스 이외의 다른 메일 박스의 상태 +정보를 돌려준다 </refpurpose> </refnamediv> <refsect1> @@ -2339,8 +2329,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns an object containing status - information. Valid flags are: + 이 함수는 상태 정보를 포함하는 객체를 돌려준다. + 유효한 플래그(flags)는 다음과 같다: <itemizedlist> <listitem> <simpara> @@ -2411,7 +2401,7 @@ <refnamediv> <refname>imap_utf7_decode</refname> <refpurpose> - Decodes a modified UTF-7 encoded string. + modified UTF-7 인코딩된 문자열을 디코딩한다. </refpurpose> </refnamediv> <refsect1> @@ -2423,16 +2413,18 @@ </funcprototype> </funcsynopsis> <para> - Decodes modified UTF-7 <parameter>text</parameter> into 8bit data. + modified UTF-7형식의 <parameter>text</parameter>를 + 8비트 데이터로 디코딩한다. </para> <para> - Returns the decoded 8bit data, or false if the input string was - not valid modified UTF-7. This function is needed to decode - mailbox names that contain international characters outside of - the printable ASCII range. The modified UTF-7 encoding is defined - in <ulink url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section - 5.1.3 (original UTF-7 was defned in <ulink - url="&url.rfc;rfc1642.html">RFC1642</ulink>). + 디코딩된 8비트 데이터를 돌려주거나, + 입력 문자열이 유효한 modified UTF-7이 아니면 false를 돌려준다. + 이 함수는 출력가능한 아스키(ASCII)코드 범위를 벗어난 +국제적인 문자를 + 갖는 메일박스 이름을 디코딩할 때 필요하다. + modified UTF-7 인코딩은 <ulink + url="&url.rfc;rfc2060.html">RFC 2060</ulink> , section 5.1.3 문서에 + 정의되어 있다( original UTF-7 은 <ulink + url="&url.rfc;rfc1642.html">RFC1642</ulink>문서에 정의되어 있었다). </para> </refsect1> </refentry> @@ -2441,7 +2433,7 @@ <refnamediv> <refname>imap_utf7_encode</refname> <refpurpose> - Converts 8bit data to modified UTF-7 text. + 8비트 데이터를 UTF-7 텍스트로 변환한다. </refpurpose> </refnamediv> <refsect1> @@ -2453,16 +2445,17 @@ </funcprototype> </funcsynopsis> <para> - Converts 8bit <parameter>data</parameter> to modified UTF-7 - text. This is needed to encode mailbox names that contain - international characters outside of the printable ASCII - range. The modified UTF-7 encoding is defined in <ulink - url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section 5.1.3 - (original UTF-7 was defned in <ulink - url="&url.rfc;rfc1642.html">RFC1642</ulink>). + 8비트 <parameter>data</parameter>를 modified UTF-7텍스트로 + 변경한다. 이 함수는 출력가능한 아스키(ASCII)코드 범위를 +벗어난 + 국제적인 문자를 포함하는 메일박스 이름을 인코딩할 때 +필요하다. + modified UTF-7 인코딩은 <ulink + url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section 5.1.3문서에 + 정의되어 있다. + ( original UTF-7은 <ulink + url="&url.rfc;rfc1642.html">RFC1642</ulink> 문서에 정의되어 있다). </para> <para> - Returns the modified UTF-7 text. + modified UTF-7 텍스트를 돌려준다. </para> </refsect1> </refentry> @@ -2471,7 +2464,7 @@ <refnamediv> <refname>imap_utf8</refname> <refpurpose> - Converts text to UTF8 + 텍스트를 UTF8로 변환한다 </refpurpose> </refnamediv> <refsect1> @@ -2483,9 +2476,8 @@ </funcprototype> </funcsynopsis> <para> - Converts the given <parameter>text</parameter> to - UTF8 (as defined in - <ulink url="&url.rfc;rfc2044.html">RFC2044</ulink>). + 주어진 <parameter>text</parameter>값을 UTF8로 변환한다 + (<ulink url="&url.rfc;rfc2044.html">RFC2044</ulink>문서에 정의된대로). </para> </refsect1> </refentry> @@ -2494,7 +2486,7 @@ <refnamediv> <refname>imap_fetch_overview</refname> <refpurpose> - Read an overview of the information in the headers of the given message + 주어진 메시지 헤더의 전체 정보를 읽어 온다 </refpurpose> </refnamediv> <refsect1> @@ -2508,12 +2500,12 @@ </funcprototype> </funcsynopsis> <para> - This function fetches mail headers for the given - <parameter>sequence</parameter> and returns an overview of their - contents. <parameter>sequence</parameter> will contain a sequence - of message indices or UIDs, if <parameter>flags</parameter> - contains FT_UID. The returned value is an array of objects - describing one message header each: + 이 함수는 주어진 <parameter>sequence</parameter>일련번호에 대한 +헤더를 + 페치하고, 전체 정보를 돌려준다. +<parameter>sequence</parameter>값은 + <parameter>flags</parameter>가 FT_UID를 갖는다면 + UID나 메시지 인덱스(indices)의 일련번호(sequence)가 된다. + 돌려받는 값은 메시지 헤더의 각각을 서술하는 다음과 같은 +속성을 갖는 + 객체의 배열이다: <itemizedlist> <listitem> <simpara> @@ -2616,7 +2608,7 @@ <refentry id="function.imap-mime-header-decode"> <refnamediv> <refname>imap_mime_header_decode</refname> - <refpurpose>Decode MIME header elements</refpurpose> + <refpurpose>MIME 헤더 구성요소(element)를 디코딩한다</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2627,14 +2619,13 @@ </funcprototype> </funcsynopsis> <para> - <function>imap_mime_header_decode</function> function decodes - MIME message header extensions that are non ASCII text - (see <ulink url="&url.rfc;rfc2047.html">RFC2047</ulink>) - The decoded elements are returned in an array of objects, - where each object has two properties, "charset" & "text". - If the element hasn't been encoded, and in other words is in - plain US-ASCII,the "charset" property of that element is set to - "default". + <function>imap_mime_header_decode</function>함수는 ASCII 텍스트가 + 아닌 MIME 메시지 헤더 확장(MIME message header extensions)을 +디코드한다. + (<ulink url="&url.rfc;rfc2047.html">RFC2047</ulink>문서를 보라) + 디코딩된 구성요소(elements)를 객체의 배열로 돌려준다. + 이 객체는 두가지 속성을 갖는다, 즉 "charset" 과 "text" 이다. + 구성요소가 인코딩되지 않았다면, 즉 평범한(plain) +US-ASCII라면, + 그 구성요소의 "charset" 속성은 "default"값을 갖는다. </para> <para> <example> @@ -2663,7 +2654,7 @@ <refnamediv> <refname>imap_mail_compose</refname> <refpurpose> - Create a MIME message based on given envelope and body sections + 주어진 envelope와 body 섹션으로 구성된 MIME메시지를 만든다 </refpurpose> </refnamediv> <refsect1> @@ -2723,7 +2714,7 @@ <refnamediv> <refname>imap_mail</refname> <refpurpose> - Send an email message + 이메일 메시지를 보낸다 </refpurpose> </refnamediv> <refsect1> @@ -2749,7 +2740,7 @@ </funcprototype> </funcsynopsis> <para> - This function is currently only available in PHP 3. + 이 함수는 현재 PHP 3에서만 유효하다. </para> </refsect1> </refentry>