PandaTech.BaseConverter 2.0.1

Base Converter

This project provides a class called PandaBaseConverter that can convert a number from base 10 to base 36 and vice versa. This project is available as a NuGet package as well.

Usage

Base 10 to Base 36

To convert a number from base 10 to base 36, call the Base10ToBase36 method, passing in the number as a long

long number = 12345;
string base36Number = BaseConverter.Base10ToBase36(number);

The resulting base36Number will be a string representation of the number in base 36.

Base 36 to Base 10

To convert a number from base 36 to base 10, call the Base36ToBase10 method, passing in the number as a string:

string base36Number = "2n9";
long number = BaseConverter.Base36ToBase10(base36Number);

The resulting number will be the decimal representation of the number in base 36.

Using in DTOs

public class MyDto
{
    [JsonConverter(typeof(PandaJsonBaseConverter))]
    public long Id { get; set; }
}

Using in controllers

[HttpGet("{id}")]
public async Task<ActionResult<MyDto>> Get([PandaParameterBaseConverter] long id)
{
    var myDto = await _myService.Get(id);
    return Ok(myDto);
}

In this case we will work in code with Id as long, but in json it will be as base 36 string.

Configuration

By default, the PandaBaseConverter class uses the characters "0123456789abcdefghijklmnopqrstuvwxyz" for base 36 conversion. You can configure the character set used by setting the *BASE36_CHARS environment variable to a string containing the desired characters.

export BASE36_CHARS="A32145789U0BCDEFGHIJKLMNOPQRSTVWXYZ6"

The resulting number will be the decimal representation of the number in base 36.

Error Handling

If the input to either conversion method is invalid, an ArgumentException will be thrown with an appropriate error message. The message will also be printed to the console.

Prgram.cs

to use PandaParameterBaseConverter in swagger, add the following code to Program.cs

builder.Services.AddSwaggerGen(
    options => 
        options.ParameterFilter<PandaParameterBaseConverter>()
    );