Morse

Morse is an encoding method that converts text to sequences of dots and dashes, following the International Morse Code standard (ITU-R M.1677-1). dongle supports standard and streaming Morse encoding, converting letters, numbers, punctuation marks, international extended characters (such as å, ä, é, ñ, ó, ö, ú) and special characters such as spaces and line breaks to standardized sequences of dots and dashes.

The default separator is space, You can customize the separator by setting morse.StdSeparator

Character set and compatibility:

• In addition to the letters, numbers and punctuation of ITU-R M.1677-1, the alphabet contains international extended characters such as ¡, ¿, å/Å, ä/Ä, é/É, ñ/Ñ, ó/Ó, ö/Ö, ú/Ú, as well as extended symbols such as [, ], {, }, | and ~
• Encoding lowercases the input first, so characters that share a code with their uppercase form (e.g. Å/å) are decoded back in lowercase
• This is incompatible with v1.2.3 and earlier: < changed from .--.- to .--.-- (.--.- is now assigned to å), and \n changed to .-..-.. and no longer shares a code with \r; data encoded with the old version decodes differently

Encoding Data

Input Data

// Input string
encoder := dongle.Encode.FromString("hello world").ByMorse()
// Input byte slice
encoder := dongle.Encode.FromBytes([]byte("hello world")).ByMorse()
// Input file stream
file, _ := os.Open("test.txt")
encoder := dongle.Encode.FromFile(file).ByMorse()

// Check encoding error
if encoder.Error != nil {
	fmt.Printf("Encoding error: %v\n", encoder.Error)
	return
}

Output Data

// Output string
encoder.ToString() // .... . .-.. .-.. --- / .-- --- .-. .-.. -..
// Output byte slice
encoder.ToBytes()  // []byte(".... . .-.. .-.. --- / .-- --- .-. .-.. -..")

Decoding Data

Input Data

// Input string
decoder := dongle.Decode.FromString(".... . .-.. .-.. --- / .-- --- .-. .-.. -..").ByMorse()
// Input byte slice
decoder := dongle.Decode.FromBytes([]byte(".... . .-.. .-.. --- / .-- --- .-. .-.. -..")).ByMorse()
// Input file stream
file, _ := os.Open("test.txt")
decoder := dongle.Decode.FromFile(file).ByMorse()

// Check decoding error
if decoder.Error != nil {
	fmt.Printf("Decoding error: %v\n", decoder.Error)
	return
}

Output Data

// Output string
decoder.ToString() // hello world
// Output byte slice
decoder.ToBytes()  // []byte("hello world")