I would love to access all Fields, so far you only can Get one(the preferred) value by calling Get. You have access to all the Values, but that might not be sufficient: In my case, I want to have the details on all existing phone Numbers, so whether that phoneNumber is for Work, Home, Cell, etc.

So my simple suggestion:

// GetAllFields returns all fields of the card for the given property. If there is    
// no such field, it returns nil.  
func (c Card) GetAllFields(k string) []*Field {  
	fields := c[k]  
	if len(fields) == 0 {  
		return nil  
	}  
	return fields  
}

and on that you can extract all necessary information. Or is there a better way to extract all phone Numbers with the details on them?

When trying to test processing a vcf file exported using thunderbird, we encounter empty value for some fields, like email.

The vcard format is 2.1 and it appear that parameters are not encoded as key=value tuples as in format 3.0 and 4.0 they are. This make parseParam function of decoder.go parsing the Field.Value as a parameter value.

Example of format not parsed correctly :

begin:vcard
fn:someone
email;internet:[email protected]
version:2.1
end:vcard

Using this temporary solution I get back Field.Value filled correctly , but bypass completly any parameters:

https://gist.github.com/gdchamal/43c58f9d581cee05c40706692f852373

Yes I know vcard2.1 format should not exist anymore ;)

What do you think ?

I've this string

Hasan Yousef
BEGIN:VCARD
VERSION:3.0
N:Yousef;Hasan;;;
FN:Hasan Yousef
item1.TEL;waid=966xxxxxxxxx:+966 xx xxx xxxx
item1.X-ABLabel:Mobile
END:VCARD

1. How can I convert the above string to to vcard.Card, i.e. Encode string into vCard
2. If I have the vcard.Card how can I convert it into string, i.e. Decode a vCard into string

example error:

func main() {
	destFile, err := os.Create(".\Contacts2.vcf")
	if err != nil {
		log.Fatal(err)
	}
	defer destFile.Close()

	// data in order: first name, middle name, last name, telephone number
	contacts := [][4]string{
		{"John", "Webber", "Maxwell", "(+1) 199 8714"},
		{"Donald", "", "Ron", "(+44) 421 8913"},
		{"Eric", "E.", "Peter", "(+37) 221 9903"},
		{"Nelson", "D.", "Patrick", "(+1) 122 8810"},
	}

	var (
		// card is a map of strings to []*vcard.Field objects
		card vcard.Card

		// destination where the vcard will be encoded to
		enc = vcard.NewEncoder(destFile)
	)

	for _, entry := range contacts {
		// set only the value of a field by using card.SetValue.
		// This does not set parameters
		card.SetValue(vcard.FieldFormattedName, strings.Join(entry[:3], " "))
		card.SetValue(vcard.FieldTelephone, entry[3])

		// set the value of a field and other parameters by using card.Set
		card.Set(vcard.FieldName, &vcard.Field{
			Value: strings.Join(entry[:3], ";"),
			Params: map[string][]string{
				vcard.ParamSortAs: []string{
					entry[0] + " " + entry[2],
				},
			},
		})

		// make the vCard version 4 compliant
		vcard.ToV4(card)
		err := enc.Encode(card)
		if err != nil {
			log.Fatal(err)
		}
	}
}

panic: assignment to entry in nil map

goroutine 1 [running]:
github.com/emersion/go-vcard.Card.Set(...)
D:/gopath/src/github.com/emersion/go-vcard/card.go:118
github.com/emersion/go-vcard.Card.SetValue(...)
D:/gopath/src/github.com/emersion/go-vcard/card.go:166
main.main()
/vcard_cretor2.go:110 +0x3cd

I wrote the below that created vcard, but once I tried to read the vcard back to its string I failed:

package main

import (
	"io"
	"log"
	"strings"

	"github.com/emersion/go-vcard"
)

func main() {

	var content strings.Builder
	content.WriteString("BEGIN:VCARD\n")
	content.WriteString("VERSION:3.0\n")
	content.WriteString("FN:Hasan Yousef\n")
	content.WriteString("TEL:999\n")
	content.WriteString("Fitem1.TEL;waid=966000000000\n")
	content.WriteString("item1.X-ABLabel:Mobile\n")
	content.WriteString("END:VCARD")

	r := strings.NewReader(content.String())
	dec := vcard.NewDecoder(r)
	var card vcard.Card
	var err error
	for {
		card, err = dec.Decode()
		if err == io.EOF {
			break
		} else if err != nil {
			log.Fatal(err)
		}

		log.Println(card.PreferredValue(vcard.FieldFormattedName))
		log.Println(card.PreferredValue(vcard.FieldTelephone))
	}

	var enc vcard.Encoder

	// enc = vcard.NewEncoder(destFile)
	err = enc.Encode(card)
	if err != nil {
		log.Fatal(err)
	}

	// How can I convert enc to string!

	log.Println(&enc)

}

I got:

2022/05/07 12:44:47 Hasan Yousef
2022/05/07 12:44:47 999
panic: runtime error: invalid memory address or nil pointer dereference
[signal 0xc0000005 code=0x0 addr=0x18 pc=0x10549d]

goroutine 1 [running]:
io.WriteString({0x0, 0x0}, {0x15c770, 0xd})
        D:/Development/go/src/io/io.go:314 +0x7d
github.com/emersion/go-vcard.(*Encoder).Encode(0xc00004a360, 0x3?)
        D:/Development/gopath/pkg/mod/github.com/emersion/[email protected]/encoder.go:23 +0x57
main.main()
        D:/Desktop/main.go:41 +0x77e
exit status 2

I noticed telephone number is defined as TEL https://github.com/emersion/go-vcard/blob/dd3110a24ec26a6b9f8a45da21cc0f2ca2ce8c67/card.go#L53 And can be read as:

log.Println(card.PreferredValue(vcard.FieldTelephone))

But in my vcard, telephone number is defined as:

Fitem1.TEL;waid=966000000000

How can I read it?

I tried:

package main

import (
	"io"
	"log"
	"strings"

	"github.com/emersion/go-vcard"
)

func main() {

	var content strings.Builder
	content.WriteString("BEGIN:VCARD")
	content.WriteString("VERSION:3.0")
	content.WriteString("FN:Hasan Yousef")
	content.WriteString("Fitem1.TEL;waid=966000000000")
	content.WriteString("item1.X-ABLabel:Mobile")
	content.WriteString("END:VCARD")

	//	byteData := bytes.Buffer{}
	//	byteData.Write([]byte(content.String()))
	//	dec := vcard.Decoder(buf)
	//	r := bytes.NewReader([]byte(content.String()))

	r := strings.NewReader(content.String())
	dec := vcard.NewDecoder(r)
	for {
		card, err := dec.Decode()
		if err == io.EOF {
			break
		} else if err != nil {
			log.Fatal(err)
		}

		log.Println(card.PreferredValue(vcard.FieldFormattedName))
	}
}

But got:

2022/05/07 10:18:24 vcard: invalid BEGIN value
exit status 1

Once I tried commenting it:

//	content.WriteString("BEGIN:VCARD")

I got:

2022/05/07 10:21:31 vcard: no BEGIN field found

Thanks for the library, I was able to see my contacts. Since, I am new to golang, and just wanted to see if it is possible that you provide a way to add a new contact and save all contacts in documentation.

According to https://tools.ietf.org/html/rfc6350#section-5.3:

Its value MUST be an integer between 1 and 100 that quantifies the level of preference. Lower values correspond to a higher level of preference, with 1 being most preferred.