패키지 함수

패키지 수준 편의 함수는 간결한 API 를 제공하며, 대부분의 사용 사례에 적합합니다. 이 함수들은 전역 기본 로더를 사용하며, 모든 함수는 스레드 안전합니다.

초기화 필요

전역 기본 로더는 Load() 또는 LoadWithConfig()로 명시적으로 초기화해야 하며, 최초 호출 시 자동으로 생성되지 않습니다. 초기화되지 않은 경우 함수 동작은 다음과 같습니다:

Get* 함수 (GetString, GetInt, GetBool 등): 전달된 기본값 (또는 제로값) 반환
Lookup: ("", false) 반환
Keys/All/Len/GetSecure: nil/0 반환
Set/Delete/Validate/ParseInto: ErrNotInitialized 반환

로드 함수

Load

func Load(filenames ...string) error

환경 변수 파일을 로드하고 시스템 환경에 적용합니다.

매개변수:

filenames - 파일 경로 목록. 제공하지 않으면 아무 파일도 로드하지 않으며, 기본 파일을 로드하려면 명시적으로 ".env"를 전달해야 합니다.

반환값:

error - 로드 오류

동작:

새로운 Loader 인스턴스를 생성하고 기본 로더로 설정
시스템 환경 (os.Environ) 에 자동 적용
나중에 로드한 파일이 먼저 로드한 파일을 덮어씀
기본 로더가 이미 초기화된 경우 ErrAlreadyInitialized 반환
다중 형식 지원 (.env, JSON, YAML)

// .env 파일 로드
if err := env.Load(".env"); err != nil {
    log.Fatal(err)
}

// 지정된 파일 로드 (순서대로, 나중 것이 앞선 것을 덮어씀)
if err := env.Load(".env", ".env.local", "config.json"); err != nil {
    log.Fatal(err)
}

// JSON/YAML 중첩 구조 점 접근 지원
// config.json: {"database": {"host": "localhost", "port": 5432}}
env.Load("config.json")
host := env.GetString("database.host") // "localhost"
port := env.GetInt("database.port")    // 5432

키 이름 해석

모든 가져오기 함수는 스마트 키 이름 해석을 지원하여 유연한 접근 방식을 제공합니다.

해석 규칙

1. 정확한 일치 (우선)

// .env: APP_NAME=myapp
name := env.GetString("APP_NAME")  // "myapp"

2. 대문자 변환 (단순 키)

// 점이 없는 키의 경우 자동으로 대문자 버전을 시도
name := env.GetString("app_name")  // app_name -> APP_NAME 검색

3. 점 경로 해석 (중첩 키)

// JSON: {"app": {"name": "myapp"}}
// 저장됨: APP_NAME=myapp

// 다음 방법 모두 해당 값에 접근 가능
name := env.GetString("APP_NAME")   // 평면화된 키 이름 (권장)
name := env.GetString("app.name")   // 점 경로 (자동 변환)
name := env.GetString("APP.NAME")   // 대문자 점 경로

경로 변환 표

입력 키 이름	저장 키 이름
`"database.host"`	`"DATABASE_HOST"`
`"db.port"`	`"DB_PORT"`
`"servers.0.host"`	`"SERVERS_0_HOST"`
`"app.config.name"`	`"APP_CONFIG_NAME"`

인덱스 접근

배열 요소는 인덱스로 접근하거나 쉼표로 구분된 값으로 폴백할 수 있습니다:

// JSON: {"servers": [{"host": "a.com"}, {"host": "b.com"}]}
// 저장됨: SERVERS_0_HOST=a.com, SERVERS_1_HOST=b.com

host0 := env.GetString("servers.0.host")  // "a.com"
host1 := env.GetString("servers.1.host")  // "b.com"

// 키가 존재하지 않지만 쉼표로 구분된 기본 값이 있는 경우
// HOSTS=localhost,example.com
host0 := env.GetString("hosts.0")  // "localhost" (쉼표로 구분된 값에서 파싱)

값 가져오기 함수

GetString

func GetString(key string, defaultValue ...string) string

문자열 값을 가져옵니다. 점 경로 해석을 지원합니다.

매개변수:

key - 키 이름 (정확한 일치, 대문자 변환, 점 경로 지원)
defaultValue - 선택적 기본값

반환값:

string - 값 또는 기본값 (찾지 못하고 기본값도 없으면 빈 문자열 반환)

