Onionmixer: GTKD 부록 E GError 타입 페이지 추가

2014-05-10T10:41:51Z

GTKD 부록 E GError 타입 페이지 추가

New page

;부록 E GError 타입

==GError 타입==

GLib은 오류 전파에 대해 GError라고 불리는 표준 방법을 제공한다. 이번 부록에서는 GTK+ 2.10 버전부터 제공되는 GError 도메인의 리스트와 함께 각 도메인에 해당하는 오류 타입을 소개하겠다.

GError 구조체는 세 가지 요소, 즉 오류 도메인, 메시지 문자열, 오류 코드를 제공한다.

<syntaxhighlight lang="c">
struct GError
{
GQuark domain;
gchar *message;
gint code;
};
</syntaxhighlight>

각 오류 도메인은 유사한 타입의 오류 집합을 나타낸다. 그 예제로 G_BOOKMARK_FILE_ERROR, GDK_PIXBUF_ERROR, G_FILE_ERROR를 들 수 있겠다. 이들은 항상 <NAMESPACE>_<MODULE>_ERROR 식으로 명명되는데, 네임스페이스는 함수를 포함하는 라이브러리이며 모듈은 위젯 또는 객체 타입을 나타낸다.

message는 사람이 읽을 수 있는 문자열로, 오류를 설명한다. 만일 발생한 오류 타입에 대해 사용자가 시각적 피드백을 기대할만한 상황이라면 개발자는 message를 출력해야 한다. 코드를 디버깅할 때도 매우 유용하게 사용된다.

오류 code는 도메인에서 발생한 오류에 특정적이다. 각 오류 코드는 도메인명 뒤에 오류 타입이 따라오는 형태로 구성된다. 가령, 오류 타입이 G_BOOKMARK_FILE_ERROR_INVALID_URI 라면 G_BOOKMARK_FILE_ERROR 도메인이 속하는 것이다.

대부분의 오류 코드 도메인에는 일반적인 실패 코드인 <NAMESPACE>_<MODULE>_ERROR_FAILED 도 포함되어 있다. 특정 오류를 이용할 수 없는 경우 이 코드가 리턴될 것이다.

