https://github.com/xorcare/pointer

Helper routines for simplifying the creation of optional fields of basic type.
https://github.com/xorcare/pointer

go godoc golang helper-routines point pointer pointers

Last synced: about 1 month ago
JSON representation

Helper routines for simplifying the creation of optional fields of basic type.

• Host: GitHub
• URL: https://github.com/xorcare/pointer
• Owner: xorcare
• License: bsd-3-clause
• Created: 2019-11-01T07:04:56.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-05T20:52:13.000Z (8 months ago)
• Last Synced: 2024-08-03T19:10:01.114Z (5 months ago)
• Topics: go, godoc, golang, helper-routines, point, pointer, pointers
• Language: Go
• Homepage: https://pkg.go.dev/github.com/xorcare/pointer
• Size: 28.3 KB
• Stars: 42
• Watchers: 4
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go-extra - pointer - 11-01T07:04:56Z|2022-08-04T16:57:51Z| (Utilities / Fail injection)

README

        
# pointer

[![Go workflow status badge](https://github.com/xorcare/pointer/actions/workflows/go.yml/badge.svg?branch=main)](https://github.com/xorcare/pointer/actions/workflows/go.yml)

[![codecov](https://codecov.io/gh/xorcare/pointer/badge.svg?branch=main)](https://codecov.io/gh/xorcare/pointer/tree/main)

[![Go Report Card](https://goreportcard.com/badge/github.com/xorcare/pointer)](https://goreportcard.com/report/github.com/xorcare/pointer)

[![GoDoc](https://godoc.org/github.com/xorcare/pointer?status.svg)](https://pkg.go.dev/github.com/xorcare/pointer)

Package pointer contains helper routines for simplifying the creation

of optional fields of basic type.

## A little copying is better than a little dependency

With the advent of generics in go 1.18, using this library in your code is

likely to be unwarranted, I recommend that you make a small local copy of this

library, for example:

Put the code below in the file: `internal/pointer/pointer.go` and use it at

your own pleasure.

```go

package pointer

// Of is a helper routine that allocates a new any value

// to store v and returns a pointer to it.

func Of[Value any](v Value) *Value {

    return &v

}

```

## Installation

```bash

go get github.com/xorcare/pointer

```

## Generics

Starting with Go 18+, you can use the `Of` method to get pointers to values of any types.

## Examples

Examples of using the library are presented on [godoc.org][GDE]

and in the [source library code][SCE].

## FAQ

| Question                                                              | Source                                               |

|-----------------------------------------------------------------------|------------------------------------------------------|

| How to set **bool** pointer in a struct literal or variable?          | `var _ *bool = pointer.Bool(true)`                   |

| How to set **byte** pointer in a struct literal or variable?          | `var _ *byte = pointer.Byte(1)`                      |

| How to set **complex64** pointer in a struct literal or variable?     | `var _ *complex64 = pointer.Complex64(1.1)`          |

| How to set **complex128** pointer in a struct literal or variable?    | `var _ *complex128 = pointer.Complex128(1.1)`        |

| How to set **float32** pointer in a struct literal or variable?       | `var _ *float32 = pointer.Float32(1.1)`              |

| How to set **float64** pointer in a struct literal or variable?       | `var _ *float64 = pointer.Float64(1.1)`              |

| How to set **int** pointer in a struct literal or variable?           | `var _ *int = pointer.Int(1)`                        |

| How to set **int8** pointer in a struct literal or variable?          | `var _ *int8 = pointer.Int8(8)`                      |

| How to set **int16** pointer in a struct literal or variable?         | `var _ *int16 = pointer.Int16(16)`                   |

| How to set **int32** pointer in a struct literal or variable?         | `var _ *int32 = pointer.Int32(32)`                   |

| How to set **int64** pointer in a struct literal or variable?         | `var _ *int64 = pointer.Int64(64)`                   |

| How to set **rune** pointer in a struct literal or variable?          | `var _ *rune = pointer.Rune(1)`                      |

| How to set **string** pointer in a struct literal or variable?        | `var _ *string = pointer.String("ptr")`              |

| How to set **uint** pointer in a struct literal or variable?          | `var _ *uint = pointer.Uint(1)`                      |

| How to set **uint8** pointer in a struct literal or variable?         | `var _ *uint8 = pointer.Uint8(8)`                    |

| How to set **uint16** pointer in a struct literal or variable?        | `var _ *uint16 = pointer.Uint16(16)`                 |

| How to set **uint32** pointer in a struct literal or variable?        | `var _ *uint32 = pointer.Uint32(32)`                 |

| How to set **uint64** pointer in a struct literal or variable?        | `var _ *uint64 = pointer.Uint64(64)`                 |

| How to set **time.Time** pointer in a struct literal or variable?     | `var _ *time.Time = pointer.Time(time.Now())`        |

| How to set **time.Duration** pointer in a struct literal or variable? | `var _ *time.Duration = pointer.Duration(time.Hour)` |

## License

© 2019-2020,2022 Vasiliy Vasilyuk 

Released under the [BSD 3-Clause License].

[BSD 3-Clause License]: https://github.com/xorcare/pointer/blob/main/LICENSE 'BSD 3-Clause "New" or "Revised" License'

[GDE]: https://godoc.org/github.com/xorcare/pointer#pkg-examples 'Examples of using package pointer'

[SCE]: https://github.com/xorcare/pointer/blob/main/example_test.go 'Source code examples of using package pointer'