// 기본 사용법
host := env.GetString("HOST", "localhost")

// 점 경로 접근 (JSON/YAML 중첩 구조)
dbHost := env.GetString("database.host", "localhost")
appName := env.GetString("app.name")

// 기본값이 없으면 빈 문자열 반환
value := env.GetString("NON_EXISTENT")  // ""

GetInt

func GetInt(key string, defaultValue ...int64) int64

정수 값을 가져옵니다. 문자열을 정수로 자동 변환합니다. 점 경로 해석을 지원합니다.

매개변수:

key - 키 이름 (점 경로 지원)
defaultValue - 선택적 기본값, int64 유형

반환값:

int64 - 값 또는 기본값 (찾지 못하고 기본값도 없으면 0 반환)

port := env.GetInt("PORT", 8080)
maxConn := env.GetInt("database.max_connections", 10)

// 기본값이 없으면 0 반환
value := env.GetInt("NON_EXISTENT")  // 0

GetBool

func GetBool(key string, defaultValue ...bool) bool

부울 값을 가져옵니다. 점 경로 해석을 지원합니다.

참 값 (대소문자 구분 없음): true, 1, yes, on, enabled
거짓 값 (대소문자 구분 없음): false, 0, no, off, disabled

매개변수:

key - 키 이름 (점 경로 지원)
defaultValue - 선택적 기본값

반환값:

bool - 값 또는 기본값 (찾지 못하고 기본값도 없으면 false 반환)

debug := env.GetBool("DEBUG", false)
cacheEnabled := env.GetBool("cache.enabled", true)

// 기본값이 없으면 false 반환
value := env.GetBool("NON_EXISTENT")  // false

GetUint64

func GetUint64(key string, defaultValue ...uint64) uint64

부호 없는 정수 값을 가져옵니다. 점 경로 해석을 지원합니다.

매개변수:

key - 키 이름 (점 경로 지원)
defaultValue - 선택적 기본값, uint64 유형

반환값:

uint64 - 값 또는 기본값 (찾지 못하고 기본값도 없으면 0 반환)

port := env.GetUint64("PORT", 8080)
maxSize := env.GetUint64("MAX_SIZE", 1024)

// 기본값이 없으면 0 반환
value := env.GetUint64("NON_EXISTENT")  // 0

GetFloat64

func GetFloat64(key string, defaultValue ...float64) float64

부동소수점 값을 가져옵니다. 점 경로 해석을 지원합니다.

매개변수:

key - 키 이름 (점 경로 지원)
defaultValue - 선택적 기본값, float64 유형

반환값:

float64 - 값 또는 기본값 (찾지 못하고 기본값도 없으면 0 반환)

rate := env.GetFloat64("RATE", 0.5)
threshold := env.GetFloat64("THRESHOLD")

// 기본값이 없으면 0 반환
value := env.GetFloat64("NON_EXISTENT")  // 0

GetDuration

func GetDuration(key string, defaultValue ...time.Duration) time.Duration

시간 간격 값을 가져옵니다. 점 경로 해석을 지원합니다.

지원 형식:

300ms - 밀리초
1.5s - 초
2m30s - 분 + 초
1h30m - 시간 + 분

매개변수:

key - 키 이름 (점 경로 지원)
defaultValue - 선택적 기본값

반환값:

time.Duration - 값 또는 기본값 (찾지 못하고 기본값도 없으면 0 반환)

timeout := env.GetDuration("TIMEOUT", 30*time.Second)
interval := env.GetDuration("INTERVAL", 5*time.Minute)

// 기본값이 없으면 0 반환
value := env.GetDuration("NON_EXISTENT")  // 0

GetSecure

func GetSecure(key string) *SecureValue

보안 값을 가져옵니다 (민감한 데이터용).

매개변수:

key - 키 이름

반환값:

*SecureValue - 보안 값 래퍼, 키가 존재하지 않거나 로더를 사용할 수 없으면 nil 반환

secret := env.GetSecure("API_KEY")
if secret != nil {
    defer secret.Release()

    value := secret.Reveal()   // 평문 값 (필요할 때만 호출)
    masked := secret.Masked()  // 로깅용: [SECURE:32 bytes]
}

중요

사용 후 반드시 Release() 또는 Close()를 호출하여 리소스를 해제해야 합니다. defer를 사용하여 해제를 보장하는 것을 권장합니다.

자세히

SecureValue API에서 전체 API 문서를 확인하세요.

