Utility API¶

Oasis에서 쓰이는 유용한 함수들입니다.

헤더 파일¶

OasisNet.h
OasisUtil.h

네트워크¶

플래그 값은 아래 값을 OR'ing 합니다.

#define NETIF_LIST_F_LOOPBACK_INCLUDED          0x0001
#define NETIF_LIST_F_MULTICAST_SUPPORTED        0x0002

• NETIF_LIST_F_LOOPBACK_INCLUDED 검색 시 루프백 장치도 포함시킵니다.
• NETIF_LIST_F_MULTICAST_SUPPORTED 검색 시 멀티캐스트를 지원하는 네트워크 인터페이스만 포함시킵니다.

아래는 Oasis가 인식하는 파일 확장자별 MIME 타입 표입니다.

문자열¶

아래는 toHexDumpString 예입니다.

" 00000000 33 59 c6 dd 97 07 1d d4 3b d3 5c 40 b3 b0 c9 a4 3Y......;.\@....\n 00000010 f1 0b 36 39 59 5c ed e8 dd 63 42 ce f9 d0 88 2c ..69Y...cB....,\n 00000020 29 4e 09 c0 \n"

이 문자열을 콘솔에 출력하면 아래와 같이 보입니다.

   00000000  33 59 c6 dd 97 07 1d d4 3b d3 5c 40 b3 b0 c9 a4   3Y......;.\@....
   00000010  f1 0b 36 39 59 5c ed e8 dd 63 42 ce f9 d0 88 2c   ..69Y\...cB....,
   00000020  29 4e 09 c0                                       )N..

Base64¶

아래는 line_length 가 0 인 경우, BASE64 인코딩한 문자열입니다.

아래는 line_length 가 32 인 경우, BASE64 인코딩한 문자열입니다.

Random 데이터와 UUID¶

시간¶

패러미터 맵¶

INI 파일¶

get_profile_section, get_profile_section_names, get_profile_string, write_profile_string 함수는 모두 확장자가 ini 타입인 파일의 내용을 다룹니다.

ini 파일은 여러 개의 섹션으로 구성되어 있으며, 각 섹션은 <키 이름>=<값> 줄로 이루어져 있습니다. # 나 ; 는 코멘트 구분 기호로 사용됩니다. <값> 에 공백을 포함하는 경우, 큰따옴표로 시작하여 큰따옴표로 끝납니다. 섹션 이름은 대소문자 구별됩니다.

; 코멘트
# 코멘트
[섹션1 이름]
키이름=값   # 코멘트
키이름=값   ; 코멘트

예로 아래와 같습니다.

[general]
key1=value1
key2="general value2"  ; comment

[section1]
key1=section1_value1
key2="section1 value2"  ; comment

[section2]
key1=section2_value1
key2="section2 value2"  ; comment

:[general], __data=0xffffeafcf4c8, __size=47 of 47:
   00000000  6b 65 79 31 3d 76 61 6c 75 65 31 00 6b 65 79 32   key1=value1.key2
   00000010  3d 22 67 65 6e 65 72 61 6c 20 76 61 6c 75 65 32   ="general value2
   00000020  22 20 20 3b 20 63 6f 6d 6d 65 6e 74 00 00 00      "  ; comment...

:section list, __data=0xffffeafcf4c8, __size=27 of 27:
   00000000  67 65 6e 65 72 61 6c 00 73 65 63 74 69 6f 6e 31   general.section1
   00000010  00 73 65 63 74 69 6f 6e 32 00 00                  .section2..

파일 경로¶

아래는 몇 가지 경로에 대해 위 함수들을 적용한 예입니다.

path: /a/b/c/d/file.ext
get_path_dir: /a/b/c/d
get_path_leaf: file.ext
get_path_leaf_name: file
get_file_ext: ext

path: /a/b/c/d/
get_path_dir: /a/b/c/d
get_path_leaf: 
get_path_leaf_name: 
get_file_ext: 

path: /a/b/c/d/file
get_path_dir: /a/b/c/d
get_path_leaf: file
get_path_leaf_name: file
get_file_ext: 

path: /a/b/c/d/.ext
get_path_dir: /a/b/c/d
get_path_leaf: .ext
get_path_leaf_name: 
get_file_ext: ext

path: /a/b/c/d/.
get_path_dir: /a/b/c/d
get_path_leaf: .
get_path_leaf_name: 
get_file_ext: 

파일 I/O¶

아래는 읽어온 데이터 버퍼을 HEX DUMP한 예입니다.

readLinesFromFile, __data=0xfffff09f8d68, __size=206 of 206:
   00000000  23 20 63 6f 6d 6d 65 6e 74 0a 00 0a 00 5b 67 65   # comment....[ge
   00000010  6e 65 72 61 6c 5d 0a 00 6b 65 79 31 3d 76 61 6c   neral]..key1=val
   00000020  75 65 31 0a 00 6b 65 79 32 3d 22 67 65 6e 65 72   ue1..key2="gener
   00000030  61 6c 20 76 61 6c 75 65 32 22 20 20 3b 20 63 6f   al value2"  ; co
   00000040  6d 6d 65 6e 74 0a 00 0a 00 5b 73 65 63 74 69 6f   mment....[sectio
   00000050  6e 31 5d 0a 00 6b 65 79 32 3d 0a 00 6b 65 79 33   n1]..key2=..key3
   00000060  3d 22 6e 65 77 20 6b 65 79 20 76 61 6c 75 65 22   ="new key value"
   00000070  0a 00 6b 65 79 31 3d 22 73 68 6f 72 74 20 76 61   ..key1="short va
   00000080  6c 75 65 22 0a 00 0a 00 5b 73 65 63 74 69 6f 6e   lue"....[section
   00000090  32 5d 0a 00 6b 65 79 31 3d 73 65 63 74 69 6f 6e   2]..key1=section
   000000a0  32 5f 76 61 6c 75 65 31 0a 00 6b 65 79 32 3d 22   2_value1..key2="
   000000b0  73 65 63 74 69 6f 6e 32 20 76 61 6c 75 65 32 22   section2 value2"
   000000c0  20 20 3b 20 63 6f 6d 6d 65 6e 74 0a 00 00           ; comment...

자원 및 환경 변수¶

/etc/profile 파일 내용이 아래와 같은 경우,

export PATH="/bin:/sbin:/usr/bin:/usr/sbin"

if [ "$PS1" ]; then
        if [ "`id -u`" -eq 0 ]; then
                export PS1='# '
        else
                export PS1='$ '
        fi
fi

export EDITOR='/bin/vi'

# Source configuration files from /etc/profile.d
for i in /etc/profile.d/*.sh ; do
        if [ -r "$i" ]; then
                . $i
        fi
done
unset i

PATH 와 EDITOR 환경 변수 값을 알고자 할 때,

const char *known_env_variables[] = { "PATH", "EDITOR", nullptr };
key_value_map_t vars;
std::list<std::string> sources;
loadEnvironmentVariables("/" , "/etc/profile" , known_env_variables , vars , sources);

dumpParameters("loadEnvironmentVariables", vars);

실행 하면, 아래 같은 결과를 볼 수 있습니다.

loadEnvironmentVariables parameters[PATH] /bin:/sbin:/usr/bin:/usr/sbin
loadEnvironmentVariables parameters[EDITOR] /bin/vi