표 E-1부터 E-14까지는 GTK+와 그것이 지원하는 라이브러리에서 발견되는 GError 열거의 참고자료를 모두 제공한다. 각 오류와 함께 무엇이 발생했는지에 대한 설명을 제공하겠다.

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_INVALID_URI||함수로 제공된 URI가 올바르게 포맷팅되지 않았다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_INVALID_VALUE||요청한 필드를 찾을 수 없다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED||요청한 애플리케이션이 북마크를 등록하지 않았다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND||함수로 제공된 요청 URI를 찾을 수 없다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_READ||문서가 올바로 포맷팅되지 않았다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING||파싱 중인 문서로 인해 알려지지 않은 인코딩이 실행되었다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_WRITE||북마크를쓰는 데 실패하였다. 특정한 유형의 쓰기 오류가 발생하였다.
|- style="vertical-align:top;"
|G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND||요청한 북마크 파일을 찾을 수 없다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-1. GBookmarkFileError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_CORRUPT_IMAGE||이미지 파일이 깨졌다.
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_INSUFFICIENT_MEMORY||이미지를 저장하기에 메모리가 충분하지 않다.
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_BAD_OPTION||올바르지 않은 옵션이 전달되었다. 이 오류는 이미지를 저장 시 발생할 수 있다.
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_UNKNOWN_TYPE||함수가 이미지 유형을 감지할 수 없다.
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION||이 함수는명시된 이미지에서 연산을 실행할 수 없다.
|- style="vertical-align:top;"
|GDK_PIXBUF_ERROR_FAILED||그 외 모든 오류에 대한 일반적 실패 코드다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-2. GdkPixbufError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_FILE_ERROR_EXIST||애플리케이션이 연산을 실행할 권한을 갖고 있지 않다.
|- style="vertical-align:top;"
|G_FILE_ERROR_ISDIR||파일이 디렉터리여서 쓰기용으로 열 수 없다.
|- style="vertical-align:top;"
|G_FILE_ERROR_ACCESS||파일 권한이 현재 연산을 허용하지 않는다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NAMETOOLONG||명시된 파일명이 너무 길다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NOENT||파일 또는 디렉터리가 존재하지 않는다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NOTDIR||명시된 위치가 디렉터리가 아닌데 옵션은 디렉터리를 필요로 한다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NXIO||파일이 위치한 장치를 찾을 수 없다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NODEV||파일 유형이 매핑을 지원하지 않는다.
|- style="vertical-align:top;"
|G_FILE_ERROR_ROFS||파일 시스템이 읽기전용으로 되어 있다.
|- style="vertical-align:top;"
|G_FILE_ERROR_TXTBSY||텍스트 파일이 현재 사용 중이다(busy).
|- style="vertical-align:top;"
|G_FILE_ERROR_FAULT||올바르지 않은 메모리 위치를 향한 포인터가 전달되었다.
|- style="vertical-align:top;"
|G_FILE_ERROR_LOOP||원형의 심볼릭 링크가 감지되었다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NOSPC||디스크가 가득 차서 이용할 수 있는 공간이 없다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NOMEM||이용할 수 있는 메모리가 없으며, 가상 메모리가 가득 찼다.
|- style="vertical-align:top;"
|G_FILE_ERROR_MFILE||현재 프로세스에 너무 많은 오픈 파일이 있다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NFILE||전체 시스템에 너무 많은 파일이 열려 있다.
|- style="vertical-align:top;"
|G_FILE_ERROR_BADF||쓰기에 읽기 파일 디스크립터가 명시되거나, 읽기에 쓰기 파일 디스크립터가 명시되었다.
|- style="vertical-align:top;"
|G_FILE_ERROR_INVAL||올바르지 않은 인자(argument)가 전달되었다.
|- style="vertical-align:top;"
|G_FILE_ERROR_PIPE||파이프가 깨졌거나 블로킹되었다.
|- style="vertical-align:top;"
|G_FILE_ERROR_AGAIN||자원이 깨졌지만 조금 있다 다시 시도하면 작동할 수도 있다.
|- style="vertical-align:top;"
|G_FILE_ERROR_INTR||함수 호출이 방해받았다.
|- style="vertical-align:top;"
|G_FILE_ERROR_IO||디스크 상에서 읽기 또는 쓰기 오류가 발생하였다.
|- style="vertical-align:top;"
|G_FILE_ERROR_PERM||연산이 허용되지 않는다.
|- style="vertical-align:top;"
|G_FILE_ERROR_NOSYS||함수가 자신의 운영체제에 맞게 구현되지 않았다.
|- style="vertical-align:top;"
|G_FILE_ERROR_FAILED||확인할 수 없는 이유로 연산이 실패하였다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-3. GFileError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_UNKNOWN_ENCODING||파싱 중인 문서로 인해 알려지지 않은 인코딩이 실행되었다.
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_PARSE||파싱 중인 문서가 올바로 포맷팅되지 않았다.
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_NOT_FOUND||함수로 제공된 파일을 찾을 수 없다.
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_KEY_NOT_FOUND||함수가 요청한 키를 찾을 수 없다.
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_GROUP_NOT_FOUND||함수가 요청한 그룹을 찾을 수 없다.
|- style="vertical-align:top;"
|G_KEY_FILE_ERROR_INVALID_VALUE||함수로 제공된 값이 성공적으로 파생되지 않았다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-4. GKeyFileError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_MARKUP_ERROR_BAD_UTF8||파싱 중인 텍스트가 유효한 UTF-8 포맷으로 명시되지 않았다. 포맷팅을 변경하고 다시 시도할 필요가 있다.
|- style="vertical-align:top;"
|G_MARKUP_ERROR_EMPTY||문서에 내용이 없거나 공백만 포함한다.
|- style="vertical-align:top;"
|G_MARKUP_ERROR_PARSE||파싱 중인 문서가 올바로 포맷팅되지 않았다.
|- style="vertical-align:top;"
|G_MARKUP_ERROR_UNKNOWN_ELEMENT||함수로 명시한 요소를 찾을 수 없다. 이 값은 GMarkupParser 함수에 의해서만 설정되어야 한다.
|- style="vertical-align:top;"
|G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE||함수로 명시한 속성을 찾을 수 없다. 이 값은 GMarkupParser 함수에 의해서만 설정되어야 한다.
|- style="vertical-align:top;"
|G_MARKUP_ERROR_INVALID_CONTENT||문서의 내용에 문제가 발생하여 오류를 야기하였다. 이 값은 GMarkupParser 함수에 의해서만 설정되어야 한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-5. GMarkupError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_OPTION_ERROR_UNKNOWN_OPTION||파서가 함수로 제공된 옵션을 실현하지 않았다. 이 오류는GOptionContext를 설정하여 알려지지 않은 옵션을 무시하지 않을 때에만 보고될 것이다.
|- style="vertical-align:top;"
|G_OPTION_ERROR_BAD_VALUE||값을 올바로 파싱할 수 없다.
|- style="vertical-align:top;"
|G_OPTION_ERROR_FAILED||GOptionArgFunc 타입의 콜백 함수가 실패하였다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-6. GOptionError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_SHELL_ERROR_BAD_QUOTING||쿼팅(Quoting)이 올바로 매치되지 않았거나 이해할 수 없다.
|- style="vertical-align:top;"
|G_SHELL_ERROR_EMPTY_STRING||파싱될 문자열이 완전히 비어 있다.
|- style="vertical-align:top;"
|G_SHELL_ERROR_FAILED||다른 타입의 GShellError가 발생하였다. 상세한 정보는 error->message 를 참고한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-7. GShellError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_SPAWN_ERROR_FORK||이용 가능한 메모리가 부족하여 포크(fork)가 실패하였다.
|- style="vertical-align:top;"
|G_SPAWN_ERROR_READ||파이프를 선택하거나 읽는 데에 실패하였다.
|- style="vertical-align:top;"
|G_SPAWN_ERROR_CHDIR||작업 디렉터리를 성공적으로 변경하는 데 실패하였다.
|- style="vertical-align:top;"
|G_SPAWN_ERROR_ACCES||경로 접두사에 대한 검색 권한이 거부되었거나, 새로운 파일이 일반 파일이 아니거나, 실행 권한이 거부되었거나, 파일의 실행이 비활성화된 채로 파일 시스템에 마운트되어 있었다(execv()가 EACCES를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_PERM||프로세스의 권한이 올바르지 않아 연산이 허용되지 않았다 (execv()가 EPERM을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_2BIG||시스템에서 설정한 한계로 인해 프로세스의 인자 리스트가 너무 길다 (execv()가 E2BIG을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NOEXEC||파일이 실행되는 데 필요한 권한을 갖고 있지 않다(execv()가 ENOEXEC를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NAMETOOLONG||전체 경로 또는 경로의 일부 길이가 최대 허용 길이를 초과하였다(execv()가 ENAMETOOLONG을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NOENT||프로세스 파일이 존재하지 않는다 (execv()가 ENOENT를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NOMEM||프로세스에 최대 가상 메모리 할당이 존재하며, 최대량보다 많은 메모리가 요구되었다(execv()가 ENOMEM을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NOTDIR||경로 접두사가 유효하지 않은 디렉터리를 가리켰다 (execv()가 ENOTDIR을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_LOOP||함수가 경로에 대해 너무 많은 심볼릭 링크가 감지되었다 (execv()가 ELOOP를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_TXTBUSY||다른 프로세스에서 이미 열려 있어서 해당 프로세스를 열 수 없다 (execv()가 ETXTBUSY를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_IO||읽는 도중에 입력 또는 출력 오류가 발생하였다 (execv()가 EIO를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_NFILE||시스템이 지원하는 오픈 파일의 최대 개수에 도달하였다 (execv()가 ENFILE를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_MFILE||시스템이 하나의 프로세스에 지원하는 오픈 파일의 최대 개수에 도달하였다 (execv()가 EMFILE를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_INVAL||함수로 전달된 매개변수가 올바로 포맷팅되지 않았다 (execv()가 EINVAL을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_ISDIR||파일이 디렉터리로 발견되었고, 디렉터리에 지원되지 않는 연산의 실행이 시도되었다 (execv()가 EISDIR을 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_LIBBAD||접근을 시도한 공유 라이브러리가 손상되었다(execv()가 ELIBBAD를 실패하였다).
|- style="vertical-align:top;"
|G_SPAWN_ERROR_FAILED||그 외 다른 치명적인 오류가 발생하였다. 상세한 정보는 error->message 를 참고한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-8. GSpawnError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|G_THREAD_ERROR_AGAIN||쓰레드(thread)를 생성하는 데에 이용 가능한 자원이 충분하지 않았다. 이런 경우 조금 있다 다시 시도해야 한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-9. GThreadError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GTK_FILE_CHOOSER_ERROR_NONEXISTENT||GtkFileChooser 로 명시한 파일이 존재하지 않는다.
|- style="vertical-align:top;"
|GTK_FILE_CHOOSER_ERROR_BAD_FILENAME||함수로 명시한 파일명이 올바로 포맷팅되지 않았다.
|- style="vertical-align:top;"
|GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS||함수로 명시한 파일명이 이미 존재한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-10. GtkFileChooserError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GTK_ICON_THEME_NOT_FOUND||함수에 매개변수로 명시된 아이콘이 GtkIconTheme에 존재하지 않는다.
|- style="vertical-align:top;"
|GTK_ICON_THEME_FAILED||다른 타입의 GtkIconTheme 오류가 발생하였다. 상세한 정보는 error->message를 참고한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-11. GtkIconThemeError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GTK_PRINT_ERROR_GENERAL||일반적인 출력 오류가 발생하였다. 상세한 정보는 error->message를 참고한다.
|- style="vertical-align:top;"
|GTK_PRINT_ERROR_INTERNAL_ERROR||출력 시스템에서 내부적으로 오류가 발생하였다. 사용자의 시스템에 문제가 발생했다는 의미다.
|- style="vertical-align:top;"
|GTK_PRINT_ERROR_NOMEM||출력 연산을 계속하기에 메모리가 충분하지 않다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-12. GtkPrintError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GTK_RECENT_CHOOSER_ERROR_NOT_FOUND||함수로 명시한 파일이 존재하지 않는다.
|- style="vertical-align:top;"
|GTK_RECENT_CHOOSER_ERROR_INVALID_URI||함수로 명시한 URI가 올바로 포맷팅되지 않았다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-13. GtkRecentChooserError 열거 값
|}

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''오류 값'''||'''설명'''
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_NOT_FOUND||함수로 명시한 URI가 리스트에 존재하지 않았다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_INVALID_URI||함수로 명시한 URI가 올바로 포맷팅되지 않았다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING||명시된 문자열이 UTF-8 인코딩으로 제공되지 않았다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED||함수로 명시한 항목이 어떤 애플리케이션에서도 등록되지 않았다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_READ||최근 사용한 자원 파일을 읽는 데 실패하였다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_WRITE||최근 사용한 자원 파일을 쓰는 데 실패하였다.
|- style="vertical-align:top;"
|GTK_RECENT_MANAGER_ERROR_UNKNOWN||다른 타입의 오류가 발생하였다. 상세한 정보는 error->message를 참고한다.
|- style="color: black; background-color: gray;"
| colspan="2" |표 E-14. GtkRecentManagerError 열거 값
|}

==Notes==
<references />

[[Category:FoundationsofGTKDevelopment]]

FoundationsofGTKDevelopment:Appendix E - Revision history

Onionmixer: GTKD 부록 E GError 타입 페이지 추가