GetSlice[T]

func GetSlice[T sliceElement](key string, defaultValue ...[]T) []T

제네릭 함수, 슬라이스 값을 가져옵니다.

지원 유형: string, int, int64, uint, uint64, bool, float64, time.Duration

참고: 이 함수는 제네릭 함수이며 Loader 의 메서드가 아닙니다. 특정 Loader 인스턴스에서 슬라이스를 가져오려면 GetSliceFrom[T]를 사용하세요.

파싱 순서:

인덱스 키 KEY_0, KEY_1, KEY_2...를 먼저 검색
인덱스 키가 없으면 KEY의 값을 쉼표로 구분하여 파싱
점 경로 해석 지원

매개변수:

key - 키 이름
defaultValue - 선택적 기본값

반환값:

[]T - 슬라이스 값

// 인덱스 키 형식 (권장)
// HOSTS_0=localhost
// HOSTS_1=example.com
hosts := env.GetSlice[string]("HOSTS")  // ["localhost", "example.com"]

// 쉼표 구분 형식
// PORTS=80,443,8080
ports := env.GetSlice[int64]("PORTS", []int64{80})  // [80, 443, 8080]

// 부동소수점 슬라이스
rates := env.GetSlice[float64]("RATES", []float64{0.1, 0.2})

// 부울 슬라이스
flags := env.GetSlice[bool]("FLAGS")

// Duration 슬라이스
timeouts := env.GetSlice[time.Duration]("TIMEOUTS")

// 부호 없는 정수 슬라이스
ports := env.GetSlice[uint]("PORTS")
port64s := env.GetSlice[uint64]("PORTS")

// int 유형
portInts := env.GetSlice[int]("PORTS")

// 기본값이 없으면 nil 반환
value := env.GetSlice[string]("NON_EXISTENT")  // nil

GetSliceFrom[T]

func GetSliceFrom[T sliceElement](loader *Loader, key string, defaultValue ...[]T) []T

지정된 Loader 인스턴스에서 슬라이스 값을 가져옵니다. 독립적인 제네릭 함수입니다 (Loader 메서드가 아님).

매개변수:

loader - Loader 인스턴스 포인터 (nil 인 경우 기본값 반환)
key - 키 이름
defaultValue - 선택적 기본값

반환값:

[]T - 슬라이스 값

지원 유형: string, int, int64, uint, uint64, bool, float64, time.Duration

loader, _ := env.New(cfg)
defer loader.Close()

// loader 인스턴스에서 슬라이스 가져오기
hosts := env.GetSliceFrom[string](loader, "HOSTS")
ports := env.GetSliceFrom[int64](loader, "PORTS", []int64{80})

// int, uint, uint64 유형도 지원
portsInt := env.GetSliceFrom[int](loader, "PORTS")
portsUint := env.GetSliceFrom[uint](loader, "PORTS")
portsUint64 := env.GetSliceFrom[uint64](loader, "PORTS")

차이점

GetSlice[T] - 기본 로더를 사용하는 패키지 수준 함수
GetSliceFrom[T] - 지정된 Loader 인스턴스의 제네릭 함수 (Go 는 제네릭 메서드를 지원하지 않음)

조회 함수

Lookup

func Lookup(key string) (string, bool)

키가 존재하는지 확인하고 값을 가져옵니다. 점 경로 해석을 지원합니다.

매개변수:

key - 키 이름 (점 경로 지원)

반환값:

string - 값 (앞뒤 공백 제거됨)
bool - 존재 여부

value, exists := env.Lookup("API_KEY")
if !exists {
    // 키가 존재하지 않음
}

// 점 경로
if value, exists := env.Lookup("database.host"); exists {
    fmt.Println(value)
}

Keys

func Keys() []string

모든 키 이름을 가져옵니다.

반환값:

[]string - 키 이름 목록, 로더를 사용할 수 없으면 nil 반환

keys := env.Keys()
for _, key := range keys {
    fmt.Println(key)
}

All

func All() map[string]string

모든 키 - 값 쌍을 가져옵니다.

반환값:

map[string]string - 키 - 값 매핑, 로더를 사용할 수 없으면 nil 반환

all := env.All()
for key, value := range all {
    fmt.Printf("%s=%s\n", key, value)
}

Len

func Len() int

변수 수를 가져옵니다.

반환값:

int - 변수 수, 로더를 사용할 수 없으면 0 반환

count := env.Len()
fmt.Printf("%d개의 환경 변수가 로드됨\n", count)

설정 및 삭제

Set

func Set(key, value string) error

환경 변수를 설정합니다.

매개변수:

key - 키 이름
value - 값

반환값:

error - 설정 오류

오류 유형:

*ValidationError - 키 이름 형식이 유효하지 않음 (Field="key")
*SecurityError - 키가 금지됨 (errors.Is(err, env.ErrSecurityViolation)로 일치 가능)
ErrInvalidValue - 값이 유효하지 않음 (ValidateValues가 true 일 때, 값에 널 바이트·제어 문자 등 안전하지 않은 내용이 포함된 경우)
ErrClosed - 로더가 닫힘

if err := env.Set("CUSTOM_KEY", "value"); err != nil {
    // *SecurityError (금지 키) 또는 *ValidationError (키 형식) 일 수 있음
}

Delete

func Delete(key string) error

환경 변수를 삭제합니다.

매개변수:

key - 키 이름

반환값:

error - 삭제 오류

if err := env.Delete("TEMP_KEY"); err != nil {
    panic(err)
}

검증 및 매핑

Validate

func Validate() error

필수 키가 존재하는지 검증합니다. Config 에 RequiredKeys 를 설정해야 합니다.

반환값:

error - 검증 오류

// RequiredKeys 를 먼저 구성해야 함 (커스텀 로더를 통해)
cfg := env.ProductionConfig()
cfg.RequiredKeys = []string{"DB_HOST", "API_KEY"}

loader, _ := env.New(cfg)
loader.LoadFiles(".env")

if err := loader.Validate(); err != nil {
    // 필수 키 누락
}

ParseInto

func ParseInto(v any) error

환경 변수를 구조체에 매핑합니다.

매개변수:

v - 구조체 포인터

반환값:

error - 매핑 오류

type Config struct {
    Host string `env:"HOST" envDefault:"localhost"`
    Port int64  `env:"PORT" envDefault:"8080"`
}

var cfg Config
if err := env.ParseInto(&cfg); err != nil {
    panic(err)
}

구조체 태그:

태그	설명
`env:"KEY"`	지정된 키에 매핑
`env:"-"`	이 필드 무시
`envDefault:"value"`	기본값

슬라이스 필드는 기본적으로 쉼표 ,로 구분됩니다 (구분자 앞뒤 공백은 자동 제거되며, 커스텀 구분자 태그는 없습니다).

자세히

구조체 매핑에서 전체 가이드를 확인하세요.

유틸리티 함수

ResetDefaultLoader

func ResetDefaultLoader() error

전역 기본 로더를 재설정합니다. 주로 테스트 시나리오에서 사용합니다.

반환값:

error - 이전 로더 닫기 오류 (있는 경우); 이전에 로더가 없거나 닫기에 성공하면 nil 반환

동작:

atomic.Pointer.Swap로 기본 로더를 nil 로 원자적 교체
defaultMu 락을 보유한 상태에서 이전 로더를 닫습니다 (닫기 완료 후에야 락 해제, 재설정의 원자성 보장)
재설정 후 Load() 또는 LoadWithConfig()로 새 기본 로더 생성 가능

func TestMain(m *testing.M) {
    if err := env.ResetDefaultLoader(); err != nil {
        log.Printf("warning: failed to reset loader: %v", err)
    }
    os.Exit(m.Run())
}

func TestSomething(t *testing.T) {
    if err := env.ResetDefaultLoader(); err != nil {
        t.Logf("warning: %v", err)
    }
    defer env.ResetDefaultLoader()
    // ... 테스트 코드
}

참고

이 함수는 동시성에 안전하지만, 예기치 않은 동작을 방지하기 위해 테스트나 시작 시에만 호출하세요.

LoadWithConfig

func LoadWithConfig(cfg Config) error

사용자 정의 설정으로 기본 로더를 초기화합니다.

매개변수:

cfg - 사용자 정의 설정

반환값:

error - 초기화 오류

동작:

패키지 수준 기본 로더 설정 (GetString, GetInt 등의 함수가 사용)
cfg 의 설정에 관계없이 AutoApply = true를 강제 적용
기본 로더가 이미 초기화된 경우 ErrAlreadyInitialized 반환

Load 와의 차이점:

Load() - 파일 이름 목록만 허용, 기본 설정 사용
LoadWithConfig() - 전체 Config 허용, 모든 설정 옵션 지원

cfg := env.DefaultConfig()
cfg.Filenames = []string{".env.production"}
cfg.OverwriteExisting = true
if err := env.LoadWithConfig(cfg); err != nil {
    log.Fatal(err)
}
// 이제 패키지 수준 함수를 사용할 수 있음
port := env.GetInt("PORT", 8080)

참고

이 함수는 cfg.AutoApply를 true로 강제 설정하여 변수가 시스템 환경에 적용되도록 합니다. 적용 시점을 제어하려면 New()를 사용하여 독립 인스턴스를 생성하세요.

직렬화 함수

Marshal

func Marshal(data any, format ...FileFormat) (string, error)

데이터를 지정된 형식의 문자열로 직렬화합니다. map[string]string 또는 구조체를 입력으로 지원합니다.

인터페이스 통합: 입력 유형이 Marshaler 인터페이스를 구현한 경우, MarshalEnv() 메서드를 우선 호출하여 직렬화합니다.

매개변수:

data - 직렬화할 데이터 (map 또는 구조체)
format - 선택적 형식, 기본값 FormatEnv

반환값:

string - 직렬화된 문자열 (키가 정렬됨)
error - 직렬화 오류

지원 형식:

FormatEnv (기본값) - .env 형식
FormatJSON - JSON 형식
FormatYAML - YAML 형식

// map 을 .env 형식으로 변환
mapData := map[string]string{"HOST": "localhost", "PORT": "8080"}
envStr, _ := env.Marshal(mapData)
// HOST=localhost
// PORT=8080

// map 을 JSON 형식으로 변환 (숫자 문자열을 숫자로 그대로 출력하고, 키를 알파벳순으로 정렬)
jsonStr, _ := env.Marshal(mapData, env.FormatJSON)
// {
//   "HOST": "localhost",
//   "PORT": 8080
// }

// 구조체를 .env 형식으로 변환
type Config struct {
    Host string `env:"HOST"`
    Port string `env:"PORT"`
}
envStr, _ := env.Marshal(Config{Host: "localhost", Port: "8080"})

UnmarshalMap

func UnmarshalMap(data string, format ...FileFormat) (map[string]string, error)

형식화된 문자열을 map 으로 파싱합니다. 자동 형식 감지를 지원합니다.

매개변수:

data - 형식화된 문자열
format - 선택적 형식, 기본값 FormatEnv; FormatAuto를 사용하면 자동 감지

반환값:

map[string]string - 파싱된 키 - 값 쌍
error - 파싱 오류

// .env 형식
m, _ := env.UnmarshalMap("HOST=localhost\nPORT=8080")

// JSON 형식 (중첩 구조는 평면화됨)
m, _ := env.UnmarshalMap(`{"database": {"host": "localhost"}}`, env.FormatJSON)
// m["DATABASE_HOST"] = "localhost"

// 자동 형식 감지
m, _ := env.UnmarshalMap(jsonString, env.FormatAuto)

UnmarshalStruct

func UnmarshalStruct(data string, v any, format ...FileFormat) error

형식화된 문자열을 파싱하여 구조체에 채웁니다.

매개변수:

data - 형식화된 문자열
v - 구조체 포인터
format - 선택적 형식, 기본값 FormatEnv

반환값:

error - 파싱 오류

type Config struct {
    Host string `env:"SERVER_HOST"`
    Port int    `env:"SERVER_PORT"`
}

var cfg Config
err := env.UnmarshalStruct("SERVER_HOST=localhost\nSERVER_PORT=8080", &cfg)
// cfg.Host = "localhost", cfg.Port = 8080

// JSON 에서 파싱
err = env.UnmarshalStruct(`{"server": {"host": "localhost"}}`, &cfg, env.FormatJSON)

UnmarshalInto

func UnmarshalInto(data map[string]string, v any) error

map 을 구조체에 채웁니다. env 및 envDefault 태그를 지원합니다.

인터페이스 통합: 대상 유형이 Unmarshaler 인터페이스를 구현한 경우, UnmarshalEnv(data) 메서드를 우선 호출합니다.

매개변수:

data - 키 - 값 쌍 매핑
v - 구조체 포인터

반환값:

error - 채우기 오류

type Config struct {
    Host string `env:"HOST" envDefault:"localhost"`
    Port int    `env:"PORT" envDefault:"8080"`
}

data := map[string]string{"HOST": "example.com"}
var cfg Config
err := env.UnmarshalInto(data, &cfg)
// cfg.Host = "example.com", cfg.Port = 8080 (기본값 사용)

MarshalStruct

func MarshalStruct(v any) (map[string]string, error)

구조체를 map 으로 변환합니다. env 태그로 키 이름을 지정할 수 있습니다.

인터페이스 통합: 입력 유형이 Marshaler 인터페이스를 구현한 경우, MarshalEnv() 메서드를 우선 호출합니다.

매개변수:

v - 구조체 또는 구조체 포인터

반환값:

map[string]string - 키 - 값 쌍 매핑
error - 변환 오류

type Config struct {
    Host string `env:"SERVER_HOST"`
    Port int    `env:"SERVER_PORT"`
}

cfg := Config{Host: "localhost", Port: 8080}
m, _ := env.MarshalStruct(cfg)
// m["SERVER_HOST"] = "localhost"
// m["SERVER_PORT"] = "8080"

IsMarshalError

func IsMarshalError(err error) bool

오류가 직렬화/역직렬화 오류인지 확인합니다.

매개변수:

err - 확인할 오류

반환값:

bool - MarshalError 유형인지 여부

_, err := env.MarshalStruct(invalidData)
if env.IsMarshalError(err) {
    // 직렬화 오류 처리
}

전체 예제

package main

import (
    "fmt"
    "log"
    "time"

    "github.com/cybergodev/env"
)

type AppConfig struct {
    Host     string        `env:"APP_HOST" envDefault:"0.0.0.0"`
    Port     int64         `env:"APP_PORT" envDefault:"8080"`
    Debug    bool          `env:"DEBUG" envDefault:"false"`
    Timeout  time.Duration `env:"TIMEOUT" envDefault:"30s"`
    Hosts    []string      `env:"HOSTS"`
}

func main() {
    // 설정 파일 로드
    if err := env.Load(".env"); err != nil {
        log.Printf("Warning: %v", err)
    }

    // 개별 값 읽기
    host := env.GetString("APP_HOST", "localhost")
    port := env.GetInt("APP_PORT", 8080)
    debug := env.GetBool("DEBUG", false)
    timeout := env.GetDuration("TIMEOUT", 30*time.Second)

    fmt.Printf("Server: %s:%d\n", host, port)
    fmt.Printf("Debug: %v, Timeout: %v\n", debug, timeout)

    // 민감한 데이터
    secret := env.GetSecure("API_KEY")
    if secret != nil {
        defer secret.Release()
        fmt.Printf("API Key length: %d\n", secret.Length())
    }

    // 구조체 매핑
    var cfg AppConfig
    if err := env.ParseInto(&cfg); err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Config: %+v\n", cfg)

    // 모든 변수
    fmt.Printf("Loaded %d variables\n", env.Len())
}

패키지 함수 ​

로드 함수 ​

Load ​

키 이름 해석 ​

해석 규칙 ​

경로 변환 표 ​

인덱스 접근 ​

값 가져오기 함수 ​

GetString ​

GetInt ​

GetBool ​

GetUint64 ​

GetFloat64 ​

GetDuration ​

GetSecure ​

GetSlice[T] ​

GetSliceFrom[T] ​

조회 함수 ​

Lookup ​

Keys ​

All ​

Len ​

설정 및 삭제 ​

Set ​

Delete ​

검증 및 매핑 ​

Validate ​

ParseInto ​

유틸리티 함수 ​

ResetDefaultLoader ​

LoadWithConfig ​

직렬화 함수 ​

Marshal ​

UnmarshalMap ​

UnmarshalStruct ​

UnmarshalInto ​

MarshalStruct ​

IsMarshalError ​

전체 예제 ​

관련 문서 ​

패키지 함수

로드 함수

Load

키 이름 해석

해석 규칙

경로 변환 표

인덱스 접근

값 가져오기 함수

GetString

GetInt

GetBool

GetUint64

GetFloat64

GetDuration

GetSecure

GetSlice[T]

GetSliceFrom[T]

조회 함수

Lookup

Keys

All

Len

설정 및 삭제

Set

Delete

검증 및 매핑

Validate

ParseInto

유틸리티 함수

ResetDefaultLoader

LoadWithConfig

직렬화 함수

Marshal

UnmarshalMap

UnmarshalStruct

UnmarshalInto

MarshalStruct

IsMarshalError

전체 예제

관련 문서